Man page (български)

Тази страница се нуждае от поддръжка

man страници(от английскиmanual- ръководство) са страници с ръководство, които се предоставят от почти всички *nix дистрибуции, включително Arch Linux. За показването им се използва командата man.

страниците с ръководство първоначално са предназначени да бъдат самостоятелни документи. Те са ограничени в способността си да се свързват един с друг, за разлика от информационните файлове с хипервръзки, опитът на GNU да създаде заместител на традиционния формат на страницата с ръководство.

Достъп до страниците на ръководството

За да покажете страницата на ръководството, въведете

  1. Основни команди
  2. Системни повиквания (функции, предоставени от ядрото на Linux)
  3. Библиотечни извиквания (стандартни C библиотечни функции)
  4. Специални файлове (обикновено намиращи се в /dev) и драйвери
  5. Файлови формати и конвенции
  6. игри
  7. Други страници (също включително споразумения)
  8. Команди за системно администриране (които обикновено изискват права на суперпотребител) и демони

ще покаже страницата с ръководство за файла /etc/passwd вместо помощната програма passwd.

Вместо да показвате цялата страница на ръководството, можете да покажете само кратко описание на страницата на ръководството, като използвате командата whatis. Например,

ще отпечата кратко описание на командатаls: "списък на съдържанието на директорията" ("списък на съдържанието на директорията").

Формат на страницата

За по-лесна навигация всички страници с ръководство отговарят на един стандартен формат. Ето списък на някои секции, които често се използват на страниците:

  • NAME е името на командата и кратко описание от един ред на нейната цел.
  • СИНОПСИС е списък с опции и аргументи на командния ред, които командата приема, или функционални параметри и нейния заглавен файл.
  • ОПИСАНИЕ - по-подробно описание на предназначението и принципите на командата или функцията.
  • ПРИМЕРИ - типични примери за употреба, обикновено от най-простите до най-сложните.
  • ОПЦИИ Описания за всяка от опциите, които командата приема.
  • ИЗХОДЕН СТАТУС - кодове за връщане и техните значения.
  • FILES - Файлове, свързани с команда или функция.
  • ГРЕШКИ са вероятни проблеми с екип или функция, които чакат. Известен също като ИЗВЕСТНИ БЪГОВЕ.
  • ВИЖТЕ СЪЩО - списък със свързани команди и функции.
  • АВТОР, ИСТОРИЯ, АВТОРСКИ ПРАВА, ЛИЦЕНЗ, ГАРАНЦИЯ - информация за програмата: нейната история, условия за използване, създатели на програмата.

Търсене на страница

Въпреки че командата man ви позволява да показвате man страници, става трудно, когато не знаете точното име на страницата, която искате. За щастие, можете да използвате опциите -k или --apropos, за да търсите ключова дума в описанията на страницата с ръководство.

Търсенето работи само на индексирани страници. Кешът на индекса може да е остарял или изобщо да липсва и няма да получите очакваните резултати при опити за търсене. Можете да създадете индекс или да го актуализирате, като направите

Индексирането на страници трябва да се изпълнява всеки път, когато се добавят страници с ръководство.

Сега можете да използвате търсенето. Например, за да намерите man страници, свързани с пароли ("парола"), въведете:

Със същия успех можете да използвате и командата apropos:

По подразбиране ключовата дума се интерпретира като регулярен израз.

Ако искате да направите по-задълбочено търсене на цялото съдържание на страницата, използвайте опцията -K:

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

Текстът на man страниците може да се показва в различни цветове, което ги улеснявачетене. Има два основни метода за оцветяване на страници - използване на помощните програмиlessиmost.

С по-малко (препоръчително)

Това има предимството, че less има по-богат набор от функции от повечето и също така е по подразбиране за показване на страници с ръководство.

Добавете следните редове към конфигурационния файл на обвивката (за Bash това е файлът

Изпълнете командите от файла, за да видите промените:

За Fish настройките ще изглеждат по следния начин:

За да видите промените веднага (без да рестартирате рибата или системата), изпълнете:

Използване на повечето (не се препоръчва)

Помощната програма most изпълнява същата задача като less иmore, но с по-малък набор от функции. Задаването на цветове за повечето е по-лесно, но е необходима допълнителна конфигурация, за да работят повечето като по-малко.

Отворете която и да е страница на ръководството, за да проверите.

Цветовете се задават в персонализиран файл

/.mostrc (трябва да се създаде, ако липсва) или в системния файл /etc/most.conf. Пример за конфигурация:

Друг пример, показващ как да настроите клавишни комбинации, подобно на по-малко (прескачане към ред е присвоено на клавиша J):

Цветни страници в xterm или rxvt-unicode

Бърз начин за оцветяване на man страници, които се разглеждат чрез xterm / uxterm или rxvt-unicode, е да редактирате файла

Подсекциите предоставят конфигурация за xterm и rxvt-unicode.

Тези настройки заменят стиловете на текста с цветове. Добавете още:

ако искате да видите цветове и стилове едновременно. Вижте също xterm(1) за описание на терминалния ресурс veryBoldColors.

rxvt-уникод

След като направите промени във файла, изпълнете:

Стартирайте xterm / uxterm или rxvt-unicode и трябва да видите цветни страници с ръководство. Тези настройки добавят цветове за думи судебелен шрифтиподчертанв xterm/uxterm и цветове за думи судебелен шрифт,подчертаникурсивв rxvt-unicode. Можете също така да комбинирате тези атрибути в различни комбинации.

Разглеждане на местни страници

Като алтернатива можете да инсталирате следните пакети от официалните хранилища:

2. yelp - Помощен браузър от GNOME.

Преобразуване на страници в HTML

Инсталирайте пакета mandoc AUR. За да конвертирате страница в, например, free(1) , въведете:

Полученият файл free.html вече може да бъде отворен във всеки уеб браузър.

Преобразувайте страницата с командата:

Друга полезна функция на man2html е експортирането в обикновен текстов файл, който може да бъде отпечатан:

Реализацията на GNU на помощната програма man също ви позволява да отворите страницата в уеб браузър:

Командата ще стартира браузъра, зададен в променливата на средата BROWSER. Можете да посочите изрично браузъра, като подадете пътя до изпълнимия файл веднага след опцията -H.

За да конвертирате страница, направете:

Конвертиране в PDF

Страниците на ръководството винаги са били печатаеми: те са написани във формат troff, който е типографски език. Ако имате инсталиранghostscript, конвертирането на страниците на ръководството в PDF е много лесно:

Можете да видите как ще изглежда полученият PDF файл на тази връзка.

Обърнете внимание, че шрифтовете са предимно ограничени до набора Times и имат фиксирани размери. Документът няма да съдържа хипервръзки. Някои man страници бяха форматирани, за да изглеждат добре в терминала,въпреки това те може да не се показват правилно под формата на PostScript или PDF документи.

Сърфиране онлайн

Има много хранилища на man страници онлайн; ето кратък списък:

Полезни страници

Ето малък списък с полезни страници с ръководство, които могат да ви помогнат да придобиете по-задълбочени познания за много полезни неща. Някои от тях могат да служат като добри препратки (например ASCII таблицата).

Както и страници, свързани директно с Arch Linux: