Unix Manual page renderer
This is a plugin for rendering Unix manual pages to HTML, so they are 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.
See it working on our Trac site: http://frostie.cs.ucl.ac.uk/nets/mmedia/browser/rat/trunk/man/man1/rat.1
Originally submitted as a new enhancement to Trac, it is currently hosted on trac-hacks.
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, usually installed as a standard on most Unixes. If it is not in the usual place of /usr/bin/groff, you can specify its location in your trac.ini file:
groff_path = /your_path/groff
You will also need to enable this plugin in your trac.ini file:
[components] manpagerenderer.* = enabled
It will automatically render pages ending in .man, but if you want it to render man pages that end in .1 (or something else), then add this to [mimeviewer] section:
[mimeviewer] mime_map = application/x-troff-man:1
You can set svn:mime-type property to application/x-troff-man for specific files you want to have rendered by the plugin.
Author: Piers O'Hanlon
Maintainer: Piers O'Hanlon