Introduction DocBook et DITA sont des langages de balisage utilisé pour la documentation technique. Les deux peuvent être utilisés pour générer la sortie en HTML, PDF, et formats CHM. Cependant, il ya une grande différence entre ces deux outils car ils utilisent tous les deux approches très différentes. L'outil adapté à votre documentation dépend de vos besoins et celui de votre organisation.

DocBook

DocBook est un langage de balisage et est utilisé pour la documentation technique de toutes sortes.

Il permet aux utilisateurs de créer des documents qui peuvent être publiées dans de nombreux formats tels que HTML et PDF sans apporter de modifications au code source.

Le format DocBook est basé sur XML, ce qui rend plus facile à lire à la fois par les humains et les machines.

Avantages de DocBook:

• Même document peut être traduit à la fois basé sur le Web et imprimé format de document.
• L'utilisateur peut se concentrer sur le contenu plutôt que sa forme.
• A une très bonne documentation.
• Fournit un bon soutien.
• Est très utile pour la livraison de documents tels que des livres simples.

Darwin Information Typing Architecture (DITA)

DITA est une innovation récente dans l'édition XML.

Le nom est synonyme de:

• Darwin: Utilise les principes de spécialisation et d'héritage.
• Information Typing: identifie les sujets qui contiennent différents types d'informations tels que le concept, tâche et référence.
• Architecture: fournit un espace pour de nouvelles applications et également pour la vulgarisation au sein des applications disponibles.

DITA travaille sur une approche modulaire. En DITA, chaque élément d'information est considérée comme un sujet. Ces thèmes peuvent être combinés et réutilisés pour former des documents. DITA a un certain nombre de types de sujet, comme tâche, concept, et de référence. Un sujet tâche décrit la procédure à accomplir une tâche. Concept se compose de définitions, règles, etc Une rubrique de référence explique les instructions et les différents matériaux de référence. Vous pouvez définir un type nouveau sujet par la spécialisation. Spécialisation vous permet de créer un nouveau sujet sur la base des propriétés d'un sujet existant.

Avantages de Dita:

• Encapsulation: Chaque personne est responsable de leur emploi, ce qui augmente la sécurité. Par exemple, une personne qui crée un sujet a besoin de connaître les éléments se rapportant au type sujet, alors que la personne d'utiliser le sujet a besoin de savoir seulement comment s'en servir.
• Polymorphisme: Les sujets peuvent être créés comme des catégories plus générales d'utilisation commune.
• Les sujets peuvent être réutilisées facilement.
• XML peuvent être facilement modifiés pour répondre aux besoins des utilisateurs.

Les différences entre les DocBook et DITA

• DocBook est disponible depuis de nombreuses années et est robuste et puissant par rapport à DITA.
• DocBook a été initialement conçu pour l'impression et de sortie PDF, mais il s'est maintenant étendu à générer aide en ligne. DITA n'a pas été conçu pour les sorties imprimées, mais il a été créé pour utiliser la notion de sujet et types sujet.
• DocBook utilise hiérarchie considérant que DITA rend sujets distincts, qui peuvent être combinées selon les besoins.
• DocBook est un ensemble fixe d'éléments. DITA peut être prolongée, permettant à l'utilisateur d'ajouter plus d'éléments en fonction des besoins individuels.
• DocBook possède une documentation en bonne tandis que DITA est trop nouveau pour être bien documentés.
• Expansion du XML est mieux soutenu par Dita que DocBook.

Conclusion

DITA facilite la réutilisation de contenu. Il est utile si vous souhaitez réutiliser de nombreux sujets. Toutefois, si vous écrivez un texte unique et long comme un livre, DocBook serait un choix plus fiable.