Changes between Initial Version and Version 1 of ReadmePlugin


Ignore:
Timestamp:
Sep 18, 2014, 2:57:29 AM (10 years ago)
Author:
Southen
Comment:

New hack ReadmePlugin, created by Southen

Legend:

Unmodified
Added
Removed
Modified
  • ReadmePlugin

    v1 v1  
     1[[PageOutline(2-5,Contents,pullout)]]
     2
     3= Display README files, especially Markdown, in Browse Source
     4
     5== Description
     6
     7Plugin to display README files in Browse Source directory listings, and preview .md files as rendered Markdown
     8
     9== Bugs/Feature Requests ==
     10
     11Please use [https://github.com/Southen/trac-readme-plugin/issues GitHub] for any issues you have with this plugin.
     12
     13== Download ==
     14
     15Download the zipped source from [https://github.com/Southen/trac-readme-plugin/archive/master.zip here].
     16
     17== Source ==
     18
     19You can clone from [https://github.com/Southen/trac-readme-plugin.git here] using git, or [https://github.com/Southen/trac-readme-plugin browse the source] on GitHub.
     20
     21
     22== !Bugs/Feature Requests
     23
     24Existing bugs and feature requests for ReadmePlugin are
     25[report:9?COMPONENT=ReadmePlugin here].
     26
     27If you have any issues, create a
     28[http://trac-hacks.org/newticket?component=ReadmePlugin&owner=Southen new ticket].
     29
     30== Download
     31
     32Download the zipped source from [export:readmeplugin here].
     33
     34== Source
     35
     36You can check out ReadmePlugin from [http://trac-hacks.org/svn/readmeplugin here] using Subversion, or [source:readmeplugin browse the source] with Trac.
     37
     38== Installation
     39
     40Deploy to a specific Trac environment:
     41{{{
     42$ cd /path/to/pluginsource
     43$ python setup.py bdist_egg
     44$ cp dist/*.egg /path/to/projenv/plugins
     45}}}
     46
     47Enable plugin in trac.ini:
     48{{{
     49[components]
     50readme_renderer.* = enabled
     51}}}
     52
     53Configuration in trac.ini:
     54{{{
     55[mimeviewer]
     56mime_map = ...,text/x-trac-wiki:wiki,text/x-markdown:md
     57mime_map_patterns = text/plain:README:INSTALL:COPYING
     58}}}
     59
     60Appending `text/x-trac-wiki:wiki` and/or`text/x-markdown:md` to `mime_map` will render the appropriate file extensions as wiki and markdown files respectively in file previews.
     61The 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.
     62
     63For more information, please follow [http://trac.edgewall.org/wiki/TracPlugins#InstallingaTracPlugin documentation] on how to install Trac's plugins.
     64
     65
     66== Recent Changes
     67
     68[[ChangeLog(readmeplugin, 3)]]
     69
     70== !Author/Contributors
     71
     72**Author:** [wiki:Southen] [[BR]]
     73**Maintainer:** [[Maintainer]] [[BR]]
     74**Contributors:**