Resa DocBook

Per fare in modo che MoinMoin elabori le pagine DocBook, è necessario seguire i passi esposti di seguito. Sarà poi possibile scrivere file DocBook e vederli visualizzati come pagine HTML in MoinMoin. Notare che la resa di pagine DocBook potrebbe impiegare alcuni secondi (questo viene fatto dopo aver salvato la pagina).

Installare il supporto DocBook

  1. Installare 4suite e abilitare l'elaborazione XSLT, vedere sopra.

  2. Visitare i file DocBook presso SourceForge e scaricare l'archivio più aggiornato. Contiene i file XSLT necessari per la generazione dell'HTML.

  3. Estrarre l'archivio e copiare tutte le directory html, lib, common e il file VERSION in una directory scrivibile da MoinMoin (come la directory data).

    • Una volta aggiornato 4suite, è necessario cancellare il file db_compiled.dat in questa directory (se esiste).

  4. Modificare la configurazione del wiki, l'attributo docbook_html_dir deve puntare alla directory creata nell'ultimo passo (quella che contiene il file docbook.xsl).

  5. Ora si dovrebbe essere in grado di usare DocBook.

Usare DocBook

Basta scrivere il proprio file DocBook come viene fatto solitamente. Se si desidera inserire dei collegamenti ad altre pagine wiki, assicurarsi di scrivere in NomeWiki all'interno del testo. Notare che le pagine che necessitano di collegamenti tipo ["..."] nella marcatura classica del wiki non possono essere collegate direttamente (per il momento).

La marcatura DocBook è indicata da #format docbook alla prima riga della pagina in una pagina wiki:

XSLT option disabled, please look at HelpOnConfiguration.
<!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>Pinco</firstname>
<surname>Pallino</surname>
</author>
<copyright>
<year>2008</year>
</copyright>
</bookinfo>
<chapter>
<title>Questo è il titolo di un capitolo</title>
<sect1>
<title>Questo è il titolo di una sezione</title>
<para>Questo è un paragrafo.</para>
<para>
<emphasis role="bold">
Questo è un paragrafo in grassetto.
</emphasis>
</para>
</sect1>
</chapter>
</book>

Notare che è necessario installare DocBook come descritto precedentemente affinché questo esempio funzioni.