Как просматривать и читать всю Arch Wiki как страницы руководства Linux

Некоторое время назад я написал руководство, в котором описывалось, как просматривать Arch Wiki из терминала с помощью сценария командной строки с именем arch-wiki-cli. Используя этот скрипт, любой может легко перемещаться по всему веб-сайту Arch Wiki и читать его с помощью текстового браузера по вашему выбору. Очевидно, что для использования этого скрипта требуется активное подключение к Интернету. Сегодня я наткнулся на аналогичную утилиту под названием "Arch-wiki-man". Как следует из названия, он также используется для чтения Arch Wiki из командной строки, но не требует подключения к Интернету. Программа Arch-wiki-man позволяет просматривать и читать всю Arch Wiki в виде справочных страниц Linux. Он отобразит любую статью из Arch Wiki в формате man-страниц. Кроме того, вам не обязательно находиться в сети, чтобы просматривать Arch Wiki. Вся Arch Wiki будет загружена локально, а обновления будут автоматически устанавливаться каждые два дня. Таким образом, в вашей системе всегда есть актуальная локальная копия Arch Wiki.

Установка Arch-wiki-man

Arch-wiki-man доступен в AUR, поэтому его можно установить с помощью любой вспомогательной программы AUR, например Yay.

yay -S arch-wiki-man

Альтернативно его можно установить с помощью менеджера пакетов NPM, как показано ниже. Убедитесь, что у вас установлен NodeJS, и выполните следующую команду, чтобы установить его:

npm install -g arch-wiki-man

Просматривайте и читайте всю Arch Wiki как страницы руководства Linux

Типичный синтаксис Arch-wiki-man:

awman <search-query>

Позвольте мне показать вам несколько примеров.

Поиск по одному или нескольким совпадениям

Давайте найдем руководство по установке Arch Linux. Для этого просто запустите:

awman Installation guide

Приведенная выше команда выполнит поиск совпадений, содержащих поисковый запрос «Руководство по установке» в Arch Wiki. Если для данного поискового запроса имеется несколько совпадений, появится меню выбора. Выберите руководство, которое хотите прочитать, с помощью стрелок ВВЕРХ/ВНИЗ или сочетаний клавиш в стиле Vim (j/k) и нажмите ВВОД, чтобы открыть его. Полученное руководство откроется в формате man-страниц, как показано ниже.

Прочтите руководство по установке Arch Linux из CLI с помощью Awman.

Здесь awman относится к arch wiki man.

Поддерживаются все параметры команды man, поэтому вы можете перемещаться по руководству так же, как при чтении страницы руководства. Чтобы просмотреть раздел справки, нажмите h.

Чтобы выйти из меню выбора без ввода man, просто нажмите Ctrl+c.

Чтобы вернуться и/или выйти, man, введите q.

Поиск совпадений в заголовках и описаниях

По умолчанию Awman будет искать совпадения только в заголовках. Однако вы можете настроить его на поиск совпадений как в заголовках, так и в описаниях.

awman -d vim

Или,

awman --desc-search vim

Поиск совпадений по содержимому

Помимо поиска совпадений в заголовках и описаниях, также можно сканировать содержимое на наличие совпадений. Обратите внимание, что это значительно замедлит процесс поиска.

awman -k emacs

Или,

awman --apropos emacs

Откройте результаты поиска в веб-браузере

Если вы не хотите просматривать руководства Arch Wiki в формате man-страницы, вы можете открыть их в веб-браузере. Для этого запустите:

awman -w pacman

Или,

awman --web pacman

Эта команда откроет полученное совпадение в веб-браузере по умолчанию, а не с помощью команды man. Обратите внимание: для использования этой опции вам необходимо подключение к Интернету.

Поиск на других языках

По умолчанию Awman открывает вики-страницы Arch на английском языке. Если вы хотите просмотреть результаты на других языках, например испанском, просто выполните:

awman -l spanish codecs

Arch Wiki на испанском языке

Чтобы просмотреть список доступных языковых вариантов, запустите:

awman --list-languages

Обновите локальную копию Arch Wiki.

Как я уже сказал, обновления устанавливаются автоматически каждые два дня. Если вы хотите обновить его вручную, просто запустите:

$ awman-update
arch-wiki-man@1.3.0 /usr/lib/node_modules/arch-wiki-man
└── arch-wiki-md-repo@0.10.84

arch-wiki-md-repo has been successfully updated or reinstalled.

Рекомендуем прочитать:

• Как создавать и поддерживать собственные справочные страницы

Ресурс:

• Репозиторий Arch-wiki-man на GitHub