Annexe id195AD0L60Y4

Dépannage d’AEM Guides

Une fois AEM Guides installé et configuré, vous pouvez résoudre les problèmes.

Valider les références

Vous pouvez exécuter les scripts donnés pour valider les références. Ces scripts peuvent vous aider à identifier les références rompues, puis à les corriger.

Script de validation

Effectuez les étapes suivantes pour vérifier les références, à l’aide du script de validation disponible dans le package de produit :

Script de correctif

Effectuez les étapes suivantes pour corriger les références rompues, à l’aide du script de correctif disponible dans le package de produit :

Enregistreur

Vous pouvez également créer un enregistreur distinct pour cette exécution de script, conformément aux détails donnés ci-dessous :

Le fichier journal créé enregistre toutes les informations relatives à l’exécution du script. Il est utile au cas où les sessions du navigateur expirent, tout en déclenchant le script à partir du navigateur.

Préparation des fichiers InDesign pour la conversion id195DBF0045Z

InDesign met à la disposition des auteurs un large éventail de fonctionnalités pour créer des documents attrayants et complexes. Souvent, cela signifie que les différentes parties d’un document sont placées sur la page visuellement, mais sans tenter de fournir un flux entre ces blocs de texte. Lorsque l’« ordre lecture » des blocs de texte n’est pas défini, le fichier IDML contient des histoires qui peuvent ne pas suivre un ordre significatif. Le résultat final sera une ou plusieurs rubriques DITA avec des paragraphes, des tableaux et des graphiques dans un ordre aléatoire.

Bien qu'il soit possible de modifier le contenu DITA dans un ordre raisonnable dans un éditeur DITA, il est beaucoup plus facile de corriger le fichier InDesign avant de créer le fichier IDML. Vous pouvez le faire sans modifier l’aspect du document source. Il présente également l’avantage de rendre le document source accessible en définissant correctement l’ordre de lecture.

Fragments de texte de thread

InDesign utilise le terme ’threading’ pour le processus de liaison d’une image à une autre. Pour plus d’informations sur le thread de blocs de texte, consultez la rubrique Threading du texte dans la documentation InDesign.

Chevauchement des images

Certains documents InDesign utilisent des cadres qui ne se chevauchent pas pour des raisons de mise en page. Il peut s’avérer très difficile de fusionner ce contenu dans le thread principal. La meilleure option peut être de modifier le résultat dans l'environnement DITA.

Histoires

Chaque flux de contenu thread dans un document InDesign est appelé « histoire ». Pour de meilleurs résultats, il est recommandé de limiter le nombre d’histoires. Toutefois, certaines parties de votre document peuvent ne pas être nécessaires dans la sortie DITA. Par exemple, les pieds de page sont rarement nécessaires, mais ils peuvent apparaître au milieu d'une rubrique s'ils ne sont pas traités avec précaution.

Le moyen le plus simple d’exclure du texte qui n’est pas nécessaire dans le document consiste à lui donner une balise de paragraphe spéciale qui n’est utilisée que pour le contenu indésirable. Par exemple, au lieu de réutiliser un [Paragraphe de base] pour le pied de page, créez une balise Pied de page dédiée. Ensuite, dans le fichier MapStyle, définissez simplement les paragraphes Footer à déposer comme suit :

<paraRule style="Footer" local="0" refactor="drop">
   <attributeRules createID="false"/>
</paraRule>

Mappage aux doctypes DITA

Il est essentiel que votre document source comporte au moins un style de paragraphe ou un élément pouvant marquer le début d’une rubrique. Il est courant pour les documents d’utiliser Titre1 comme nom des titres de niveau supérieur dans le document. Vous pouvez ensuite créer un mappage de ce style à un type de document DITA spécifique. Si votre document est bien organisé et que l'utilisation de Titre1 est constante, vous obtiendrez de bons résultats.

Doctypes DITA multiples

Si certains des paragraphes Titre1 doivent être convertis en différents doctypes DITA, dupliquez le style de paragraphe dans InDesign. Donnez à ces styles un nom facile à reconnaître, tel que Heading1_genTask ou Heading1_troubleshooting selon les besoins. Configurez ensuite le fichier mapStyle comme illustré ci-dessous :

<doctypes>
   <doctypeParaRule style="Heading1" local="0" mapToDoctype="concept">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_genTask" local="0" mapToDoctype=" generalTask">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_troubleshooting" local="0"mapToDoctype=" troubleshooting">
      <attributeRules createID="true"/>
   </doctypeParaRule>
</doctypes>

Documents InDesign structurés

InDesign a une relation assez lâche avec XML. Bien qu’un document puisse inclure une DTD XML et que l’histoire principale puisse être valide par rapport à cette DTD, il est également possible de créer des documents hybrides dont une partie du contenu est XML, mais aucune DTD n’est incluse. Il s'agit des cas indésirables pour une conversion réussie en DITA. Si un document contient des parties XML, essayez d’enregistrer la sortie au format XML et vérifiez si les résultats sont acceptables. Dans le cas contraire, le contenu DITA contiendra également du contenu non valide ou risque d'échouer complètement.

