NUME¶
man2html - formatează o pagină de manual în html
SUMAR¶
man2html [opţuni] [fişier]
DESCRIERE¶
man2html converteşte o pagină de manual aşa cum se
găseşte în
fişier (sau intrarea standard (stdin),
în caz că argumentul fişier lipseşte, sau argumentul
"-" este folosit) din stilul man nroff în html, şi
tipăreşte rezultatul la ieşirea standard (stdout). Suportă
tbl dar nu ştie de eqn. Starea de ieşire este 0. Dacă ceva
merge eronat, o pagină de eroare este tipărită la ieşirea
standard (stdout).
Poate fi folosit ca un utilitar de sine stătător, dar este în
principal conceput ca un auxiliar, pentru a permite utilizatorilor să
navigheze prin paginile de manual folosind un navigator html ca
lynx(1),
xmosaic(1) sau
netscape(1).
Partea principală a
man2html este motorul troff-to-html scris de
Richard Verhoeven (rcb5@win.tue.nl). Adaugă legături pentru
următoarele construcţii:
(Primele din acestea pot fi modificate cu opţiuni - vezi mai jos.) Nici o
verificare nu este făcută - legăturile generate nu trebuie
să existe. De asemenea, este generat un cuprins cu legături interne
spre diverse secţiuni, astfel încât este mai uşor pentru
cineva să se descurce în paginile mari de manual ca
bash(1).
OPŢIUNI¶
Când se citeşte de la intrarea standard, nu este întotdeauna clar
cum să se facă expansiunea .so. Opţiunea -D permite unui script
să definească directorul de lucru.
- -D cale
- Elimină ultimele două părţi din cale,
şi face un chdir(dir) înainte de a începe
conversia.
Opţiunea -E permite generarea uşoară a mesajelor de eroare
dintr-un script cgi.
- -E şir
- Produce o pagină de eroare conţinând mesajul
de eroare dat.
Forma generală a unei legături generate pentru o referinţă
la o pagină de manual este
- <metodă:cale_cgi><cale_man2html><separator><pagină_man>
cu o formă implicită ca mai sus. Părţile acestei
legături sunt configurate folosind diverse opţiuni.
- -h
- Configurează metodă:cele_cgi ca http://localhost.
Această opţiune este implicită.
- -H gazdă[.domeniu][:port]
- Configurează metodă:cale_cgi ca
http://gazdă.domeniu:port.
- -l
- Configurează metodă:cale_cgi ca
lynxcgi:/home/httpd.
- -L dir
- Configurează metodă:cale_cgi ca
lynxcgi:dir.
- -M cale_man2html
- Configurează cale_man2html care va fi folosită.
Implicit ea este /cgi-bin/man/man2html.
- -p
- Configurează separatorul ca '/'.
- -q
- Configurează separatorul ca '?'. Această
opţiune este implicită.
Pe o maşină care nu rulează
httpd, se poate folosi
lynx pentru a naviga prin paginile de manual, folosind metoda lynxcgi.
Când un demon http rulează, lynx, sau orice alt navigator, poate fi
folosit pentru a naviga prin paginile de manual, folosind metoda http.
Opţiunea -l (pentru `lynxcgi') selectează comportamentul precedent.
Cu ea, cale_cgi este
/home/httpd.
În general, un script cgi poate fi apelat prin
- <cale_la_script>/<mai_multă_cale>?<cerere>
şi variabilele de mediu PATH_INFO şi QUERY_STRING vor fi configurate
ca <mai_multă_cale> şi respectiv <cere>. Din moment ce
lynxcgi nu tratează partea PATH_INFO, generăm legături cu `?'
drept separator în mod implicit. Opţiunea -p (de la eng. `path'
(cale)) selectează '/' ca separator, în timp ce opţiunea -q (de
la eng. `query'(cerere)) selectează '?' ca separator.
Opţiunea -H
gazdă va specifica gazda care va fi folosită
(în loc de
localhost). Un script cgi ar putea folosi
- man2html -H $SERVER_NAME
dacă variabila SERVER_NAME este configurată. Aceasta ar permite
maşinii să se comporte ca un server şi să exporte pagini
de manual.
ERORI¶
Sunt multe euristici. Rezultatul nu va fi întotdeauna perfect. Metoda
lynxcgi nu va funcţiona dacă lynx a fost compilat fără a
selecta suport pentru ea. Ar putea fi probleme de securitate.
VEZI ŞI¶
lynx(1),
man(1)