<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//pt_BR">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<META NAME="GENERATOR" CONTENT="lfparser_2.17">
<META NAME="LFCATEGORY" CONTENT="Applications">
<!-- this is used be a number of tools:
=LF=AUTHOR: Egon Willighagen
=LF=CAT___: Applications
=LF=TITLE_: Usando o XML e o XSLT para construir o LinuxFocus.org(/Nederlands)
=LF=NUMBER: 206
=LF=ANAME_: article206.shtml
-->
<TITLE>lf206, Applications: Usando o XML e o XSLT para construir o LinuxFocus.org(/Nederlands)</TITLE>
<!-- stylesheet added by lfparser: -->
<style type="text/css">
<!--
td.top {font-family: Arial,Geneva,Verdana,Helvetica,sans-serif; font-size:12 }
pre { font-familiy:monospace,Courier }
p.cl { color:#EE9500 }
a.nodec { text-decoration:none }
p.trans { font-size:8pt; text-align:right }
p.clbox { width:50%; alignment:center; background-color:#FFD700; border-style:none; border-width:medium; border-color:#FFD700; padding:0.5cm ; text-align:center }
p.foot { background-color:#AAAAAA; color:#FFFFFF; border-style:none; border-width:medium; border-color:#AAAAAA; padding:0.5cm ; margin-top:0.1cm; margin-right:1cm; margin-left:1cm; text-align:center }
-->
</style>
</HEAD>
<BODY bgcolor="#ffffff" text="#000000">
<!-- this is generated html code. NEVER use this file for your
translation work. Instead get the file with the same article number
and .meta.shtml in its name. Translate this meta file and then
use lfparser program to generate the final article -->
<!-- lfparser can be obtained from http://www.linuxfocus.org/~guido/dev/lfparser.html -->
<!-- 2pdaIgnoreStart -->
<!-- start navegation bar -->
<!-- top navegation bar -->
<TABLE cellspacing="0" cellpadding="0" border="0" align="center" width="90%">
<TR bgcolor="#2e2292">
<TD class="top"><TABLE cellspacing="0" cellpadding="0" border="0" width=
"100%">
<TR><TD width="144"><IMG src="../../common/images/logolftop.gif"
alt="[LinuxFocus-icon]" width="350" height="45" align="left"
border="0"></TD>
<TD class="top">
<TABLE width="100%">
<TR align="right">
<TD class="top"><A class="nodec" href="../index.shtml"><FONT color=
"#DDDDDD">Início</FONT></A> | <A class=
"nodec" href="../map.html"><FONT color=
"#DDDDDD">Mapa</FONT></A> | <A class=
"nodec" href="../indice.html"><FONT color=
"#DDDDDD">Índice</FONT></A> | <A class="nodec" href="../Search/index.shtml"><FONT color=
"#DDDDDD">Procura</FONT></A> </TD>
</TR>
<TR align="right">
<TD class="top">
<HR width="100%" noshade size="1">
</TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE>
<!-- end top navegation bar -->
<!-- blue bar -->
<TABLE cellspacing="0" cellpadding="0" border="0" align="center"
width="90%">
<TR bgcolor="#00ffff">
<TD><IMG src="../../common/images/transpix.gif" width="1" height=
"2" alt=""></TD>
</TR>
</TABLE>
<!-- end blue bar -->
<!-- bottom navegation bar -->
<TABLE cellspacing="0" cellpadding="0" border="0" align="center"
width="94%">
<TR bgcolor="#000000">
<TD>
<TABLE cellspacing="0" cellpadding="1" border="0" width=
"100%">
<TR align="center">
<TD><A class="nodec" href="../News/index.shtml"><FONT color=
"#FFFFFF">Novidades</FONT></A> </TD>
<TD><FONT color="#FFFFFF">|</FONT> </TD>
<TD><A class="nodec" href="../Archives/index.html"><FONT color=
"#FFFFFF">Arquivos</FONT></A> </TD>
<TD><FONT color="#FFFFFF">|</FONT> </TD>
<TD><A class="nodec" href="../Links/index.shtml"><FONT color=
"#FFFFFF">Links</FONT></A> </TD>
<TD><FONT color="#FFFFFF">|</FONT> </TD>
<TD><A class="nodec" href="../aboutus.html"><FONT color=
"#FFFFFF">Sobre LF</FONT></A> </TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE>
<!-- end bottom navegation bar -->
<!-- stop navegation bar -->
<!-- SSI_INFO -->
<!-- tr_staticssi include virtual -->
<!-- tr_staticssi exec cmd -->
<!-- addedByLfdynahead ver 1.5 --><TABLE ALIGN="right" border=0><TR><TD ALIGN="right"><FONT SIZE="-1" FACE="Arial,Helvetica">Este artigo está disponível em: <A href="../../English/September2001/article206.shtml">English</a> <A href="../../Castellano/September2001/article206.shtml">Castellano</a> <A href="../../Deutsch/September2001/article206.shtml">Deutsch</a> <A href="../../Francais/September2001/article206.shtml">Francais</a> <A href="../../Italiano/September2001/article206.shtml">Italiano</a> <A href="../../Nederlands/September2001/article206.shtml">Nederlands</a> <A href="../../Portugues/September2001/article206.shtml">Portugues</a> <A href="../../Russian/September2001/article206.shtml">Russian</a> <A href="../../Turkce/September2001/article206.shtml">Turkce</a> </FONT></TD></TR></TABLE><br>
<!-- 2pdaIgnoreStop -->
<!-- SHORT BIO ABOUT THE AUTHOR -->
<TABLE ALIGN=LEFT BORDER=0 hspace=4 vspace=4 WIDTH="30%" >
<TR>
<TD>
<!-- 2pdaIgnoreStart -->
<!-- PALM DOC -->
<TABLE BORDER=0 hspace=4 vspace=4> <TR> <TD>
<font size=1> <img src="../../common/images/2doc.gif" width=34 align=left border=0 height=22 alt="convert to palm"><a href="http://cgi.linuxfocus.org/cgi-bin/2ztxt">Convert to GutenPalm</a><br>or <a href="http://cgi.linuxfocus.org/cgi-bin/2pda">to PalmDoc</a></font>
</TD> </TR> </TABLE>
<!-- END PALM DOC -->
<!-- 2pdaIgnoreStop -->
<br>
<IMG src="../../common/images/EgonWillighagen.jpg" alt="[Photo of the Author]" height="102" width="79">
<BR>por <A href="mailto:egonw@linuxfocus.org">Egon Willighagen</A>
<BR><BR>
<I>Sobre o autor:</I><BR>
<P>Este ano receberá o seu mestrado e começará o seu doutoramento em
quimiometria. Gosta ainda imenso de basketball como gosta do LinuxFocus e
do Linux em geral.
<BR><i>Conteúdo</i>:
<UL>
<LI><A HREF="#206lfindex0">Introdução</A></LI>
<LI><A HREF="#206lfindex1">O Tipo de Definição do Documento (DTD)</A></LI>
<LI><A HREF="#206lfindex2"><database></A></LI>
<LI><A HREF="#206lfindex3"><themes></A></LI>
<LI><A HREF="#206lfindex4"><issues></A></LI>
<LI><A HREF="#206lfindex5"><persons></A></LI>
<LI><A HREF="#206lfindex6"><articles></A></LI>
<LI><A HREF="#206lfindex7">Gerar automaticamente as páginas web</A></LI>
<LI><A HREF="#206lfindex8">Localizando</A></LI>
<LI><A HREF="#206lfindex9">Planos Futuros</A></LI>
<LI><A HREF="http://cgi.linuxfocus.org/cgi-bin/lftalkback?anum=206&lang=pt">Forma de respostas para este artigo</A></LI>
</UL>
</TD></TR></TABLE>
<!-- HEAD OF THE ARTICLE -->
<br>
<H2>Usando o XML e o XSLT para construir o LinuxFocus.org(/Nederlands)</H2>
<IMG src="../../common/images/illustration206.jpg" alt="[Illustration]" hspace="10" width="102" height="38">
<!-- ABSTRACT OF THE ARTICLE -->
<P><i>Abstrato</i>:
<P>
Este artigo contém a apresentação dada no encontro de software livre
em Bordéus em Julho. Explica a base de dados XML utilizada para gerar
automaticamente o site da LinuxFocus.org(/Nederlands).
</P>
<HR size="2" noshade align="right"><BR>
<!-- BODY OF THE ARTICLE -->
<A NAME="206lfindex0"> </A>
<H2>Introdução</H2>
<p>O sistema utilizada no projecto da LinuxFocus para gerir a
documentação e a tradução consiste em diversos ficheiros ASCII, incluíndo
<i>resdb.txt</i>, o <i>issuedb.txt</i> e o <i>maindb.txt</i>.
Estes ficheiros têm um formato fixo e são utilizados para gerar as
páginas web. Contudo, são difíceis de estender e a sua natureza separada
dos dados torna difícil o manuseamento da informação para um artigo.</p>
<p>
A LinuxFocus não gerou muito conteúdo web automaticamente desde que
comecei a nova base de dados. Como editor na equipa alemã tinha todo o
interesse em ter os ficheiros index.html gerados na site dinamicamente.
Editar diversos ficheiros HTML cada vez que um novo artigo é traduzido
traduz um enorme esforço e era a causa de muitos links inacessíveis. Assim
sendo, pretendia um novo sistema ao qual podesse adicionar informação
facilmente e a partir do qual podesse gerar as páginas index para o site.
Eu comecei a trabalhar nisto algures no Verão de 2000. </P>
<p>A escolha do XML foi um pouco arbitrária. Foram feitas sugest�es
para construir uma base de dados relacional, mas tinha experiência no XML e
preferia um sistema baseado em ficheiros de texto. Nesse mesmo instante se
viu que um novo esquema de numeração seria mais útil, porque a base de
dados podia utilizar um tipo de ID em vez de dois ou três esquemas em uso.
O Guido Socher procedeu a toda a renumeração, o que foi um grande feito (o
meu muito obrigado!).</p>
<p>O Tipo de definição do Documento (DTD) já estava em desenvolvimento,
e já havia um pouco de conteúdo na base de dados para testar. Com o novo
esquema de numeração, o tempo estava correcto para carregar a base de dados
com conteúdo. Depois de ter adicionado cerca de 20 artigos, tornou-se mais
claro que isto era uma projecto enorme. Escrever scripts para utilizarem os
velhos ficheiros era possível, mas nem toda a informação que a nova base de
dados podia conter estava disponível, e como explicado a informação que
estava disponível estava distribuída por diversos ficheiros. Felizmente, o
Floris Lambrechts envolveu-se e tenho de lhe agradecer profundamente por
ter adicionado muito do conteúdo à base de dados. Sem a sua ajuda, o
sistema não seria o que é hoje.</P>
<p>Ao mesmo tempo do novo formato também veio a possibilidade de
adicionar nova informação. E ao longo do último foram adicionados novos
tipos de dados à base de dados. Nos princípios as extens�es eram uma tabela
de tradutores, editores e outras pessoas envolvidas no LinuxFocus e a
localização de ficheiros. A razão para a acrescentar a última tinha haver
os vários esquemas para os nomes dos ficheiros usados desde o princípio da
LinuxFocus. Durante a renumeração foram reduzidos para dois esquemas.
Alguns ficheiros utilizavam includes do lado do servidor e a extensão
.shtml, onde velhos artigos utilizavam as extens�es .html. A identificação
<file> pode ser usado para sobrescrever o utilizado por defeito. (O
utilizado por defeito correntemente utiliza um formato "article" + número
de artigo + ".shtml". Pode ainda incluir uma opção ".meta" no caso do
ficheiro estar no formato meta da LinuxFocus.) </p>
<p>Agora que a base de dados estava a atingir um nível crítico de
informação, eu finalmente consegui testar o software que estava a escrever.
As correntes folhas de estilo XSLT, não são as primeiras implementaç�es.
Foram precedidas pelo código Perl. Mas com o crescimento do tamanho da base
de dados a performance tornou-se importante. A primeira tentativa foi
simples mas não foi suficientemente boa. Mas antes de iniciar a explicação
das ferramentas. Explicarei o formato da base de dados.</p>
<A NAME="206lfindex1"> </A>
<H2>O Tipo de Definição do Documento (DTD)</H2>
<p>Primeiro de tudo, o XML, é uma sintaxe de especificação para
linguagens de markup. O XML define como o markup deve parecer. A sintaxe
descreve a sequência de caracteres permitidos num documento XML "bem
feito". Declara que um documento tem um elemento raíz e que um elemento
consiste numa identificação de inicio, conteúdo (texto, elementos filhos,
ou ambos) e uma identificação de fim. Estas identificaç�es consistem no
caracter "<" seguido do nome e no fim pelo caracter ">". Uma
identificação de fim tem de ter uma "/" mesmo em frente ao nome.
Identificaç�es vazias como as do HTML <br>, levam uma "/" depois do
nome. Uma identificação de inicio pode conter atributos, e estes mesmos têm
uma sintaxe específica. As identificaç�es XML assemelham-se a estas:
</p>
<pre>
<greeting>Hello, world!</greeting>
</pre>
para uma tag vazia
<pre>
<br/>
</pre>
<p>Além da sintaxe, as linguagens também contêm semântica. Isto
descreve como alguns elementos se relacionam entre si. A semântica do HTML
declara que a tag <body> deve estar contida no elemento <html>
e não o inverso. A semântica também descreve que o elemento <img> é
vazio, bem como o elemento <br>. Se estas semânticas são dadas numa
notação formal, podem ser tratadas por um programa e utilizadas para <i>validar</i> o
documento que utilize esta semânticas. Uma destas notaç�es formais é
chamada de Document Type Definition, ou sem sigla DTD (Definição Tipo de
Documento). Se um documento passa no processo de validação, chama-se um
documento <I>validada</I>. Você tem de ser cuidadoso com o XML, pois a sua
validação é muito rígida.
</p>
<p>Agora que sabemos o que é um DTD, demos uma vista de olhos na
<a href="../../common/src/article206/xml/dtd/lfdb.dtd">Base de Dados
XML da LinuxFocus</a>. Para as várias especificaç�es apresentaremos um
exemplo. Ao examinar estes exemplos obterá uma ideia da informação contida
na base de Dados XML da LinuxFocus.</P>
<A NAME="206lfindex2"> </A>
<H2><database></H2>
<p>O elemento raíz na base de dados XML da LinuxFocus, uma das suas
extens�es/localizaç�es, é o elemento <database>.
</p>
<pre>
<!ELEMENT database (themes?, persons?, issues?, articles?)>
</pre>
<p>Antes de mais, note que o "?" significa que o elemento filho pode
ocorrer nenhuma ou uma vez. Assim, a base de dados pode conter informação
acerca dos temas LinuxFocus, pessoas, ediç�es e artigos. Visto ser bastante
simples, seguirei para um exemplo mais interessante.</p>
<A NAME="206lfindex3"> </A>
<H2><themes></H2>
<p>Os Temas estão contidos no elemento <themes> o qual é um
elemento filho de <database>. Cada um dos temas tem um só ID, um
título e opcionalmente, uma imagem.</p>
<pre>
<!ELEMENT themes (theme+)>
<!ELEMENT theme (title*, desc?, img?)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT desc (#PCDATA)>
<!ELEMENT img (EMPTY)>
</pre>
<p>Alguns destes elementos tem de ter atributos. Estes são também dados
na DTD. Qualquer contexto textual é contido num elemento com o atributo
xml:lang. O valor do atributo pode ser qualquer um conforme o
<a href="http://www.everything2.org/index.pl?node_id=781276">ISO 3166 standard</a> para
o código dos países. Os exemplos são "en", "fr" e "nl". Quer o id e os
atributos xml:langand xml:lang são especificados na especificação XML original e
fazem parte da sintaxe do XML.</p>
<pre>
<!ATTLIST theme id ID #REQUIRED>
<!ATTLIST title xml:lang NMTOKEN #REQUIRED>
<!ATTLIST desc xml:lang NMTOKEN #REQUIRED>
<!ATTLIST img src CDATA #REQUIRED>
</pre>
<p>Um exemplo de uma base de dados pode parecer-se com isto:
</p>
<pre>
<database>
<themes>
<theme id="hw">
<title xml:lang="en">Hardware</title>
<img src="Hardware.jpg"/>
<theme>
<themes>
</database>
</pre>
<A NAME="206lfindex4"> </A>
<H2><issues></H2>
<p>As ediç�es estão contidas no elemento <issues>. Como os temas,
as ediç�es têm um único ID.
</p>
<pre>
<!ELEMENT issues (issue+)>
<!ELEMENT issue (title+, published?, file*)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT published (EMPTY)>
<!ELEMENT file (#PCDATA)>
</pre>
<p>O elemento <published> assinala as ediç�es publicadas. A
próxima edição e as pseudo ediç�es da mesma Linguagem para Inglês não têm este
elemento. O elemento <title> tem novamente o atributo @xml:lang. O
elemento <file> denota o directório onde a edição está localizada.
Não <i>deve</i> apontar para o index.html, porque é utilizado para
determinar a localização dos ficheiros.
<p>Um exemplo (note que usamos o atributo @code para ordenação):
<pre>
<issue id="ToBeWritten" code="999996">
<title xml:lang="en">Not yet written articles</title>
</issue>
<issue id="September2001" code="200109">
<title xml:lang="en">September2001</title>
</issue>
</pre>
<A NAME="206lfindex5"> </A>
<H2><persons></H2>
<p>Informação acerca dos autores e tradutores são armazenadas nos
elementos <person>. Cada pessoa deve ter um único ID.
<pre>
<!ELEMENT persons (person+)>
<!ELEMENT person
((name|email)*,(homepage|nickname|desc|team)*)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT homepage (#PCDATA)>
<!ELEMENT nickname (#PCDATA)>
<!ELEMENT desc (#PCDATA|%html-els;)*>
<!ELEMENT team EMPTY>
</pre>
<p>Cada pessoa pode ter a seguinte informação: um nome, um (ou mais) endereços de
correio electrónico, páginas pessoais e alcunhas. Se a pessoa também faz
parte de uma equipa de tradução, adicionamos o elemento <team>. Por
exemplo, a linha seguinte no elemento <person> quer dizer que o
Floris pertence à equipa alemã <team xml:lang="nl"/>. Por fim, cada
pessoa pode ter uma descrição, que podem conter vários links.
<p>Um exemplo:
<pre>
<person id="nl-ew">
<name>Egon Willighagen</name>
<email>egonw@linuxfocus.org</email>
<team xml:lang="nl"/>
</person>
</pre>
<A NAME="206lfindex6"> </A>
<H2><articles></H2>
<p>Os artigos, obviamente, a parte mais interessante da base de dados.
<pre>
<!ELEMENT articles (article+)>
<!ELEMENT article (title+,
(file|personref|abstract|issueref|themeref|
nometa|nohtml|translation|proofread)*)>
<!ELEMENT abstract (#PCDATA)>
<!ELEMENT nohtml EMPTY>
<!ELEMENT nometa EMPTY>
<!ELEMENT translation
(personref*, (reserved|finished|proofread)*)>
<!ELEMENT reserved (#PCDATA)>
<!ELEMENT finished (#PCDATA)>
<!ELEMENT proofread (personref*, (reserved|finished)*)>
<!ATTLIST article id ID #REQUIRED
xml:lang NMTOKEN #IMPLIED
type (article|coverpage)
"article"
next IDREF #IMPLIED
prev IDREF #IMPLIED>
<!ATTLIST file xml:lang NMTOKEN #REQUIRED
type (target|meta) "target">
<!ATTLIST translation from NMTOKEN #REQUIRED
to NMTOKEN #REQUIRED>
</pre>
<p>Cada artigo tem, pelo menos, um título; um para cada linguagem. O
elemento <file> pode ser usado para dar a localização do ficheiro do
artigo, quer para o formato META e a versão HTML (veja o exemplo abaixo).
No caso de a versão META ou HTML não estar disponível pode utilizar-se os
elementos opcionais <nohtml/> e <nometa/>. Cada artigo pode
conter um resumo. Tendo o resumo na base de dados quer dizer que podem ser
criadas páginas web indexadas a partir dele.
<p>O elemento <article> tem cinco atributos: o @ID requerido, o
atributo xml:lang opcional que denota a língua em que o artigo original foi
escrito, um atributo @type utilizado para páginas principais, os atributos
são utilizados na tradução sendo tratados como artigos. Por fim, mais dois
atributos opcionais, @next e @prev, que são utilizados para juntar os
artigos a partir de uma série.
<p>Um artigo está associado a uma edição e a um tema com os elementos <issueref> e <themeref>,
tendo ambos um atributo @href. O valor para este atributo deve ter um único
ID, o ID associado à edição ou tema.
<p>Um exemplo:
<pre>
<article id="article206" xml:lang="en">
<title xml:lang="en">Using XML and XSLT to build
LinuxFocus.org(/Nederlands)</title>
<personref href="nl-ew"/>
<issueref href="ToBeWritten"/>
<themeref href="appl"/>
<abstract xml:lang="en">
This article shows you how parts of the Dutch web site of LinuxFocus is
generated with XSLT tools from the XML database. It compares this with
the (very) much slower DOM tools in Perl.
</abstract>
</article>
</pre>
<p>Um elemento <article> localizado assemelha-se:
<pre>
<article id="52">
<title xml:lang="nl">Enlightenment</title>
<file xml:lang="nl">Nederlands/July1998/article52.html</file>
<translation from="en" to="nl">
<personref href="nl-tu"/>
<reserved>2000-09-06</reserved>
<finished>2000-10-04</finished>
<proofread>
<personref href="nl-fl"/>
<reserved>2000-10-04</reserved>
<finished>2000-10-04</finished>
</proofread>
</translation>
<abstract xml:lang="nl">
Enlightenment is een Linux window-manager met
uitgebreide mogelijkheden. Dit artikel bespreekt
ze, samen met de installatie en de instelling
van E. Dit alles is niet voor beginners daar
E op het moment nog in beta-stadium
verkeert.
</abstract>
</article>
</pre>
<p>Note que esta tradução é reservada para a tradução de uma dada data
em que é feito, mas também torna a leitura mais evidente. De qualquer
maneira a pessoa que fez o trabalho é linkada com os elementos <personref>.
<p>Para todos os elementos, o melhor tutorial é a própria base de dados actual:
<ul>
<li><a href="../../common/src/article206/xml/db/lfdb.en.xml">English Database</a>
<li><a href="../../common/src/article206/xml/db/lfdb.nl.xml">Dutch localisation</a>
</ul>
<A NAME="206lfindex7"> </A>
<H2>Gerar automaticamente as páginas web</H2>
<p>Uma das raz�es para criar este novo formato foi o de criar
automáticas os índices web a partir de. Agora que entendemos (?) o formato
da base de dados vejamos como podemos utilizá-lo para gerar algumas páginas.
<p>Primeiro, um pouco de história. A primeira implementação utilizou
módulos Perl como interface à base de dados. Apesar da interface
ser bastante limpa, a implementação era muito lenta. A informação estava contida num
contentor XML chamado Document Object Model (DOM). Muitas das
implementaç�es para DOM, são, contudo, muito lentas pelo menos mais lenta
que a alternativa Simple Application interface para XML (SAX).
<p>Mas se a tarefa é só para gerar páginas web uma terceira alternativa
parece ser melhor: <a href="http://www.w3.org/TR/xslt">XSLT</a>. É uma
linguagem de transformação baseada no XML. Muitos processadores XSLT existem
presentemente e muitas das linguagens de programação são suportadas. Há
alguns tempos atrás houve um artigo da LinuxFocus
<a href="../July2000/article156.shtml">XML::XSLT,
uma das implementaç�es Perl em XSLT</a>. Desde a publicação deste artigo,
muitas implementaç�es apareceram e há alguns que eu recomendo:
<ul>
<li><a href="http://www.gingerall.com/">Sablotron</a>
<li><a href="http://jakarta.apache.org/">Xalan</a>
<li><a href="http://xmlsoft.org/XSLT/">Xsltproc</a>
</ul>
Os exemplos utilizados no resto do artigo utilizaram o Sablotron.
<p>Um processador XSLT toma dois ficheiros para entrada. Um é a fonte XML
para transformar. O outro é uma folha de estilo XSLT que define a
transformação. Para gerar as páginas web as seguintes folhas de estilo XSLT
estão disponíveis:
<ul>
<li><a href="../../common/src/article206/xml/stylesheets/issues.xslt">issues.xslt</a><br>
Esta folha de estilo gera uma lista de ediç�es, com os seus respectivos artigos.
<li><a href="../../common/src/article206/xml/stylesheets/issuetoc.xslt">issuetoc.xsl</a><br>
Este gera uma tabela com o conteúdo de uma determinada edição.
<li><a href="../../common/src/article206/xml/stylesheets/issuetoc_full.xslt">issuetoc_full.xslt</a><br>
Como o anterior, mas com mais informação.
<li><a href="../../common/src/article206/xml/stylesheets/mainindex.xslt">mainindex.xslt</a><br>
Gera uma lista de artigos com informação do estado da tradução.
<li><a href="../../common/src/article206/xml/stylesheets/previssues.xslt">previssues.xslt</a><br>
Uma lista de todas as ediç�es publicadas.
<li><a href="../../common/src/article206/xml/stylesheets/recently_translated.xslt">recently_translated.xslt</a><br>
Os dez artigos traduzidos mais recentes.
<li><a href="../../common/src/article206/xml/stylesheets/rss.xslt">rss.xslt</a><br>
Gera um ficheiro RSS com os dez artigos traduzidos mais recentemente.
<li><a href="../../common/src/article206/xml/stylesheets/theme.xslt">theme.xslt</a><br>
Esta folha de estilo gera a página index para um determinado tema.
<li><a href="../../common/src/article206/xml/stylesheets/themes_index.xslt">themes_index.xslt</a><br>
Gera um índice com todos os temas.
<li><a href="../../common/src/article206/xml/stylesheets/vertaald.xslt">vertaald.xslt</a><br>
Mostra todos os artigos traduzidos numa determinada língua.
</ul>
Note que estas folhas de estilo não são as últimas vers�es. Contactem-me
ou um dos editores da equipas de tradução alemãs para obter as vers�es mais
actualizadas.
<p>Para gerar o mainindex.html, por exemplo, a equipa Alemã corre:
<pre>
sabcmd stylesheets/mainindex.xslt db/lfdb.nl.xml > ../mainindex.html
</pre>
<p>As folhas de estilo sabem onde se encontra a raiz da base de dados
Inglesa e só precisam da localização da base de dados como entrada. Algumas
folhas de estilo precisam de um parâmetro adicional:
<pre>
sabcmd stylesheets/theme.xslt db/lfdb.nl.xml '$theme=appl' > ../Themes/appl.html
</pre>
<p>O <a href="../../Nederlands/index.html">index.html</a> alemão é gerado
a partir da base de dados, mas utiliza uma configuração mais complexa. O
index.html é feito com o <a href="http://main.linuxfocus.org/~guido/dev/#lfpagecomposer">lfpagecomposer</a> do
Guido Socher a partir de um determinado número de ficheiros pré-processados de entrada. E
estes ficheiros pré-processados são gerados a partir de um número de
ficheiros .set tais como:
<pre>
<H2>Vorige nummers</H2>
<p>Dit zijn de uitgaven van LinuxFocus in het Nederlands:
<ul>
<!-- macro xslt previssues -->
</ul>
</pre>
<pre>
<H2>Recent vertaalde artikelen</H2>
< macro xslt recently_translated -->
<!-- macro xslt recently_translated -->
</pre>
Estes ficheiros são simplesmente fragmentos HTML com macros aplicadas à
base de dados local. O processo é feito com um programa chamado
<a href="../../common/src/article206/xml/bin/apply_stylesheets.pl">apply_stylesheets.pl</a>
que procura por comandos <!-- macro xslt [stylesheet] --> e
verifica a base de dados com este comando. Note que a extensão .xslt é
omitida. O nosso <a href="../../Nederlands/WorkSpace/Index/Makefile">Makefile</a> contém:
<pre>
%.shtml: %.pre
@echo "Making $*..."
@../../xml/bin/apply_stylesheets.pl $*.pre
</pre>
<p>Os ficheiros *.shtml resultantes são utilizados pela script
lfpagecomposer. AS folhas de estilo que são utilizadas para gerar o index.html são:
issuetoc.xslt, previssues.xslt e recently_translated.xslt.
<A NAME="206lfindex8"> </A>
<H2>Localizando</H2>
<p>Para utilizar este sistema noutras linguagens, precisa de fazer o
seguinte:
<ol>
<li>localizar a base de dados XML (como lfdb.nl.xml)
<li>localizar as folhas de estilo
</ol>
<p>O segundo passo é um pouco infeliz. Em princípio só o texto de saída é
que precisa de ser localizado, mas as folhas de estilo ainda não têm
propriedades de localização. Isto é possível, contudo, gostaria de o ver
implementado.
<p>Eu recomendo um editor XML conhecedor de DTD. No Emacs pode, por
exemplo utilizar o modo <a href="http://www.lysator.liu.se/projects/about_psgml.html">psgml</a>.
Isto permite-lhe-á validar o documento (com <a href="http://www.jclark.com/sp/nsgmls.htm">nsgmls</a>).
Isto ajuda imenso a evitar erros. No Emacs para ainda carregar no botão
direito para ver os elementos e atributos que pode inserir num determinado
sítio de um ficheiro XML. (Muito Obrigado a Jaime Villate pela sua
excelente palestra na <a href="http://lsm.abul.org/">conferência LSM</a>
em Bordéus este ano.)
<p>Uma outra grande ajuda é a localização alemã da base de dados XML. Se
encontrar problemas pode consultar este ficheiro. Apesar do conteúdo ser
maioritariamente alemão pode ver como os elementos estão organizados. No
caso de não ajudar, pode sempre enviar-me um <a href="mailto:egonw@linuxfocus.org">email</a>.
<p>Localizar as folhas de estilo é provavelmente um pouco meticuloso. O
texto está misturado com os comandos XSLT. Nos últimos não deve mexer (
a não ser que saiba o que está a fazer) para preservar a sua
funcionalidade. Eu planeio no futuro, ter as folhas de estilo localizadas,
o que significa que só precisa de editar um ficheiro que contem as suas
traduç�es sem comandos XSLT, mas isto ainda não está feito.
<A NAME="206lfindex9"> </A>
<H2>Planos Futuros</H2>
<p>OK, isto deve dar-lhe uma ajuda a começar. Muitas das coisas pode
copiar/colar dos ficheiros alemães. Todos os ficheiros são FDL e GPL. No
próximo ano estes são os planos com este sistema:
<ul>
<li>localizar os folhas de estilo
<li>adicionar novas folhas de estilo (para top_authors.html, top_translaters.html
e outras coisas que vemos como páginas web)
<li>possibilidade de uma interface para um demónio de base de dados
relacional, com o MySQL.
<li>integrar o sistema com outros utilitários da LinuxFocus (como o
getticket, etc)
</ul>
<!-- 2pdaIgnoreStart -->
<A NAME="talkback"> </a>
<h2>Forma de respostas para este artigo</h2>
Todo artigo tem sua própria página de respostas. Nesta página você pode enviar um comentário ou ver os comentários de outros leitores:
<center>
<table border="0" CELLSPACING="2" CELLPADDING="1">
<tr BGCOLOR="#C2C2C2"><td align=center>
<table border="3" CELLSPACING="2" CELLPADDING="1">
<tr BGCOLOR="#C2C2C2"><td align=center>
<A href="http://cgi.linuxfocus.org/cgi-bin/lftalkback?anum=206&lang=pt"><b> página de respostas </b></a>
</td></tr></table>
</td></tr></table>
</center>
<HR size="2" noshade>
<!-- ARTICLE FOOT -->
<CENTER><TABLE WIDTH="95%">
<TR><TD ALIGN=CENTER BGCOLOR="#9999AA">
<A HREF="../../common/lfteam.html">Páginas Web mantidas pelo time de Editores LinuxFocus</A>
<BR><FONT COLOR="#FFFFFF">© Egon Willighagen, <a href="../../common/copy.html">FDL</a> <BR><a href="http://www.linuxfocus.org">LinuxFocus.org</a></FONT>
<BR><a href="http://cgi.linuxfocus.org/cgi-bin/lfcomment?lang=pt&article=article206.shtml" target="_TOP">Clique aqui para reportar uma falha ou para enviar um comentário para LinuxFocus</A><BR></TD>
<TD BGCOLOR="#9999AA"><!-- TRANSLATION INFO -->
<font size=2>Informação sobre tradução:</font><TABLE>
<tr><td><font size=2>en</font></td>
<td><font size=2>-></font></td>
<td><font size=2>--</font></td>
<td><font size=2><a href="mailto:egonw@linuxfocus.org"><FONT COLOR="#FFFFFF">Egon Willighagen</FONT></a></font></td>
</tr>
<tr><td><font size=2>en</font></td>
<td><font size=2>-></font></td>
<td><font size=2>en</font></td>
<td><font size=2><a href="mailto:sherm_pbody@yahoo.com"><FONT COLOR="#FFFFFF">Lorne Bailey</FONT></a></font></td>
</tr>
<tr><td><font size=2>en</font></td>
<td><font size=2>-></font></td>
<td><font size=2>pt</font></td>
<td><font size=2><a href="mailto:bruno@linuxfocus.org"><FONT COLOR="#FFFFFF">Bruno Sousa</FONT></a></font></td>
</tr>
</TABLE></TD>
</TR></TABLE></CENTER>
<p><font size=1>2001-10-05, generated by lfparser version 2.17</font></p>
<!-- 2pdaIgnoreStop -->
</BODY>
</HTML>