Publication DITA

1. Avec le fichier DITA adéquat sélectionné, sélectionnezStructure > 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. Sélectionnez l’option Afficher le fichier journal si vous souhaitez lancer le fichier journal une fois la publication terminée.

   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 modifier le répertoire par défaut, voir Utilisation d’un package DITA-OT différent.

4. Sélectionnez l’option Ouvrir le dossier de sortie pour ouvrir le dossier de sortie dans l’explorateur Windows. Le dossier de sortie est affiché dans l’explorateur Windows une fois la publication terminée.

5. Sélectionnez l’option Laisser cette fenêtre ouverte après génération afin de conserver cette boîte de dialogue ouverte une fois la publication terminée.

6. 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é.

7. 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.

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.

1. Ouvrez le fichier ditafm.ini dans le dossier Appdata de l’utilisateur actuel :%appdata%\Adobe\FrameMaker\xx\ditafm.ini

2. Recherchez le texte suivant dans le fichier :

   Count=3
   1=xhtml
   2=htmlhelp
   3=pdf

   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

   • pdf

   • 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
   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.

FrameMaker a intégré DITA-OT 2.3. 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 ou à partir de la boîte de dialogue Personnaliser DITA-OT.

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 Open Source DITA.

Pour modifier le répertoire DITA-OT par défaut de FrameMaker via le fichier d’initialisation DITA :

1. Ouvrez le fichier ditafm.ini dans le dossier Appdata de l’utilisateur actuel :

   %appdata%\Adobe\FrameMaker\xx\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-OT_3.1.2.

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.

Pour modifier le répertoire DITA-OT par défaut de FrameMaker via la boîte de dialogue Personnaliser DITA-OT :

1. Sélectionnez Structure > DITA > Générer la sortie DITA-OT pour ouvrir la boîte de dialogue Générer la sortie DITA-OT.

2. Cliquez sur le bouton Personnaliser pour ouvrir la boîte de dialogue Personnaliser DITA-OT.

   Boîte de dialogue Personnalisation de DITA-OT
   
   

3. Dans cette boîte de dialogue, renseignez les informations ci-dessous :

   Répertoire DITA-OT

   Spécifiez le chemin du dossier dans lequel le fichier DITA-OT.zip est enregistré. Vous pouvez utiliser la variable %FMHOME% qui se rapporte à l’emplacement d’installation de FrameMaker. Ce chemin est enregistré dans la variable DITA_DIR, qui peut être utilisée pour indiquer le chemin d’accès d’autres dossiers correspondants.

   Commande Ant

   Spécifiez le chemin du dossier du script Ant. Ce chemin est relatif au répertoire DITA-OT dans votre système de fichiers.

   Ant Home

   Spécifiez le chemin du dossier d’installation Ant.

   Classpath

   Spécifiez le chemin des bibliothèques Java.

   Build File

   Spécifiez le chemin du fichier de script de génération ANT build.xml. Ce chemin est relatif au répertoire DITA-OT.

   Extra Params

   Spécifiez tous les paramètres supplémentaires requis par votre module externe personnalisé DITA-OT.