summaryrefslogtreecommitdiffstats
path: root/man/ro/man2html.man
blob: ebe05d04c304cac816d73db66db082b51a719c20 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
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)