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
145
146
147
148
149
150
151
152
153
154
155
156
157
|
'\" t
.\" Man page for man2html
.\" aeb, 980101
.\"
.\" Ελληνική μετάφραση από Λ. Δημητρουλάκη edimitro@tee.gr, Ιούλιος 2003
.\"
.TH man2html 1 "1 Ιανουαρίου 1998"
.LO 1
.SH ΟΝΟΜΑ
man2html \- μορφοποιεί μιά σελίδα εγχειριδίου σε html
.SH ΣΥΝΟΨΗ
man2html [επιλογή] [αρχείο]
.SH ΠΕΡΙΓΡΑΦΗ
.B man2html
μετατρέπει μιά σελίδα εγχειριδίου όπως βρέθηκε στο
.I αρχείο
(ή στην τυπική είσοδο,
αν δώθηκε το όρισμα «-» ή κανένα όρισμα)
από το συνηθισμένη μορφή nroff σε html,
κι εμφανίζει το αποτέλεσμα στην τυπική έξοδο.
Διαθέτει υποστήριξη του προεπεξεργαστή tbl αλλά όχι και του eqn.
Η κανονική τιμή επιστροφής εξόδου είναι 0. Αν όμως κάτι πάει στραβά,
εμφανίζεται στη τυπική έξοδο μιά σελίδα σφάλματος.
Μπορεί να χρησιμοποιηθεί ως αυτοτελής υπηρεσία,
αλλά προορίζεται κυρίως ως επιβοηθητική,
που επιτρέπει στους χρήστες την πλοήγηση στις σελίδες
εγχειριδίου με ένα φυλλομετρητή html όπως οι
.BR lynx (1),
.BR xmosaic (1)
ή
.BR netscape (1).
./" (Βλέπε
./" .BR man (1)
./" για πληροφορίες πλοήγησης στις σελίδες εγχειριδίου μέσω της
./" .BR man2html .
./" Συνήθως αρκεί να βάλλεις "MANHTMLPAGER=/usr/bin/lynx"
./" στο περιβάλλον σου.)
Το βασικό κομμάτι της
.B man2html
είναι η μηχανή troff-to-html του Richard Verhoeven (rcb5@win.tue.nl) που
προσθέτει υπερσυνδέσμους για τις παρακάτω δομές:
.LP
.TS
l l.
foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
method://string "method://string"
www.host.name "http://www.host.name"
ftp.host.name "ftp://ftp.host.name"
name@host "mailto:name@host"
<string.h> "file:/usr/include/string.h"
.TE
.LP
(Η πρώτη μπορεί να ρυθμιστεί λεπτομερώς με επιλογές - βλέπε παρακάτω.)
Δε γίνεται έλεγχος - οι δημιουργούμενοι σύνδεσμοι δεν είναι κατ' ανάγκη υπαρκτοί.
Επίσης δημιουργείται ένα ευρετήριο με εσωτερικούς υπερσυνδέσμους προς τις διάφορες παραγράφους,
ώστε να είναι ευκολότερο να βρει κανείς το δρόμο του
μέσα σε εκτεταμένες σελίδες εγχειριδίου όπως η
.BR bash (1).
.SH ΕΠΙΛΟΓΕΣ
Κατά την ανάγνωση από την τυπική είσοδο,
δεν είναι πάντοτε ξεκάθαρο πώς να γίνει το ταίριασμα ονόματος αρχείου.
Η επιλογή \-D επιτρέπει σ' ένα σενάριο να ορίσει τον τρέχοντα κατάλογο.
.LP
.TP
.B \-\^D όνομα_διαδρομής
Απαλείφει τα δύο τελευταία τμήματα από το όνομα διαδρομής, και κάνει ένα
\fIchdir\fP(\fIdir\fP) πριν αρχίσει τη μετατροπή.
.LP
Η επιλογή \-E επιτρέπει την εύκολη δημιουργία μηνυμάτων λάθους
από ένα σενάριο cgi.
.LP
.TP
.B \-\^E συμβολοσειρά
Βγάζει μιά σελίδα σφάλματος που περιέχει το δεδομένο μήνυμα σφάλματος.
.LP
Η γενική μορφή ενός υπερσυνδέσμου δημιουργημένου για μιά σελίδα εγχειριδίου είναι
.LP
<μέθοδος:διαδ/μή_cgi><διαδ/μή_man2html><διαχ/στής><σελίδα_man>
.LP
με προεπιλογή ως ανωτέρω. Τα τμήματα αυτού του υπερσυνδέσμου
ρυθμίζονται με τις διάφορες επιλογές.
.TP
.B \-\^h
Ορίζει τη μέθοδο:διαδρομή_cgi σε http://localhost που είναι η προεπιλογή.
.TP
.BI \-\^H " υπολογιστής_υπηρεσίας[.δικτυακός_τόπος][:θύρα]"
Ορίζει τη μέθοδο:διαδρομή_cgi σε
.RI http:// υπολογιστής_υπηρεσίας.δικτυακός_τόπος:θύρα .
.TP
.B \-\^l
Ορίζει τη μέθοδο:διαδρομή_cgi σε
.RI lynxcgi: /home/httpd .
.TP
.BI \-\^L " dir"
Ορίζει τη μέθοδο:διαδρομή_cgi σε
.RI lynxcgi: dir .
.TP
.BI \-\^M " διαδρομή_man2html"
Ορίζει ποιά διαδρομή_man2html θα χρησιμοποιηθεί. Η προεπιλογή είναι
.IR /cgi-bin/man/man2html .
.TP
.B \-\^p
Ορισμός διαχωριστή σε «/».
.TP
.B \-\^q
Ορισμός διαχωριστή σε «?». Αυτό είναι η προεπιλογή.
.TP
.B \-\^r
Χρήση σχετικών διαδρομών html,
αντί των διαδρομών cgi-bin.
.LP
Σ' ένα μηχάνημα που δεν τρέχει ένας
.BR httpd ,
μπορεί να χρησιμοποιήσει κανείς το
.B lynx
για πλοήγηση στις σελίδες εγχειριδίου,
χρησιμοποιώντας τη μέθοδο lynxcgi.
Αν τρέχει κάποιος δαίμονας http, τότε ο lynx,
ή όποιος άλλος φυλλομετρητής,
μπορεί να χρησιμοποιηθεί για πλοήγηση στις σελίδες εγχειριδίου,
χρησιμοποιώντας τη μέθοδο http.
Η επιλογή \-l (από το « lynxcgi ») διαλέγει τον πρώτο τρόπο.
Με αυτό τον τρόπο,
η προεπιλεγμένη διαδρομή_cgip είναι \fI/home/httpd\fP.
Γενικώς, ένα σενάριο cgi μπορεί να κληθεί από τη
.LP
<διαδρομή_προς_το_σενάριο>/<επί_πλέον_διαδρομή>?<ερώτηση>
.LP
και οι μεταβλητές περιβάλλοντος PATH_INFO και QUERY_STRING
θα οριστούν σε <επί_πλέον_διαδρομή> και <ερώτηση>, αντιστοίχως.
Αφού η lynxcgi δεν ανακατεύεται με το τμήμα PATH_INFO,
δημιουργούμε υπερσυνδέσμους με το «?» ως προεπιλεγμένο διαχωριστή.
Η επιλογή \-p (από το « path ») διαλέγει τη «/» ως διαχωριστή,
ενώ η επιλογή \-q (από το « query ») διαλέγει το «?».
Η επιλογή \-H \fIυπολογιστής_υπηρεσίας\fP,
θα ορίσει το χρησιμοποιούμενο υπολογιστή υπηρεσίας
(αντί του \fIlocalhost\fP).
Ένα σενάριο cgi θα μπορούσε να χρησιμοποιήσει τη
.IP
man2html -H $SERVER_NAME
.LP
αν είχε οριστεί η μεταβλητή SERVER_NAME.
Αυτό θα επέτρεπε στο μηχάνημά σου να λειτουργεί ως εξυπηρετητής,
και να εξάγει σελίδες εγχειριδίου.
.SH ΣΦΑΛΜΑΤΑ
Υπάρχουν πολλές ιδιοκατασκευές. Η έξοδος δεν θα είναι πάντοτε τέλεια.
Η μέθοδος lynxcgi δε θα δουλέψει αν το lynx είχε μεταγλωττιστεί χωρίς
υποστήριξη γιαυτήν. Μπορεί να υπάρξουν προβλήματα ασφαλείας.
.SH "ΒΛΕΠΕ ΕΠΙΣΗΣ"
.BR lynx (1),
.BR man (1)
|
