Pessoal,<br><br>conforme solicitação do Marcelo e de outros membros, tentarei explicar o processo de compilação dos fontes DocBook para PDF e HTML. Este processo é descrito no arquivo README que pode ser acessado pelas URLs abaixo:<br>

<ul><li><a href="http://svn.red-bean.com/svnbook/tags/en-1.4-final/src/en/README" target="_blank">http://svn.red-bean.com/svnbook/tags/en-1.4-final/src/en/README</a></li><li><a href="http://svnbook-pt-br.googlecode.com/svn/trunk/README" target="_blank">http://svnbook-pt-br.googlecode.com/svn/trunk/README</a></li>

</ul>Lembrando que esse processo só poderá ser executado em sistemas Unix, Linux ou em Windows utilizando o Cygwin. Aqui eu não entro em detalhes na utilização do Cygwin, apenas considero que você esteja utilizando uma distribuição Linux na qual você saiba instalar programas, bibliotecas e executar comandos simples, além de rodar scripts Make e Python.<br>
<br>Contudo, ao ler essa descrição no README verifiquei que temos alguns detalhes a serem ajustados pelo fato de nosso projeto ter como "trunk" o que seria o diretório "/src/pt_BR" no projeto original. Dessa forma, precisamos fazer o checkout de "/src/tools" no mesmo diretório em que foi feito o checkout do "trunk" de nosso projeto. Assim teríamos duas cópias de trabalho lado a lado, uma do "trunk" do nosso projeto no "<a href="http://googlecode.com">googlecode.com</a>" e outra do "src/tools" do projeto original no "<a href="http://svn.red-bean.com">svn.red-bean.com</a>" (conforme descrito logo abaixo).<br>

