Kako pronaći dokumentaciju u mom vlastitom GNU / Linux sustavu

Mnogi od onih novih u svijetu GNU / Linux puni su sumnji i ne mogu brzo pronaći odgovor na svoju zabrinutost, ponekad čak nemaju ni vezu putem koje mogu pristupiti forumu za podršku i na kraju završe s idejom da im je Linux vrlo težak.

Većina onih koji se nađu u ovoj situaciji nisu svjesni da naš vlastiti sustav sadrži dobar dio odgovora na naše početne brige. U osnovi postoje tri izvora dokumentacije GNU / Linux: stranice priručnika (stranice s uputama), stranice s informacijama (stranice s informacijama) i priručnici za aplikacije pakirane u / usr / share / doc.

U ovom ćemo članku detaljno objasniti svaki od ovih izvora.

---

Man stranice

Stranice s priručnicima ili "stranice s uputama" klasični su oblici referentne dokumentacije u Linuxu i Unixu. U idealnom slučaju, možete potražiti pomoćne stranice za bilo koju naredbu, konfiguracijsku datoteku ili rutinu knjižnice.

U praksi je Linux besplatan softver, a neke stranice nisu napisane niti pokazuju njihovu dob. Međutim, stranice s muškarcima prvo su mjesto koje trebate potražiti kada vam treba pomoć. Da biste pristupili man stranicama, samo upišite čovjek nakon čega slijedi tema koju treba istražiti.

Paging će se pokrenuti, pa ćete pritisnuti q kad završim s čitanjem. Na primjer, za pronalaženje podataka o naredbi ls, Napisao bih:

$ čovjek ls

Poznavajući dijelove man stranica, moglo bi vam biti korisno da brzo prijeđete do potrebnih informacija, na man stranici ćete pronaći sljedeće odjeljke (okvir 1):

Tablica 1: Ručne stranice

IME	Naziv i opis naredbe
SINOPSIS	Kako se koristi naredba
OPIS	Dubinsko objašnjenje načina rada naredbe
PRIMJERI	Prijedlozi za upotrebu naredbe
VIDI TAKOĐER	Povezane teme (obično na man stranicama)

Dijelovi man stranica

Datoteke koje sadrže ručne stranice pohranjene su u / usr / share / man (ili u / usr / čovjek na nekim starim sustavima). Unutar tog direktorija naći ćete da su stranice priručnika organizirane u sljedeće odjeljke (okvir 2).

Tablica 2: Odjeljci stranica priručnika

man1	Korisnički programi
man2	Sistemski pozivi
man3	Funkcije knjižnice
man4	Posebne datoteke
man5	Format datoteke
man6	igre
man7	mješavina

Višestruke man stranice

Neke teme postoje u više odjeljaka. Da bismo to demonstrirali, upotrijebit ćemo naredbu što je, koji prikazuje sve stranice s uputama dostupne za ovu temu:

$ što je printf

printf (1) - format i ispis podataka

printf (3) - formatirana pretvorba izlaza

U ovom slučaju čovjek printf to bi bilo na stranici u odjeljku 1 (Korisnički programi). Da pišemo C program, više bi nas zanimala stranica u odjeljku 3 (Knjižnične funkcije). Možete nazvati određeni odjeljak man stranica tako što ćete ga odrediti u naredbenom retku, pa da zatražite printf, možemo napisati:

$ čovjek 3 printf

Pronalaženje ispravne stranice s uputama

Ponekad je teško pronaći nekoliko man stranica na zadanu temu. U tom biste slučaju mogli koristiti čovječe -k kako biste pronašli odjeljak IME na man stranicama. Znajte da je ovo pretraga podniza, pa nešto slično čovjek -k ls dalo bi vam puno rezultata, evo primjera koji koristi specifičniju riječ:

$ man -k whatis whatis (1) - ispisuje ručne opise stranica

Sve o tome

Prethodni primjer donio nam je još nekoliko bodova. Prvo, naredba odnosno je točno ekvivalentno čovječe -k, (Zapravo ću vam otkriti tajnu. Kad pobjegnete čovječe -k zapravo trčati odnosno iza scene).

---

Redak koda MANPATH

Sada se okrećemo drugoj vrsti dokumentacije koju ćemo pronaći u našem GNU / Linux sustavu. Prema zadanim postavkama program man traži stranice s uputama u / usr / share / man, / usr / local / man, / usr / X11R6 / man i eventualno / opt / čovjek. ponekad možete pronaći ono što vam treba dodavanjem dodatnog puta na put pretraživanja. U tom slučaju, samo uredite /etc/man.conf u uređivaču teksta i dodajte redak poput sljedećeg:

MANPATH / opt / man

Odsad, bilo koja stranica s uputama u direktoriju / opt / čovjek naći će se. Sjeti se da trebaš ponovno trčati napraviti što je za dodavanje ovih novih man stranica u bazu podataka što je.

---

GNU informacije

Jedan od nedostataka ručnih stranica je taj što ne podržavaju hipertekst pa ne možete lako prelaziti s jedne stranice na drugu. Prijatelji GNU-a prepoznaju ovu manu, pa su izmislili drugi format dokumentacije: stranice s informacijama.

Mnogi GNU programi dolaze s opsežnom dokumentacijom u formatu info stranice. Pomoću naredbe možete započeti čitanje stranica s informacijama info:

Na taj ćemo način donijeti indeks svih info stranica dostupnih u sustavu. U njima se možete kretati tipkama sa strelicama, slijediti "veze" (označene zvjezdicom) pomoću tipke Enter i za izlaz pritiskom na q. Tipke se temelje na Emacsu, pa bi vam trebalo biti lako kretati se ako ste upoznati s tim uređivačem.

Za više informacija o upotrebi info, pročitajte njihovu info stranicu. Morali biste se kretati njima pomoću gore spomenutih tipki:

$ info info

---

/ usr / share / doc

Postoji jedan posljednji izvor koji vam može pomoći u sustavu Linux. Mnogi su programi opremljeni dodatnom dokumentacijom u drugim formatima: tekst, PDF, PostScript, HTML, da nabrojimo samo neke.

Pogledaj / usr / share / doc (/ usr / doc na starim sustavima). Pronaći ćete dugački popis direktorija od kojih svaki dolazi s aplikacijama na vašem sustavu. Pretragom ove dokumentacije često se može otkriti nešto zanimljivo, poput vodiča ili dodatne tehničke dokumentacije. Brza provjera otkriva hrpu materijala dostupnog za čitanje:

$ cd / usr / share / doc

$ pronađi. -tip f | wc -l

---

U drugim ćemo se člancima pozvati na vanjske izvore dokumentacije kao što je Linux Documentation Project (LDP), mailing liste i news grupe.

Izvor: Članak preuzet sa GUTL a napisao Maikel Llamaret Heredia. Veze: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org