Au-delà de Linux® From Scratch (édition System V) - Version 9.1

Chapitre 49. Langage de balises extensible (Extensible Markup Language : XML)

docbook-xsl-nons-1.79.2

Introduction à DocBook XSL Stylesheets

Le paquet DocBook XSL Stylesheets contient les feuilles de style XSL. Elles sont utiles pour effectuer des transformations sur des fichiers DocBook XML.

Ce paquet est connu pour se construire correctement sur une plateforme LFS-9.1.

Informations sur le paquet

Téléchargements supplémentaires

Documentation facultative

Dépendances de DocBook XSL Stylesheets

Recommandées (à l'exécution)

libxml2-2.9.10

Facultatives (toutes à l'exécution)

apache-ant-1.10.7 (pour produire les documents « webhelp »), libxslt-1.1.34 (ou tout autre moteur XSLT), pour traiter des documents Docbook - les modules Python2 libxml2 et libxslt peuvent être utilisés, Python-2.7.17 (à l'exécution), Ruby-2.7.0 (pour utiliser les feuilles de style « epub »), Zip-3.0 (pour produire les documents « epub3 »), et Saxon6 et Xerces2 Java (utilisés avec apache-ant-1.10.7 pour produire les documents « webhelp »)

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/docbook-xsl

Installation de DocBook XSL Stylesheets

Tout d'abord, corrigez un problème qui cause des dépassements de pile pendant la récursion : 

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

Si vous avez téléchargé l'archive de documentation facultative, décompressez-la avec la commande suivante : 

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

BLFS n'installe pas les paquets requis pour lancer la suite de tests et fournir des résultats significatifs.

Installez DocBook XSL Stylesheets en lançant les commandes suivantes en tant qu'utilisateur 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

Si vous avez téléchargé l'archive tar de la documentation facultative, installez la documentation en lançant la commande suivante en tant qu'utilisateur root : 

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

Configuration de DocBook XSL Stylesheets

Fichiers de configuration

/etc/xml/catalog

Informations sur la configuration

[Note]

Note

Si vous installez la version actuelle de docbook-xsl-nons à la place d'une version précédente de docbook-xsl, supprimez les anciennes entrées de réécriture dans le catalogue en tant qu'utilisateur root : 

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

Créez (ou ajoutez) et peuplez le fichier de catalogue XML en utilisant les commandes suivantes en tant qu'utilisateur root : 

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" \
           "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" \
           "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" \
           "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" \
           "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

À l'occasion, il se peut que vous éprouviez le besoin d'installer d'autres versions des feuilles de style XSL vu que certains projets se réfèrent à une version spécifique. Un exemple est BLFS-6.0, qui exigeaient la version 1.67.2. Dans ces instances vous devriez installer une autre version requise dans son propre répertoire versionné et créer des entrées de catalogue comme suit (remplacez <version> par le numéro de version désiré) : 

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

Contenu

Fichiers installées: /usr/share/xml/docbook/xsl-stylesheets-1.79.2/*/*.xsl
Répertoires installés: /usr/share/xml/docbook/xsl-stylesheets-1.79.2 et /usr/share/doc/docbook-xsl-1.79.2

Descriptions courtes

Feuilles de style XSL

utilisées pour effectuer des transformations sur des fichiers XML.

Last updated on 2020-02-15 17:54:30 +0100