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�: