Jeu d’outils DITA Open Toolkit
Le jeu d'outils Open Source DITA (DITA OT) est un ensemble d'outils open source basés sur Java, offrant un traitement pour des contenus de mappages DITA et le contenu des rubriques. FrameMaker intègre le jeu d’outils Open Toolkit DITA 2.1 (DITA OT) pour transformer le contenu DITA (mappages et rubriques) en formats livrables.
Par défaut, FrameMaker permet de générer votre contenu DITA pour les trois sorties suivantes :
1)PDF2
2)XHTML
3)CHM (installez HTML Help Workshop pour générer des CHM)
Vous pouvez également générer une sortie pour des formats comme Docbook, Java help et RTF. Pour activer d’autres formats de sortie, voir Modification de la liste des types de sortie.
Génération de sortie avec DITA OT
1)Avec le fichier DITA adéquat sélectionné, sélectionnez DITA > Générer la sortie DITA OT.
La boîte de dialogue Générer la sortie DITA-OT s’affiche.
Boîte de dialogue Générer la sortie DITA-OT
2)Sélectionnez un type de sortie.
3)Par défaut, DITA-OT est installée en même temps que FrameMaker. Cependant, si vous avez installé séparément le jeu d’outils, vous pouvez spécifier l’emplacement d’installation dans le champ Répertoire DITA-OT. La modification dans le champ ne s’applique que pour la sortie actuelle. Lors de la prochaine ouverture de la boîte de dialogue Générer la sortie DITA-OT, le répertoire est réinitialisé à la valeur par défaut de FrameMaker. Pour changer le répertoire par défaut, voir Utilisation d’un package DITA-OT différent.
4)Sélectionnez un fichier Ditaval pour spécifier le filtrage conditionnel du contenu avec des paires attribut/valeur définies dans le fichier DitaVal. Pour plus d’informations sur l’utilisation des fichiers DitaVal, voir DITAval.
Si vous envisagez d’utiliser le même fichier DitaVal lorsque vous générez plusieurs documents, vous pouvez spécifier le nom de fichier et l’emplacement dans ditafm.ini. Dans ce cas, vous n'avez pas besoin de sélectionner un fichier DitaVal chaque fois que vous générez la sortie.
remarque : Si vous spécifiez un fichier DitaVal dans les deux emplacements (ditafm.ini et boîte de dialogue Générer la sortie DITA-OT), le fichier sélectionné dans la boîte de dialogue Générer la sortie DITA-OT a la priorité.
5)Cliquez sur Générer.
FrameMaker appelle DITA-OT et génère la sortie dans le même dossier que celui de la rubrique ou du mappage source.
Modification de la liste des types de sortie
Par défaut, FrameMaker permet d’utiliser DITA-OT pour générer la sortie pour PDF2, XHTML et l’aide HTML. Cependant, le jeu d’outils permet également de générer une sortie pour plusieurs autres formats. Pour générer une sortie dans d’autres formats, vous devez mettre à jour le fichier ditafm.ini.
important : La procédure suivante nécessite des modifications à apporter au fichier ditafm.ini. Préalablement à toute modification, nous recommandons d’effectuer une sauvegarde de ce fichier.
1)Ouvrez le fichier ditafm.ini. (<Fm_install_location>\fminit\ditafm\ditafm.ini)
2)Recherchez le texte suivant dans le fichier :
Count=3
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
1=xhtml
2=htmlhelp
3=pdf2
remarque : La liste numérotée ci-dessus est identique à la liste des formats de sortie disponibles dans la boîte de dialogue Générer la sortie DITA-OT.
3)Pour ajouter ou supprimer des types de sortie de la boîte de dialogue Générer la sortie DITA-OT, vous devez spécifier Count comme le nombre de types à afficher dans la liste.
4)La liste suivante répertorie tous les types de sortie disponibles que vous pouvez inclure. Pour inclure un ou plusieurs des types suivants, vous devez les ajouter à la liste numérotée et vous assurer que la séquence des nombres est conservée :
•docbook
•eclipsecontent
•eclipsehelp
•htmlhelp
•javahelp
•net.sourceforge
•html
•odt
•tocjs
•troff
•wordrtf
•xhtml
remarque : Les entrées de type output (sortie) dans le fichier ditafm.ini respectent la casse. Vous devez rendre les entrées comme la liste ci-dessus.
L’exemple suivant ajoute les formats d’aide d’Eclipse et RTF de MS Word à la liste existante.
Count=5
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
1=xhtml
2=htmlhelp
3=pdf2
4=eclipsehelp
5=wordrtf
remarque : Vous pouvez modifier complètement la liste pour inclure n’importe quel ensemble de types de sortie.
5)Redémarrez FrameMaker pour que les modifications prennent effet.
Utilisation d’un package DITA-OT différent
FrameMaker a intégré DITA-OT 2.1. Si vous avez déjà installé une autre version du jeu d’outils DITA Open Toolkit, vous pouvez personnaliser son chemin d’accès en modifiant le fichier d’initialisation de DITA. Pour une modification unique, vous pouvez modifier le chemin d’accès au répertoire lorsque vous générez la sortie à l’aide du jeu d’outils Jeu d’outils DITA Open Toolkit.
Pour modifier le répertoire DITA-OT par défaut de FrameMaker :
1)Ouvrez le fichier ditafm.ini. (<Fm_install_location>\fminit\ditafm\ditafm.ini)
2)Recherchez le texte suivant dans le fichier :
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
3)Modifiez la valeur de DitaDir pour désigner l’autre dossier DITA-OT.
Par exemple, c:\DITA-OT1.7.5_standard_bin.
4)Relancez FrameMaker.
Le nouveau chemin d’accès de DITA OT est renseigné dans la boîte de dialogue Sortie DITA générée.