[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
howtos:software:man2html_mini_howto [2014/12/18 05:56 (UTC)] – [Sources] added attribution pdihowtos:software:man2html_mini_howto [2019/02/21 11:35 (UTC)] (current) – removed markand
Line 1: Line 1:
-<!-- Add your text below. We strongly advise to start with a Headline (see button bar above). --> 
-====== man2html Mini HOWTO ====== 
  
-===== Introduction ===== 
- 
-//man2html// can generate //on the fly// HTML pages from //man// documentation. This makes it a useful addition to [[howtos:software:asciidoc_mini_howto|asciidoc]] based notes. 
-((The HTML from //man2html// is formatted differently from that of //asciidoc//, and a possible, but heavy-handed, solution might be the use of [[http://slackbuilds.org/office/pandoc/|pandoc]], available from Slackbuilds.org.)) 
-One of the advantages it offers is that when //man// pages are converted to HTML they become navigable through hyperlinks. A similar script exists for //info//, [[http://www.w3.org/Tools/info2www.html|info2www]]. 
- 
-//man2html// can be used from the command line, for example, to read in //lynx// the html-formatted //man// page of //grep//: 
- 
-  $ zcat $(man --path 1 grep) | man2html -l | lynx -stdin 
- 
-It is more useful, however, to setup a //cgi-bin// infrastructure which will allow the //on the fly// operation, see man2html(1). 
- 
-===== http ===== 
- 
-This is the most versatile mode, as it works from any browser. 
- 
-**''# mkdir /var/www/cgi-bin/man''** 
- 
-**''# $EDITOR /etc/lynx.cfg''** 
-<file> 
-# NB: <TAB> must be a real tab. 
-TRUSTED_LYNXCGI:<TAB>/var/www/cgi-bin/man/ 
-</file> 
- 
-**''# $EDITOR /var/www/cgi-bin/man/man2html''** 
-<code bash> 
-#!/bin/bash 
-# $1 is the man section 
-# $2 is the command name 
-zcat "$(man --path $1 $2)" | /usr/bin/man2html 
-</code> 
- 
-**''# chmod 0755 /var/www/cgi-bin/man/man2html''** 
- 
-**''# /etc/rc.d/rc.httpd start''** 
- 
-See [[[[howtos:software:asciidoc_mini_howto#man|asciidoc Mini HOWTO]] for how to use in an //asciidoc// file. 
- 
-<note warning>The steps are intended for //localhost//, or at most a LAN. //cgi-bin// may need some hardening for a public web server.</note> 
- 
-===== lynxcgi ===== 
- 
-This works only from //lynx//. Make sure //lynx// is compiled with enabled ''cgi-bin'', the default for Slackware. 
- 
-**''$ mkdir -p /home/httpd/cgi-bin/man''** 
- 
-**''$ $EDITOR /etc/lynx.cfg''** 
- 
-<file> 
-# NB: <TAB> must be a real tab. 
-TRUSTED_LYNXCGI:<TAB>/home/httpd/cgi-bin/man/ 
-</file> 
- 
-**''$ $EDITOR /home/httpd/cgi-bin/man/man2html''** 
-<code bash> 
-#!/bin/bash 
-# $1 is the man section 
-# $2 is the command name 
-zcat "$(man --path $1 $2)" | /usr/bin/man2html -l 
-</code> 
- 
-**''$ chmod 0755 /home/httpd/cgi-bin/man/man2html''** 
- 
-A link in an //asciidoc// file for //grep// will be: 
-<file> 
-lynxcgi:/home/httpd/cgi-bin/man/man2html?1+grep[grep(1)] 
-</file> 
- 
- 
- 
- 
-====== Sources ====== 
-<!-- If you are copying information from another source, then specify that source --> 
-<!-- * Original source: [[http://some.website.org/some/page.html]] --> 
-<!-- Authors are allowed to give credit to themselves! --> 
-* Originally written by [[wiki:user:pdi | pdi]] 
-<!-- * Contributions by [[wiki:user:yyy | User Y]] --> 
- 
-<!-- Please do not modify anything below, except adding new tags.--> 
-<!-- You must remove the tag-word "template" below before saving your new page --> 
-{{tag>howtos}} 

Trace:

howtos:software:man2html_mini_howto ()