'\" t .\" Man page for man2html .\" aeb, 980101 .\" .\" Traducere de Ovidiu Constantin .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ă" "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 .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 /? .LP și variabilele de mediu PATH_INFO și QUERY_STRING vor fi configurate ca și respectiv . 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)