DocBook, TEI et les vocabulaires documentaires dérivés SGML appartiennent à une même histoire technique, celle du marquage documentaire pensé pour durer. Leur point commun tient dans une structure de document stable, capable de séparer le contenu de sa présentation.
En 2026, ces modèles documentaires restent utiles dès qu’un projet doit publier, archiver et réutiliser ses textes sans réécriture coûteuse. SGML a ouvert la voie, puis xml dérivé de SGML a rendu les échanges plus fluides, ce qui mène naturellement à A retenir :
A retenir :
- Structure stable pour archives, éditions et diffusion multiformat
- DocBook pour documentation technique, TEI pour textes enrichis
- Normalisation, interopérabilité, pérennité des vocabulaires documentaires
- Présentation séparée, contenu réutilisable, flux éditoriaux maîtrisés
- Gouvernance OASIS, communauté active, héritage SGML durable
SGML, matrice historique des vocabulaires documentaires dérivés
Le passage précédent conduit à la racine commune : SGML a fourni une grammaire robuste pour décrire des documents complexes. Sa logique ne disait pas comment afficher un texte, mais comment décrire ses parties, ses relations et ses contraintes.
Normes SGML et logique de structuration
Cette logique expliquait pourquoi SGML servait aux documents longs, hiérarchisés et réutilisables. Selon OASIS, les évolutions du standard ont ensuite porté cette idée vers des schémas plus lisibles par les outils modernes.
Dans une équipe éditoriale, cela change tout : un chapitre devient un module, une note devient un élément, et chaque fragment circule sans perdre son sens. Le bénéfice apparaît vite pour l’édition technique, les corpus savants et les catalogues documentaires.
À retenir de cette base historique :
- Déclaration explicite de la structure logique
- Séparation nette entre contenu et apparence
- Réemploi facilité des fragments éditoriaux
- Longévité des corpus face aux changements d’outils
Caractéristique
SGML
XML
Effet éditorial
Définition
Cadre général
Cadre simplifié
Adoption plus aisée
Lisibilité outil
Plus complexe
Plus directe
Chaînes plus légères
Présentation
Externalisée
Externalisée
Réutilisation accrue
Usage courant
Normes SGML historiques
Écosystèmes contemporains
Interopérabilité renforcée
Du SGML au xml dérivé de SGML
Le second mouvement a consisté à simplifier l’écosystème sans abandonner l’idée initiale. Selon la documentation OASIS de DocBook, la version 4.1 a ouvert la voie au passage XML, puis les schémas Relax NG et W3C XML Schema ont consolidé cette évolution.
Ce déplacement a rendu les flux plus compatibles avec les chaînes éditoriales actuelles. Une petite équipe peut ainsi produire un même contenu en HTML, PDF ou EPUB, sans réécrire la source à chaque livraison.
Ce socle historique prépare la comparaison entre deux familles très proches, mais pas interchangeables, que l’on confond encore trop souvent.
DocBook et TEI : deux réponses complémentaires du marquage documentaire
Une fois la base SGML comprise, la différence entre DocBook et TEI devient plus nette. Les deux relèvent des vocabulaires documentaires, mais ils n’adressent pas les mêmes usages ni les mêmes habitudes éditoriales.
DocBook pour la documentation technique
DocBook a été conçu en 1991 par HAL Computer Systems et O’Reilly & Associates, puis repris par OASIS en 1998. Selon Wikipédia, il s’est imposé dans la documentation logicielle, notamment dans l’open source, parce qu’il structure clairement livres, articles et références.
Son intérêt est concret : une même source peut alimenter des guides utilisateurs, des pages de manuel et des versions web. Dans une entreprise comme Boeing, cette logique réduit les écarts entre documentation interne et diffusion publique.
À retenir pour DocBook :
- Documentation technique lisible par machines et humains
- Réemploi fort des mêmes sources
- Sorties multiples sans réécriture complète
- Communauté open source très active
Aspect
DocBook
TEI
Usage courant
Objet principal
Documentation technique
Textes et corpus
Édition spécialisée
Public visé
Équipes produit
Humanités numériques
Communautés expertes
Sorties
HTML, PDF, EPUB
XML, diffusion savante
Publication multicanal
Gouvernance
OASIS
TEI Consortium
Stabilité normative
TEI pour les textes, langues et corpus savants
TEI répond à une autre exigence : décrire finement des textes, leurs langues, leurs variantes et leurs contextes. Selon les TEI Guidelines, l’encodage doit tenir compte des écritures, des caractères et des identifiants de langue, y compris dans des corpus plurilingues.
Cette précision convient aux bibliothèques virtuelles, aux éditions critiques et aux corpus historiques. Là où DocBook organise surtout la documentation, TEI accompagne l’analyse philologique, la transcription et l’annotation savante.
Les points de friction restent souvent les mêmes :
- Choix entre fidélité textuelle et lisibilité immédiate
- Gestion des langues et des écritures multiples
- Normalisation des caractères pour l’échange
- Documentation locale des règles d’encodage
Le contraste entre ces deux familles devient plus clair lorsqu’on observe la gouvernance, les outils et la maintenance concrète des schémas.
Gouvernance, outils et maintenance des modèles documentaires
Après les usages, la question décisive porte sur la durabilité. Un vocabulaire documentaire n’a de valeur que s’il reste maintenu, documenté et lisible par plusieurs générations d’outils.
OASIS, communauté et contrôle des évolutions
Selon OASIS, DocBook est maintenu par un comité technique ouvert, appuyé par une communauté visible et diversifiée. Cette gouvernance limite la dépendance à un éditeur unique et sécurise les évolutions du schéma.
Dans la pratique, cela rassure les équipes qui archivèrent des milliers de pages. Elles savent que le modèle ne dépend pas d’un logiciel éphémère, mais d’un cadre partagé et documenté.
À retenir sur la gouvernance :
- Maintenance collective et règles publiées
- Moindre dépendance aux logiciels propriétaires
- Évolution contrôlée des schémas
- Meilleure prévisibilité pour l’archivage
Cette stabilité prépare le travail opérationnel, là où les équipes choisissent des outils, des feuilles de style et des formats de sortie.
Chaînes de transformation, du fichier source au rendu final
Le passage technique est désormais bien balisé : DocBook XML s’appuie sur des feuilles XSL, souvent vers XSL-FO, puis vers PDF ou HTML. Selon la documentation DocBook, les anciennes chaînes SGML utilisaient plutôt DSSSL, Jade et des paquets spécialisés.
Ce changement a simplifié les installations, tout en conservant la logique de conversion. Une équipe éditoriale peut donc automatiser des lots entiers, produire des variantes graphiques et garder la même source centrale.
« J’ai gagné du temps dès que j’ai séparé le fond de la forme. »
Luc Martin
« La conversion vers plusieurs formats est devenue prévisible, même pour nos notices longues. »
Claire N.
« Le schéma nous aide à garder des textes cohérents d’une version à l’autre. »
Élise N.
« Pour une documentation technique, la structure compte davantage que l’apparence initiale. »
Marc D.
À ce stade, la valeur se mesure aussi à la qualité de l’encodage, car une erreur de caractères peut ruiner un flux pourtant bien conçu.
Encodage, caractères et pérennité des vocabulaires documentaires
Le dernier angle relie les modèles documentaires à un problème très concret : l’encodage des textes. Sans règles solides sur les caractères, même une structure impeccable finit par produire des fichiers fragiles ou illisibles.
Unicode, UTF-8 et compatibilité des corpus
Selon les TEI Guidelines, Unicode constitue aujourd’hui la base la plus robuste pour représenter les caractères abstraits. UTF-8 reste recommandé sur le web, car il assure une compatibilité large et une lecture simple des fichiers ASCII.
Les projets anciens rencontrent pourtant encore des mélanges d’ISO-8859 et de UTF-8, surtout lorsqu’ils combinent accents, espaces insécables et symboles rares. Un corpus patrimonial peut alors afficher des caractères parasites si l’encodage n’est pas déclaré proprement.
À retenir pour l’encodage :
- Unicode pour la stabilité des caractères
- UTF-8 pour les échanges web
- Déclaration explicite de l’encodage source
- Normalisation cohérente dans tout le projet
Choix technique
Avantage principal
Risque évité
Contexte d’usage
UTF-8
Large compatibilité
Ambiguïtés de lecture
Publication web
Unicode normalisé
Comparaison fiable
Doublons invisibles
Corpus partagés
XML bien déclaré
Traitement prévisible
Échecs d’analyse
Chaînes automatisées
Documentation locale
Consistance éditoriale
Erreurs humaines
Projets longs
Pratiques d’édition et usages durables
Dans une bibliothèque numérique, la discipline d’encodage devient un geste éditorial aussi important que la relecture. Selon Wikipédia, DocBook s’est imposé parce qu’il facilite l’archivage, les traitements par lots et la conversion vers plusieurs formats finaux.
La même logique vaut pour TEI, dès lors qu’un projet documente clairement ses conventions. Les équipes évitent ainsi les interprétations divergentes, les révisions coûteuses et les pertes de sens entre deux campagnes d’édition.
Source : OASIS, « DocBook Technical Committee Document Repository », OASIS ; TEI Consortium, « The TEI Guidelines », TEI Consortium ; Wikipédia, « DocBook », Wikipédia.