.\" -*- coding: UTF-8 -*- '\" t .\" Man page for man2html .\" aeb, 980101 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH man2html 1 "1 gennaio 1998" .SH NOME man2html \- formatta una pagina di manuale in html .SH SINTASSI man2html [opzioni] [file] .SH DESCRIZIONE \fBman2html\fP converte una pagina di manuale che si trova in \fIfile\fP (o stdin, nel caso non ci sia alcun file come argomento, o sia dato "\-", come argomento) dallo stile man nroff in html, e stampa il risultato in stdout. Supporta tbl, ma non conosce eqn. Lo stato di uscita è 0. Se qualcosa va male su stdout viene stampata una pagina di errore. .\" (See .\" .BR man (1) .\" for info on how to browse man pages via .\" .BR man2html . .\" Usually it would suffice to put "MANHTMLPAGER=/usr/bin/lynx" .\" in the environment.) Può essere usato come un'utilità stand\-alone, ma è pensato principalmente come ausilio per permettere agli utenti di navigare le proprio man page usando un browser html come \fBlynx\fP(1), \fBxmosaic\fP(1) o \fBnetscape\fP(1). La parte principale di \fBman2html\fP è il motore da troff a html scritto da Richard Verhoeven (rcb5@win.tue.nl). Esso aggiunge collegamenti ipertestuali per i seguenti costrutti: .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" "file:/usr/include/string.h" .TE .LP (Il primo di questi può essere regolato dalle opzioni \- vedere sotto). Non viene fatto nessun controllo \- i collegamenti generati non hanno bisogno di esistere. Inoltre è generato un indice con collegamenti interni alle varie sezioni, in modo che sia più facile trovare la propria strada in pagine di manuale grandi come \fBbash\fP(1). .SH OPZIONI Quando si legge da stdin non è sempre chiaro come effettuare l'espansione \&.so. L'opzione \-D permette a uno script di definire la directory di lavoro. .LP .TP \fB\-\^D pathname\fP Estrae le ultime due parti dal percorso, ed esegue \fIchdir\fP(\fIdir\fP) prima di iniziare la conversione. .LP L'opzione \-E permette una facile generazione di messaggi di errore da uno script cgi. .LP .TP \fB\-\^E string\fP Emette una pagina di errore contenente il messaggio di errore dato. .LP La forma generale di un collegamento ipertestuale generato per un riferimenti a una man page è .IP .LP con un predefinito come mostrato sopra. Le parti di questo collegamento ipertestuale sono impostate usando le varie opzioni. .TP \fB\-\^h\fP .\" This is the default. Set method:cgipath to http://localhost. .TP \fB\-\^H\fP\fI host[.domain][:port]\fP Set method:cgipath to http://\fIhost.domain:port\fP. .TP \fB\-\^l\fP Set method:cgipath to lynxcgi:\fI/usr/lib\fP. .TP \fB\-\^L\fP\fI dir\fP Set method:cgipath to lynxcgi:\fIdir\fP. .TP \fB\-\^M\fP\fI man2htmlpath\fP Imposta il man2htmlpath da usare. Il valore predefinito è \fI/cgi\-bin/man/man2html\fP. .TP \fB\-\^p\fP Imposta '/' come separatore. .TP \fB\-\^q\fP Imposta '?' come separatore. Questo è il valore predefinito. .TP \fB\-\^r\fP Usa percorsi html relativi, invece dei percorsi cgi\-bin. .LP In una macchina senza eseguire \fBhttpd\fP, si può usare \fBlynx\fP per navigare le man page, usando il metodo lynxcgi. Quando è in funzione qualche demone http, lynx, o qualunque altro browser, può essere usato per navigare le man page, usando il metodo http. L'opzione \-l (per `lynxcgi') seleziona il vecchio comportamento. Con esso, il valore predefinito di cgipath è \fI/usr/lib\fP. In generale, uno script cgi può essere chiamato da .IP /? .LP e le variabili d'ambiente PATH_INFO e QUERY_STRING verranno impostate in e , rispettivamente. Poiché lynxcgi non gestisce la parte PATH_INFO, generiamo collegamenti ipertestualil con `?' come separatore predefinito. L'opzione \-p (per `path') seleziona '/' come separatore, mentre l'opzione \-q (per `query') seleziona '?' come separatore. L'opzione \-H \fIhost\fP specificherà l'host da usare (invece di \fIlocalhost\fP). Uno script cgi può usare .IP man2html \-H $SERVER_NAME .LP se la variabile SERVER_NAME è impostata. Questo permetterò alla propria macchina di agire come server ed esportare man page. .SH BUG Ci sono molti euristici. L'output non sarà sempre perfetto. Il metodo lynxcgi non funzionerà se lynx è stato compilato senza selezionare il supporto per esso. Ci potrebbero essere problemi di sicurezza. .SH AUTORE Richard Verhoeven was the original author of \fBman2html\fP. Michael Hamilton and Andries Brouwer subsequently improved on it. Federico Lucifredi is the current maintainer. .SH "VEDERE ANCHE" \fBlynx\fP(1), \fBman\fP(1), \fBhman\fP(1) .SH TRADUZIONE La traduzione italiana di questa pagina di manuale è stata creata da Giulio Daprelà . Questa traduzione è documentazione libera; leggere la GNU General Public License Versione 3 o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilità. Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a .