2. Télécharger les paquetages

2.1. OpenJade

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 :

http://www.tug.org/tetex/

2.2. La DTD SGML DocBook

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 :

http://www.oasis-open.org/docbook/sgml/index.html

2.3. ISO8879 ENTITY SGML

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 :

  • http://www.oasis-open.org/cover/topics.html#entities

  • http://www.oasis-open.org/cover/ISOEnts.zip

  • http://www.oasis-open.org/cover/isoENT-tar.gz

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

2.4. DSSSL DocBook

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 :

http://docbook.sourceforge.net/

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 :

http://www.linuxdoc.org/authors/tools/ldp.dsl

2.5. Sgmltools-lite

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://www.sgmltools.org/

http://sourceforge.net/projects/sgmltools-lite/

Ce paquetage est optionnel, mais rend parfois les choses plus faciles.

2.6. HTMLdoc

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.

2.7. DocBook2X

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.

http://www.cpan.org/

http://docbook2x.sourceforge.net/

2.8. Liens pour téléchargement direct

Les fichiers ci-dessous sont donnés dans leur dernière version au moment de la rédaction de ce document :