doc/plugins/rst.mdwn

   1 [[template id=plugin name=rst author="Sergio Talens-Oliag"]]
   2 [[tag type/format]]
   3 [[tag type/slow]]
   4
   5 This plugin lets ikwiki convert files with names ending in ".rst" to html.
   6 It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
   7 markup syntax. You need to have the python-docutils module installed to use
   8 it.
   9
  10 Note that this plugin does not interoperate very well with the rest of
  11 ikiwiki. Limitations include:
  12
  13 * There are issues with inserting raw html into documents, as ikiwiki
  14   does with [[WikiLinks|WikiLink]] and many
  15   [[PreprocessorDirectives|PreprocessorDirective]].
  16 * It's slow; it forks a copy of python for each page. While there is a
  17   perl version of the reStructuredText processor, it is not being kept in
  18   sync with the standard version, so is not used.
  19
  20 So while you may find this useful for importing old files into your wiki,
  21 using this as your main markup language in ikiwiki isn't recommended at
  22 this time.