summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-08-17 19:45:34 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-08-17 19:45:34 +0000
commit6887ef169e525e303c7d6f3f6d23cdc939b17f54 (patch)
tree52c9a7b205495fd86cac8bff1fa85c2e370316b8 /doc
parent724c011d940280a5545dbe0dbe2dd5b2cb2a721e (diff)
revert
Diffstat (limited to 'doc')
-rw-r--r--doc/plugins/rst.mdwn12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn
index 7d542646c..7250e46a1 100644
--- a/doc/plugins/rst.mdwn
+++ b/doc/plugins/rst.mdwn
@@ -7,9 +7,15 @@ It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
markup syntax. You need to have the python-docutils module installed to use
it.
-Note that this plugin is rather 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.
+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.
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