]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/plugins/rst.mdwn
web commit by joey: resp
[git.ikiwiki.info.git] / doc / plugins / rst.mdwn
index 0f0d6f96c6b5fef32c5768e56ad85213d411ab5c..7250e46a13b352261f79344ab3682fe82da97f26 100644 (file)
@@ -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
 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:
 
 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
   [[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.
 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]]