Что такое справочная страница ?
Страница man (сокращение от man-страницы) - это традиционная форма документации программного обеспечения для Unix-подобных ОС, таких как Ubuntu. Для подавляющего большинства команд и программ есть справочная страница, которая перечисляет их параметры и объясняет их использование.
Как я могу найти и просмотреть справочные страницы?
Оффлайн в терминале
Справочные страницы автоматически устанавливаются в вашей системе вместе с командами, которые они описывают. Для просмотра и поиска справочных страниц есть команда man
:
man mv
отображает страницу человека в mv
то время
man -k mv
ищет имена и короткие описания всех установленных man-страниц для строки mv
. Расширенные регулярные выражения POSIX разрешены, и это поиск , так что это также найдет, например, git-mv
и semver
, если вы хотите искать именно mv
использовать ^mv$
вместо этого.
Смотрите. В чем разница между `man` и` man (#) `? читать о разделах справочной страницы. Для получения дополнительной информации прочитайте справочную man
страницу. ;)
Как я могу повлиять на отображение страницы руководства?
Программа по умолчанию для отображения man-страниц less
. Этот так называемый пейджер предоставляет полезную функцию поиска, просто введите, /
а затем поисковый запрос, например
/--version
и нажмите Enter. Это пометит все находки и перейдет к первому. Нажмите, Nчтобы перейти к следующей находке и ⇧ Shift+, Nчтобы перейти к предыдущей (см. Как я могу выполнить поиск на странице справки? ). Для просмотра списка команд нажмите H, для выхода less
нажмите Q.
Рядом less
есть другие пейджеры доступны: pg
, most
а w3m
просто перечислить три. Я рекомендую most
: он поставляется с очень полезной раскраской ключевых слов, что значительно облегчает чтение и навигацию по man-странице , убедитесь сами:
Чтобы просмотреть справочную страницу, отличную от вашего пейджера по умолчанию, используйте -P
параметр, например:
man -P most mv
Если вы хотите изменить страницы пейджера по умолчанию , отображаются два варианта:
изменить пейджер по умолчанию только man
export MANPAGER=most
Чтобы сделать изменения постоянными, добавьте эту команду в ваш ~/.bashrc
файл.
изменить пейджер по умолчанию всей вашей системы
sudo update-alternatives --config pager
Поклонники могут даже (ab) использовать vim
как MANPAGER
, см. Эту статью, написанную muru .
Страницы руководства отображаются шрифтом, указанным в настройках эмулятора терминала. Если вы регулярно работаете с терминалом, вы можете изменить этот шрифт; Я могу только порекомендовать Hack - гарнитуру, разработанную для исходного кода , см. Скриншот выше для ее красоты.
Оффлайн через графический интерфейс
Хорошим и простым способом отображения справочных страниц с помощью простого графического интерфейса пользователя является предустановленная yelp
программа. Чтобы запустить справочную страницу с помощью yelp
execute yelp man:PROGRAM
или gnome-help man:PROGRAM
, например:
yelp man:mv
Вы также можете просматривать справочные страницы в выбранном вами браузере , см. Как открыть справочные страницы в веб-браузере? , Например , для man mv
в firefox
:
man -Hfirefox mv
И последнее, но не менее важное: вы можете конвертировать справочные страницы в PDF и просматривать их с помощью предпочитаемого вами средства просмотра PDF, см .: Есть ли способ распечатать информационные / справочные страницы в PDF?
В сети
Вы можете просматривать справочные страницы программ, доступные через репозитории всех поддерживаемых в настоящее время версий Ubuntu, с сокращенным URL-адресом manpg.es/PROGRAM
, например, http://manpg.es/mv . Откроется mv
страница руководства для последней версии Ubuntu, вы можете выбрать другую версию в верхней панели. Для поиска справочных страниц вы можете использовать, например, http://manpages.ubuntu.com/cgi-bin/search.py?q=mv .
Как объяснено выше, man
могут отображаться только справочные страницы программного обеспечения, установленного в системе. Для просмотра страницы человека от http://manpages.ubuntu.com с помощью терминала пейджера есть dman
доступны в bikeshed
пакете.
Другие источники
Когда вы читаете документацию из других онлайн-источников, рекомендуется следить за версией программы. Большинство программ имеют --version
опцию, которая отображает версию рассматриваемой программы, например,
$ mv --version
mv (GNU coreutils) 8.25
Есть много сайтов, которые посвятили себя тому, чтобы сделать man-страницы легко доступными, я просто собираюсь представить два, которые мне нравятся больше всего:
- В man7.org есть полезная подсветка синтаксиса, но в нем есть только последняя выпущенная версия программы.
- На manpag.es размещены справочные страницы релизов Ubuntu, которые давно исчезли. EOL
Источник еще не связан: https://wiki.ubuntuusers.de/man/