223 lines
6.6 KiB
HTML
223 lines
6.6 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: User Commands (1)<BR>Updated: 1 Ianuarie 1998<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NUME</H2>
|
|
|
|
man2html - formatează o pagină de manual în html
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SUMAR</H2>
|
|
|
|
man2html [opţuni] [fişier]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIERE</H2>
|
|
|
|
<B>man2html</B>
|
|
|
|
converteşte o pagină de manual aşa cum se găseşte în
|
|
<I>fişier</I>
|
|
|
|
(sau intrarea standard (stdin), în caz că argumentul fişier lipseşte,
|
|
sau argumentul "-" este folosit) din stilul man nroff în html, şi
|
|
tipăreşte rezultatul la ieşirea standard (stdout). Suportă tbl dar nu
|
|
ştie de eqn. Starea de ieşire este 0. Dacă ceva merge eronat, o pagină
|
|
de eroare este tipărită la ieşirea standard (stdout).
|
|
<P>
|
|
Poate fi folosit ca un utilitar de sine stătător, dar este în principal
|
|
conceput ca un auxiliar, pentru a permite utilizatorilor să navigheze
|
|
prin paginile de manual folosind un navigator html ca
|
|
<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)
|
|
|
|
sau
|
|
<B><A HREF="/cgi-bin/man/man2html?1+netscape">netscape</A></B>(1).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
Partea principală a
|
|
<B>man2html</B>
|
|
|
|
este motorul troff-to-html scris de Richard Verhoeven (<A HREF="mailto:rcb5@win.tue.nl">rcb5@win.tue.nl</A>).
|
|
Adaugă legături pentru următoarele construcţii:
|
|
<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://şir">method://şir</A></TD><TD>"<A HREF="method://şir">method://şir</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="http://www.nume.gazd">www.nume.gazd</A>ă</TD><TD>"<A HREF="http://www.nume.gazdă">http://www.nume.gazdă</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="ftp://ftp.nume.gazd">ftp.nume.gazd</A>ă</TD><TD>"<A HREF="ftp://ftp.nume.gazdă">ftp://ftp.nume.gazdă</A>"<BR></TD></TR>
|
|
<TR VALIGN=top><TD><A HREF="mailto:nume@gazd">nume@gazd</A>ă</TD><TD>"mailto:<A HREF="mailto:nume@gazd">nume@gazd</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>
|
|
|
|
(Primele din acestea pot fi modificate cu opţiuni - vezi mai jos.) Nici
|
|
o verificare nu este făcută - legăturile generate nu trebuie să existe.
|
|
De asemenea, este generat un cuprins cu legături interne spre diverse
|
|
secţiuni, astfel încât este mai uşor pentru cineva să se descurce în
|
|
paginile mari de manual ca
|
|
<B><A HREF="/cgi-bin/man/man2html?1+bash">bash</A></B>(1).
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPŢIUNI</H2>
|
|
|
|
Când se citeşte de la intrarea standard, nu este întotdeauna clar cum să
|
|
se facă expansiunea .so. Opţiunea -D permite unui script să definească
|
|
directorul de lucru.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-D cale</B>
|
|
|
|
<DD>
|
|
Elimină ultimele două părţi din cale, şi face un
|
|
<I>chdir</I>(<I>dir</I>) înainte de a începe conversia.
|
|
</DL>
|
|
<P>
|
|
|
|
Opţiunea -E permite generarea uşoară a mesajelor de eroare dintr-un
|
|
script cgi.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><B>-E şir</B>
|
|
|
|
<DD>
|
|
Produce o pagină de eroare conţinând mesajul de eroare dat.
|
|
</DL>
|
|
<P>
|
|
|
|
Forma generală a unei legături generate pentru o referinţă la o pagină
|
|
de manual este
|
|
<DL COMPACT>
|
|
<DT id="3"><DD>
|
|
<metodă:cale_cgi><cale_man2html><separator><pagină_man>
|
|
</DL>
|
|
<P>
|
|
|
|
cu o formă implicită ca mai sus. Părţile acestei legături sunt
|
|
configurate folosind diverse opţiuni.
|
|
<DL COMPACT>
|
|
<DT id="4"><B>-h</B>
|
|
|
|
<DD>
|
|
Configurează metodă:cele_cgi ca <A HREF="http://localhost.">http://localhost.</A> Această opţiune este implicită.
|
|
<DT id="5"><B>-H</B><I> gazdă[.domeniu][:port]</I>
|
|
|
|
<DD>
|
|
Configurează metodă:cale_cgi ca
|
|
http://<I>gazdă.domeniu:port</I>.
|
|
|
|
<DT id="6"><B>-l</B>
|
|
|
|
<DD>
|
|
Configurează metodă:cale_cgi ca
|
|
lynxcgi:<I>/home/httpd</I>.
|
|
|
|
<DT id="7"><B>-L</B><I> dir</I>
|
|
|
|
<DD>
|
|
Configurează metodă:cale_cgi ca
|
|
lynxcgi:<I>dir</I>.
|
|
|
|
<DT id="8"><B>-M</B><I> cale_man2html</I>
|
|
|
|
<DD>
|
|
Configurează cale_man2html care va fi folosită. Implicit ea este
|
|
<I>/cgi-bin/man/man2html</I>.
|
|
|
|
<DT id="9"><B>-p</B>
|
|
|
|
<DD>
|
|
Configurează separatorul ca '/'.
|
|
<DT id="10"><B>-q</B>
|
|
|
|
<DD>
|
|
Configurează separatorul ca '?'. Această opţiune este implicită.
|
|
</DL>
|
|
<P>
|
|
|
|
Pe o maşină care nu rulează
|
|
<B>httpd</B>,
|
|
|
|
se poate folosi
|
|
<B>lynx</B>
|
|
|
|
pentru a naviga prin paginile de manual, folosind metoda lynxcgi. Când
|
|
un demon http rulează, lynx, sau orice alt navigator, poate fi folosit
|
|
pentru a naviga prin paginile de manual, folosind metoda http. Opţiunea
|
|
-l (pentru `lynxcgi') selectează comportamentul precedent. Cu ea,
|
|
cale_cgi este <I>/home/httpd</I>.
|
|
<P>
|
|
În general, un script cgi poate fi apelat prin
|
|
<DL COMPACT>
|
|
<DT id="11"><DD>
|
|
<cale_la_script>/<mai_multă_cale>?<cerere>
|
|
</DL>
|
|
<P>
|
|
|
|
şi variabilele de mediu PATH_INFO şi QUERY_STRING vor fi configurate ca
|
|
<mai_multă_cale> şi respectiv <cere>. Din moment ce lynxcgi nu tratează
|
|
partea PATH_INFO, generăm legături cu `?' drept separator în mod
|
|
implicit. Opţiunea -p (de la eng. `path' (cale)) selectează '/' ca
|
|
separator, în timp ce opţiunea -q (de la eng. `query'(cerere))
|
|
selectează '?' ca separator.
|
|
<P>
|
|
Opţiunea -H <I>gazdă</I> va specifica gazda care va fi folosită (în loc
|
|
de <I>localhost</I>). Un script cgi ar putea folosi
|
|
<DL COMPACT>
|
|
<DT id="12"><DD>
|
|
man2html -H $SERVER_NAME
|
|
</DL>
|
|
<P>
|
|
|
|
dacă variabila SERVER_NAME este configurată. Aceasta ar permite maşinii
|
|
să se comporte ca un server şi să exporte pagini de manual.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ERORI</H2>
|
|
|
|
Sunt multe euristici. Rezultatul nu va fi întotdeauna perfect. Metoda
|
|
lynxcgi nu va funcţiona dacă lynx a fost compilat fără a selecta suport
|
|
pentru ea. Ar putea fi probleme de securitate.
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VEZI ŞI</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>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NUME</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">SUMAR</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">DESCRIERE</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">OPŢIUNI</A><DD>
|
|
<DT id="17"><A HREF="#lbAF">ERORI</A><DD>
|
|
<DT id="18"><A HREF="#lbAG">VEZI ŞI</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:22 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|