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

Chapitre 48. Standard Generalized Markup Language (SGML) (langage standard de balises généralisées)

DocBook-utils-0.6.14

Introduction à DocBook-utils

Le paquet DocBook-utils est un ensemble d'outils scriptés utilisés pour convertir et analyser des documents SGML en général, et des fichiers DocBook en particulier. Les scripts sont utilisés pour convertir à partir de DocBook ou d'autres formats SGML en formats de fichier « classiques » comme HTML, man, info, RTF et bien davantage. Il existe aussi un outil pour comparer deux fichiers SGML et n'afficher que les différences entre les balises. C'est utile pour comparer des documents préparés pour différentes langues.

Ce paquet est connu pour pouvoir être construit et fonctionner correctement avec une plateform 12.2.

Informations sur le paquet

Téléchargements supplémentaires

Dépendances de DocBook-utils

Requises

OpenJade-1.3.2, docbook-dsssl-1.79 et docbook-3.1-dtd

Recommandées (Dépendances à l'exécution seulement)

SGMLSpm-1.1 (pour convertir en man et texinfo) et Lynx-2.9.2 ou Links-2.30 ou W3m (pour convertir en texte ASCII)

Installation de DocBook-utils

Installez DocBook-utils en exécutant les commandes suivantes : 

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch &&
sed -i 's:/html::' doc/HTML/Makefile.in                &&

./configure --prefix=/usr --mandir=/usr/share/man      &&
make

Ce paquet n'a pas de suite de tests.

Maintenant, en tant qu'utilisateur root : 

make docdir=/usr/share/doc install

De nombreux paquets utilisent nom différent pour les scripts DocBook-utils. Si vous souhaitez créer ces noms alternatifs, utilisez la commande suivante en tant qu'utilisateur root : 

for doctype in html ps dvi man pdf rtf tex texi txt
do
    ln -svf docbook2$doctype /usr/bin/db2$doctype
done
[Note]

Note

Le script jw utilise la commande which pour localiser les outils requis. Vous devez installer Which-2.21 avant d'essayer d'utiliser un des programmes DocBook-utils.

Explication des commandes

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch : Ce correctif corrige la syntaxe dans le script jw (Jade Wrapper) qui est au cœur de nombreux processus db2*, afin que la version actuelle de Grep ne le rejette pas.

sed -i 's:/html::' doc/HTML/Makefile.in : Cette commande change le répertoire d'installation des documents HTML.

docdir=/usr/share/doc : Cette option est placée sur la ligne make install car elle n'est pas reconnue par configure.

Contenu

Programmes installés: docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw et sgmldiff
Bibliothèques installées: Aucune
Répertoires installés: /usr/share/doc/docbook-utils-0.6.14 et /usr/share/sgml/docbook/utils-0.6.14
Liens symboliques installés: db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi et db2txt

Descriptions courtes

docbook2*

sont de simples scripts enveloppes d'une ligne vers jw. Ils sont fournis pour donner des noms faciles à mémoriser utilisés pour convertir des fichiers DocBook ou SGML ou autres dans leurs formats respectifs

db2*

sont des liens symboliques pointant vers des commandes docbook2* respectivement nommés, créés pour satisfaire certaines utilisations par le programme de ces tests

jw

est un script utilisé pour convertir des fichiers DocBook ou autres SGML en divers formats de sortie. Il cache la plupart de la complexité de OpenJade et ajoute des fonctionnalités confortables

sgmldiff

est utilisé pour comparer deux fichiers SGML et ne retourner que les différences dans les balises. C'est surtout utile pour comparer des fichiers qui devraient être identiques, sauf pour les différences de langue dans le contenu