diff options
Diffstat (limited to 'man/ro/man2html.man')
-rw-r--r-- | man/ro/man2html.man | 144 |
1 files changed, 144 insertions, 0 deletions
diff --git a/man/ro/man2html.man b/man/ro/man2html.man new file mode 100644 index 0000000..ebe05d0 --- /dev/null +++ b/man/ro/man2html.man @@ -0,0 +1,144 @@ +'\" t +.\" Man page for man2html +.\" aeb, 980101 +.\" +.\" Traducere de Ovidiu Constantin <ovidiu.soft@xnet.ro> +.TH man2html 1 "1 Ianuarie 1998" +.LO 1 +.SH NUME +man2html \- formatează o pagină de manual în html +.SH SUMAR +man2html [opțuni] [fișier] +.SH DESCRIERE +.B man2html +convertește o pagină de manual așa cum se găsește în +.I 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 +.BR lynx (1), +.BR xmosaic (1) +sau +.BR netscape (1). +./" (Vezi +./" .BR man (1) +./" pentru informații despre cum să navighezi prin paginile de manual cu +./" .BR man2html . +./" De obicei este suficientă adăugarea "MANHTMLPAGER=/usr/bin/lynx" +./" la mediu.) + +Partea principală a +.B man2html +este motorul troff-to-html scris de Richard Verhoeven (rcb5@win.tue.nl). +Adaugă legături pentru următoarele construcții: +.LP +.TS +l l. +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" +.TE +.LP +(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 +.BR bash (1). + +.SH 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. +.LP +.TP +.B \-\^D cale +Elimină ultimele două părți din cale, și face un +\fIchdir\fP(\fIdir\fP) înainte de a începe conversia. +.LP +Opțiunea \-E permite generarea ușoară a mesajelor de eroare dintr-un +script cgi. +.LP +.TP +.B \-\^E șir +Produce o pagină de eroare conținând mesajul de eroare dat. +.LP +Forma generală a unei legături generate pentru o referință la o pagină +de manual este +.IP +<metodă:cale_cgi><cale_man2html><separator><pagină_man> +.LP +cu o formă implicită ca mai sus. Părțile acestei legături sunt +configurate folosind diverse opțiuni. +.TP +.B \-\^h +Configurează metodă:cele_cgi ca http://localhost. Această opțiune este implicită. +.TP +.BI \-\^H " gazdă[.domeniu][:port]" +Configurează metodă:cale_cgi ca +.RI http:// gazdă.domeniu:port . +.TP +.B \-\^l +Configurează metodă:cale_cgi ca +.RI lynxcgi: /home/httpd . +.TP +.BI \-\^L " dir" +Configurează metodă:cale_cgi ca +.RI lynxcgi: dir . +.TP +.BI \-\^M " cale_man2html" +Configurează cale_man2html care va fi folosită. Implicit ea este +.IR /cgi-bin/man/man2html . +.TP +.B \-\^p +Configurează separatorul ca '/'. +.TP +.B \-\^q +Configurează separatorul ca '?'. Această opțiune este implicită. +.LP +Pe o mașină care nu rulează +.BR httpd , +se poate folosi +.B 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 \fI/home/httpd\fP. + +În general, un script cgi poate fi apelat prin +.IP +<cale_la_script>/<mai_multă_cale>?<cerere> +.LP +ș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 \fIgazdă\fP va specifica gazda care va fi folosită (în loc +de \fIlocalhost\fP). Un script cgi ar putea folosi +.IP +man2html -H $SERVER_NAME +.LP +dacă variabila SERVER_NAME este configurată. Aceasta ar permite mașinii +să se comporte ca un server și să exporte pagini de manual. + +.SH 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. + +.SH "VEZI ȘI" +.BR lynx (1), +.BR man (1) |