• AjudaComPáginasXml

Páginas XML e Processamento XSLT

Se tiver o Python4Suite instalado no seu sistema, é possível guardar documentos XML como páginas. É importante identificar essas páginas com uma declaração XML "<?xml ...>" logo na primeira linha. Terá de especificar também a folha de cálculo a ser utilizada para converter o documento XML para HTML. Isto é possível utilizando uma instrução de processamento "xml-stylesheet" standard, tendo como parâmetro "href" o nome da página que contém a folha de cálculo.

Não se esqueça de activar o processamento XSLT, consulte o tópico AjudaNaConfiguração.

Para mais informações, veja o exemplo seguinte, que pode ser igualmente encontrado na página VersãoXslt.

Exemplo

<?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>

Apresentar DocBook

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

1. Instale o 4suite e active o processamento XSLT, ver em cima.

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

3. 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).

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

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