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'affiche que les différences entre les balises. C'est utile pour comparer des documents préparés pour différents langages.

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

Informations sur le paquet

Téléchargement supplémentaire

Dépendances de DocBook-utils

Requises

OpenJade-1.3.2, DocBook DSSSL Stylesheets-1.79, et DocBook SGML-DTD-3.1

Dépendances facultatives (au moment de l'exécution seulement)

SGMLSpm-1.1 (pour la conversion de man et texinfo), et Lynx-2.8.8rel.2 ou Links-2.9 ou w3m-0.5.3 (pour la conversion en texte ASCII)

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

Installation de DocBook-utils

Installez DocBook-utils en lançant 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'est pas fourni avec une 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.20 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 appelé par de nombreux process db2*, afin que la version actuelle de Grep ne le rejette pas.

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

docdir=/usr/share/doc: Cette option est placée dans 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
Installed Symlinks: 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 comfortables.

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.

Last updated on : 2012-07-28 23:45:43 +020