3. Installer les paquetages
3.1. Installer OpenJade
3.1.1. OpenJade
Voici ce qui est n�cessaire de faire, mais pensez � lire les fichiers fournis avec OpenJade pour voir s'il n'y a pas des param�tres que vous pourriez personnaliser pour votre plate-forme�:
cd /usr/local tar -xvzf ~/openjade-1.3.tar.gz cd openjade-1.3 ./configure --prefix=/usr/local/openjade-1.3 make make install # Une fois install�s, les fichiers objets etc. # peuvent �tre supprim�s make clean |
3.1.2. jadetex & pdfjadetex
Comme mentionn�, jadetex et pdfjadetex sont des macros TeX fournies avec OpenJade. Elles sont plac�es dans /usr/local/openjade-3.1/dsssl. Un guide pratique sur l'installation de ces macros a �t� �crit par Frank Atanassow Christoph et peut �tre trouv� sur�:
ftp://ftp.dante.de/tex-archive/macros/jadetex/install.pdf
http://www.comptechnews.com/~reaster/installjadetex.pdf
Les sections suivantes sont adapt�es des instructions trouv�es dans install.pdf�:
3.1.2.1. Cr�er hugelatex (si n�cessaire)
Les macros TeX jadetex et pdfjadetex n�cessitent plus de m�moire qu'une utilisation habituelle de TeX. Souvent, la configuration par d�faut des limites d'utilisation m�moire de TeX n'est pas adapt�e. Le fichier de configuration de TeX, texmf.cnf, peut �tre modifi� et les valeurs des variables correspondant � la limite d'utilisation de la m�moire par TeX peuvent �tre augment�es. Cependant, plut�t que de simplement �diter le fichier texmf.cnf pour permettre � TeX d'utiliser plus de m�moire en toutes circonstances, un contexte TeX sp�cifique peut �tre cr��, appel� hugelatex. Si hugelatex est d�j� configur� sur votre syst�me, vous pouvez sauter cette section (which hugelatex vous donne l'emplacement de la macro si elle est configur�e).
V�rifiez qu'une version fonctionnelle de TeX est install�e et trouvez son emplacement�:
bash$ which tex /usr/share/texmf/bin/tex bash$ kpsewhich -expand-var='$TEXMFMAIN' /usr/share/texmf bash$ |
L'utilisation de which devrait trouver l'emplacement du programme TeX. Si TeX n'est pas trouv�, vous aurez peut-�tre � installer teTeX puis � revenir ici. kpsewhich est un utilitaire fourni avec teTeX qui donne, si tout va bien, le r�pertoire TeX principal.
Maintenant que le r�pertoire de texmf est connu, l'installation peut d�buter�:
cd /usr/share/texmf cd tex/latex cp -r config config-temp cd config-temp tex -ini -progname=hugelatex latex.ini mv latex.fmt hugelatex.fmt mv hugelatex.fmt /usr/share/texmf/web2c cd .. rm -r config-temp cd /usr/share/texmf/bin ln -s tex hugelatex cd /usr/share/texmf/web2c |
% hugelatex settings extra_mem_top.hugelatex = 8000000 extra_mem_bot.hugelatex = 8000000 hash_extra.hugelatex = 15000 pool_size.hugelatex = 5000000 string_vacancies.hugelatex = 45000 max_strings.hugelatex = 55000 pool_free.hugelatex = 47500 nest_size.hugelatex = 500 param_size.hugelatex = 1500 save_size.hugelatex = 5000 stack_size.hugelatex = 15000 % jadetex extra_mem_top.jadetex = 8000000 extra_mem_bot.jadetex = 8000000 hash_extra.jadetex = 20000 pool_size.jadetex = 5000000 string_vacancies.jadetex = 45000 max_strings.jadetex = 55000 pool_free.jadetex = 47500 nest_size.jadetex = 500 param_size.jadetex = 1500 save_size.jadetex = 5000 stack_size.jadetex = 15000 % pdfjadetex extra_mem_top.pdfjadetex = 8000000 extra_mem_bot.pdfjadetex = 8000000 hash_extra.pdfjadetex = 20000 pool_size.pdfjadetex = 5000000 string_vacancies.pdfjadetex = 45000 max_strings.pdfjadetex = 55000 pool_free.pdfjadetex = 47500 nest_size.pdfjadetex = 500 param_size.pdfjadetex = 1500 save_size.pdfjadetex = 5000 stack_size.pdfjadetex = 15000 |
Notez que la mise en place de hugelatex n'est prise en compte qu'apr�s avoir lanc� le programme texhash
root# texhash texhash: Updating /usr/share/texmf/ls-R... texhash: Updating /var/cache/fonts/ls-R... texhash: Done. root# |
3.1.2.2. jadetex & pdfjadetex
La configuration de jadetex et de pdfjadetex est similaire � celle de hugelatex.
cd /usr/local/openjade-1.3/dsssl make -f Makefile.jadetex install # make cr�e et installe les fichiers .fmt # dans /usr/share/texmf/web2c # Cr�ation des liens symboliques... cd /usr/share/texmf/bin ln -s tex jadetex ln -s pdftex pdfjadetex # Enfin, lancement de texhash. root# texhash |
Jadetex utilise un fichier tex g�n�r� par OpenJade pour cr�er un DVI. De m�me pdfjadetex utilise le fichier tex g�n�r� par OpenJade et cr�e un PDF. Le programme dvips utilise le fichier DVI et cr�e un fichier postscript (PS).
3.2. La DTD SGML DocBook
3.2.1. D�compresser la DTD SGML DocBook
La DTD DocBook n'est constitu�e que de fichiers texte SGML, aussi il n'y a rien � compiler. D�compressez uniquement ces fichiers dans un endroit choisi.
# DocBook DTD V4.1 plac� dans # /usr/local/share/sgml/docbook/4.1 cd /usr/local/share mkdir sgml; cd sgml mkdir docbook; cd docbook mkdir 4.1; cd 4.1 unzip -a ~/docbk41.zip |
Il y a des diff�rences entre les diverses versions de la DTD DocBook. Les fichiers xxxissues.txt documentent ces questions. Des balises ont �t� ajout�es, retir�es ou renomm�es entre les versions.
Si vous devez utiliser la DTD DocBook dans sa version 3.1, elle est disponible au m�me endroit o� la version 4.1 se t�l�charge. La version 3.1 est beaucoup utilis�e, aussi c'est une bonne id�e de la t�l�charger et de la placer dans un sous-r�pertoire 3.1/.
3.2.2. D�compresser les entit�s ISO8879
Allez dans le r�pertoire de chaque version install�e de la DTD DocBook, et d�compressez-y le fichier iso8879-entities.tar.gz�:
cd /usr/local/share/sgml/docbook/4.1 tar -xvzf ~/iso8879-entities.tar.gz |
# Si n�cessaire... cd /usr/local/share/sgml/docbook/4.1 ln -s docbook.cat catalog |
3.3. Les DSSSL DocBook
L'installation des feuilles de style DSSSL DocBook, qui sont compatibles avec toutes les versions de DocBook, ne n�cessitent que de les d�compresser dans un r�pertoire appropri�:
cd /usr/local/share/sgml mkdir dsssl; cd dsssl unzip -a ~/db160.zip # Si vous avez t�l�charg� ldp.dsl le fichier de personnalisation # des feuilles de style, copiez-le dans... cd docbook cp ~/ldp.dsl html cp ~/ldp.dsl print # ces deux r�pertoires |
3.4. sgmltools-lite
Si vous le voulez, vous pouvez installer sgmltools-lite, bien que ce soit optionnel. Son installation est standard�:
cd /usr/src tar -xvzf ~/sgmltools-lite-3.0.2.tar.gz cd sgmltools-lite-3.0.2 ./configure make install |
Pour que le script sgmltools fonctionne il vous faudra l'�diter pour corriger le chemin d'acc�s � OpenJade : vi `which sgmltools`. Consultez sa documentation pour en savoir plus.
3.5. htmldoc
3.5.1. binaires
Pr�f�rez le t�l�chargement de la version compil�e de htmldoc pour votre plate-forme. L'installation est on ne peut plus simple�: d�compressez le paquetage et lancez le setup. Lisez la documentation fournie pour plus d'information.
3.5.2. sources
Si vous avez t�l�charg� les sources, vous aurez �galement besoin de la biblioth�que Fast Light Tool Kit, pour r�ussir l'�dition de liens.
L'installation est de la famille autoconf. Lancez simplement le script ./configure, puis make et make install. Si tout va bien, le programme sera install� dans /usr/bin.
3.5.3. ldp_print
Le programme htmldoc a quelques soucis pour traiter les fichiers HTML d'OpenJade. Par exemple, les puces des listes ne sont pas rendues correctement, et les zones ombr�es ne le sont pas toujours.
Pour contourner ce probl�me, un script perl (ldp_print) est disponible sur LinuxDoc.org. Le script traite un fichier HTML unique cr�� par OpenJade et lance htmldoc dessus, pour produire des fichiers aux formats PDF et PS corrects.
 | Conseil |
|---|---|
Adoptez-le�! |
tar -xvzf ldp_print.tar.gz cd ldp_print # Copiez la biblioth�que dans le chemin # de recherche de Perl. cp fix_print_html.lib /usr/lib/perl5/site_perl cp ldp_print /usr/local/bin |
3.6. DocBook2X et SGMLS.pm (sgmlspl)
3.6.1. sgmlspl
Pour que les fichiers de sp�cifications de DocBook2X soient utiles, le module SGMLS.pm pour Perl5 doit �tre install�, en supposant que Perl5 est d�j� install�. L'installation de ce module n'est pas autant automatis�e que le sont les installations de la plupart des modules Perl. Il utilise un fichier Makefile qui doit �tre �dit� avant de lancer make.
cd /usr/src
tar -xvzf ~/SGMLSpm-1.03ii.tar.gz
cd SGMLSpm
# Editez Makefile
vi Makefile
# Adaptez la section du Makefile relative
# aux options utilisateurs afin qu'elles
# refl�tent votre syst�me.
# Exemple :
# PERL = /usr/bin/perl
# BINDIR = /usr/local/bin
# PERL5DIR = /usr/lib/perl5/site_perl
# MODULEDIR = ${PERL5DIR}/SGMLS
# SPECDIR = ${PERL5DIR}
# HTMLDIR= /usr/local/apache/htdocs
make install
|
3.6.2. docbook2X (docbook2man-spec.pl)
DocBook2X ne contient aucun programme � compiler ou installer, mais des scripts que vous voudrez certainement examiner, aussi, tout ce qu'il y a � faire est de d�compresser le paquetage quelque part�:
cd /usr/local/share/sgml tar -xvzf ~/docbook2X-0.6.0.tar.gz cd docbook2X |
patch docbook2man-spec.pl docbook2man-spec.pl.patch |
<refentry>.
3.7. $SGML_CATALOG_FILES
La variable d'environnement SGML_CATALOG_FILES est utilis�e par OpenJade (ainsi que d'autres logiciels SGML) pour localiser les DTD et les feuilles de style DSSSL. Les logiciels SGML ne peuvent pas travailler sans trouver ces fichiers, lesquels ont �t� plac�s dans de nombreux r�pertoires. Au point o� nous en sommes de notre configuration, voici comment SGML_CATALOG_FILES peut �tre positionn�e dans /etc/profile�:
###################################################################################### # SGML DocBook - openjade sgmltools-lite JADE_HOME=/usr/local/openjade-1.3 SGML_SHARE=/usr/local/share/sgml PATH=$PATH:$JADE_HOME/bin # feuilles de style DSSSL # Modular DocBook Stylesheets de Norman Walsh SGML_CATALOG_FILES=$SGML_SHARE/dsssl/docbook/catalog # Feuilles de style OpenJade SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$JADE_HOME/dsssl/catalog # Feuilles de style sgmltools-lite SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/stylesheets/sgmltools/sgmltools.cat # DTD DocBook # D'OASIS-Open.org SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.1/catalog SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/4.1/catalog # Ces anciennes versions ont �t� install�es par # doctools-1.2 d'XFree86.org SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/2.4.1/catalog SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.0/catalog # Catalogues sgmltools-lite pour LinuxDoc SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/dtd/sgmltools/catalog export JADE_HOME SGML_SHARE PATH SGML_CATALOG_FILES ###################################################################################### |
L'installation est termin�e�! Dans la section suivante, nous testerons notre configuration et convertirons quelques fichiers DocBook.