updated branch; this is ready for review for inclusion in IkIWiki

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

diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn
index 7250e46a13b352261f79344ab3682fe82da97f26..5e97e2d8058391ec39cb7a493c3a4a6e1a219732 100644 (file)
--- a/doc/plugins/rst.mdwn
+++ b/doc/plugins/rst.mdwn
@@ -1,21 +1,17 @@
-[[template id=plugin name=rst author="Sergio Talens-Oliag"]]
-[[tag type/format]]
-[[tag type/slow]]
+[[!template id=plugin name=rst author="martin f. krafft"]]
+[[!tag type/format]]

 
 This plugin lets ikwiki convert files with names ending in ".rst" to html.
 It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
 
 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
-it.
+markup syntax. You need to have [[!cpan RPC::XML]], python and the
+python-docutils module installed to use it.

 
 Note that this plugin does not interoperate very well with the rest of
 ikiwiki. Limitations include:
 
 * There are issues with inserting raw html into documents, as ikiwiki 
 
 Note that this plugin does not interoperate very well with the rest of
 ikiwiki. Limitations include:
 
 * 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
-  sync with the standard version, so is not used.
+  does with [[WikiLinks|ikiwiki/WikiLink]] and many 
+  [[directives|ikiwiki/directive]].

 
 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
 
 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