Beyond Linux® From Scratch (Edição System V) - Versão 12.1

Capítulo 48. Standard Generalized Markup Language (SGML)

docbook-dsssl-1.79

Introdução ao DocBook DSSSL Stylesheets

O pacote DocBook DSSSL Stylesheets contém folhas de estilo DSSSL. Elas são usadas pelo OpenJade ou outras ferramentas para transformar arquivos SGML e XML do DocBook.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.1.

Informação do Pacote

Transferências Adicionais

Documentação e dados de teste

Dependências do DocBook DSSSL Stylesheets

Exigidas

sgml-common-0.6.3

Exigidas (para testar o conjunto de ferramentas SGML do DocBook)

docbook-3.1-dtd, docbook-4.5-dtd, OpenSP-1.5.2 e OpenJade-1.3.2

Instalação do DocBook DSSSL Stylesheets

Se você baixou a documentação, execute: 

tar -xf ../docbook-dsssl-doc-1.79.tar.bz2 --strip-components=1

Instale o DocBook DSSSL Stylesheets executando os seguintes comandos como o(a) usuário(a) root: 

install -v -m755 bin/collateindex.pl /usr/bin                      &&
install -v -m644 bin/collateindex.pl.1 /usr/share/man/man1         &&
install -v -d -m755 /usr/share/sgml/docbook/dsssl-stylesheets-1.79 &&
cp -v -R * /usr/share/sgml/docbook/dsssl-stylesheets-1.79          &&

install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-1.79/catalog         &&

install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-1.79/common/catalog  &&

install-catalog --add /etc/sgml/sgml-docbook.cat              \
    /etc/sgml/dsssl-docbook-stylesheets.cat

Explicações do Comando

Os comandos acima criam um conjunto de comandos sequenciais de instalação para esse pacote.

Testando o Conjunto de Ferramentas SGML do DocBook (opcional)

Os comandos a seguir realizarão os testes necessários para confirmar se a tua cadeia de ferramentas instaladas SGML do DocBook produzirá os resultados desejados. Você precisa ter os pacotes docbook-3.1-dtd, docbook-4.5-dtd, OpenSP-1.5.2 e OpenJade-1.3.2 instalados e realizar os testes como o(a) usuário(a) root.

Todos os testes serão realizados a partir do diretório /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata como o(a) usuário(a) root: 

cd /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata

O primeiro teste não deveria produzir nenhuma saída para stdout (tua tela) e criaria um arquivo chamado jtest.rtf no diretório atual: 

openjade -t rtf -d jtest.dsl jtest.sgm

O próximo teste deveria retornar somente a seguinte linha para stdout: onsgmls:I: "OpenSP" version "1.5.2" 

onsgmls -sv test.sgm

O próximo teste não deveria produzir nenhuma saída para stdout e criaria um arquivo chamado test.rtf no diretório atual: 

openjade -t rtf \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/print/docbook.dsl \
    test.sgm

O último teste não deveria produzir saída para stdout e criaria um arquivo chamado c1.htm no diretório atual: 

openjade -t sgml \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/html/docbook.dsl \
    test.sgm

Finalmente, limpe: 

rm jtest.rtf test.rtf c1.htm

Conteúdo

Aplicativo Instalado: collateindex.pl
Bibliotecas Instaladas: Nenhum(a)
Arquivos Instalados: Folhas de estilo DSSSL
Diretório Instalado: /usr/share/sgml/docbook/dsssl-stylesheets-1.79

Descrições Curtas

collateindex.pl

é um conjunto de comandos sequenciais do Perl que cria um índice DocBook a partir de dados brutos do índice