Formatage de tableau

La conversion de règles de formatage de tableau InDesign en formatage de tableau équivalent dans DITA est un processus complexe. Cela est dû aux riches fonctions de formatage disponibles dans les fichiers sources par rapport aux options de base fournies par le modèle de table Oasis (CALS) utilisé dans DITA. L’alignement vertical et horizontal du texte est fourni et donne des résultats similaires, bien que le texte justifié soit toujours justifié en fonction de la direction du texte, tandis qu’InDesign autorise les options Justifié à gauche et Justifié à droite.

La gestion par InDesign des séparateurs de colonnes et de lignes est, encore une fois, beaucoup plus efficace que les options de base du modèle de tableau Oasis. InDesign fournit quatre bordures de cellule : type de bordure (solide ou motif), épaisseur de bordure, couleur de bordure, teinte de bordure, couleur d’intervalle de bordure et teinte d’intervalle de bordure. Tous ces éléments doivent être mappés à des bordures à droite et en bas de chaque cellule (élément d’entrée) où les seuls choix sont 0 ou 1 - masquer la bordure ou afficher la bordure.

Les décisions de bordure dans InDesign peuvent être appliquées aux niveaux suivants :

Le processus de conversion d'InDesign vers DITA applique la décision de contrôle aux frontières comme suit :

Modèles en alternance

Les styles de tableau InDesign permettent aux colonnes et aux cellules de suivre un modèle en alternance. Bien que cette fonction soit prise en charge pour la conversion, les résultats ne seront évidents que lorsqu'un groupe de motifs mappe pour afficher la règle (1) et que l'autre groupe de motifs mappe pour masquer la règle (0).

Préparer le fichier de mappage pour la migration d'InDesign vers DITA id194AF0003HT

Une conversion DITA correcte nécessite un fichier de mappage correspondant au contenu du document source. Pour les documents InDesign non structurés, cela signifie que tous les styles de paragraphe et de caractère disponibles doivent être mappés. Pour les documents InDesign XML structurés, tous les éléments de la DTD associée doivent être mappés.

Les fichiers de mappage pour les documents InDesign structurés et non structurés sont différents. Cela est dû aux exigences de traitement plus complexes pour convertir le contenu source non structuré en DITA.

Voici un exemple de fichier de mappage :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE styleMap SYSTEM "mapStyle.dtd">
<styleMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="mapStyle.xsd" >
   <doctypes>
      <mapDoctypeParaRule root="itpx:stories" mapToDoctype="map">
         <attributeRules createID="true">
            <addNew name="outputclass" value="map"/>
         </attributeRules>
      </mapDoctypeParaRule>
      <doctypeParaRule style="Heading 1" local="0" mapToDoctype="concept">
         <attributeRules createID="true"/>
      </doctypeParaRule>
      <doctypeParaRule style="Heading A" local="0" mapToDoctype="topic">
         <attributeRules createID="true"/>
      </doctypeParaRule>
   </doctypes>
   <wrappingRules>
      <wrap elements="li+" context="number" wrapper="ol">
         <attributeRules createID="true"/>
      </wrap>
      <wrap elements="li+" context="bullet" wrapper="ul">
         <attributeRules createID="true"/>
      </wrap>
   </wrappingRules>
   <paragraphStyleRules>
      <paraRule style="Heading 2" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Heading 3" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|n|-|-]" context="number" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="0" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Title" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
   </paragraphStyleRules>
   <characterStyleRules>
      <charRule style="Bold" local="0" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="Code" local="0" mapTo="codeph">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Bold|-|-|-|-|-|-|-]" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Italic|-|-|-|-|-|-|-]" mapTo="i">
         <attributeRules createID="false"/>
      </charRule>
   </characterStyleRules>
</styleMap>

Le fichier de mappage est un fichier XML avec une structure simple qui répertorie tous les styles de paragraphe source et les codes de style de caractère. Le contenu du fichier est expliqué ci-dessous :

Mappage de style

Dans l’élément styleMap, vous pouvez spécifier deux attributs facultatifs : @map_date et @map_version pour enregistrer la version du fichier de mappage.

Type de document

L'élément doctypes répertorie les mappages DITA et de rubrique pris en charge.

Mapper des règles de paragraphe de type document

L’élément mapDoctypeParaRule est obligatoire. Les attributs de cet élément ne doivent pas être modifiés car l'élément racine du XML source est toujours mappé à l'élément map racine du plan DITA.

Règle de paragraphe de type document

