summaryrefslogtreecommitdiffstats
path: root/man/ro/man2html.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/ro/man2html.man')
-rw-r--r--man/ro/man2html.man144
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)