AP NF29 A2011 - Rapport d'étude

L'imagemap dans DITA est un élément permettant d'associer des liens à une zone d'une image, et est adapté à la documentation technique dans le cadre d'un schéma avec légende par exemple.

Une imagemap nécessite une image, incluse grâce à un href, ainsi qu'autant de zones (area) que l'on veut pour qualifier l'image. Une area est définie par sa forme (rectangle, cercle ou polygone) et sa position (coordonnées en pixels) ainsi que le contenu associé. Cependant le contenu est en fait une référence vers un topic à partir entière à travers la balise xref qui comporte un lien.

Le modèle pour les imageMap dans Doctek n'étant pas encore en place au moment du projet, nous n'avons pas pu créer la transformation des imageMap de Scenari vers DITA. Cependant, cela aurait été possible en appliquant une transformation XSL au fichier XML issu de Scenari de la même manière que pour les autres transformations. Le point spécifique à prendre en compte est qu'en DITA les éléments de légende doivent se situer dans des fichiers externes.

La solution pourrait être de créer pour chaque élément de légende un concept dont le titre serait la légende en question. Etant donné qu'en DITA la zone référence un topic on pourra même imaginer des structures plus complexes qu'une simple légende (paragraphe, lien, etc.) et qui pourront être transformées de la même manière qu'un concept classique. Les formes et les façons de représenter les coordonnées étant a priori les mêmes dans Doctek et dans DITA, il suffira pour cette partie de changer le nom des balises lors de la transformation. Pour les contenus de légende on pourrait par exemple procéder en 2 passes. Lors de la 1ère passe on créé le fichier « classique » contenant l'imagemap et on met dans les xrefs des liens. Puis dans la 2ème passe on créé les fichiers pointés par les xref avec comme contenu le commentaire associé à la zone, en gérant la correspondance entre fichiers et références, par exemple en prenant pour nom de fichier le titre de la zone (cela impliquant l'hypothèse de titres différents pour chaque zone afin d'avoir unicité des fichiers). Mais comme nous n'avons pas directement expérimenté, cette solution reste une suggestion.

Un gros avantage d'utiliser Scenari plutôt que directement DITA est que cela permet de créer les zones à la souris plutôt que de renseigner à la main les coordonnées en pixel, ce qui est vite laborieux.

En conclusion nous n'avons pas pu mettre en place une transformation des ImageMap de Doctek vers DITA mais nous avons vu grâce au modèle Dokiel que cela sera possible une fois le modèle établi dans Doctek, et nous avons créé à la main une imageMap DITA pour permettre une transformation vers une version mobile et une version web.