Export du modèle Scenari-Doctek vers Dita

Introduction

Après l'analyse des manuels de vol et la phase de veille sur Dita, il nous a paru possible de structurer le contenu de cette documentation à l'aide de ce langage. D'un autre côté, Dita s'est imposé comme une solution assez souple pour les publications que nous souhaitions faire, en plus de l'avantage qu'on peut en tirer du fait que c'est un standard, à savoir la conformité et la comparabilité à d'autres documentations techniques structurées en Dita.

Ainsi, nous avons décidé de réaliser une transformation du modèle Scenari-Doctek vers Dita, puis de nous appuyer sur les fichiers Dita générés pour les publications finales.

L'éditeur Doctek et les fichiers .xml sources nous ont permis un export Dita résumé par le diagramme UML suivant :

Diagramme UML de la Dita que nous utilisons
Diagramme UML de la Dita que nous utilisons

Démarche

Le modèle Scenari-Doctek propose entre autres la création de 4 types d'items, à savoir les maps, les chapters, les concepts et les tasks. Pour chacun d'entre eux, une transformation spécifique en langage Dita a été nécessaire, ce qui a mené aux fichiers suivants :

  • exportDitaMap.xsl,

  • exportDitaChapter.xsl,

  • exportDitaConcept.xsl,

  • exportDitaTask.xsl.