doc/plugins/rst.mdwn

   1 [[template id=plugin name=rst author="martin f. krafft"]]
   2 [[tag type/format]]
   3
   4 This plugin lets ikwiki convert files with names ending in ".rst" to html.
   5 It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
   6 markup syntax. You need to have [[cpan RPC::XML]], python and the
   7 python-docutils module installed to use it.
   8
   9 Note that this plugin does not interoperate very well with the rest of
  10 ikiwiki. Limitations include:
  11
  12 * There are issues with inserting raw html into documents, as ikiwiki
  13   does with [[WikiLinks|WikiLink]] and many
  14   [[PreprocessorDirectives|ikiwiki/PreprocessorDirective]].
  15
  16 So while you may find this useful for importing old files into your wiki,
  17 using this as your main markup language in ikiwiki isn't recommended at
  18 this time.