AP NF29 A2011 - Rapport d'étude

Afin de générer les fichiers HTML des concepts et des tasks, le fichier buildHTML.xml applique la transformation publiWebStructure.xsl sur tous les fichiers du répertoire build ayant l'extension "*.dita" (qui ont été générés à l'aide du fichier buildDita.xml, appelé en amont dans la génération globale build.xml).

En précisant différents attributs de la balise xslt dans buildHTML.xml, on est assuré que le nom du fichier source (situé dans le répertoire précisé par l'attribut basedir) sera repris pour le fichier généré (qui sera placé dans le destdir), qui aura pour extension "*.html" (valeur donnée à l'attribut extension). On peut également n'appliquer la transformation qu'aux fichiers "*.dita" grâce à la valeur de l'attribut includes (dans le cas où le répertoire source contient par exemple des maps - extension "*.ditamap").

Cette précaution permet d'assurer que les liens qui peuvent exister entre les différents fichiers Dita existeront et fonctionneront effectivement entre les fichiers HTML correspondant :

• d'un côté, les références au sein des fichiers Dita qui se font vers des fichiers Dita, se feront désormais des fichiers HTML vers des fichiers HTML ayant le même nom que les fichiers Dita d'origine,

• de l'autre, tous les fichiers Dita du répertoire seront transformés, d'où l'assurance que chaque passage d'un lien Dita à un lien HTML soit cohérent et mène à un fichier HTML existant.