Dans cette section, nous localiserons et téléchargerons les logiciels sur Internet.
OpenJade est un logiciel aux sources libres (open-source), activement maintenu, basé sur le paquetage Jade de James Clark. Téléchargez la dernière version stable (1.3 ?) sur :
http://openjade.sourceforge.net/
OpenJade inclut également le paquetage OpenSP et les macros TeX jadetex et pdfjadetex pour convertir les fichiers en DVI et en PDF. Les programmes suivants sont installés par ce paquetage :
openjade
onsgmls
osgmlnorm
ospam
ospent
osx
Afin de pouvoir utiliser jadetex et pdfjadetex pour créer du DVI, PS et PDF, vous devez avoir une installation de TeX qui fonctionne. Si vous n'avez pas TeX, cherchez dans votre distribution Linux le paquetage à installer. Sinon, vous pouvez télécharger la distribution TeX teTeX depuis :
Les DTD DocBook SGML et XML sont maintenues par un comité technique à Oasis-Open.ORG. Téléchargez la dernière version (et les versions anciennes dont vous pourriez avoir besoin) de DocBook SGML sur :
Les entités définissent la représentation de caractères spéciaux ou de symboles qui ne peuvent être saisis au clavier, y compris les symboles mathématiques et les entités qui peuvent vous être familières avec le HTML. Ces fichiers d'entités doivent être installés pour avoir une configuration correcte.
Ressources à OASIS :
ISOEnts.zip n'a besoin que d'être décompacté dans le répertoire de la DTD DocBook et de rien d'autre, mais les fichiers dans isoENT-tar.gz restent nécessaires. Les fichiers de isoENT-tar.gz doivent donc également être décompactés dans le répertoire de la DTD DocBook (cf. Section 3 pour les détails). Mais ces fichiers possèdent un suffixe ".ent" qui doit être renommé en ".gml". Vous pouvez le faire manuellement, ou bien vous pouvez télécharger et utiliser le fichier ci-dessous, préparé par l'auteur, qui contient les fichiers des deux archives ISOEnts.zip et isoENT-tar.gz :
http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz
Des fichiers DSSSL (Document Style Semantics and Specification Language) pour la DTD DocBook (SGML/XML) sont fournis par Norman Walsh. Ces fichiers, appelés Modular DocBook Stylesheets (feuilles de style modulaires pour DocBook), disent à OpenJade comment convertir votre fichier SGML DocBook en un autre format. Un fichier dsl décrit par exemple la correspondance entre une balise d'une DTD et une autre balise d'une autre DTD, ou d'autres conversions programmées, écrites dans un langage appelé Core Expression Language, qui est dérivé du Scheme. Le paquetage DSSSL DocBook et sa documentation peuvent être téléchargés sur le site de Norman Walsh :
http://nwalsh.com/docbook/dsssl/
NdT : Norman Walsh a depuis ouvert un projet sur SourceForge, qui doit maintenant être considéré comme le principal lieu de téléchargement :
Le Projet de Documentation Linux a créé un fichier de personnalisation des feuilles de style qui active des options de présentation intéressantes. Il peut être téléchargé sur :
Sgmltools est une interface pour OpenJade, jadetex, pdfjadetex, dvips, et d'autres programmes. Sgmltools offre une commande unique pour générer tous les formats possibles avec ces outils. La dernière version, v1.3 à l'heure où nous écrivons ces lignes, peut être téléchargée sur :
http://sourceforge.net/projects/sgmltools-lite/
Ce paquetage est optionnel, mais rend parfois les choses plus faciles.
HTMLdoc est un programme libre pour convertir des sites Web en documents au format PDF (Portable Document Format) ou PS (Postscript). Concernant le format PDF, il crée une arborescence de signets correspondant aux sections, rendant la navigation plus facile. HTMLdoc et pdfjadetex créent tous deux des documents PDF, mais avec des rendus légèrement différents. Comparez les deux pour voir lequel produit le meilleur résultat pour un fichier DocBook particulier. Reportez-vous à la Section 2.8 pour connaître les adresses de téléchargement.
DocBook2X nécessite Perl5 et le module Perl SGMLS.pm, disponible sur le CPAN. SGMLS.pm fournit des bibliothèques et un programme appelé sgmlspl qui convertissent les fichiers DocBook en d'autres formats en utilisant des fichiers de spécification. Ces fichiers de spécification sont des scripts Perl qui donnent le mécanisme de traduction dans un format particulier.
Les fichiers ci-dessous sont donnés dans leur dernière version au moment de la rédaction de ce document :
openjade-1.3.tar.gz . OpenJade, version 1.3.
docbk41.zip . DocBook SGML DTD, version 4.1.
iso8879-entities.tar.gz . Entités ISO 8879 SGML. Cet unique fichier est plus pratique à utiliser. Vous pouvez sinon télécharger les deux autres fichiers et changer les suffixes des fichiers en .gml.
db160.zip & db160d.zip . Feuilles de style Modulaires DSSSL DocBook, version 1.60, et leur documentation.
sgmltools-lite-3.0.2.tar.gz . Sgmltools-lite version 3.0.2. Je rappelle que c'est un paquetage optionnel.
ftp://ftp.easysw.com/pub/htmldoc/1.8.9/ . HTMLdod 1.8.6. Des versions compilées sont disponibles avec le code source. Choisissez en fonction de votre plate-forme. Les versions compilées sont recommandées. Pour obtenir une version compilée, vous pouvez la télécharger directement par FTP sur les liens ci-dessous. Si le choix n'est pas évident, consultez le site Internet de EasySw : http://www.easysw.com/software.html
http://www.cpan.org/authors/id/DMEGG/SGMLSpm-1.03ii.tar.gz . SGMLS.pm 1.03ii sur CPAN. (sgmlspl)
http://download.sourceforge.net/docbook2x/docbook2X-0.6.0.tar.gz . DocBook2X 0.6.0 (fournit docbook2man-spec.pl à utiliser avec sgmlspl vu précédemment)