docbook-xsl-nons-1.79.2

Introdução ao DocBook XSL Stylesheets

O pacote DocBook XSL Stylesheets contém folhas de estilo XSL. Elas são úteis para realizar transformações em arquivos XML do DocBook.

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

Informação do Pacote

Transferências Adicionais

Documentação opcional

Dependências do DocBook XSL Stylesheets

Recomendadas (em tempo de execução)

Opcionais (todas usadas em tempo de execução)

apache-ant-1.10.14 (para produzir documentos webhelp), libxslt-1.1.42 (ou qualquer outro processador XSLT), para processar documentos Docbook, Ruby-3.3.4 (para utilizar as folhas de estilo epub), Zip-3.0 (para produzir documentos epub3) e Saxon6 e Xerces2 Java (usado com apache-ant-1.10.14 para produzir documentos webhelp)

Instalação do DocBook XSL Stylesheets

Primeiro, corrija um problema que causa estouros de pilha ao fazer recursão:

patch -Np1 -i ../docbook-xsl-nons-1.79.2-stack_fix-1.patch

Se você baixou o tarball opcional da documentação, desempacote-o com o seguinte comando:

tar -xf ../docbook-xsl-doc-1.79.2.tar.bz2 --strip-components=1

O BLFS não instala os pacotes exigidos para executar a suíte de teste e fornecer resultados significativos.

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

install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

cp -v -R VERSION assembly common eclipse epub epub3 extensions fo        \
         highlighting html htmlhelp images javahelp lib manpages params  \
         profiling roundtrip slides template tests tools webhelp website \
         xhtml xhtml-1_1 xhtml5                                          \
    /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/VERSION.xsl &&

install -v -m644 -D README \
                    /usr/share/doc/docbook-xsl-nons-1.79.2/README.txt &&
install -v -m644    RELEASE-NOTES* NEWS* \
                    /usr/share/doc/docbook-xsl-nons-1.79.2

Se você baixou o tarball de documentação opcional, instale a documentação emitindo o seguinte comando como o(a) usuário(a) root:

cp -v -R doc/* /usr/share/doc/docbook-xsl-nons-1.79.2

Configurando Folhas de Estilo XSL do DocBook

Arquivos de Configuração

/etc/xml/catalog

Informação de Configuração

[Nota]

Nota

Se você estiver instalando a versão atual do docbook-xsl-nons sobre uma versão anterior do docbook-xsl, então remova as entradas reescritas antigas no catálogo como o(a) usuário(a) root:

sed -i '/rewrite/d' /etc/xml/catalog

Crie (ou anexe) e povoe o arquivo de catálogo XML usando os seguintes comandos como o(a) usuário(a) root (ambas as formas http e https são usadas porque o fluxo de desenvolvimento tem ambas colocadas na documentação deles(as)):

if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &&
if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog

Ocasionalmente, você pode achar necessário instalar outras versões das folhas de estilo XSL, pois alguns projetos referenciam uma versão específica. Um exemplo é o BLFS-6.0, que exigia a versão 1.67.2. Nesses casos você deveria instalar qualquer outra versão exigida no próprio diretório versionado dela e criar entradas de catálogo como segue (substitua o número desejado de versão por <versão>):

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/<version>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/<version>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
    /etc/xml/catalog

Conteúdo

Arquivos Instalados: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/*/*.xsl
Diretórios Instalados: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 e /usr/share/doc/docbook-xsl-nons-1.79.2

Descrições Curtas

Folhas de Estilo XSL

são usados para realizar transformações em arquivos XML