diff options
Diffstat (limited to 'man/el/man2html.man')
-rw-r--r-- | man/el/man2html.man | 157 |
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) |