NOM

       man2html - formate une page de manuel en html

SYNOPSIS

       man2html [options] [fichier]

DESCRIPTION

       man2html convertit une page de manuel telle que trouvée dans fichier (ou l'entrée standard stdin si aucun
       argument  fichier n'est donné ou si l'argument « - » est donné) à partir du format nroff (celui des pages
       de manuels) vers un format html et affiche le résultat sur la sortie standard (stdout). man2html supporte
       tbl(1) mais ne connaît rien à propos de eqn(1). Le code de sortie est 0. Si quelque  chose  va  mal,  une
       page d'erreur est affichée sur la sortie standard stdout.

       Cette commande peut être utilisée seule mais a été principalement conçue pour être 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 »  écrit  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  première de celles-ci peut être ajustée par des options - voir plus loin.) Aucune consultation n'est
       effectuée - les liens générés n'ont pas besoin d'exister. Un index avec des hyperliens internes vers  les
       diverses  sections  est  également  créé  rendant  plus facile la navigation dans les grandes pages comme
       bash(1).

OPTIONS

       Lorsqu'on lit à partir de stdin, il n'est pas toujours évident de savoir comment se fait l'expansion .so.
       L'option -D permet à un script de définir le répertoire de travail.

       -D chemin
              Retire les deux derniers éléments du chemin  et  effectue  un  changement  de  répertoire  courant
              chdir(dir) avant de débuter la conversion.

       L'option -E option facilite la production de messages d'erreurs à partir de scripts cgi.

       -E chaîne
              Produire en sortie une page d'erreur contenant le message d'erreur donné.

       La forme générale d'un hyperlien généré pour référencer une page de manuel est

              <method:cgipath><man2htmlpath><separator><manpage>

       qui  est  d'ailleurs  la  forme  par  défaut. Les éléments de cet hyperlien sont positionnés en utilisant
       diverses options.

       -h     Positionner method:cgipath à http://localhost. C'est le comportement par défaut.

       -H hôte[.domaine][:port]
              Positionner method:cgipath à http://hôte.domaine:port.

       -l     Positionner method:cgipath à lynxcgi:/home/httpd.

       -L dir Positionner method:cgipath à lynxcgi:dir.

       -M man2htmlpath
              Positionner le chemin vers man2html à utiliser. La valeur par défaut est /cgi-bin/man/man2html.

       -p     Positionner le séparateur à « / ».

       -q     Positionner le séparateur à « ? ». C'est la valeur par défaut.

       -r     Utiliser des chemins html relatifs plutôt 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 méthode lynxcgi. Lorsqu'un démon http est en service, vous pouvez utiliser lynx
       ou  n'importe  quel  autre  navigateur  pour  parcourir les pages de manuel en utilisant la méthode http.
       L'option -l (pour « lynxcgi ») sélectionne ce fonctionnement. Avec elle, le chemin  cgi  par  défaut  est
       /home/httpd.

       En général, un script cgi peut être appelé de la façon suivante

              <path_to_script>/<more_path>?<query>

       et  les  variables  d'environnement  PATH_INFO  et  QUERY_STRING  seront  positionnées  respectivement  à
       <more_path> et <query>. Puisque lynxcgi  ne  gère  pas  l'élément  PATH_INFO,  nous  allons  générer  des
       hyperliens  avec  « ? »  comme séparateur par défaut. L'option -p (pour « path ») sélectionne « / » comme
       séparateur, alors que l'option -q (for « query ») sélectionne « ? ».

       L'option -H host spécifiera l'hôte à utiliser (à la place localhost). Un script cgi pourra utiliser

              man2html -H $SERVER_NAME

       si la variable SERVER_NAME est positionnée. Cela permettra à 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 méthode lynxcgi ne
       fonctionnera pas si lynx a été compilé sans le support de celle-ci. Il peut  y  avoir  des  problèmes  de
       sécurité.

VOIR AUSSI

       lynx(1), man(1)

TRADUCTION

       Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 1er juin 2005
       et mise à jour le 7 novembre 2005.

       L'équipe  de  traduction  a fait le maximum pour réaliser une adaptation française de qualité. La version
       anglaise  la  plus   à   jour   de   ce   document   est   toujours   consultable   via   la   commande :
       « LANG=en man 1 man2html ».  N'hésitez  pas  à  signaler à l'auteur ou au traducteur, selon le cas, toute
       erreur dans cette page de manuel.

Manuel Linux                                    1er janvier 1998                                     man2html(1)