summaryrefslogtreecommitdiff
path: root/doc/plugins/rst.mdwn
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-10-15 16:33:02 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-10-15 16:33:02 +0000
commit65dca9f89d82cc512f1c10ac8cf70696243e650a (patch)
tree53e0c9e87da2fcd86f23a557ac2132c92b700bb6 /doc/plugins/rst.mdwn
parent68c77ef01fff197c65678f6f23a12cea66f635db (diff)
* Rewritten rst plugin by madduck is a python program that communicates with
ikiwiki via XML RPC. This should be much faster than the old plugin that had to fork python for every rst page render. Note that if you use the rst plugin, you now need to have the RPC::XML perl module installed.
Diffstat (limited to 'doc/plugins/rst.mdwn')
-rw-r--r--doc/plugins/rst.mdwn10
1 files changed, 3 insertions, 7 deletions
diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn
index 7250e46a1..1f8073517 100644
--- a/doc/plugins/rst.mdwn
+++ b/doc/plugins/rst.mdwn
@@ -1,11 +1,10 @@
-[[template id=plugin name=rst author="Sergio Talens-Oliag"]]
+[[template id=plugin name=rst author="martin f. krafft"]]
[[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
-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:
@@ -13,9 +12,6 @@ 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.
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