Para que o MoinMoin apresente páginas de DocBook, precisa de seguir os passos descritos em baixo. Depois, tem de ter permissões de edição nos ficheiros de DocBook no MoinMoin, e vê-las apresentadas em HTML. Tenha em consideração que a apresentação de páginas DocBook, pode demorar alguns segundos de tempo de processamento (este é feito depois de guardar a página).
Instalar o suporte do DocBook
- Instale o 4suite e active o processamento XSLT, ver em cima.
Veja os ficheiros DocBook no SourceForge e descarregue o artigo mais recente. Contém os ficheiros XSLT necessários para a criação de HTML.
Extraia os ficheiros do arquivo e copie todas as directorias html, lib, common e o ficheiro VERSION para uma directoria editável pelo MoinMoin (ex: a directoria data).
Depois de ter actualizado o 4suite, tem de eliminar o ficheiro db_compiled.dat desta directoria (se existir).
Edite a configuração do seu wiki, o atributo docbook_html_dir tem de apontar para a directoria (que contém, por exemplo, o ficheiro docbook.xsl) que criou no passo anterior.
Já deve conseguir utilizar o parser do DocBook.
Utilizar o DocBook
Basta editar o seu ficheiro DocBook como o teria feito num ambiente diferente. Se quiser inserir ligações para outras páginas de wiki, certifique-se de que adiciona um NomeDeWiki ao texto. Repare que as páginas que necessitam de ligações ["..."] na formatação normal de wiki, ainda não podem ser ligadas directamente.
A formatação do DocBook é formatada por #format docbook na primeira linha de uma página ou numa página wiki como esta:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <book> <bookinfo> <author> <firstname>Bernd</firstname> <surname>Le Pain</surname> </author> <copyright> <year>2005</year> </copyright> </bookinfo> <chapter> <title>This is a title of a chapter</title> <sect1> <title>This is a title of a section</title> <para>This is a paragraph.</para> <para> <emphasis role="bold"> This is a paragraph in bold. </emphasis> </para> </sect1> </chapter> </book>
Tenha em consideração de que precisa de instalar o DocBook como descrevemos em cima para que este exemplo funcione.