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

From ArchWiki
Jump to navigation Jump to search
m (Bot: Removing from Category:HOWTOs (Русский))
(Чтение man страниц с помощью браузера)
Line 161: Line 161:
 
To customize the colors, see [[Wikipedia:ANSI escape code]] for reference.
 
To customize the colors, see [[Wikipedia:ANSI escape code]] for reference.
  
==Reading man pages with a browser==
+
==Чтение man страниц с помощью браузера==
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.
+
Использование таких браузеров, как [[lynx]] и [[Firefox]] для просмотра man страниц позволяет пользователям воспользоваться основным преимуществом информационных страниц: текст с гиперссылками.
Additionally, [[KDE]] users can read man pages in Konqueror using:
+
Кроме того, пользователи [[KDE]] могут читать страницы man в браузере Konqueror с помощью:
 
  man:<name>
 
  man:<name>
  
===Using Local Man Pages===
+
===Использование локальных man страниц===
First, install {{package AUR|man2html}} from the [[AUR]].
+
Для начала, установите {{package AUR|man2html}} из [[Arch_User_Repository_(Русский)|AUR]].
  
Now, convert a man page:
+
Теперь, сконвертируйте man страницу:
 
  $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html
 
  $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html
  
Another use for {{codeline|man2html}} is exporting to raw, printer-friendly text:
+
Также, {{codeline|man2html}} можно использовать для экспортирование в сырой, подходящий для принтера, текст:
 
  $ man free | man2html -bare > ~/free.txt
 
  $ 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:
+
GNU реализация man, находящегося в репозиториях Arch также имеет возможно сделать это самостоятельно:
 
  $ man -H free
 
  $ man -H free
  
This will read your <code>BROWSER</code> environment variable to determine the browser. You can override this by passing the binary to the -H option.
+
Эта команда считает вашу переменную окружения <code>BROWSER</code> для определения браузера. Вы можете сами определить нужный браузер, передавая опции -H путь к бинарному файлу. Например:
 +
man -H /путь/к/бинарнику free
  
===Using Online Man Pages===
+
===Использование онлайновых страниц man===
There are several online databases of man pages, many of them listed on [[Wikipedia:Man_page#Repositories_of_manual_pages]], including:
+
Есть несколько онлайновых баз данных страниц man, включая:
*[http://manpages.debian.net/ ''Debian GNU/Linux man pages'']
+
 
*[http://leaf.dragonflybsd.org/cgi/web-man ''DragonFlyBSD manual pages'']
+
*[http://manpages.debian.net/ ''Страницы man Debian GNU/Linux'']
*[http://www.freebsd.org/cgi/man.cgi ''FreeBSD Hypertext Man Pages'']
+
*[http://leaf.dragonflybsd.org/cgi/web-man ''Страницы man DragonFlyBSD'']
*[http://www.manpages.spotlynx.com/ ''Linux and Solaris 10 Man Pages'']
+
*[http://www.freebsd.org/cgi/man.cgi ''Страницы man FreeBSD Hypertext'']
*[http://manpagehelp.net ''Linux/FreeBSD Man Pages''] with user comments
+
*[http://www.manpages.spotlynx.com/ ''Страницы man Linux и Solaris 10'']
*[http://linux.die.net/man/ ''Linux man pages at die.net'']
+
*[http://manpagehelp.net ''Страницы man Linux/FreeBSD''] с комментариями пользователей
* [http://www.kernel.org/doc/man-pages/ The Linux man-pages project at kernel.org]
+
*[http://linux.die.net/man/ ''Страницы man Linux на die.net'']
 +
* [http://www.kernel.org/doc/man-pages/ Проект man страниц по Linux на kernel.org]
 
*[http://man-wiki.net/index.php/Main_Page Man-Wiki: ''Linux / Solaris / UNIX / BSD'']
 
*[http://man-wiki.net/index.php/Main_Page Man-Wiki: ''Linux / Solaris / UNIX / BSD'']
*[http://netbsd.gw.com/cgi-bin/man-cgi ''NetBSD manual pages'']
+
*[http://netbsd.gw.com/cgi-bin/man-cgi ''Страницы man NetBSD'']
*[http://developer.apple.com/documentation/Darwin/Reference/ManPages/index.html ''Mac OS X Manual Pages'']
+
*[http://developer.apple.com/documentation/Darwin/Reference/ManPages/index.html ''Страницы man Mac OS X'']
*[http://unixhelp.ed.ac.uk/alphabetical/index.html ''On-line UNIX manual pages'']
+
*[http://unixhelp.ed.ac.uk/alphabetical/index.html ''Онлайн страницы man UNIX'']
*[http://www.openbsd.org/cgi-bin/man.cgi ''OpenBSD manual pages'']
+
*[http://www.openbsd.org/cgi-bin/man.cgi ''Страницы man OpenBSD'']
*[http://man.cat-v.org/plan_9/ ''Plan 9 Manual Volume 1'']
+
*[http://man.cat-v.org/plan_9/ ''Руководство по Plan 9 — Том 1'']
*[http://man.cat-v.org/inferno/ ''Inferno Manual Volume 1'']
+
*[http://man.cat-v.org/inferno/ ''Руководство по Inferno — Том 1'']
*[http://sfdoccentral.symantec.com/sf/5.0MP3/linux/manpages/index.html ''Storage Foundation Man Pages'']
+
*[http://sfdoccentral.symantec.com/sf/5.0MP3/linux/manpages/index.html ''Страницы man Storage Foundation'']
*[http://markhobley.yi.org/manpages/missingman.html ''The Missing Man Project''] [dead link as of 9 July 2010]
+
*[http://www.unix.com/man-page/OpenSolaris/1/man/ ''Репозиторий страниц man на форуме UNIX и Linux'']
*[http://en.linuxpages.info/index.php?title=Main_Page ''Gobuntu Manual Pages''] [dead link as of 9 July 2010]
+
*[http://manpages.ubuntu.com/ ''Репозиторий страниц man Ubuntu'']
*[http://www.unix.com/man-page/OpenSolaris/1/man/ ''The UNIX and Linux Forums Man Page Repository'']
 
*[http://manpages.ubuntu.com/ ''Ubuntu Manpage Repository'']
 

Revision as of 07:43, 28 January 2012

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.

Чтение man страниц с помощью браузера

Использование таких браузеров, как lynx и Firefox для просмотра man страниц позволяет пользователям воспользоваться основным преимуществом информационных страниц: текст с гиперссылками. Кроме того, пользователи KDE могут читать страницы man в браузере Konqueror с помощью:

man:<name>

Использование локальных man страниц

Для начала, установите Template:Package AUR из AUR.

Теперь, сконвертируйте man страницу:

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

Также, Template:Codeline можно использовать для экспортирование в сырой, подходящий для принтера, текст:

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

GNU реализация man, находящегося в репозиториях Arch также имеет возможно сделать это самостоятельно:

$ man -H free

Эта команда считает вашу переменную окружения BROWSER для определения браузера. Вы можете сами определить нужный браузер, передавая опции -H путь к бинарному файлу. Например:

man -H /путь/к/бинарнику free

Использование онлайновых страниц man

Есть несколько онлайновых баз данных страниц man, включая: