[[PageOutline(2-5,Contents,pullout)]] = Trac Renderer for Asciidoc pages using Asciidoctor == Description This is a plugin for rendering !AsciiDoc source files to HTML when browsing the repository. [wikipedia:AsciiDoc] offers a plain-text syntax, embellished with markup, that's designed for humans to read, write and edit in raw form. To use this plugin install [http://asciidoctor.org/ Asciidoctor] and enable the plugin as usual. Asciidoctor itself is MIT licensed. Note that the plugin only renders files using the browser, I don't plan to add support for the wiki unless someone asks for it. == !Bugs/Feature Requests Existing bugs and feature requests for TracAsciidoctorPlugin are [report:9?COMPONENT=TracAsciidoctorPlugin here]. If you have any issues, create a [/newticket?component=TracAsciidoctorPlugin new ticket]. [[TicketQuery(component=TracAsciidoctorPlugin&group=type,format=progress)]] == Download Download the zipped source from [export:tracasciidoctorplugin here]. == Source You can check out TracAsciidoctorPlugin from [/svn/tracasciidoctorplugin here] using Subversion, or [source:tracasciidoctorplugin browse the source] with Trac. == Installation General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. The simplest way to install it is using `easy_install`: {{{#!sh easy_install https://trac-hacks.org/svn/tracasciidoctorplugin/1.0/ }}} This plugin uses asciidoctor so it needs to be installed on your machine. If it is not in the usual place of `/usr/bin/asciidoctor`, you can specify its location in the `trac.ini` file: {{{#!ini asciidoctor_path = /your_path/asciidoctor }}} You will need to enable it in `trac.ini` under the `[components]` subheading: {{{#!ini [components] tracasciidoctor.* = enabled }}} It will render pages with `svn:mime-type` property set to `text/asciidoc` or `text/x-asciidoc`. If you want to render pages without setting the `mime-type` a good option is to add extensions to the `[mimeviewer]` section: {{{#!ini [mimeviewer] mime_map = text/asciidoc:adoc:asc:asciidoc }}} == Recent Changes [[ChangeLog(tracasciidoctorplugin, 3)]] == !Author/Contributors **Author:** [wiki:sto] [[BR]] **Maintainer:** [[Maintainer]] [[BR]] **Contributors:**