Totalement automatique
Livre blanc du format structuré DITA XML au format cible PDF via DITA-OT.
Format cible
Le format cible est celui que les utilisateurs consomment - PDF, HTML ou aide compilée - généré à partir d'une source unique. Découvrez la différence entre publication totalement automatique, semi-automatique et manuelle.
Définition
Section intitulée « Définition »Le Format cibleLe format réellement consommé par le lecteur — PDF, HTML, aide compilée — généré à partir du format source.Voir dans le glossaire → d’un support de rédaction technique est celui sous lequel l’audience du message y accédera. Il est différent de celui sous lequel le rédacteur technique crée le contenu. Le Single-sourcingGénérer plusieurs livrables (PDF, HTML, formats d'aide) à partir d'une source unique, plutôt que de maintenir une source séparée par format de sortie.Voir dans le glossaire → permet de générer plusieurs livrables à des formats différents à partir d’un même Format sourceLe format dans lequel le contenu est rédigé, par distinction avec le format cible vers lequel il est publié — la recette contre le plat.Voir dans le glossaire →.
Exemples
Section intitulée « Exemples »À partir des fichiers sources validés, les livrables sont générés selon l’une des méthodes suivantes :
Semi-automatique
Contenu au format DITA XML exporté en HTML puis collé sous un CMS.
Manuelle
Plaquette marketing au format traitement de texte ou DITA XML mise en page sous InDesign, exportée en PDF, puis imprimée. Selon la fréquence de publication du document final, des filtres d’import XML peuvent également être mis en place pour automatiser partiellement cette étape.
Plus le processus est automatisé, plus le risque d’erreur est faible et plus la publication et la mise à jour sont aisées. L’automatisation facilite également le single-sourcing, qui consiste à générer plusieurs livrables à des formats cibles différents à partir d’un même format source. Un projet au format DITA XMLUne architecture de rédaction structurée et modulaire, construite autour de la typologie concept/tâche/référence et de la réutilisation de contenu via conrefs et ditamaps.Voir dans le glossaire → peut ainsi être livré sous forme de fichier PDF, d’aide compilée Windows, d’aide JavaHelp, de site en HTML, etc. Le XML offre en ce domaine des possibilités quasi illimitées.
Les formats légers suivent le même principe. Dans un workflow Docs-as-codeTraiter la documentation comme du code source : formats texte, gestion de versions, revue de code et CI/CD, plutôt qu'un processus de publication séparé.Voir dans le glossaire →, des sources MarkdownLangage de balisage léger en texte brut, où la mise en forme s'exprime par une ponctuation simple, par exemple un # en début de ligne pour un titre. Facile à rédiger et à relire sous gestion de versions, il n'impose aucun schéma : les équipes docs-as-code compensent par des modèles et des contrôles automatisés. Ce manuel est rédigé en MDX, une variante de Markdown.Voir dans le glossaire → sont généralement transformées par un générateur de site statique en site HTML, et la publication devient une étape du pipeline plutôt qu’une opération manuelle (voir livraison). Les formats cibles ne s’adressent d’ailleurs plus seulement aux lecteurs humains : ce manuel est généré à partir de Markdown sous forme de pages HTML, mais aussi de fichiers Markdown par page et d’index JSON destinés aux scripts et aux assistants IA (voir l’API de ce manuel).