##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt

<<TableOfContents(1)>>

= Páginas XML e Processamento XSLT =
Se tiver o [[http://4suite.org/|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 [[http://www.w3.org/TR/xml-stylesheet/|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 [[WikiMoinMoin|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 [[WikiMoinMoin|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.
 1. Veja os [[http://sourceforge.net/project/showfiles.php?group_id=21935&package_id=16608|ficheiros DocBook no SourceForge]] e descarregue o artigo mais recente. Contém os ficheiros XSLT necessários para a criação de HTML.
 1. Extraia os ficheiros do arquivo e copie todas as directorias {{{html}}}, {{{lib}}}, {{{common}}} e o ficheiro {{{VERSION}}} para uma directoria editável pelo [[WikiMoinMoin|MoinMoin]] (ex: a directoria {{{data}}}).
  * Depois de ter actualizado o 4suite, tem de eliminar o ficheiro {{{db_compiled.dat}}} desta directoria (se existir).
 1. 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.
 1. 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:
{{{#!docbook
<!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.
