12-docbook-vu.doc

[pic]
|PRÉFACE |
|Ce guide s'adresse à toute personne désireuse de se familiariser avec DocBook, mais |
|ne possédant pas nécessairement un haut niveau en informatique. Que vous soyez |
|étudiant ou tout simplement curieux à propos de ce langage, ce guide vous propose |
|une présentation simple et concise du langage, suivi d'une approche thématique |
|abordant les différentes caractéristiques, avantages et inconvénient de ce dernier. |
|Enfin, une approche pratique sera abordée en fin de [ce] guide, vous proposant des |
|conseils pour la création d'un document DocBook. |
|Bonne lecture ! |
|[pic][pic][pic] |
| |
| |
| |
| |
| |
| |
|Mise en page (Table des matières, Index) et illustrations : Alice Somsouk |
|Rédaction : |
|Préface et troisième partie : Alice Somsouk |
|Première partie, glossaire et annexes : David Buxton, |
|Deuxième partie, glossaire, et annexes : René Gilles Étienne |
| |
| |
| |
|TABLE DES MATIÈRES |
|INTRODUCTION GÉNÉRALE 5 |
|DOCBOOK : QU'EST-CE QUE C'EST ? 7 |
|DocBook : Pourquoi ? 8 |
|DocBook : Historique ? 9 |
|DocBook : Quelle version ? 10 |
|APPROCHE THÉMATIQUE 11 |
|UN LANGAGE SIMPLE 13 |
|Les éléments de ce langage 13 |
|Un label installé sur de solides bases 15 |
|La DTD (Document Type definition) 15 |
|Le style 16 |
|Un code aux principes éprouvés 19 |
|Un balisage flexible... 19 |
|... d'où découle une grande productivité 19 |
|La méthode en question 20 |
|Un format exportable 21 |
|Bémols 22 |
|CRÉATION D'UN DOCUMENT DOCBOOK 23 |
|XML 26 |
|Rédaction du XML 26 |
|Validation de la DTD 32 |
|Introduction aux feuilles XSL 33 |
|Structure d'un document XSL 33 |
|Association d'une feuille XSL à un document XML 33 |
| |
| |
|TABLE DES MATIÈRES |
|CRÉATION D'UN DOCUMENT DOCBOOK (suite) 23 |
|DOCBOOK 36 |
|Rédaction 36 |
|Les différentes balises de structures 36 |
|Eléments racines 36 |
|Eléments de structure 37 |
|Eléments d'information 38 |
|Eléments d'avertissement 39 |
|Les balises pour insérer des images 41 |
|Les balises servant à la création d'entités 41 |
|Transformation 43 |
|ANNEXES 44 |
|ANNEXES 51 |
|INDEX 53 |
|GLOSSAIRE 56 |
|SOURCES 58 |
|NOTES 59 |
| |
| |
|INTRODUCTION GÉNÉRALE |
|GUIDE D'INTRODUCTION À DOCBOOK |1 ÈRE PARTIE |
| | |
| |DOCBOOK VOUS FAIT PEUR ? TOUT AU LONG DE CE |
| |GUIDE, NOUS VOUS FERONS DÉCOUVRIR LES PRINCIPALES|
| |UTILISATIONS PRATIQUES DE CE PROGRAMME, COMMENT |
| |S'EN SERVIR DE MANIÈRE EFFICACE ET AVEC UN |
| |MINIMUM DE DIFFICULTÉ. |
| INTRODUCTION GÉNÉRALE - SOMMAIRE |
| | | |
| |DocBook, qu'est-ce que c'est ? |
| |DocBook, pourquoi ? |
| |DocBook, historique ? |
| |DocBook, quelle version ? |
| | |

INTRODUCTION GÉNÉRALE - 1 e PARTIE
|DocBook : Qu'est-ce que c'est ? |
| |DocBook est un langage qui vous permet de publier votre document |
| |texte en plusieurs formats sans avoir à rédiger votre document à |
| |nouveau dans chaque langage. |
| |DocBook fait référence à un langage de balisage défini à partir de |
| |SGML / XML (Métalangage de balisage issu comme le HTML du SGML). |
| |Globalement, DocBook est un ensemble de balises typiques qui |
| |ressemblent néanmoins sur le principe aux balises HTML (Langage de |
| |programmation des pages web) ce qui donnera peut-être une impression |
| |familière aux plus érudits d'entre nous. Mais attention, DocBook est |
| |un peu plus complexe que HTML tout en vous offrant cependant plus de |
| |fonctionnalités et de possibilités de sortie.(?) |
| |Langage de balisage : ensemble de données qui sont destinées à être |
| |interprétées par un processeur et non pas par l'utilisateur. Il est |
| |composé de balises, unités sémantiques qui servent à structurer le |
| |texte |
| |SGML : (Standard Generalized Markup) langage standard de balisage |
| |généralisé et reconnu comme une norme de l'Organisation |
| |internationale de normalisation (ISO), depuis 1986. Tout document |
| |SGML est associé à une DTD (Définition du type de document). SGML |
| |est à l'origine de HTML et de XML.) |
| | |

INTRODUCTION GÉNÉRALE - 1 e PARTIE
|DocBook : Pourquoi ? |
| |DocBook vous offre une variété d'avantages significatifs. S'il n'en |
| |fallait retenir que six : |
| |DocBook XML est un format pérenne car librement développable et |
| |utilisable |
| |DocBook XML est un format accessible pour peu que l'on soi