aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/rst.mdwn
blob: 6a6606f2056e1369aceb48bf9bd7a16aa4ae844a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[[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)
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 
  does with [[WikiLinks|WikiLink]] and many 
  [[PreprocessorDirectives|ikiwiki/PreprocessorDirective]].

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
this time.