Version 5 (modified by pierz, 7 years ago) (diff)

Added link to original submission

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.

Bugs/Feature Requests

Existing bugs and feature requests for ManPageRendererPlugin are here.

If you have any issues, create a new ticket.


Download the zipped source from [download:manpagerendererplugin here].


You can check out ManPageRendererPlugin from here using Subversion, or browse the source with Trac.


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:

Recent Changes

6358 by pierz on 2009-08-11 11:58:54
Added url entry to point to homepage
6347 by pierz on 2009-08-07 19:10:20
Commit of initial revision - tested ok on 0.9.4 system
6346 by pierz on 2009-08-07 18:53:36
Check in of intial version


Author: Piers O'Hanlon