Sommaire :
Qu’est-ce que la norme DITA ?
DITA (acronyme de “Darwin Information Typing Architecture”), est un système basé sur XML pour créer et publier des contenus thématiques.
En 2005, DITA a été adoptée comme norme par l’OASIS (encore un acronyme, pour “Organization for the Advancement of Structured Information Standards”).
Le comité technique DITA d’OASIS est désormais responsable de sa maintenance et mise à jour. Le langage DITA comprend à la fois des sujets génériques et des types de sujets spécialisés, y compris des sujets de concepts, des sujets de référence et des sujets de tâches.
La structure traditionnelle d’un livre comprend des chapitres, des sections et des sous-sections. Les auteurs utilisent généralement des applications comme Word ou LibreOffice pour créer cette structure de livre. Mais ce format ne fonctionne pas dans tous les cas. C’est là que DITA entre en jeu.
DITA prend en charge un certain nombre de fonctionnalités très utiles pour les rédacteurs de documentation technique.
Voici quelques-unes des fonctionnalités qui rendent DITA si utile et dans quel cas vous devez l’utiliser.
DITA peut produire plusieurs formats avec une seule source
Ces dernières années ont vu de nombreux changements dans la manière d’aider les utilisateurs.
Dans le passé, une application ou un produit pouvait avoir un seul manuel ou guide d’utilisation. Aujourd’hui, les guides d’utilisation peuvent être fournis de différentes manières :
- Sur un site
- Aide HTML
- Un PDF
- Une documentation en ligne etc.
DITA vous permet de produire des sorties dans plusieurs formats à partir d’un seul ensemble de fichiers XML. Par exemple, vous pouvez produire un fichier d’aide HTML, un fichier PDF et d’autres formats à partir d’une seule source.
La principale caractéristique de la DITA est l’organisation de l’information par thème. La structure thématique permet à l’auteur d’organiser le contenu plus facilement. Un sujet est généralement une tâche, un concept ou une référence.
La norme DITA réduit les coûts de traduction
En conservant le contenu dans une seule source, il est plus facile de gérer les coûts de traduction. Par exemple, si vous avez une procédure qui est utilisée dans plusieurs types de contenu (site web, aide HTML, FAQ), vous devez alors traduire un seul document au lieu de trois.
A qui s’adresse la norme DITA ?
Si vous avez bien suivi, DITA sera parfait pour les professionnels qui :
- Doivent rédiger un document technique rapidement
- Souhaite exporter leur document sous plusieurs formats en un clic (PDF, HTML, FAQ…)
- Souhaite traduire un document plus facilement
- Ne souhaite pas passer par la structure classique par chapitre – comme pour les livres.
- Veulent diviser leur document par thème et simplifier la navigation
Comment rédiger mon document au format DITA ?
Vous êtes convaincu ? La norme DITA est faite pour vous ? Très bien, maintenant, il faut savoir quel logiciel utiliser. Personnellement, je vous recommande le logiciel Dita Author qui est le plus complet et le plus simple sur le marché.
Si vous n’êtes pas doué en code de programmation, le logiciel vous permet d’avoir un éditeur de texte et de visualiser simplement vos différentes structures. Il existe aussi bien d’autres logiciels, je vous conseille de faire un tour sur cet article.
Conclusion
Si vous ne connaissiez pas la norme DITA, j’espère que vous en savez davantage aujourd’hui. Au final, c’est très pratique pour les professionnels, et même pour l’utilisateur final.