L’élément doctypeParaRule est obligatoire. Cela permet au processus de conversion d’identifier le début d’une nouvelle rubrique. Normalement, l’attribut @style est utilisé seul avec l’attribut @local défini sur 0. Cependant, s’il existe toujours des remplacements de mise en forme locaux pour le style sélectionné, vous devrez ajouter une règle pour chaque style, ainsi que ses remplacements locaux. Il est simple à reconnaître dans le fichier de mappage généré où il serait possible de trouver ceci ou similaire :

<paraRule style="Heading 1" local="0" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>
<paraRule style="Heading 1" local="p[Italic|-|-|-|-|-|-|-]" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>

Dans l’exemple ci-dessus, il y a deux éléments paraRule pour @style = « Titre1 ». Créez simplement un élément de doctypeParaRule équivalent avec l’attribut @mapToDoctype défini selon vos besoins.

Les attributs utilisés dans le doctypeParaRule sont expliqués ci-dessous :

Règles d’habillage des éléments

Les règles d’habillage des éléments définissent les méthodes d’habillage ou de déplacement d’éléments du document entrant dans un élément prédéfini en fonction d’un ensemble de valeurs d’attribut.

wrapélément

Il s’agit d’un élément facultatif. L’élément wrap répertorie les éléments qui seront enveloppés ou déplacés. L’encapsulation est généralement utilisée lorsqu’une série d’éléments doit se voir attribuer un élément parent commun. Par exemple, plusieurs éléments li sont enveloppés dans un élément ol. De plus, wrap peut être utilisé pour déplacer des éléments tels que des titres pour des figures et des tableaux.

Les attributs utilisés dans le wrap sont expliqués ci-dessous :

L’exemple suivant montre comment créer un élément fig à partir d’un title et d’un élément image :

L’exemple suivant montre comment déplacer un title dans un table :

Règles de style de paragraphe

Les éléments paragraphStyleRule sont décrits ci-dessous :

​ élément paraRule

L’élément paraRule est obligatoire. Cette option spécifie les règles de mappage pour tous les styles de paragraphe. Dans un document InDesign, tout le texte se trouve dans une sous-structure de styles de paragraphe. Même les paragraphes sans style sont nommés \[No paragraph style\]. Les crochets, ils indiquent un nom de style InDesign intégré.

Les attributs utilisés dans le paraRule sont expliqués ci-dessous :

Règles de style des caractères

Les éléments charRule sont décrits ci-dessous :

charRuleélément

Il s’agit d’un élément facultatif.

Il s’agit des règles de mappage pour tous les styles de caractères. Dans un document InDesign, tout le texte est contenu dans les éléments enfants des styles de caractères.

Les attributs utilisés dans le charRule sont expliqués ci-dessous :

Règles d’attribut

Cet élément peut être un enfant des contextes d’élément suivants :

L’objectif des règles d’attribut est de gérer les attributs pour les éléments correspondants.

En fonction du contexte, les attributs suivants sont disponibles pour l’élément attributeRules :

Les attributs utilisés dans le attributeRules sont expliqués ci-dessous :

Codes de formatage locaux

Dans n’importe quel document InDesign, les styles de paragraphe et de caractère peuvent comporter plusieurs centaines de remplacements de mise en forme différents. La plupart de ces propriétés ne jouent aucun rôle utile dans le processus de conversion. Cependant, nous avons identifié un ensemble de fonctions de mise en forme qui affectent la sémantique du document et qui doivent influencer le processus de conversion.

Les attributs @local sont présentés sous la forme d’un format délimité spécial où huit champs sont fournis avec un préfixe pour afficher le type de remplacement de la mise en forme. Les champs de codes de formatage sont répertoriés ci-dessous :

L’utilisation attentive de cette fonctionnalité permet de perdre la mise en forme locale et peut contribuer à améliorer la qualité d’un transfert de contenu stylisé vers DITA. Cet exemple peut être résolu en texte italique de 16 points dans une liste à puces : p[Italic|16|-|-|-|b|-|-].

Mappage de structure

Le fichier de mappage de structure est similaire au fichier de mappage de style avec une structure simple qui répertorie tous les types d’éléments sources et d’attributs pertinents. Deux attributs, @map_date et @map_version, sont fournis pour enregistrer la version du fichier de mappage à utiliser.

Type de document

L'élément doctypes répertorie les mappages DITA et de rubrique pris en charge.

Mapper des règles d’élément de type document

L’élément mapDoctypeElemRule est obligatoire. Les attributs de cet élément ne doivent pas être modifiés car l'élément racine du XML source est toujours mappé à l'élément map racine du plan DITA.

Règles d’habillage des éléments

Voir #id194CG600NY4.

elementRulesélément

Cette option répertorie tous les #id194CGC00SHSéléments.

elementRuleélément

L’élément elementRule est obligatoire. Il s’agit des règles de mappage pour tous les éléments sources. Bien qu’un document InDesign contienne des éléments de style non structurés, ils sont ignorés pour le contenu structuré, sauf si le traitement en « mode hybride » est activé.

Les attributs utilisés dans le elementRule sont expliqués ci-dessous :