A.3. Produzindo saídas formatadas

Esta seção assume que você já instalou os softwares listados no port textproc/docproj, seja via meta-port ou manualmente. Além disso, ela também assume que os seus softwares estão instalados em subdiretórios sob o /usr/local/, e que os diretórios nos quais os binários foram instalados, estão mapeados no seu PATH. Ajuste os paths conforme a necessidade do seu sistema.

A.3.1. Usando o Jade

Example A.3. Convertendo de DocBook para HTML (em um único grande arquivo)
% jade -V nochunks \  1
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 2
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \3
    -t sgml 4 file.xml > file.html 5

1

Especifique o parâmetro nochunks para as folhas de estilo, forçando que todos os outputs sejam escritos para a saída padrão (STDOUT) (utilizando as folhas de estilo do Norm Walsh).

2

Especifique os catálogos que o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo que contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DockBook. E o terceiro contém informações específicas para o Jade.

3

Especifique o caminho completo das folhas de estilo DSSSL as quais o Jade irá utilizar quando estiver processando o documento.

4

Instrua o Jade para realizar uma transformação de uma DTD para outra. Neste caso, a entrada será transformada de um DTD DocBook para um DTD HTML.

5

Especifique o arquivo que o Jade deve processar, e redirecione a saída para o arquivo .html desejado.


Example A.4. Convertendo de DocBook para HTML (vários arquivos pequenos)
% jade \
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 1
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \2
    -t sgml 3 file.xml 4

1

Especifique os catálogos os quais o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo o qual contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DocBook. O terceiro contém informações específicas para o Jade.

2

Especifique o caminho completo da folha de estilo DSSSL a qual o Jade irá utilizar quando estiver processando o documento.

3

Instrua o Jade para realizar a transformação de uma DTD para outra. Neste caso, a entrada será transformada de um DTD DocBook para um DTD HTML.

4

Especifique o arquivo que o Jade deve processar. A folha de estilo determina como os arquivos HTML individuais serão nomeados, inclusive o nome do arquivo raiz (é o arquivo que contém o inicio do documento).

Este exemplo pode continuar gerando apenas um único arquivo HTML, dependerá da estrutura do documento que você estiver processando e das regras da folha de estilo selecionada, para divisão do output.


Example A.5. Convertendo de DocBook para Postscript

O arquivo fonte SGML precisa ser convertido para um arquivo TeX.

% jade -V tex-backend \ 1
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 2
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \3
    -t tex 4 file.xml

1

Customize as folhas de estilo para utilizar as várias opções existentes, específicas para a produção de saídas TeX.

2

Especifique os catálogos os quais o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo o qual contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DocBook. O terceiro contém informações específicas para o Jade.

3

Especifique o caminho completo da folha de estilo DSSSL a qual o Jade irá utilizar quando estiver processando o documento.

4

Instrua o Jade para converter o output para TeX.

O arquivo .tex gerado, deve ser agora processado pelo tex, especificando o pacote de macros &jadetex.

% tex "&jadetex" file.tex

Você tem que executar o tex pelo menos três vezes. A primeira execução irá processar o documento, e determinar as áreas do documento que são referenciadas a partir de outras partes do documento, para uso na indexação, etc.

Não fique alarmado se você visualizar mensagens de alertas tais como LaTeX Warning: Reference `136' on page 5 undefined on input line 728. neste momento.

A segunda execução reprocessa o documento agora que certas peças de informação são conhecidas (tais como o número de páginas do documento). Isto permite indexar as entradas e estabelecer as outras referências cruzadas.

A terceira execução irá realizar a limpeza final necessária no arquivo

O output deste estágio será um arquivo.dvi.

Finalmente, execute o dvips para converter o arquivo .dvi para o formato Postscript.

% dvips -o file.ps file.dvi

Example A.6. Convertendo de DocBook para PDF

A primeira parte deste processo é idêntica ao realizado quando se converte de DocBook para Postscript, utilizando a mesma linha de comando para o jade (Example A.5, “Convertendo de DocBook para Postscript”).

Quando o arquivo .tex já tiver sido gerado, você deve executar o pdfTeX utilizando o pacote de macros &pdfjadetex.

% pdftex "&pdfjadetex" file.tex

De novo, execute este comando três vezes.

Ele irá gerar um arquivo .pdf, o qual não necessita de nenhum processamento adicional.


Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/

Para perguntas sobre FreeBSD, leia a documentação antes de contatar <questions@FreeBSD.org>.

Para perguntas sobre esta documentação, envie e-mail para <doc@FreeBSD.org>.