Au-delà de Linux® From Scratch (édition systemd) - Version 13.1

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

docbook-xml-4.5

Introduction à DocBook-4.5 XML DTD

Le paquet DocBook-4.5 XML DTD-4.5 contient des définitions de type de documents pour vérifier les fichiers de données XML avec un ensemble de règles DocBook. Elles sont utiles pour structurer des livres et de la documentation logicielle en un standard qui vous permet d'utiliser des transformations déjà écrites pour ce standard.

[Note]

Note

Les versions de développement de BLFS peuvent ne pas arriver à contruire ou à exécuter certains paquets correctement si LFS ou des dépendances ont été mises à jour depuis la dernière version stable des livres.

Informations sur le paquet

  • Téléchargement (HTTP) : https://archive.docbook.org/xml/4.5/docbook-xml-4.5.zip

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 du téléchargement : 03083e288e87a7e829e437358da7ef9e

  • Taille du téléchargement : 96 Ko

  • Estimation de l'espace disque requis : 1,2 Mo

  • Estimation du temps de construction : moins de 0,1 SBU

Dépendances de DocBook-4.5 XML DTD

Requises

libxml2-2.15.3

Installation de DocBook-4.5 XML DTD

[Note]

Note

La source du paquet est distribuée au format zip et vous pouvez utiliser la commande python3 -m zipfile -e <name>.zip <nom> pour l'extraire. Le dernier paramètre, <nom>, s'assure d'extraire le contenu de l'archive zip dans le répertoire nommé <nom> (il sera automatiquement créé s'il n'existe pas déjà), pour faciliter la suppression des fichiers sources après l'installation du paquet.

Installez DocBook XML DTD en exécutant les commandes suivantes en tant qu'utilisateur root : 

install -v -d -m755 /usr/share/xml/docbook/xml-dtd-4.5 &&
install -v -d -m755 /etc/xml                           &&
cp -v -af --no-preserve=ownership                      \
    catalog.xml docbook.cat *.dtd ent/ *.mod           \
    /usr/share/xml/docbook/xml-dtd-4.5

Le fichier catalog.xml embarqué gère les identifiants publics formels du DTD XML de DocBook-4.5. Nous avons besoin d'ajouter des entrées dans son installation pour prendre en charge les URL des DTD également, en exécutant les commandes suivantes en tant qu'utilisation root : 

xmlcatalog --noout --add "rewriteSystem"     \
    "http://www.oasis-open.org/docbook/xml/4.5" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml &&

xmlcatalog --noout --add "rewriteURI"        \
    "http://www.oasis-open.org/docbook/xml/4.5" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml

Créez (ou mettez à jour) et peuplez le fichier catalogue /etc/xml/catalog en exécutant les commandes suivantes en tant qu'utilisateur root : 

if [ ! -e /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &&

xmlcatalog --noout --add "delegatePublic"                   \
    "-//OASIS//ENTITIES DocBook XML"                        \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegatePublic"                   \
    "-//OASIS//DTD DocBook XML"                             \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegateSystem"                   \
    "http://www.oasis-open.org/docbook/"                    \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegateURI"                      \
    "http://www.oasis-open.org/docbook/"                    \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog

Configuration de DocBook-4.5 XML DTD

Fichiers de configuration

/etc/xml/catalog

Informations sur la configuration

[Attention]

Attention

divers paquets de BLFS demandent DocBook XML DTD version 4.x avant V4.5, donc vous devez effectuer l'étape suivante pour que ces paquets construisent correctement.

L'installation ci-dessus crée les fichiers et met à jour les catalogues. Pour utiliser DocBook XML DTD V4.5 quand une version 4.x est demandée dans l'identifiant système, vous devez ajouter des entrées supplémentaires dans les fichiers catalogues. Si vous avez déjà installé l'un des DocBook XML DTD référencés ci-dessous sur votre système, supprimez ces entrées de la commande for (lancez la commande en tant qu'utilisateur root) : 

for DTDVERSION in 4.1.2 4.2 4.3 4.4
do
  xmlcatalog --noout --add "public"                                  \
    "-//OASIS//DTD DocBook XML V$DTDVERSION//EN"                     \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml

  xmlcatalog --noout --add "rewriteSystem"              \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5"         \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
  
  xmlcatalog --noout --add "rewriteURI"                 \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5"         \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
done

Contenu

Programmes installés: None
Bibliothèques installées: None
Fichiers installés: fichiers DTD, MOD et ENT
Répertoires installés: /etc/xml et /usr/share/xml/docbook/xml-dtd-4.5

Descriptions courtes

fichiers DTD

contient une définition de type de documents qui définie les types d'éléments et les listes d'attributs qui peuvent être utilisés dans les fichiers XML correspondants

fichiers MOD

contient les composants des définitions de type de documents qui sont récupérés dans les fichiers DTD

fichiers ENT

contient les listes des entités nommées permises en HTML