[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

Next revision
Previous revision
Last revisionBoth sides next revision
howtos:software:man2html_mini_howto [2014/12/17 16:20 (UTC)] – created pdihowtos:software:man2html_mini_howto [2014/12/18 16:08 (UTC)] – [Sources] pdi
Line 4: Line 4:
 ===== Introduction ===== ===== 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. [1] 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 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//: //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''**+  $ 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). It is more useful, however, to setup a //cgi-bin// infrastructure which will allow the //on the fly// operation, see man2html(1).
Line 42: Line 44:
 ===== lynxcgi ===== ===== lynxcgi =====
  
-This works only from lynx. Make sure lynx is compiled with enabled cgi-bin, the default for Slackware.+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''** **''$ mkdir -p /home/httpd/cgi-bin/man''**
Line 75: Line 77:
 <!-- * Original source: [[http://some.website.org/some/page.html]] --> <!-- * Original source: [[http://some.website.org/some/page.html]] -->
 <!-- Authors are allowed to give credit to themselves! --> <!-- Authors are allowed to give credit to themselves! -->
-<!-- * Originally written by [[wiki:user:xxx User X]] -->+* Originally written by [[wiki:user:pdi pdi]]
 <!-- * Contributions by [[wiki:user:yyy | User Y]] --> <!-- * Contributions by [[wiki:user:yyy | User Y]] -->
  
 <!-- Please do not modify anything below, except adding new tags.--> <!-- Please do not modify anything below, except adding new tags.-->
 <!-- You must remove the tag-word "template" below before saving your new page --> <!-- You must remove the tag-word "template" below before saving your new page -->
-{{tag>howtos}}+{{tag>howtos man2html}}
 howtos:software:man2html_mini_howto ()