Pagine XML ed elaborazione XSLT

Se nel sistema è installato Python4Suite, è possibile salvare documenti XML come delle pagine. È importante iniziare queste pagine con una dichiarazione XML "<?xml ...>" alla prima riga. È anche necessario specificare il foglio di stile da usare per elaborare il documento XML in HTML. Questo viene fatto usando istruzioni di elaborazione standard, con il nome della pagina contenente il foglio di stile come parametro "href".

È necessario anche abilitare l'elaborazione XSLT, consultare AiutoSuConfigurazione.

Consultare il seguente esempio per i dettagli (può essere trovato anche alla pagina VersioneXslt).

Esempio

<?xml version="1.0" encoding="ISO-8859-1"?>

<?xml-stylesheet href="XsltVersion" type="text/xml"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

   <xsl:output method="html" omit-xml-declaration="yes" indent="no"/>

   <xsl:template match="/">
     This Wiki is running an XSLT engine by
     <xsl:value-of select="system-property('xsl:vendor')"/>
     (<a href="{system-property('xsl:vendor-url')}"><xsl:value-of select="system-property('xsl:vendor-url')"/></a>)
     implementing XSLT v<xsl:value-of select="system-property('xsl:version')"/>
   </xsl:template>

</xsl:stylesheet>

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:

<!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.