|Version 6 (modified by pierz, 5 years ago) (diff)|
Unix Manual page renderer
A plugin for rendering unix manual pages to HTML so they're human readable when browsing the repository.
Specifically it extends the IHTMLPreviewRenderer component of the mimeviewer to pass the nroff man page through groff which generates an HTML version of the page. I originally submitted it as a new enhancement a while back to the main trac site but trac-hacks seems to be the place for such things now.
If you have any issues, create a new ticket.
Download the zipped source from here.
The simplest way to install it is using easy_install:
This plugin uses groff so it needs to be installed on your machine (it usually is installed on most unixes) and if it is not in the usual place of /usr/bin/groff you can specify its location in the trac.ini file:
groff_path = /your_path/groff
You will need to enable it in trac.ini:
manpagerenderer.* = enabled
It will automatically render pages ending .man but if you want it to render man pages that end in .1 (or something else) then add this to [mimeviewer] section:
mime_map = application/x-troff-man:1
And/or you can set svn:mime-type property to application/x-troff-man for specific files you want renderer by the plugin.
See it working on our trac site: http://frostie.cs.ucl.ac.uk/nets/mmedia/browser/rat/trunk/man/man1/rat.1
Author: Piers O'Hanlon