X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/63edea27bc71c3bdf1837f994fb7effdd93fb2dd..bf34ced2fc3e8cf8623a576b8601234de70024ad:/doc/plugins/rst.mdwn diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn index 0f0d6f96c..7250e46a1 100644 --- a/doc/plugins/rst.mdwn +++ b/doc/plugins/rst.mdwn @@ -1,3 +1,7 @@ +[[template id=plugin name=rst author="Sergio Talens-Oliag"]] +[[tag type/format]] +[[tag type/slow]] + This plugin lets ikwiki convert files with names ending in ".rst" to html. It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html) markup syntax. You need to have the python-docutils module installed to use @@ -6,9 +10,8 @@ it. Note that this plugin does not interoperate very well with the rest of ikiwiki. Limitations include: -* reStructuredText does not allow raw html to be inserted into - documents, but ikiwiki does so in many cases, including - [[WikiLinks|WikiLink]] and many +* There are issues with inserting raw html into documents, as ikiwiki + does with [[WikiLinks|WikiLink]] and many [[PreprocessorDirectives|PreprocessorDirective]]. * It's slow; it forks a copy of python for each page. While there is a perl version of the reStructuredText processor, it is not being kept in @@ -17,8 +20,3 @@ ikiwiki. Limitations include: So while you may find this useful for importing old files into your wiki, using this as your main markup language in ikiwiki isn't recommended at this time. - -This plugin is included in ikiwiki, but not enabled by default. -It was contributed by Sergio Talens-Oliag. - -[[tag type/format]]