summaryrefslogtreecommitdiffstats
path: root/man/el/man2html.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/el/man2html.man')
-rw-r--r--man/el/man2html.man157
1 files changed, 157 insertions, 0 deletions
diff --git a/man/el/man2html.man b/man/el/man2html.man
new file mode 100644
index 0000000..9aae819
--- /dev/null
+++ b/man/el/man2html.man
@@ -0,0 +1,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)