Как да намеря документация в собствената си система GNU / Linux

Много от новите в света GNU / Linux те са пълни със съмнения и не могат да намерят бърз отговор на притесненията си, понякога дори нямат връзка, чрез която да получат достъп до форум за поддръжка и накрая стигат до идеята, че Linux е много труден за тях.

Повечето от онези, които се оказват в тази ситуация, не знаят, че нашата собствена система съдържа добра част от отговорите на първоначалните ни притеснения. По същество в системата има три източника на документация GNU / Linux: ръчни страници (ръководства), информационни страници (информационни страници) и ръководства за приложения, опаковани в / usr / share / doc

В тази статия ще разкажем подробно всеки от тези източници.

---

Човешки страници

Страниците с ръководството или „ръководствата“ са класическите форми на справочна документация в Linux и Unix. В идеалния случай можете да търсите в ръководствата за помощ за всяка команда, конфигурационен файл или рутинна библиотека.

На практика Linux е безплатен софтуер и някои страници не са написани или показват възрастта им. Страниците с хора обаче са първото място за търсене, когато имате нужда от помощ. За достъп до страниците с ръководства, просто напишете мъж последвано от темата, която трябва да бъде проучена.

Ще се стартира пейджинг, така че ще натиснете q когато приключа с четенето. Например, за да намерите информация за командата ls, Бих написал:

$ man ls

Познавайки частите от справочните страници, може да е полезно да преминете бързо към информацията, от която се нуждаете, ще намерите следните раздели на ръководството (каре 1):

Таблица 1: Ръчни страници

NAME	Име и описание на командата
Кратък обзор	Как да използвам командата
ОПИСАНИЕ	Подробно обяснение на начина, по който работи командата
ПРИМЕРИ	Предложения как да използвате командата
ВИЖТЕ СЪЩО	Свързани теми (Обикновено в man страници)

Раздели на ръководствата

Файловете, които съдържат ръководствата, се съхраняват в / usr / share / man (или в / usr / човек на някои стари системи). В тази директория ще откриете, че страниците с ръководството са организирани в следните раздели (каре 2).

Таблица 2: Раздели на страниците с ръководството

man1	Потребителски програми
man2	Системни разговори
man3	Библиотечни функции
man4	Специални файлове
man5	Файлов формат
man6	Juegos
man7	смесица

Няколко човешки страници

Някои теми съществуват в повече от един раздел. За да демонстрираме това, ще използваме командата какво е, който показва всички ръководства за тази тема:

$ какво е printf

printf (1) - формат и данни за печат

printf (3) - форматирано преобразуване на изхода

В този случай, човек printf ще бъде на страницата на раздел 1 (Потребителски програми). Ако трябваше да напишем програма на C, щяхме да се интересуваме повече от страницата в раздел 3 (Библиотечни функции). Можете да извикате определен раздел от ръководствата, като го посочите в командния ред, така че да поискате ФОРМАТ, можем да напишем:

$man 3 printf

Намиране на правилната страница на човека

Понякога е трудно да се намерят няколко ръководства по дадена тема. В този случай можете да използвате човек -к за да намерите раздела ИМЕ на страниците с ръководства. Знайте, че това е търсене на поднизове, така че нещо като човек -k ls ще ви даде много резултати, ето пример с по-конкретна дума:

$ man -k whatis whatis (1) - отпечатва ръчни описания на страници

Всичко за това

Предишният пример ни донесе още няколко точки. Първо, командата уместен е точно еквивалентно на човек -к, (Всъщност ще ви дам тайна. Когато бягате човек -к всъщност тичам уместен зад сцената).

---

Кодът на MANPATH

Сега ще се обърнем към втория тип документация, която ще намерим в нашата система GNU / Linux. По подразбиране програмата man търси страниците с информация в / usr / share / man, / usr / local / man, / usr / X11R6 / man и евентуално / opt / man. понякога можете да намерите това, от което се нуждаете, като добавите допълнителен път към пътя за търсене. В този случай просто редактирайте /etc/man.conf в текстов редактор и добавете ред като следния:

MANPATH / opt / man

Оттук нататък всяка страница на човека в директорията / opt / man ще бъде намерен. Не забравяйте, че трябва да бягате отново направи каквото е за да добавите тези нови страници в базата данни какво е.

---

Информация за GNU

Един от недостатъците на ръчните страници е, че те не поддържат хипертекст, така че не можете лесно да прескачате от една страница на друга. Приятели на GNU разпознават този недостатък, така че те изобретиха друг формат на документацията: страниците „информация“.

Много от програмите на GNU идват с обширна документация във формата на информационната страница. Можете да започнете да четете информационни страници с командата инфо:

По този начин ще изведем индекс на всички информационни страници, налични в системата. Можете да се придвижвате в тях с клавишите със стрелки, да следвате "връзки" (обозначени със звезда) с помощта на клавиша Enter и да излезете с натискане q. Клавишите са базирани на Emacs, така че трябва да е лесно да се движите, ако сте запознати с този редактор.

За повече информация с използването на инфо, прочетете тяхната информационна страница. Трябва да можете да навигирате в тях, като използвате гореспоменатите клавиши:

$ инфо информация

---

/ usr / share / doc

Има един последен източник, който може да ви помогне в системата Linux. Много програми са оборудвани с допълнителна документация в други формати: текст, PDF, PostScript, HTML, за да назовем само няколко.

Погледни / usr / share / doc (/ usr / doc за стари системи). Ще намерите дълъг списък с директории, всеки от които се доставя с приложенията във вашата система. Търсенето в тази документация често може да разкрие нещо интересно, като уроци или допълнителна техническа документация. Бърза проверка разкрива много материали, налични за четене:

$ cd / usr / share / doc

$ намери. -тип f | wc -l

---

В други статии ще се позоваваме на външни източници на документация като Linux Documentation Project (LDP), пощенски списъци и новинарски групи.

Източник: Статия, взета от ГУТЛ и написана от Maikel Llamaret Heredia. Връзки: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org