HelpOnXmlPagesXML Pages & XSLT ProcessingSecurity advisory: enabling xslt processing with 4suite is dangerous (see HelpOnConfiguration page about allow_xslt setting for more details). If you have Python4Suite installed in your system, it is possible to save XML documents as pages. It's important to start those pages with an XML declaration "<?xml ...>
" in the very first line. Also, you have to specify the stylesheet that is to be used to process the XML document to HTML. This is done using a standard "xml-stylesheet" processing instruction, with the name of a page containing the stylesheet as the "href
" parameter. Do no forget to enable XSLT processing, see HelpOnConfiguration. See the following example for details, which can also be found on the XsltVersion page. Example
]]>
]]>
]]>
]]>
This Wiki is running an XSLT engine by
()
implementing XSLT v
]]>]]>Rendering DocBookIn order to let MoinMoin render DocBook pages, you will need to follow the steps described below. Afterwards, you will be able to write DocBook files in MoinMoin and see them as rendered HTML. Note that rendering DocBook pages may take some seconds of processing time (this is done after the page is saved). Installing the DocBook supportInstall 4suite and enable XSLT processing, see above. Go to DocBook files at SourceForge and download the latest archive. It contains the XSLT files necessary for HTML generation. Extract the archive and copy the whole directories html
, lib
, common
and the file VERSION
into a directory that is writable by MoinMoin (e.g. the data
directory). After you have upgraded 4suite, you have to delete the file db_compiled.dat
in this directory (if it exists). Edit your wiki configuration, the attribute docbook_html_dir
has to point to the directory (which contains e.g. the file docbook.xsl
) you created in the last step. You should be able to use the DocBook parser now. Using DocBookJust write your DocBook file like you would have done in a different environment as well. If you want to insert links to other wiki pages, be sure to simply write the WikiName into the text. Note that pages that would need [[...]]
links in ordinary wiki markup cannot be linked to directly, yet. DocBook markup is either marked by #format docbook
in the first line of the page or in a wiki page like this:
Bernd
Le Pain
2005
This is a title of a chapter
This is a title of a section
This is a paragraph.
This is a paragraph in bold.
]]>Note that you need to install DocBook like described above to make this example work.