| 1 | = Repository Readme File Rendering = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | 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: |
| 8 | * .rst files (restructured text) |
| 9 | * 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) |
| 10 | |
| 11 | == Installation == |
| 12 | |
| 13 | 1. Install or easy_install plugin as usual |
| 14 | 1. Enable in trac.ini: `[components] reposreadme.* = enabled` |
| 15 | |
| 16 | |
| 17 | == Bugs/Feature Requests == |
| 18 | |
| 19 | Existing bugs and feature requests for ReposReadMePlugin are |
| 20 | [report:9?COMPONENT=ReposReadMePlugin here]. |
| 21 | |
| 22 | If you have any issues, create a |
| 23 | [http://trac-hacks.org/newticket?component=ReposReadMePlugin&owner=osimons new ticket]. |
| 24 | |
| 25 | == Download == |
| 26 | |
| 27 | Download the zipped source from [download:reposreadmeplugin here]. |
| 28 | |
| 29 | == Source == |
| 30 | |
| 31 | You can check out ReposReadMePlugin from [http://trac-hacks.org/svn/reposreadmeplugin here] using Subversion, or [source:reposreadmeplugin browse the source] with Trac. |
| 32 | |
| 33 | == Example == |
| 34 | |
| 35 | Examples - add your own directory if you use the plugin for a public site: |
| 36 | * https://www.coderesort.com/p/reiseregningen/browser/trunk (license text file) |
| 37 | |
| 38 | |
| 39 | == Recent Changes == |
| 40 | |
| 41 | [[ChangeLog(reposreadmeplugin, 3)]] |
| 42 | |
| 43 | == Author/Contributors == |
| 44 | |
| 45 | '''Author:''' [wiki:osimons] [[BR]] |
| 46 | '''Contributors:''' |