Display README files, especially Markdown, in Browse Source

Description

This is plugin to display README files in Browse Source directory listings, and preview .md files as rendered Markdown.

Bugs/Feature Requests

Please use ​GitHub for any issues you have with this plugin.

Download

Download the zipped source from ​here.

Source

You can clone from ​here using git, or ​browse the source on GitHub.

Installation

Deploy to a specific Trac environment:

cd /path/to/pluginsource
python setup.py bdist_egg
cp dist/*.egg /path/to/projenv/plugins

Enable plugin in trac.ini:

[components]
readme_renderer.* = enabled

Configuration in trac.ini:

[mimeviewer]
mime_map = ...,text/x-trac-wiki:wiki,text/x-markdown:md
mime_map_patterns = text/plain:README:INSTALL:COPYING

Appending text/x-trac-wiki:wiki and/ortext/x-markdown:md to mime_map will render the appropriate file extensions as wiki and markdown files respectively in file previews. The default setting for mime_map_patterns forces all README files to be plain text, you may need to replace | with : or remove the .* to get expected behaviour.

For more information, please follow documentation on how to install Trac plugins.

Recent Changes

14171 by Southen on 2014-09-18 02:57:26

New hack ReadmePlugin, created by Southen

(more)

Author/Contributors

Author: Southen?
Maintainer: Southen?
Contributors: osimons