<br>Então, temos que criar uma cópia de trabalho do diretório que o pessoal da versão original criaram contendo os scripts para o processo de compilação do DocBook para PDF e HTML. Então teríamos o comando abaixo utilizando o cliente svn, a ser executado no diretório pai do diretório que foi realizado o checkout do nosso projeto:<br>
<ul><li>
svn co <a href="http://svn.red-bean.com/svnbook/tags/en-1.4-final/src/tools/" target="_blank">http://svn.red-bean.com/svnbook/tags/en-1.4-final/src/tools/</a> tools<br></li></ul>Este criará um diretório "tools" com os script de compilação. A minha versão está na revisão 3355 e produziu a seguinte estrutura de diretórios:<br>
<br><span style="font-family: courier new,monospace;">  + pt_BR</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">  + tools</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">    + bin</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">    + dtd</span><br><br>Nesta estrutura temos que "pt_BR" seja o diretório em que está a sua cópia de trabalho do projeto de tradução. Já "tools" é o diretório criado com o checkout que acabou de ser efetuado. Em "tools" temos uma série de arquivos, entre os quais estão script Make, Python e alguns arquivos XSL, além de dois diretórios: "bin" e "dtd".<br>
<br>Agora precisamos baixar dois recursos: docbook-xsl e fop.<br><br>O docbook-xsl pode ser encontrado no endereço abaixo:<br><ul><li><a href="http://sourceforge.net/project/showfiles.php?group_id=21935">http://sourceforge.net/project/showfiles.php?group_id=21935</a></li>
</ul>Lembrando, baixe o pacote docbook-xsl, e nas compilações que estou mantendo no projeto, utilizo a versão <a href="http://1.74.0.">1.74.0.</a> Descompacte o pacote abaixado dentro do diretório "tools", e será produzido um novo diretório "docbook-xsl-X.YY.Z", então renomeie esse diretório para somente "xsl". Certo, agora temos os arquivos XSL de suporte para a conversão de DocBook para outros formatos. Agora precisamos da biblioteca "libxslt", proceda para a instalar em seu sistema.<br>
<br>Com estes procedimentos já estamos capazes de produzir as compilações em HTML. Para isso, entre no diretório raiz da tradução para pt-BR e execute o seguinte comando:<br><br><span style="font-family: courier new,monospace;">$ make all-html</span><br>
<br>Este comando produzirá duas versões em HTML, uma contendo todo o livro em um único arquivo HTML, e outro contendo o livro em vários arquivos HTML, separados por capítulo.<br><br>Nosso próximo passo é baixar o FOP para que possamos compilar o livro para PDF. Este pode ser encontrado no endereço abaixo:<br style="font-family: arial,helvetica,sans-serif;">
<ul><li><a href="http://xmlgraphics.apache.org/fop/download.html">http://xmlgraphics.apache.org/fop/download.html</a></li></ul>Então, baixe a versão binária 0.95, a qual é a mesma que estou utilizando nas compilações mantidas no projeto. Agora, descompacte o arquivo baixado também no diretório "tools", e será produzido ó diretório "fop-0.95", então renomeie o diretório para somente "fop". Pronto, agora temos todos os recursos necessários para produzir também o livro em PDF.<br>
<br>Contudo, necessitamos ajustar alguns detalhes em alguns arquivos. Primeiro, abra o arquivo "fo-stylesheet.xsl" em seu editor de textos preferido e altere a linha 8, onde você encontra <span style="font-family: courier new,monospace;">fop</span> para <span style="font-family: courier new,monospace;">fop1</span>, então teremos ela com o seguinte texto:<br>
<br><font style="font-family: courier new,monospace;" face="courier new,monospace"></font><span style="font-family: courier new,monospace;"><xsl:param name="fop1.extensions" select="1" /></span><br>
<br>Esta alteração modifica o processador das extensões que são utilizadas pelos fontes do livro em DocBook. Agora abra o arquivo "Makefile.base-vars" em seu editor e altere a linha 30 para que ele fique da seguinte forma:<br>
<br><span style="font-family: courier new,monospace;">SVNVERSION = svnversion -n</span><br><br>Esta alteração inibe a produção de um caractere de nova linha ao recuperar a revisão em que se encontra o projeto de tradução. Neste mesmo arquivo vá até a linha 73 e remova o comentário no início da linha, assim teremos:<br>
<br><span style="font-family: courier new,monospace;">FO_XSLTPROC_OPTS = --stringparam paper.type A4</span><br><br>Já esta alteração passa um parâmetro para a produção do FO->PDF para que seja utilizado o tamanho A4 ao produzir as páginas do livro. Pronto, agora podemos produzir a compilação em PDF do livro, executando o seguinte comando no diretório raiz da tradução:<br>
<br><font face="courier new,monospace">$ make pdf</font><br><br>Com este comando será produzido o livro em PDF. Agora, vale uma observação para que antes de produzir qualquer compilação, execute os seguintes comandos:<br>
<br><font face="courier new,monospace">$ make clean<br>$ make valid<br></font><br>O primeiro comando limpará qualquer das compilações que tenham sido produzidas anteriormente. Já o segundo comando verificará se os arquivos XML do projeto, e as respectivas alterações submetidas por nós, são válidas dentro do formato DocBook. Dessa forma, caso algum erro tenha sido comedito nos arquivos XML, como por exemplo, esquecer de fechar uma tag, ou incluir uma tag inválida, estes serão detectados e relatados. Assim, as compilações só serão produzidas caso nenhum aviso de erro seja relatado pelo comando de validação dos fontes.<br>
<br>Acredito que eu tenha abordado todos os detalhes que envolveram as configurações para que o processo de compilação produza o livro nas versões em HTML e PDF. Se algum erro cometido, ou ainda se tiver algum problema no processo, poste seu problema na lista e algum de nossos membros poderá te auxiliar, e até mesmo eu que todos os dias leio as mensagens postadas na lista.<br>
<br>Espero que as orientações acima sejam suficientes.<br><br>Abraços!<br style="font-family: courier new,monospace;"><br><br>Att,<br>Bruno Leonardo Gonçalves<br>