Utiliser la rédaction structurée

DITA XML et la discipline du typage de l’information : découper le contenu en concepts, tâches et références réutilisables et assemblables en différents livrables.

Formats et architecture

Formats structurés et non structurésLe choix fondamental qui détermine réutilisation, coûts de traduction et outillage.

Cas concrets d'utilisation de DITA XMLDes solutions de rédaction structurée en conditions réelles.

Complexité de l'architecture documentaireQuand une architecture documentaire devient trop complexe — et comment le reconnaître.

Du document à la base documentaire modulairePasser de documents monolithiques à une base de contenu modulaire et réutilisable.

Cas concret : documentation de NuFirewallLa rédaction structurée en production, issue d'un projet open source salué par la presse.

Didacticiels

Didacticiels DITA XML et XSL-FORédiger en DITA XML et générer du PDF avec des feuilles de style XSL-FO.

Insérer automatiquement des données dans un fichier DITA XMLInsérer dynamiquement des données produit dans des topics DITA.

Texte conditionnel avec Jinja (méthode objet)Définir audience, plateforme et version comme objets Python, puis filtrer le contenu à la génération.

Texte conditionnel avec JinjaUn script de prétraitement Python qui inclut ou retire des sections de contenu avant génération.

Texte conditionnel avec Sphinx/ReSTGénérer des variantes de documents à partir des mêmes sources ReST.

Insérer automatiquement des données dans un fichier reStructuredTextTemplater un fichier ReST pour que Python y insère noms et versions produit à la génération.

Insérer automatiquement des données SQL dans un fichier reStructuredTextInterroger une base de données produit et injecter les résultats directement dans la documentation.

Encore en train d’arbitrer entre DITA et Markdown ? Voir choisir outils et formats.