Requirements

This has been tested under trac 0.12. It may well work in earlier versions. It probably requires python >= 2.6.

Configuration

Somewhere in your trac configs put a section like:

[staticdocs]

# (Optional) Set the required permission for viewing static docs
# The default is WIKI_VIEW
permission         = WIKI_VIEW

# Set up some aliases (you need at least one alias for this plugin
# to be worthwhile.)
alias./docs/       = /path/to/docs/
alias./docs/other/ = /path/to/other/docs/

# (Optional) Override the required permission for a specific alias
permission./docs/other/  = TICKET_VIEW

Also, you will want to enable the plugin. Probably like this:

[components]

staticdocsplugin.* = enabled

Now if you visit, e.g., http://example.com/yourtrac/docs/file.html, you will get served the file /path/to/docs/file.html.

Notes, Possible Buglets

Other Hints

The NavAddPlugin (from trac-hacks) will let you add links to your static docs (or anywhere else) to the trac navigation bar.

The standard ExtraPermissionsProvider plugin can be used to add a new custom permission (say STATIC_DOCS_VIEW) if you would like one to control access to your static files.

Author

Jeff Dairiki.

Release 0.1 (2012-02-14)

Happy Valentine’s Day!