]> sipb.mit.edu Git - ikiwiki.git/blob - doc/plugins/rst.mdwn
web commit by ptman: It seems the exclamation mark is now needed, can someone confirm...
[ikiwiki.git] / 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|ikiwiki/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.