Provided by:
man2html-base_1.6g-6_i386 
NOM
man2html - formate une page de manuel en html
SYNOPSIS
man2html [options] [fichier]
DESCRIPTION
man2html convertit une page de manuel telle que trouvee dans fichier
(ou l'entree standard stdin si aucun argument fichier n'est donne ou si
l'argument << - >> est donne) a partir du format nroff (celui des pages
de manuels) vers un format html et affiche le resultat sur la sortie
standard (stdout). man2html supporte tbl(1) mais ne connait rien a
propos de eqn(1). Le code de sortie est 0. Si quelque chose va mal,
une page d'erreur est affichee sur la sortie standard stdout.
Cette commande peut etre utilisee seule mais a ete principalement
concue pour etre un auxiliaire afin que les utilisateurs puissent
naviguer dans les pages de manuel avec un navigateur html comme
lynx(1), xmosaic(1) ou netscape(1).
La plus grande partie de man2html est l'engin << troff-vers-html >>
ecrit par Richard Verhoeven (rcb5@win.tue.nl). Il ajoute des
hyperliens aux constructions suivantes :
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"
(La premiere de celles-ci peut etre ajustee par des options - voir plus
loin.) Aucune consultation n'est effectuee - les liens generes n'ont
pas besoin d'exister. Un index avec des hyperliens internes vers les
diverses sections est egalement cree rendant plus facile la navigation
dans les grandes pages comme bash(1).
OPTIONS
Lorsqu'on lit a partir de stdin, il n'est pas toujours evident de
savoir comment se fait l'expansion .so. L'option -D permet a un script
de definir le repertoire de travail.
-D chemin
Retire les deux derniers elements du chemin et effectue un
changement de repertoire courant chdir(dir) avant de debuter la
conversion.
L'option -E option facilite la production de messages d'erreurs a
partir de scripts cgi.
-E cha^ine
Produire en sortie une page d'erreur contenant le message
d'erreur donne.
La forme generale d'un hyperlien genere pour referencer une page de
manuel est
<method:cgipath><man2htmlpath><separator><manpage>
qui est d'ailleurs la forme par defaut. Les elements de cet hyperlien
sont positionnes en utilisant diverses options.
-h Positionner method:cgipath a http://localhost. C'est le
comportement par defaut.
-H h^ote[.domaine][:port]
Positionner method:cgipath a http://h^ote.domaine:port.
-l Positionner method:cgipath a lynxcgi:/home/httpd.
-L dir Positionner method:cgipath a lynxcgi:dir.
-M man2htmlpath
Positionner le chemin vers man2html a utiliser. La valeur par
defaut est /cgi-bin/man/man2html.
-p Positionner le separateur a << / >>.
-q Positionner le separateur a << ? >>. C'est la valeur par defaut.
-r Utiliser des chemins html relatifs plutot que les chemins cgi-
bin.
Sur une machine sur laquelle httpd ne tourne pas, vous pouvez utiliser
lynx pour naviguer dans les pages de manuel en utilisant la methode
lynxcgi. Lorsqu'un demon http est en service, vous pouvez utiliser
lynx ou n'importe quel autre navigateur pour parcourir les pages de
manuel en utilisant la methode http. L'option -l (pour << lynxcgi >>)
selectionne ce fonctionnement. Avec elle, le chemin cgi par defaut est
/home/httpd.
En general, un script cgi peut etre appele de la facon suivante
<path_to_script>/<more_path>?<query>
et les variables d'environnement PATH_INFO et QUERY_STRING seront
positionnees respectivement a <more_path> et <query>. Puisque lynxcgi
ne gere pas l'element PATH_INFO, nous allons generer des hyperliens
avec << ? >> comme separateur par defaut. L'option -p (pour
<< path >>) selectionne << / >> comme separateur, alors que l'option -q
(for << query >>) selectionne << ? >>.
L'option -H host specifiera l'hote a utiliser (a la place localhost).
Un script cgi pourra utiliser
man2html -H $SERVER_NAME
si la variable SERVER_NAME est positionnee. Cela permettra a votre
machine de fonctionner en tant que serveur et d'exporter les pages
manuel.
BOGUES
Il y a beaucoup d'heuristiques. La sortie produite ne sera pas toujours
parfaite. La methode lynxcgi ne fonctionnera pas si lynx a ete compile
sans le support de celle-ci. Il peut y avoir des problemes de securite.
VOIR AUSSI
lynx(1), man(1)
TRADUCTION
Ce document est une traduction realisee par Alain Portal <aportal AT
univ-montp2 DOT fr> le 1er juin 2005 et mise a jour le 7 novembre 2005.
L'equipe de traduction a fait le maximum pour realiser une adaptation
francaise de qualite. La version anglaise la plus a jour de ce document
est toujours consultable via la commande :
<< LANG=en man 1 man2html >>. N'hesitez pas a signaler a l'auteur ou
au traducteur, selon le cas, toute erreur dans cette page de manuel.