man2html(1) General Commands Manual man2html(1)
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:
foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
method://şir "method://şir"
www.nume.gazdă "http://www.nume.gazdă"
ftp.nume.gazdă "ftp://ftp.nume.gazdă"
nume@gazdă "mailto:nume@gazdă"
<string.h> "file:/usr/include/string.h"
(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)
1 Ianuarie 1998 man2html(1)
Generated by dwww version 1.15 on Mon Jul 1 05:39:07 CEST 2024.