Как установить страницы руководства в Alpine Linux

Alpine Linux известен своим размером. Минимальный образ Docker на базе Alpine Linux с полным индексом пакетов имеет размер всего 5 МБ! Неудивительно, почему он популярен среди многих опытных пользователей и разработчиков Linux. Он настолько мал по сравнению со своими аналогами, потому что многие ненужные пакеты удалены, чтобы уменьшить размер Alpine Linux. Даже страницы руководства для многих утилит командной строки по умолчанию не включены в образы докеров Alpine и бродячие поля. В этом кратком руководстве вы узнаете, как установить справочные страницы в Alpine Linux.

Установка страниц руководства в Alpine Linux

Чтобы добавить или установить справочные страницы в Alpine Linux, запустите:

sudo apk add man man-pages mdocml-apropos less less-doc

Начиная с Alpine Linux 3.12, разработчики изменили имя пакета man на mandoc. Итак, если вы используете версию 3.12, выполните следующую команду, чтобы добавить страницы руководства:

sudo apk add mandoc man-pages less less-doc

Затем используйте предпочитаемый вами PAGER для просмотра длинных страниц руководства, страница за страницей:

export PAGER=less

Чтобы сделать это постоянным, добавьте его в свой файл ~/.bashrc:

echo 'export PAGER=less' >> ~/.bashrc

Выполните следующую команду, чтобы изменения вступили в силу:

source ~/.bashrc 

Теперь вы можете просмотреть справочные страницы команд Linux в системе Alpine Linux:

man uname

Из-за своего небольшого размера установленные выше пакеты добавят только основные страницы руководства. Тем не менее, многие другие установленные программы не имеют собственных страниц руководства. Вместо этого они предоставляют ассоциированный пакет, содержащий страницы руководства.

Например, давайте попробуем отобразить справочную страницу curl:

man curl
man: No entry for curl in the manual.

Видеть? Страница руководства для curl не включена, хотя мы уже добавили пакеты, предоставляющие страницы руководства.

Вы можете узнать, какой пакет предоставляет документацию для данного пакета, используя команды apk и grep, как показано ниже:

apk search curl | grep ^curl

Пример вывода:

curl-7.69.1-r3
curl-dev-7.69.1-r3
curl-dbg-7.69.1-r3
curl-static-7.69.1-r3
curl-doc-7.69.1-r3

Найдите пакет, предоставляющий справочную страницу команды Curl.

Как видно из приведенного выше вывода, пакет curl-doc добавит документацию к команде curl. Итак, давайте установим его с помощью команды:

sudo apk add curl-doc

Теперь вы можете отобразить справочную страницу команды Curl:

man curl

Отобразить справочную страницу команды Curl

Давайте найдем другую утилиту командной строки, например wget:

apk search wget | grep ^wget
wget-1.20.3-r1
wget-doc-1.20.3-r1
wgetpaste-2.29-r1
wgetpaste-zsh-completion-2.29-r1

Как видите, пакет, содержащий документацию для команды wget, — это wget-doc. Вам необходимо установить этот пакет для просмотра страниц руководства по команде wget:

sudo apk add wget-doc

Надеюсь это поможет.

Связанное чтение:

• Научитесь эффективно использовать справочные страницы в Linux
• Как просмотреть определенный раздел на страницах руководства в Linux
• Хорошие альтернативы man-страницам, которые должен знать каждый пользователь Linux
• Как найти самую длинную справочную страницу в Linux
• Как создавать и поддерживать собственные справочные страницы
• Как установить отсутствующие страницы команд команд в Ubuntu
• Pinfo — программа CLI для чтения информации и справочных страниц в цвете