web commit by tschwinge: Request about adding a better linking functionality.

[ikiwiki.git] / doc / plugins / rst.mdwn

diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn
index 0f0d6f96c6b5fef32c5768e56ad85213d411ab5c..7250e46a13b352261f79344ab3682fe82da97f26 100644 (file)
--- 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]]