254 lines
7.8 KiB
HTML
254 lines
7.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of man2html</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>man2html</H1>
|
|
Section: Commandes utilisateur (1)<BR>Updated: 1er janvier 1998<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOM</H2>
|
|
|
|
man2html - formate une page de manuel en html
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
man2html [options] [fichier]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>man2html</B>
|
|
|
|
convertit une page de manuel telle que trouvée dans
|
|
<I>fichier</I>
|
|
|
|
(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).
|
|
<B>man2html</B>
|
|
|
|
supporte
|
|
<B><A HREF="/cgi-bin/man/man2html?1+tbl">tbl</A></B>(1)
|
|
|
|
mais ne connaît rien à propos de
|
|
<B><A HREF="/cgi-bin/man/man2html?1+eqn">eqn</A></B>(1).
|
|
|
|
Le code de sortie est 0. Si quelque chose va mal, une page d'erreur
|
|
est affichée sur la sortie standard stdout.
|
|
<P>
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lynx">lynx</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xmosaic">xmosaic</A></B>(1)
|
|
|
|
ou
|
|
<B><A HREF="/cgi-bin/man/man2html?1+netscape">netscape</A></B>(1).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
La plus grande partie de
|
|
<B>man2html</B>
|
|
|
|
est l'engin « troff-vers-html » écrit par Richard Verhoeven (<A HREF="mailto:rcb5@win.tue.nl">rcb5@win.tue.nl</A>).
|
|
Il ajoute des hyperliens aux constructions suivantes :
|
|
<P>
|
|
|
|
<TABLE>
|
|
<TR VALIGN=top><TD><A HREF="/cgi-bin/man/man2html?3x+foo">foo</A>(3x)</TD><TD>"<A HREF="http://localhost/cgi-bin/man/man2html?3x+foo">http://localhost/cgi-bin/man/man2html?3x+foo</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="method://string">method://string</A></TD><TD>"<A HREF="method://string">method://string</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="http://www.host.name">www.host.name</A></TD><TD>"<A HREF="http://www.host.name">http://www.host.name</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="ftp://ftp.host.name">ftp.host.name</A></TD><TD>"<A HREF="ftp://ftp.host.name">ftp://ftp.host.name</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="mailto:name@host">name@host</A></TD><TD>"mailto:<A HREF="mailto:name@host">name@host</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><<A HREF="file:///usr/include/string.h">string.h</A>></TD><TD>"file:/usr/include/string.h"<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
|
|
(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
|
|
<B><A HREF="/cgi-bin/man/man2html?1+bash">bash</A></B>(1).
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
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.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-D chemin</B>
|
|
|
|
<DD>
|
|
Retire les deux derniers éléments du chemin et effectue un changement
|
|
de répertoire courant <I>chdir</I>(<I>dir</I>) avant de débuter la conversion.
|
|
</DL>
|
|
<P>
|
|
|
|
L'option -E option facilite la production de messages d'erreurs à partir
|
|
de scripts cgi.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><B>-E chaîne</B>
|
|
|
|
<DD>
|
|
Produire en sortie une page d'erreur contenant le message d'erreur donné.
|
|
</DL>
|
|
<P>
|
|
|
|
La forme générale d'un hyperlien généré pour référencer une page de manuel est
|
|
<DL COMPACT>
|
|
<DT id="3"><DD>
|
|
<method:cgipath><man2htmlpath><separator><manpage>
|
|
</DL>
|
|
<P>
|
|
|
|
qui est d'ailleurs la forme par défaut. Les éléments de cet hyperlien sont
|
|
positionnés en utilisant diverses options.
|
|
<DL COMPACT>
|
|
<DT id="4"><B>-h</B>
|
|
|
|
<DD>
|
|
Positionner method:cgipath à <A HREF="http://localhost.">http://localhost.</A>
|
|
C'est le comportement par défaut.
|
|
<DT id="5"><B>-H</B><I> hôte[.domaine][:port]</I>
|
|
|
|
<DD>
|
|
Positionner method:cgipath à
|
|
http://<I>hôte.domaine:port</I>.
|
|
|
|
<DT id="6"><B>-l</B>
|
|
|
|
<DD>
|
|
Positionner method:cgipath à
|
|
lynxcgi:<I>/home/httpd</I>.
|
|
|
|
<DT id="7"><B>-L</B><I> dir</I>
|
|
|
|
<DD>
|
|
Positionner method:cgipath à
|
|
lynxcgi:<I>dir</I>.
|
|
|
|
<DT id="8"><B>-M</B><I> man2htmlpath</I>
|
|
|
|
<DD>
|
|
Positionner le chemin vers man2html à utiliser. La valeur par défaut est
|
|
<I>/cgi-bin/man/man2html</I>.
|
|
|
|
<DT id="9"><B>-p</B>
|
|
|
|
<DD>
|
|
Positionner le séparateur à « / ».
|
|
<DT id="10"><B>-q</B>
|
|
|
|
<DD>
|
|
Positionner le séparateur à « ? ». C'est la valeur par défaut.
|
|
<DT id="11"><B>-r</B>
|
|
|
|
<DD>
|
|
Utiliser des chemins html relatifs plutôt que les chemins cgi-bin.
|
|
</DL>
|
|
<P>
|
|
|
|
Sur une machine sur laquelle
|
|
<B>httpd</B>
|
|
|
|
ne tourne pas, vous pouvez utiliser
|
|
<B>lynx</B>
|
|
|
|
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 <I>/home/httpd</I>.
|
|
<P>
|
|
En général, un script cgi peut être appelé de la façon suivante
|
|
<DL COMPACT>
|
|
<DT id="12"><DD>
|
|
<path_to_script>/<more_path>?<query>
|
|
</DL>
|
|
<P>
|
|
|
|
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 « ? ».
|
|
<P>
|
|
L'option -H <I>host</I> spécifiera l'hôte à utiliser
|
|
(à la place <I>localhost</I>). Un script cgi pourra utiliser
|
|
<DL COMPACT>
|
|
<DT id="13"><DD>
|
|
man2html -H $SERVER_NAME
|
|
</DL>
|
|
<P>
|
|
|
|
si la variable SERVER_NAME est positionnée. Cela permettra à votre machine
|
|
de fonctionner en tant que serveur et d'exporter les pages manuel.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BOGUES</H2>
|
|
|
|
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é.
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VOIR AUSSI</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lynx">lynx</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1)
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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 : « <B>LANG=en man 1 man2html</B> ».
|
|
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
|
|
erreur dans cette page de manuel.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">BOGUES</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">VOIR AUSSI</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|