Apprenez à convertir des documents Microsoft Word en documents et mappage DITA.
FrameMaker vous permet de migrer vos documents Word existants (.docx) vers des documents de type rubrique DITA. Il vous suffit de spécifier les emplacements des dossiers d'entrée et de sortie ainsi que d'autres paramètres pour convertir le document en document DITA. Selon le contenu, vous pouvez obtenir un fichier .dita et un fichier .ditamap.
Pour pouvoir convertir un document Word avec succès, votre document doit être bien structuré. Par exemple, votre document doit avoir un titre, suivi de l'intitulé 1, de l'intitulé 2, et ainsi de suite. Chacun des intitulés doit inclure certains contenus. Si votre document n'est pas bien structuré, le processus risque de ne pas fonctionner comme prévu.
Par défaut, FrameMaker utilise le cadre de transformation Word-to-DITA (Word2DITA). Cette transformation dépend du fichier de configuration de mappage de style de balisage . Pour pouvoir utiliser la transformation Word2DITA avec succès, vous devez tenir compte des directives suivantes afin de préparer votre document Word à la conversion :
Assurez-vous que votre document commence par un titre ; ce titre est associé au titre du mappage DITA. De plus, le titre doit être suivi d'un contenu standard.
Le titre doit être suivi de l'intitulé 1, puis de l'intitulé 2, et ainsi de suite. Chaque intitulé doit inclure certains contenus. Les intitulés sont convertis en nouvelles rubriques de type « concept ». La hiérarchie des rubriques générées est conforme aux niveaux des intitulés dans le document, par exemple, l'intitulé 1 précède l'intitulé 2, et l'intitulé 2 précède le contenu de l'intitulé 3.
Le document doit avoir au moins un contenu de type Intitulé.
Assurez-vous que vous n'avez pas d'images groupées. Si vous avez regroupé des images dans votre document, dégroupez toutes ces images.
Supprimez tous les en-têtes et pieds de page.
Les styles en ligne tels que gras, italique et souligné sont convertis en éléments
<b>,<i>, et<u>.Toutes les listes ordonnées et non ordonnées sont converties en éléments
<ol>et<ul>. Cela s'applique également aux listes imbriquées, aux listes à l'intérieur de tableaux, aux notes ou aux notes de bas de page.Tous les hyperliens sont convertis en
<xref>.Le nom des fichiers convertis est basé sur le texte de l'intitulé suivi d'un numéro de fichier.
Pour convertir un document Word en DITA, effectuez les étapes suivantes :
Sélectionnez .
La boîte de dialogue Convertir Word (.docx) en DITA apparaît.
Figure 1. Boîte de dialogue Conversion Word en DITA
Dans la boîte de dialogue Convertir Word (.docx) en DITA indiquez les éléments suivants :
Fichier : chemin du fichier Word source à convertir.
Map Style de balisage : fichier de mappage utilisé pour la conversion. Le fichier de mappage par défaut est disponible à l’emplacement suivant :
C:\Users\<username>\AppData\Roaming\Adobe\FrameMaker\17\X2DITA\Word2DITA\style2tagMap.xml
Vous pouvez ajouter vos personnalisations au fichier de mappage par défaut. Si vous utilisez un fichier différent du fichier de mappage source, mettez à jour le chemin du fichier dans l'emplacement Map Style de balisage.
Fichiers DITA de sortie > Répertoire : emplacement de sortie où enregistrer le document DITA converti. Par défaut, un fichier de mappage DITA est créé avec le nom du document Word source. Le dossier topics contient les fichiers .dita, créés sur la base des configurations du fichier de mappage. Le répertoire Topics contient un sous-répertoire Média, qui inclut tous les fichiers multimédias utilisés dans le document Word source.