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.

[Nota]

Nota

Esse pacote é conhecido por construir e funcionar adequadamente usando-se uma plataforma LFS 13.0.

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.15 (para produzir documentos webhelp), libxslt-1.1.45 (ou qualquer outro processador XSLT), para processar documentos Docbook, Ruby-4.0.1 (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.15 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 -svf 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

Crie (ou posponha) 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)):

(set -e

 install -v -d -m755 /etc/xml
 [ -e /etc/xml/catalog ] || xmlcatalog --noout --create /etc/xml/catalog

 for uri in http{,s}://cdn.docbook.org/release/xsl-nons/{1.79.2,current} \
            http://docbook.sourceforge.net/release/xsl/current; do
   for rewrite in System URI; do
     xmlcatalog --noout --add "rewrite$rewrite"             \
       "$uri"                                               \
       "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
       /etc/xml/catalog
   done
 done)

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