Message-Id: <9210231051.AA03886@daneel.rdt.monash.edu.au> To: timbl@nxoc01.cern.ch (Tim Berners-Lee) Cc: www-talk@nxoc01.cern.ch Subject: Re: Man pages server code, anyone? In-Reply-To: Your message of "28 Sep 92 13:40:33 +0100." <9209281240.AA04048@ nxoc01.cern.ch > Date: Fri, 23 Oct 92 20:51:06 -1000 From: Rik Harris <rik@daneel.rdt.monash.edu.au> Almost a month ago, Tim wrote: > I know I heard of someone with a filter for unix man page to HTML, > but I can't find it. Does anyone on this list write one? OK, I finally have a reasonably nice-looking man converter. It does the following things: * puts section headings in <H2> </H2>'s. * formats paragraphs with <P>. * does some special characters. * hypertext links for references to other manual pages. * some <HP?> highlighting. Current problems: * it's not lightning fast. * doesn't handle tbl correctly yet. * it would be nice to put some things in a <DL> type list. * many of the special characters missing. * it does some strange spacing sometimes. The filter is in a number of parts. The first part is written in perl, and parses the man page names and gets a list of filenames, which it pipes to groff. I have built a special groff filter in perl for the second part. This filter takes the groff device-independent intermediate output, and converts it to HTML. The code's not too bad, but could do with a bit of cleaning-up, particularly the tbl handling. You can play with the filter by connecting to: http://www.vifp.monash.edu.au:5000/MANPAGE where MANPAGE can just be a name, like 'cat', or it can be a name and section, like 'cos(3m)'. Please tell me if you notice anything strange, and I will attempt to fix it. I'll give the code to people if they really want it, but as I said before, I hope to clean it up a little before I release it more generally. To run the code, you need groff and perl and you need to be able to install new drivers for groff (I think there's an option for groff to look in a different directory for drivers). This is part of our local help/documentation system, which will eventually be complete, changing documentation for our computer systems. I essentially wanted to be able to direct people to the man pages when necessary, and I thought it pointless to have man pages if you couldn't just click on the "See Also"'s :-) Have fun, and let me know what you think. rik. -- Rik Harris - rik.harris@fcit.monash.edu.au || Systems Programmer +61 3 571-2895 (AH & ans.mach) +61 3 573-2679 (BH) || and Administrator Faculty of Computing and Information Technology, || Vic. Institute of Caulfield Campus, Monash University, Australia || Forensic Pathology