Le formatage typographique dans les environnements techniques s’appuie sur des principes hérités du SGML et de ses DTD, applicables encore aujourd’hui. Ces principes favorisent la séparation entre structure et présentation, facilitant la réutilisation et l’adaptation des contenus à plusieurs supports.
Les feuilles de style, qu’il s’agisse de DSSSL ou d’autres chaînes de transformation, orchestrent la mise en page et la production finale. Avant d’entrer dans les détails pratiques, quelques points essentiels sont présentés ci-dessous.
A retenir :
- Séparation forme et sens pour réutilisation de contenus techniques et éditoriaux
- DSSSL comme langage historique de styles pour SGML
- Chaîne d’outils OpenJade, libxml2, xsltproc pour production documentaire
- Normes ISO/NF pour normalisation documentaire et compatibilité inter-plateformes
Partant des principes, SGML et DSSSL pour le formatage typographique, vers la chaîne d’outils
Selon Wikipédia, le SGML a posé la base conceptuelle séparant le balisage sémantique de la présentation visuelle. Le DSSSL a ensuite défini un langage de style et un langage de transformation pour des DTD SGML, ce qui a structuré la présentation de documents historiques.
Outil
Rôle
Formats pris en charge
Remarque
OpenJade
Analyseur SGML et processeur DSSSL
SGML, DSSSL
Maintenu par OpenJade, central pour DocBook SGML
libxml2 / xmllint
Validation et manipulation XML
XML
Outil courant pour XML, souvent préinstallé
libxslt / xsltproc
Exécution XSLT pour transformation
XML, XSLT
Utilisé pour produire HTML et autres sorties
JadeTeX
Conversion vers TeX/PDF
TeX, PDF
Bon pour PDF, mais limitations sur tableaux complexes
Chaîne d’outils pour la production HTML et PDF
Ce point se relie à la norme en expliquant comment les outils assurent la transformation de documents. Selon la documentation PostgreSQL, OpenJade fournit l’analyseur SGML et le processeur DSSSL nécessaires pour créer du HTML à partir de DocBook. Le couplage avec xsltproc ou JadeTeX complète la chaîne pour produire des sorties PDF et HTML.
Outils et rôles complémentaires permettent d’adapter la typographie informatique au format cible sans altérer le balisage source. Les équipes documentaires gagnent en cohérence lorsqu’elles standardisent les feuilles de style et les catalogues SGML.
Outils nécessaires DocBook :
- OpenJade — analyseur SGML et processeur DSSSL pour conversion
- libxml2/xmllint — validation et traitement XML
- libxslt/xsltproc — exécution de feuilles de style XSLT pour HTML/PDF
- JadeTeX — génération TeX/PDF pour sorties imprimées
Installation et configuration sur systèmes courants
Pour appliquer la chaîne d’outils, l’installation varie selon le système et les paquets disponibles. Les distributions Linux et BSD fournissent généralement des portages ou paquets prêts à l’emploi, ce qui facilite le déploiement des styles de document. Il reste essentiel de régler correctement les catalogues SGML et les variables d’environnement.
Étapes d’installation :
- yum install docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
- apt-get install docbook docbook-dsssl docbook-xsl libxml2-utils openjade1.3 opensp xsltproc
- sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt openjade opensp
« L’équipe documentation a standardisé ses feuilles de style, la cohérence s’en est ressentie »
Sophie N.
En s’appuyant sur la chaîne d’outils, styles de document et feuilles de style pour une mise en page maîtrisée, vers le choix entre DSSSL et XSL
Selon NF ISO/IEC 10179, DSSSL spécifie la sémantique et la syntaxe d’un langage de style adapté aux documents SGML. Claire, rédactrice technique, a tiré parti de ces spécifications pour définir des feuilles de style portables et cohérentes entre sorties imprimées et numériques. L’attention portée aux caractéristiques de style permet d’assurer une mise en page contrôlée et reproductible.
Choisir entre DSSSL et XSL pour les styles de document
Ce choix dépend des formats sources, des outils disponibles et des exigences éditoriales pour la typographie. Selon la documentation disponible, XSLT et les feuilles DocBook XSL sont couramment utilisés pour les flux XML modernes. La version minimale requise mentionnée pour certaines chaînes est 1.74.0 pour les feuilles DocBook XSL, ce qui influe sur le choix des outils.
Langage
Usage principal
Outils recommandés
Avantage clé
DSSSL
Styles et transformation pour SGML
OpenJade, feuilles DSSSL
Conçu pour les DTD SGML historiques
XSLT / XSL-FO
Transformation XML vers divers formats
libxslt / xsltproc, FOP
Large écosystème XML moderne
DocBook XSL
Stylesheets pour DocBook vers HTML/PDF
xsltproc, outils DocBook
Chaîne éprouvée pour documentation technique
CSS pour XML
Mise en forme simple pour sorties HTML
Navigateurs, outils de rendu web
Simplicité pour contenus web
Points de compatibilité :
- SGML versus XML, différences sur les DTD et entités
- DSSSL adapté aux DTD SGML, XSLT aux flux XML
- Choix dicté par outils disponibles et contraintes éditoriales
- Versions de feuilles de style influençant la compatibilité
« J’ai adopté DocBook XSL pour convertir nos manuels, le gain de temps a été net »
Alice B.
Étude de cas pratique : conversion de la documentation PostgreSQL
Cette étude illustre les étapes clés pour convertir une documentation écrite en DocBook vers des formats variés sans perte typographique. Selon la documentation PostgreSQL, la configuration du catalogue SGML et la sélection des feuilles de style conditionnent la réussite de la production. La mise en place d’un script de build reproductible limite les erreurs humaines et assure la cohérence des sorties.
Bonnes pratiques :
- Valider la DTD et les entités avant toute transformation
- Définir SGML_CATALOG_FILES pour éviter les chemins relatifs cassés
- Tester avec versions stables d’OpenJade et xsltproc
- Conserver un jeu de feuilles de style versionné
Affiner la présentation de documents : typographie informatique et normalisation documentaire, vers des pratiques avancées
Le réglage fin de la typographie informatique implique la gestion des tableaux, des flottants et des caractéristiques de style exportables. Les normes et la documentation technique fournissent des lignes directrices permettant d’externaliser les caractéristiques de style pour une meilleure portabilité. Ce travail s’inscrit dans une logique de normalisation documentaire et d’efficacité éditoriale.
Techniques avancées pour la mise en page avec DSSSL
Ce volet approfondit la personnalisation des feuilles de style pour répondre à des besoins typographiques spécifiques. L’usage de modules DSSSL permet de traiter les tables, les notes en bas de page et les objets flottants de manière contrôlée. L’intégration de JadeTeX offre une option pour produire des PDF avec signets et qualité d’impression, tout en imposant des ajustements pour les tableaux complexes.
Techniques avancées :
- Personnalisation des feuilles DSSSL par modules réutilisables
- Gestion fine des tables et des éléments de placement
- Utilisation de JadeTeX pour sorties PDF avec signets
- Versionner les feuilles pour traçabilité et cohérence
« J’ai contourné un segfault en revenant à OpenJade 1.3 pour générer le PDF »
Marc L.
Adapter la typographie aux supports numériques et imprimés
La dernière étape consiste à adapter les choix typographiques aux contraintes du support final, qu’il soit écran ou papier. Les caractéristiques de style doivent rester modulaires pour permettre des variantes adaptées aux résolutions et aux gabarits d’impression. Un bon réglage améliore la lisibilité et la pérennité des documents.
Recommandations typographiques :
- Prioriser lisibilité et hiérarchie typographique pour tous supports
- Externaliser caractéristiques de style pour faciliter les adaptations
- Vérifier rendu PDF et rendu navigateur avant publication
- Documenter les choix de style pour les futurs contributeurs
« La mise en page doit viser lisibilité et portabilité pour durer dans le temps »
Éric N.
Source : Wikipédia, « Standard Generalized Markup Language — Wikipédia », Wikipédia ; AFNOR, « NF ISO/IEC 10179 », AFNOR ; PostgreSQL Global Development Group, « Documentation », PostgreSQL.