Repository Readme File Rendering

Description

When browsing directories using the 'Browse Source' menu item (repository browser), this plugin will render any file in listing starting with 'readme(*)' in some form.

It uses the default Trac Mimeview rendering, and will render text (and source files) as usual (less line numbers). However, any supported output format can be used to provide HTML, like:

  • .rst files (restructured text)
  • wiki markup by setting file mime-type to text/x-trac-wiki (or making for instance .wiki file extension default by trac.ini setting `[mimeviewer] mime_map = ...., text/x-trac-wiki:wiki)

Installation

  1. Install or easy_install plugin as usual
  2. Enable in trac.ini: [components] reposreadme.* = enabled

Bugs/Feature Requests

Existing bugs and feature requests for ReposReadMePlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

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

Example

Examples - add your own directory if you use the plugin for a public site:

Recent Changes

[5241] by osimons on 02/11/09 10:25:13

ReposReadMePlugin: License file copied, and forgot a small change.

[5238] by osimons on 02/11/09 02:00:42

ReposReadMePlugin: Initial import of working plugin. Enjoy!

[5237] by osimons on 02/11/09 01:43:54

New hack ReposReadMePlugin, created by osimons

Author/Contributors

Author: osimons
Contributors: