1. Introduction

1.1. A propos de ce document

La derni�re version de ce mini-howto peut �tre trouv�e sur :

http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/

Reportez-vous � la section Annexe A pour des informations sur les copyright, licence et d�charge de responsabilit� relatifs � ce document.

1.2. Qu'est-ce que DocBook�?

DocBook est une D�finition de Type de Documents (DTD - Document Type Definition) en Langage Standard de Balisage G�n�ralis� (SGML - Standard Generalized Markup Language), qui d�finit un ensemble de balises pour des documents litt�raux, et qui fonctionne comme le langage HTML utilis� habituellement sur le Web.

DocBook est destin� � la r�daction de livres et d'articles. Comme tel, il fournit des balises (appel�es encore marqueurs) pens�es sp�cifiquement pour d�crire des livres et des articles. Par exemple, les balises DocBook <book> et <article> sont utilis�es pour cr�er les livres et les articles. Dans ces documents, des balises <chapter>, <sect1>, et <para> seront utilis�es. Les fichiers SGML DocBook sont stock�s dans des fichiers texte avec un suffixe .sgml ou .gml

Lors de son traitement, un unique fichier SGML DocBook peut produire des fichiers HTML, PDF, PS, TXT ou d'autres formats de publication papier ou �lectronique. Le traitement est r�gi par des feuilles de style (stylesheets) qui peuvent g�n�rer automatiquement une table des mati�res, la num�rotation des pages, la num�rotation des chapitres et des sections, et bien d'autres possibilit�s.

DocBook est destin� �galement � l'�criture de pages de manuel unix, en utilisant la balise <refentry>.

1.3. Aper�u rapide

Voici une description br�ve des paquetages que nous utiliserons dans les prochaines sections :

OpenJade. OpenJade est un processeur DSSSL (Document Style Semantics and Specification Language - Langage de sp�cification et S�mantique de pr�sentation de document) pour documents SGML (Standard Generalized Markup Language - Langage Standard de Balisage G�n�ralis�). Il transforme des fichiers source SGML DocBook en fichiers HTML, TEX, RTF, TXT et autres formats. OpenJade est l'outil essentiel pour convertir un fichier DocBook dans d'autres formats. Le format de sortie TEX est utilis� surtout comme format interm�diaire pour obtenir des fichiers DVI, PDF et PS par des macros TeX et des convertisseurs DVI.

La DTD SGML DocBook. Les fichiers DTD (D�finition de Type de Document) sont des fichiers SGML qui d�finissent le langage DocBook. L'ensemble des balises valides et leurs r�gles d'utilisation y sont d�finis. OpenJade a besoin d'acc�der aux fichiers DTD des documents qu'il doit traiter.

ISO8879 ENTITY SGML. Les entit�s d�finissent la repr�sentation des caract�res sp�ciaux qui n'ont pas de touche clavier associ�e ou qui ont une signification particuli�re en SGML. Des exemples connus en HTML sont "&eacute;" pour "�","&amp;" pour "&" et "&gt;" pour ">".

DSSSL DocBook. Les fichiers DSSSL (Document Style Semantics and Specification Language) pour une DTD particuli�re, en l'occurrence DocBook, sp�cifient comment convertir le document DocBook en fichiers au format HTML, RTF, TEX, etc.

SgmlTools-lite. SgmlTools est une interface pour lancer OpenJade et les macros TeX jadetex et pdfjadetex qui en font partie. La conversion d'un fichier DocBook en format PS ou PDF est un traitement en deux ou trois �tapes. OpenJade cr�e un fichier TEX qu'utilise jadetex pour produire un DVI, et pdfjadetex pour produire un document PDF. Un fichier PS s'obtient en transformant le fichier DVI avec dvips. Les scripts SgmlTools fournissent une commande unique pour ces t�ches.

HTMLdoc. HTMLdoc est un programme libre pour convertir des fichiers HTML en documents PDF ou PS.

SGMLSpm and docbook2X. Ces deux outils sont � utiliser pour g�n�rer des pages de manuel. SGMLSpm est une biblioth�que modulaire Perl5 pour traiter les r�sultats du travail de onsgmls, un programme inclus dans OpenJade. SGMLSpm comprend une application appel�e sgmlspl permettant d'utiliser la biblioth�que SGMLSpm. Sgmlspl n�cessite des fichiers de sp�cification, disponibles sur de nombreux sites internet, pour chaque type de document � transformer. DocBook2X est un paquetage qui fournit des fichiers de sp�cification pour transformer des fichiers DocBook en pages de manuel.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:30