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

Mnogi od novih u svijetu GNU / Linux puni su sumnji i ne mogu pronaći brzi odgovor na svoje probleme, ponekad čak nemaju ni vezu preko 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 u sistemu GNU / Linux: stranice priručnika (stranice s uputama), stranice s informacijama (stranice s informacijama) i priručnici za aplikacije upakovane u / usr / share / doc.

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

---

Man stranice

Stranice priručnika ili "stranice s uputama" su klasični 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 starost. Međutim, man stranice su prvo mjesto koje trebate potražiti kada vam treba pomoć. Da biste pristupili man stranicama, samo unesite čovjek nakon čega slijedi tema koju treba istražiti.

Paging će se pokrenuti, pa ćete pritisnuti q kad završim s čitanjem. Na primjer, da biste pronašli informacije o naredbi ls, Napisao bih:

$ man ls

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

Tabela 1: Ručne stranice

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

Odjeljci man stranica

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

Tabela 2: Odjeljci stranica priručnika

man1	Korisnički programi
man2	Sistemski pozivi
man3	Funkcije biblioteke
man4	Posebne datoteke
man5	Format datoteke
man6	Igre
man7	Razno

Višestruke man stranice

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

$ šta je printf

printf (1) - format i podaci za ispis

printf (3) - formatirana pretvorba izlaza

U ovom slučaju, man 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 pozvati određeni odjeljak man stranica tako što ćete ga navesti u naredbenom retku, pa da zatražite printf, možemo napisati:

$man 3 printf

Pronalaženje ispravne stranice s uputama

Ponekad je teško pronaći nekoliko stranica sa rukom na zadanu temu. U tom slučaju možete koristiti čovjek -k kako biste pronašli odjeljak NAME 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 prikladno je potpuno ekvivalentan čovjek -k, (Zapravo ću vam otkriti tajnu. Kad pobjegnete čovjek -k zapravo trčanje prikladno iza scene).

---

MANPATH linija koda

Sada ćemo se okrenuti drugoj vrsti dokumentacije koju ćemo naći u našem GNU / Linux sistemu. Prema zadanim postavkama, man program traži upute u / usr / share / man, / usr / local / man, / usr / X11R6 / man i moguće / opt / man. ponekad možete pronaći ono što vam je potrebno dodavanjem dodatne putanje na putanju 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

Od ovog trenutka, bilo koja man stranica u direktoriju / opt / man će se naći. Zapamtite da trebate trčati ponovo makewhatis za dodavanje ovih novih man stranica u bazu podataka šta je.

---

GNU info

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 od GNU programa dolaze s opsežnom dokumentacijom u formatu info stranice. Pomoću naredbe možete početi čitati stranice s informacijama info:

Na ovaj način donijet ćemo indeks svih info stranica dostupnih u sistemu. 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 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. Mogli biste se kretati njima pomoću gore spomenutih tastera:

$ info info

---

/ usr / share / doc

Postoji jedan posljednji izvor koji vam može pomoći u Linux sistemu. Mnogi programi imaju dodatnu dokumentaciju u drugim formatima: tekst, PDF, PostScript, HTML, da nabrojimo samo neke.

Pogledaj / usr / share / doc (/ usr / doc na starim sistemima). Pronaći ćete dugačku listu direktorija, od kojih svaki dolazi s aplikacijama na vašem sistemu. Pretragom ove dokumentacije često se može otkriti nešto zanimljivo, poput vodiča ili dodatne tehničke dokumentacije. Brza provjera otkriva gomilu materijala koji je dostupan 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 diskusione grupe.

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