Gestion de contenu avec DITA et XML

Gestion de contenu avec DITA et XML

Gestion experte des contenus DITA et XML pour la publication multilingue. Rédaction structurée, écriture par thèmes et solutions de réutilisation de contenu.

Qu'est-ce que la norme DITA?

DITA (Darwin Information Typing Architecture) est une architecture basée sur XML destinée à la rédaction, à la production et à la diffusion d'informations techniques. L'architecture, ainsi qu'une DTD et un schéma W3C associés, a été développée par IBM.

Le nom complet de l'architecture s'explique comme suit :
Darwin : elle applique les principes de spécialisation et d'héritage
Information Typing : elle s'appuie sur la sémantique des rubriques (concept, tâche, référence) et du contenu (messages, expressions typées, tableaux sémantiques)
Architecture : elle offre une marge d'évolution verticale (nouvelles applications) et latérale (spécialisation vers de nouveaux types) pour l'information

Contrairement aux approches orientées livre, fondées sur des chapitres et des pages, DITA s'appuie sur des rubriques - de petits blocs d'information facilement réutilisables dans différents contextes et livrables. DITA intègre également un support d'extensibilité natif, ce qui signifie que vous pouvez personnaliser les définitions de type de document (DTD) sans rompre la compatibilité avec les applications et les processus existants. Pour ces raisons et bien d'autres, DITA va au-delà de toute approche antérieure pour vous aider à surmonter les obstacles à l'adoption de XML, à maximiser la réutilisation de contenu et à réduire les redondances d'information.

DITA définit un certain nombre de types de rubriques, tels que Tâche, Concept et Référence. Au sein de DITA, une rubrique Tâche est destinée à une procédure décrivant comment accomplir une tâche ; elle énumère une série d'étapes à suivre pour obtenir un résultat précis ; elle indique qui fait quoi, quand, où et comment. Une rubrique Référence sert aux sujets décrivant la syntaxe de commandes, des instructions de programmation ou tout autre matériel de référence ; il s'agit généralement de contenu détaillé et factuel.

Qu'est-ce que la norme DocBook?

DocBook est un langage de balisage destiné à la documentation technique, initialement conçu pour la rédaction de documents techniques liés au matériel et aux logiciels informatiques, mais qui peut être utilisé pour tout autre type de documentation.

L'un des principaux avantages de DocBook est qu'il permet à ses utilisateurs de créer du contenu documentaire sous une forme neutre sur le plan de la présentation, qui capture la structure logique du contenu ; ce contenu peut ensuite être publié dans divers formats, notamment HTML, PDF, pages man et HTML Help, sans que les utilisateurs aient à modifier la source.

Qu'est-ce que DocBook?

DocBook fournit un système pour la rédaction de documents structurés à l'aide de SGML ou de XML. Il convient particulièrement bien aux livres et aux articles consacrés au matériel et aux logiciels informatiques, sans pour autant s'y limiter.
En résumé, DocBook est une DTD simple à comprendre et largement utilisée. Des dizaines d'organisations utilisent DocBook pour des millions de pages de documentation, dans divers formats imprimés et en ligne, à travers le monde.

Pourquoi avoir besoin de DocBook?

Le format DocBook a été conçu par le consortium OASIS spécifiquement pour la documentation technique. Il offre un ensemble riche de balises permettant de décrire le contenu de votre document.
Voici quelques points clés qui aident à comprendre ce qu'est DocBook :

• DocBook est un langage de balisage
  À cet égard, il ressemble beaucoup à HTML. Les balises structurent votre document et se mêlent au texte informatif.
  Cette particularité en fait une révolution du point de vue de la traduction documentaire, car la phase de PAO (mise en forme visuelle du texte) est réalisée une fois pour toutes, de manière indirecte, par le balisage du texte d'origine. Les traducteurs n'ont plus qu'à traduire « entre les balises » et, d'une simple frappe, la sortie traduite est générée.
• Conçu pour la documentation technique
  DocBook convient parfaitement à la documentation de pièces de moteur automobile. Il est toutefois fortement orienté vers la documentation des programmes informatiques.
• Techniquement, DocBook est une DTD SGML ou XML
  Cela signifie qu'il est possible de tirer parti des nombreux outils compatibles SGML et XML. Bien que DocBook en tant qu'implémentation XML soit assez récent, il a une longue histoire en tant qu'implémentation SGML.
• DocBook n'est pas un langage de présentation
  DocBook veille soigneusement à ne pas spécifier l'apparence finale de la documentation. Cela permet au rédacteur de se concentrer sur l'organisation et le sens du document qu'il rédige. Toutes les questions de présentation sont déléguées à des feuilles de style.
  Cela garantit une apparence cohérente à tous vos documents, quel que soit le rédacteur technique.
• DocBook est personnalisable
  Grâce à son organisation modulaire, il est assez facile de personnaliser la DTD pour répondre à ses besoins. Il faut toutefois veiller à le faire dans le respect des conventions SGML/XML, car cela peut introduire des incompatibilités.
  Associé aux feuilles de style modulaires de Norman Walsh, DocBook permet également de personnaliser la manière dont un fichier DocBook est imprimé ou mis en ligne.
• DocBook est complet
  Le grand nombre de balises définies dans DocBook garantit qu'il peut s'adapter à un large éventail de situations et d'attentes de traitement.
  Cela rend son apprentissage un peu plus difficile, mais on peut rédiger de la documentation en ne connaissant qu'un ensemble limité de balises et en se référant à la documentation de référence en cas de besoin.

Qu'est-ce que la gestion de contenu XML?

Un système de gestion de contenu XML peut également transformer votre contenu pour cibler différents médias et supports : le Web, le CD, les présentations hors ligne, les catalogues imprimés, les assistants numériques personnels et les téléphones sans fil. En créant le contenu une seule fois et en le réutilisant sur différents supports, vous assurez la cohérence et la pertinence de votre message sur tous vos canaux de communication. De cette manière, la gestion de contenu XML permet aux entreprises de pratiquer plus efficacement l'e-business grâce à la réutilisation du contenu, à la séparation du contenu et de la présentation, à l'échange indépendant de la plate-forme, à une intégration sans douleur et à la publication multicanale.

Qu'est-ce que la gestion de contenu Web?

La gestion de contenu Web permet aux utilisateurs métier et aux collaborateurs non techniques d'entretenir et de faire évoluer un site Web en séparant sa structure et son contenu de son design. Elle remplace les méthodes traditionnelles qui exigent la maîtrise de HTML et des techniques de conception et, grâce à des règles valables pour l'ensemble du système, elle garantit que des éléments tels que la navigation et la mise en page sont gérés de manière cohérente. Vous pouvez ainsi piloter votre site Web sans craindre de rompre la charte graphique, sans vous préoccuper de la façon d'ajouter une nouvelle rubrique au menu ni des coûts supplémentaires induits par vos modifications, et vous concentrer sur l'utilisation du site pour mieux communiquer avec vos clients, prospects et partenaires.