Kako najti dokumentacijo v lastnem sistemu GNU / Linux

Številni novi na svetu GNU / Linux polni so dvomov in ne morejo najti hitrega odgovora na svoje pomisleke, včasih nimajo niti povezave, prek katere bi lahko dostopali do foruma za podporo in na koncu končali z mislijo, da je Linux zanje zelo težaven.

Večina tistih, ki se znajdejo v tej situaciji, se ne zaveda, da naš sistem vsebuje dobršen del odgovorov na naše začetne pomisleke. V sistemu so v bistvu trije viri dokumentacije GNU / Linux: strani z navodili (strani z informacijami), strani z informacijami (strani z informacijami) in priročniki za aplikacije, pakirane v / usr / share / doc.

V tem članku bomo podrobno opisali vsakega od teh virov.

---

Man strani

Strani z navodili ali "priročne strani" so klasična oblika referenčne dokumentacije v Linuxu in Unixu. V idealnem primeru lahko na straneh z navodili poiščete pomoč za kateri koli ukaz, konfiguracijsko datoteko ali rutino knjižnice.

V praksi je Linux brezplačna programska oprema in nekatere strani niso napisane ali kažejo njihove starosti. Kadar pa potrebujete pomoč, je prvo mesto iskati strani z informacijami. Če želite dostopati do strani z man, preprosto vnesite moški čemur sledi tema, ki jo je treba raziskati.

Paging se bo začel, zato boste pritisnili q ko končam z branjem. Na primer, da poiščete informacije o ukazu ls, Bi napisal:

$ človek ls

Če poznate dele strani z informacijami, je koristno, da hitro pridete do potrebnih informacij, na strani z navodili boste našli naslednje razdelke (polje 1):

Tabela 1: Ročne strani

NAME	Ime in opis ukaza
POVZETEK	Kako uporabiti ukaz
OPIS	Poglobljena razlaga delovanja ukaza
PRIMERI	Predlogi za uporabo ukaza
POGLEJ TUDI	Sorodne teme (ponavadi na straneh z man)

Odseki strani z navodili

Datoteke, ki vsebujejo priročne strani, so shranjene v / usr / share / man (ali v / usr / man na nekaterih starih sistemih). V tem imeniku boste ugotovili, da so strani z navodili razporejene v naslednje oddelke (Okvir 2).

Tabela 2: Odseki strani z navodili

man1	Uporabniški programi
man2	Sistemski klici
man3	Knjižnične funkcije
man4	Posebne datoteke
man5	Oblika datoteke
man6	Igre
man7	Razno

Več strani z man

Nekatere teme obstajajo v več oddelkih. Da bi to dokazali, bomo uporabili ukaz kaj je, ki prikazuje vse priročnike, ki so na voljo za to temo:

$ kaj je printf

printf (1) - format in podatki za tiskanje

printf (3) - oblikovana pretvorba izhodov

V tem primeru oz. moški printf bilo bi na strani v razdelku 1 (Uporabniški programi). Če bi pisali program C, bi nas bolj zanimala stran v oddelku 3 (Knjižnične funkcije). Določen odsek strani z informacijami lahko pokličete tako, da ga določite v ukazni vrstici, tako da zahtevate printf, lahko zapišemo:

$man 3 printf

Iskanje pravilne strani z navodili

Včasih je težko najti nekaj strani z informacijami o določeni temi. V tem primeru lahko uporabite človek -k da poiščete razdelek NAME na straneh z navodili. Vedite, da gre za iskanje podnizov, torej nekaj podobnega človek -k ls bi vam dal veliko rezultatov, tukaj je primer, ki uporablja natančnejšo besedo:

$ man -k whatis whatis (1) - natisnite opise strani v priročniku

Vse o tem

Prejšnji primer nam je prinesel še nekaj točk. Najprej ukaz apropos je popolnoma enakovredno človek -k, (Pravzaprav vam bom dal skrivnost. Ko boste tekli človek -k dejansko teči apropos v zakulisju).

---

Vrstica kode MANPATH

Zdaj se obrnemo na drugo vrsto dokumentacije, ki jo bomo našli v našem sistemu GNU / Linux. Privzeto program man išče strani z navodili v / usr / share / man, / usr / local / man, / usr / X11R6 / man in po možnosti / opt / man. včasih lahko najdete tisto, kar potrebujete, tako da na iskalno pot dodate dodatno pot. V tem primeru samo uredite /etc/man.conf v urejevalnik besedil in dodajte vrstico, kot je naslednja:

MANPATH / opt / man

Od tu naprej katera koli stran z informacijami v imeniku / opt / man bodo našli. Ne pozabite, da morate znova teči naredi kar je za dodajanje teh novih priročnikov v bazo podatkov kaj je.

---

Informacije o GNU

Ena od pomanjkljivosti strani z navodili je, da ne podpirajo hiperteksta, zato ne morete zlahka preskakovati z ene strani na drugo. Prijatelji GNU prepoznajo to napako, zato so izumili drugo obliko dokumentacije: strani z informacijami.

Številni programi GNU imajo obsežno dokumentacijo v obliki strani z informacijami. Z ukazom lahko začnete brati informativne strani info:

Na ta način bomo prinesli kazalo vseh informacijskih strani, ki so na voljo v sistemu. V njih se lahko premikate s puščičnimi tipkami, sledite "povezavam" (označeno z zvezdico) s tipko Enter in za izhod pritisnete q. Tipke temeljijo na Emacsu, zato bi vam bilo enostavno krmariti, če poznate ta urejevalnik.

Za več informacij z uporabo info, preberite njihovo informacijsko stran. Po njih bi se lahko premikali s pomočjo zgoraj omenjenih tipk:

$ info info

---

/ usr / share / doc

Obstaja še zadnji vir, ki vam lahko pomaga v sistemu Linux. Številni programi so opremljeni z dodatno dokumentacijo v drugih oblikah: besedilo, PDF, PostScript, HTML.

Poglej / usr / share / doc (/ usr / doc o starih sistemih). Našli boste dolg seznam imenikov, od katerih je vsak priložen aplikacijam v vašem sistemu. Iskanje po tej dokumentaciji lahko pogosto razkrije kaj zanimivega, kot so vaje ali dodatna tehnična dokumentacija. Hiter pregled razkrije tono gradiva, ki je na voljo za branje:

$ cd / usr / share / doc

$ najdi. -tip f | wc -l

---

V drugih člankih se bomo sklicevali na zunanje vire dokumentacije, kot so Linux Documentation Project (LDP), poštni seznami in novice.

Vir: Članek vzet iz GUTL in napisal Maikel Llamaret Heredia. Povezave: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org