Ako nájsť dokumentáciu v mojom vlastnom systéme GNU / Linux

Mnoho z tých nových pre svet GNU / Linux sú plní pochybností a nedokážu nájsť rýchlu odpoveď na svoje obavy, niekedy ani nemajú spojenie, pomocou ktorého by sa dostali na fórum podpory a nakoniec skončili s myšlienkou, že pre nich je Linux veľmi ťažký.

Väčšina z tých, ktorí sa ocitnú v tejto situácii, si neuvedomuje, že náš vlastný systém obsahuje veľkú časť odpovedí na naše počiatočné obavy. V systéme existujú v zásade tri zdroje dokumentácie GNU / Linux: manuálové stránky (man stránky), informačné stránky (informačné stránky) a príručky aplikácií zabalených v / usr / share / doc.

V tomto článku podrobne rozoberieme každý z týchto zdrojov.

---

Mužské stránky

Manuálne stránky alebo „manuálové stránky“ sú klasickými formami referenčnej dokumentácie v systémoch Linux a Unix. V ideálnom prípade môžete na manuálnych stránkach vyhľadať pomoc s akýmkoľvek príkazom, konfiguračným súborom alebo rutinou knižnice.

V praxi je Linux slobodný softvér a niektoré stránky neboli napísané alebo ukazujú svoj vek. Manuálne stránky sú však prvým miestom, kde sa môžete pozrieť, keď potrebujete pomoc. Na prístup k manuálovým stránkam stačí napísať muž po ktorej nasleduje téma, ktorá sa má skúmať.

Spustí sa stránkovanie, takže stlačte q keď dočítam. Napríklad na vyhľadanie informácií o príkaze ls, Napísal by som:

$ muž ls

Ak poznáte časti manuálových stránok, môže byť užitočné rýchlo prejsť na informácie, ktoré potrebujete. Na manuálovej stránke nájdete nasledujúce sekcie (Rámček 1):

Tabuľka 1: Ručné stránky

NÁZOV	Názov a popis príkazu
SYNOPSA	Ako používať príkaz
POPIS	Hĺbkové vysvetlenie fungovania príkazu
PRÍKLADY	Návrhy na použitie príkazu
POZRI TIEŽ	Súvisiace témy (zvyčajne na manuálnych stránkach)

Sekcie manuálových stránok

Súbory, ktoré tvoria manuálové stránky, sú uložené v / usr / share / man (alebo v / usr / man na niektorých starých systémoch). V tomto adresári nájdete, že manuálne stránky sú usporiadané do nasledujúcich sekcií (rámček 2).

Tabuľka 2: Časti manuálových stránok

man1	Používateľské programy
man2	Systémové volania
man3	Knižničné funkcie
man4	Špeciálne súbory
man5	Formát súboru
man6	Juegos
man7	rozmanitosť

Viacero manuálových stránok

Niektoré témy existujú vo viacerých sekciách. Aby sme to demonštrovali, použijeme príkaz čo je, ktorá zobrazuje všetky manuálové stránky dostupné pre túto tému:

$ čo je printf

printf (1) - formát a tlačové dáta

printf (3) - formátovaná výstupná konverzia

V tomto prípade, muž printf bolo by to na stránke v sekcii 1 (Používateľské programy). Ak by sme mali napísať program C, viac by nás zaujímala stránka v časti 3 (Funkcie knižnice). Môžete zavolať určitú časť manuálových stránok zadaním na príkazovom riadku, aby ste o ne požiadali printf, môžeme napísať:

$man 3 printf

Nájdenie správnej manuálovej stránky

Niekedy je ťažké nájsť niekoľko manuálových stránok na danú tému. V takom prípade môžete použiť človek -k nájdete sekciu MENO na manuálových stránkach. Vedzte, že toto je podreťazcové vyhľadávanie, takže niečo ako človek -k ls vám poskytne veľa výstupov, tu je príklad s konkrétnejším slovom:

$ man -k whatis whatis (1) - vypíše manuálne popisy stránok

Všetko o apropos

Predchádzajúci príklad nám priniesol ešte niekoľko bodov. Najprv príkaz apropos je presne ekvivalent k človek -k, (Vlastne ti dám tajomstvo. Keď utečieš človek -k skutočne bežať apropos v zákulisí).

---

Riadok kódu MANPATH

Teraz sa obrátime na druhý typ dokumentácie, ktorý nájdeme v našom systéme GNU / Linux. V predvolenom nastavení vyhľadáva program man stránky man v / usr / share / man, / usr / local / man, / usr / X11R6 / muž a možno / opt / man. niekedy nájdete to, čo hľadáte, ak do vyhľadávacej cesty pridáte ďalšiu cestu. V takom prípade stačí upraviť /etc/man.conf v textovom editore a pridajte nasledujúci riadok:

MANPATH / opt / man

Od tejto chvíle ľubovoľná manuálna stránka v adresári / opt / man nájdu sa. Pamätajte, že musíte bežať znova urobiť čo je pridať tieto nové man stránky do databázy čo je.

---

Informácie o GNU

Jedným z nedostatkov manuálnych stránok je, že nepodporujú hypertext, takže nemôžete jednoducho preskakovať z jednej stránky na druhú. Priatelia GNU túto chybu uznávajú, a preto vymysleli iný formát dokumentácie: stránky „info“.

Mnoho programov GNU je dodávaných s rozsiahlou dokumentáciou vo formáte informačnej stránky. Príkazom môžete začať čítať informačné stránky Info:

Týmto spôsobom prinesieme index všetkých informačných stránok dostupných v systéme. Môžete sa v nich pohybovať pomocou klávesov so šípkami, nasledovať „odkazy“ (označené hviezdičkou) pomocou klávesu Enter a ukončiť stlačením q. Kľúče sú založené na Emacse, takže by ste mali mať ľahkú navigáciu, ak tento editor poznáte.

Pre viac informácií s použitím Info, prečítajte si ich informačnú stránku. Mali by ste byť schopní sa v nich pohybovať pomocou klávesov uvedených vyššie:

$ info info

---

/ usr / share / doc

V systéme Linux vám môže pomôcť posledný zdroj. Mnoho programov je vybavených dodatočnou dokumentáciou v iných formátoch: text, PDF, PostScript, HTML.

Pozri sa na / usr / share / doc (/ usr / doc v starých systémoch). Nájdete dlhý zoznam adresárov, z ktorých každý je dodávaný s aplikáciami vo vašom systéme. Vyhľadávanie v tejto dokumentácii môže často odhaliť niečo zaujímavé, napríklad výukové programy alebo ďalšiu technickú dokumentáciu. Rýchla kontrola odhalí tonu materiálu dostupného na čítanie:

$ cd / usr / share / doc

$ nájsť. -typ f | wc -l

---

V ďalších článkoch budeme odkazovať na externé zdroje dokumentácie, ako sú The Linux Documentation Project (LDP), e-mailové zoznamy a diskusné skupiny.

Zdroj: Článok prevzatý z GUTL a autor: Maikel Llamaret Heredia. Odkazy: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org