The rst plugin requires the following additional components that must be installed separately:
- Docutils - see http://docutils.sourceforge.net/
The plugin accepts all the RestructuredText syntax described at http://docutils.sourceforge.net/. There are two ways to use it, either with <rst> directives in an existing Dokuwiki page or by creating pages with a .rst suffix.
Just wrap the RestructuredText in the directives:-
<rst> This is restructured text </rst>
Filename with .rst suffix
Create a new page, if you create a link to a new page called newpage.rst within Dokuwiki the page will actually have the filename newpage.rst.txt, this will be recognised by the plugin and will be parsed as RestructuredText. You can of course create pages by other means, just ensure they are of the form pagename.rst.txt.
Known Bugs and Issues
- Appears to be broken with 2018-04-22b “Greebo” release. The
<rst></rst>block doesn't generate an error but text in the block isn't rendered.