Difference between revisions of "Man page (Русский)"

From ArchWiki
Jump to navigation Jump to search
(Первый способ: используя 'most')
m (use language tag in category names)
Line 1: Line 1:
[[Category:Утилиты]]
+
[[Category:Утилиты (Русский)]]
 
[[Category:HOWTOs (Русский)]]
 
[[Category:HOWTOs (Русский)]]
 
{{i18n|Man Page}}
 
{{i18n|Man Page}}

Revision as of 19:35, 7 September 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Tango-preferences-desktop-locale.pngThis article or section needs to be translated.Tango-preferences-desktop-locale.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Man page (Русский)#)

Template:Article summary start Template:Article summary text Template:Article summary end

Man страницы (от англ. manual — руководство) - это обширная документация, предустановленная почти во всех значительных UNIX подобных операционных системах, включая Arch Linux. Для их отображения служит команда Template:Codeline.

Не смотря на свой масштаб, man страницы разработаны как самодостаточные документы и вследствие чего ограничены в возможности ссылаться на другие man страницы во время обсуждения связанных тем. В противоположность гипертекстовым info файлам - попытке GNU заменить формат традиционных man страниц.

Доступ к man страницам

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

$ man имя_страницы

Руководства отсортированы по нескольким секциям:

  1. Основные команды
  2. Системные вызовы (функции предоставляемые ядром)
  3. Библиотечные вызовы (функции библиотеки языка C)
  4. Специальные файлы (обычно расположены в каталоге /dev) и драйверы
  5. Формат файлов и соглашения
  6. Игры
  7. Разное (включая соглашения)
  8. Команды для системного администрирования (обычно требуют привилегий root'а) и демоны

На man страницы обычно ссылаются по их имени с последующим номером секции в круглых скобках. Часто существуют несколько man страниц с одинаковым именем, такие как man(1) и man(7). В этом случае необходимо передать команде man номер секции с последующим именем страницы, например:

$ man 5 passwd

чтобы прочитать man по Template:Codeline, вместо утилиты Template:Codeline.

Очень краткие описание программ можно прочитать из man страниц не выводя из целиком с помощью команды Template:Codeline. Например, для краткого описания ls, напечатайте:

$ whatis ls

и Template:Codeline выведет "list directory contents."

Формат

Все man страницы строго следуют стандарному формату, который помогает в навигации по ним. Некоторые часто представленные секции:

  • NAME (ИМЯ) - Имя команды и короткое выражение, описывающее ее назначения
  • SYNOPSIS (СИНТАКСИС) - Список опций и агрументов, которые принимает команда или параметры функции и ее заголовочный файл
  • DESCRIPTION (ОПИСАНИЕ) - Подробное описание назначения команды или функции и принципов работы.
  • EXAMPLES (ПРИМЕРЫ) - Типичные примеры, обычно начиная с простых до относительно сложных.
  • OPTIONS (ОПЦИИ) - Описание каждой из опций, которые принимает комнада, и что они делают.
  • EXIT STATUS (СТАТУС ВЫХОДА) - Значения различных кодов выхода.
  • FILES (ФАЙЛЫ) - Файлы связанные с командой или функцией.
  • BUGS (ОШИБКИ) - Проблемы с командой или функцией ожидающие решения. Также известны как KNOWN BUGS (ИЗВЕСТНЫЕ ОШИБКИ)
  • SEE ALSO (СМОТРИ ТАКЖЕ) - Список связанных команд и функций
  • AUTHOR (АВТОР), HISTORY (ИСТОРИЯ), COPYRIGHT (ПРАВА), LICENSE (ЛИЦЕНЗИЯ), WARRANTY (ГАРАНТИИ) - Информация о программе, ее прошлом, условиях использования и ее создателях.

Поиск документации

Хотя утилита Template:Codeline позовляет пользователям проматривать страницы руководств, возникает проблема, когда вы не знаете точного имени желаемой man страницы! К счастью, вы можете воспользоваться опцией Template:Codeline или Template:Codeline для поиска в кратком описании страницы руководства заданного ключевого слова. Например, чтобы найти страницу относящуюся к "password":

$ man -k password

или:

$ man --apropos password

Это эквивалентно вызову команды Template:Codeline:

$ apropos password

Заданное ключевое слово, по-умолчанию, интерпретируется как регулярное выражение.

Цветные man страницы

Для некоторых пользователей цветные man страницы позволяют получить более четкое представление и легче переварить содержимое. Учитывая, что новые пользователи Linux вынуждены тратить значительно количество времени для ознакомления с основными пользовательскими инструментами, создание комфортных условий для большинства является необходимым.

Есть два основных способа получения цвеных man страниц: использование Template:Codeline, или с помощью опций для Template:Codeline. Первый проще в настройках в ущерб дополнительных функций присущих Template:Codeline.

Первый способ: используя 'most'

Установите Template:Package Official с помощью pacman:

# pacman -S most

Это программа подобна Template:Codeline и Template:Codeline, а также с легкостью позволяет отображать цветной текст.

Отредактируйте Template:Filename, раскомментируйте определение просмоторщика из замените его следующим образом:

DEFINE     pager     most -s

Протестируйте новые настройки напечатав:

$ man whatever_man_page

Изменение цвета требует редактирования Template:Filename (создайте, если его не существует) или редактирования Template:Filename для глобальных настроек. Например, Template:Filename:

% Color settings
color normal lightgray black
color status yellow blue
color underline yellow black
color overstrike brightblue black

Следующий пример демострирует настройку привязки клавиш схожую с Template:Codeline (перейти на следующую строку установленно для 'J'):

% less-like keybindings
unsetkey "^K"
unsetkey "g"
unsetkey "G"
unsetkey ":"

setkey next_file ":n"
setkey find_file ":e"
setkey next_file ":p"
setkey toggle_options ":o"
setkey toggle_case ":c"
setkey delete_file ":d"
setkey exit ":q"

setkey bob "g"
setkey eob "G"
setkey down "e"
setkey down "E"
setkey down "j"
setkey down "^N"
setkey up "y"
setkey up "^Y"
setkey up "k"
setkey up "^P"
setkey up "^K"
setkey page_down "f"
setkey page_down "^F"
setkey page_up "b"
setkey page_up "^B"
setkey other_window "z"
setkey other_window "w"
setkey search_backward "?"
setkey bob "p"
setkey goto_mark "'"
setkey find_file "E"
setkey edit "v"

Second method: using 'less'

Source: nion's blog - less colors for man pages

Alternatively, getting an approximate coloured result in manual pages with Template:Codeline is also a possibility. This method has the advantage that Template:Codeline has a bigger feature set than Template:Codeline, and that might be the preference for advanced users.

Add the following to a shell configuration file. For Bash it would be Template:Filename:

man() {
	env \
		LESS_TERMCAP_mb=$(printf "\e[1;37m") \
		LESS_TERMCAP_md=$(printf "\e[1;37m") \
		LESS_TERMCAP_me=$(printf "\e[0m") \
		LESS_TERMCAP_se=$(printf "\e[0m") \
		LESS_TERMCAP_so=$(printf "\e[1;47;30m") \
		LESS_TERMCAP_ue=$(printf "\e[0m") \
		LESS_TERMCAP_us=$(printf "\e[0;36m") \
			man "$@"
}

To customize the colors, see Wikipedia:ANSI escape code for reference.

Reading man pages with a browser

Instead of the standard interface, using browsers such as lynx and Firefox to view man pages allows users to reap info pages' main benefit: hyperlinked text. Additionally, KDE users can read man pages in Konqueror using:

man:<name>

Using Local Man Pages

First, install Template:Package AUR from the AUR.

Now, convert a man page:

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

Another use for Template:Codeline is exporting to raw, printer-friendly text:

$ man free | man2html -bare > ~/free.txt

The GNU implementation of man in the Arch repositories also has the ability to do this on its own:

$ man -H free

This will read your BROWSER environment variable to determine the browser. You can override this by passing the binary to the -H option.

Using Online Man Pages

There are several online databases of man pages, many of them listed on Wikipedia:Man_page#Repositories_of_manual_pages, including: