DocumentationAEM GuidesDocumentation d’AEM Guides

Migration de contenu non DITA id181AH0R02HT

Last update: Fri Jan 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Experienced
  • Admin

Cette section vous guide tout au long du processus de migration pour migrer des documents non DITA au format DITA. AEM Guides permet la migration à partir des sources suivantes :

Migration de documents Microsoft Word id1949B040Z5Z

AEM Guides vous permet de migrer vos documents Word existants (.docx) dans des documents de type rubrique DITA. Vous devez spécifier les emplacements de dossiers d’entrée et de sortie avec d’autres paramètres et le document est converti en document DITA. Selon le contenu, vous pouvez avoir 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 comporter un titre, suivi de l’en-tête 1, de l’en-tête 2, etc. Chacun des en-têtes doit contenir du contenu. Si votre document n’est pas correctement structuré, le processus risque de ne pas fonctionner comme prévu.

Par défaut, AEM Guides utilise la variable Structure de transformation Word vers DITA (Word2DITA). Cette transformation dépend de la mappage style-balise fichier de configuration. Pour pouvoir utiliser la transformation Word2DITA avec succès, vous devez tenir compte des instructions suivantes pour préparer votre document Word à la conversion :

NOTE
Si vous apportez des modifications au fichier de configuration de mappage de style à balise par défaut, vous devez mettre à jour et utiliser les instructions pour confirmer le mappage de style mis à jour.

  • Assurez-vous que votre document commence par un titre ; ce titre est mappé sur le titre du mappage DITA. En outre, le titre doit être suivi d’un contenu normal.

  • Après le titre, il doit y avoir Titre 1, En-tête 2, etc. Chaque En-tête doit contenir du contenu. Les en-têtes sont convertis en nouvelles rubriques de type Concept . La hiérarchie des rubriques générées correspond aux niveaux d’en-tête du document. Par exemple, l’en-tête 1 précède l’en-tête 2 et l’en-tête 2 précède le contenu de l’en-tête 3.

  • Le document doit comporter au moins un contenu de type En-tête .

  • Assurez-vous que vous ne disposez d’aucune image groupée. Si vous avez groupé des images dans votre document, dissociez toutes ces images.

  • Supprimez tous les en-têtes et pieds de page.

  • Les styles intégrés tels que le gras, l’italique et le soulignement sont convertis en b, i, et u éléments .

  • Toutes les listes triées et non triées sont converties en ol et ul éléments . Cela s’applique également aux listes imbriquées, aux listes dans les tableaux, aux notes ou aux notes de bas de page.

  • Tous les liens hypertexte sont convertis en xref.

  • Le nom de fichier des fichiers convertis est basé sur le texte du titre suivi d’un numéro de fichier. Le numéro de fichier est un numéro séquentiel basé sur la position du texte de l’en-tête dans le document. Par exemple, si un titre est "Exemple d’en-tête" et qu’il est 10e dans le document, le nom de fichier généré pour cette rubrique sera similaire à Sample_Heading_10.dita.

Effectuez les étapes suivantes pour convertir vos documents Word existants en document de type rubrique DITA :

  1. Utilisez le gestionnaire de modules pour télécharger le fichier /libs/fmdita/config/w2d_io.xml .

  2. Personnalisez le fichier w2d_io.xml téléchargé.

  3. Ajoutez le fichier à l’emplacement suivant dans le référentiel Git de Cloud Manager :

    /apps/fmdita/config/w2d_io.xml

    La variable w2d_io.xml contient les paramètres configurables suivants :

    • Dans le inputDir , spécifiez l’emplacement du dossier input dans lequel vos documents Word sources sont disponibles. Par exemple, si vos documents Word sont stockés dans un dossier nommé wordtodita in projects , puis spécifiez l’emplacement comme suit : /content/dam/projects/wordtodita/

    • Dans leoutputDir , spécifiez l’emplacement du dossier output ou conservez l’emplacement de sortie par défaut pour enregistrer le document DITA converti. Si le dossier de sortie spécifié n’existe pas sur DAM, le workflow de conversion crée le dossier de sortie.

    • Pour le createRev spécifiez si une nouvelle version de la rubrique DITA convertie doit être créée (true) ou non (false).

    • Dans le s2tMap , spécifiez l’emplacement du fichier map contenant les mappages des styles de document Word aux éléments DITA. Le mappage par défaut est stocké dans le fichier situé à l’emplacement suivant :

      code language-none 
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      note note
      NOTE
      Pour plus d’informations sur la structure de word-builtin-styles-style2tagmap.xml et comment le personnaliser, voir Association des styles aux balises in Guide de l’utilisateur de DITA for Publishers.

    • Dans l’élément props2Propagate , spécifiez les propriétés à transmettre au mappage DITA. Cette propriété est requise pour transmettre les métadonnées par défaut telles que dc:title,dc:subject,dam:keywords,dam:category des métadonnées de document aux ressources DITA converties.

  4. Exécutez le pipeline Cloud Manager pour déployer la configuration mise à jour.

  5. Après avoir configuré les paramètres requis dans la variable w2d_io.xml , connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets.

  6. Accédez à l’emplacement du dossier d’entrée (wordtodita).

  7. Téléchargez les documents Word source dans ce dossier. Pour plus d’informations sur le chargement de contenu sur DAM, voir Chargement de contenu DITA existant.

En utilisant la variable config /config bloc, vous pouvez définir un ou plusieurs blocs de configurations pour la conversion. Le workflow de conversion est exécuté et la sortie finale sous la forme d’une rubrique DITA est enregistrée à l’emplacement spécifié dans la variable outputDir élément .

Mises à jour de personnalisation pour les utilisateurs existants

Si vous utilisez déjà AEM Guides as a Cloud Service et que vous effectuez une mise à niveau de la version d’août 2021 vers les versions de janvier 2022 ou ultérieures, mettez à jour les propriétés données car peu de fichiers ont été déplacés.

NOTE
Cette mise à jour ne s’applique que si vous utilisez déjà le processus de conversion Microsoft Word vers DITA.
  • Chemin du fichier : /apps/fmdita/config/w2d_io.xml
  • Modifiez la valeur de <s2tMap> de /apps/dxml/word2dita/word-builtin-styles-style2tagmap.xml à /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
  • Apportez les modifications nécessaires dans votre référentiel Git Cloud Manager, car pour le service cloud, tous les fichiers de /apps sont recouverts via le Git de Cloud Manager.

Migration de documents Adobe InDesign id195AD0B0K5Z

AEM Guides vous permet de convertir des documents InDesign. Tout comme FrameMaker, InDesign vous permet de créer des documents structurés et non structurés. Les documents non structurés utilisent les styles de paragraphe et de caractère pour formater le contenu. Le document structuré utilise des éléments et leurs attributs correspondants.

Le processus de conversion nécessite le mappage des formats de paragraphe et de style de caractère aux éléments DITA pertinents. De même, dans le cas des documents structurés, le fichier de mappage contient un mappage un-à-un des éléments et attributs d’InDesign avec des éléments et attributs DITA.

Le processus de conversion implique les actions suivantes dans le serveur principal :

  • La variable Langue de balisage de l’InDesign Le fichier (IDML) est décompressé dans un répertoire de travail.
  • Le fichier designmap.xml est lu pour localiser les différents articles d’InDesign.
  • Tous les articles sont fusionnés en une seule instance XML, les articles "vides" sont ignorés.
  • Tous les graphiques incorporés sont exportés.
  • Préconversion des structures standard telles que les tableaux et les graphiques au format DITA.
  • Mappage de style ou de structure à la sortie finale en fonction du fichier de mappage.
  • Création et validation de rubriques DITA individuelles et de fichiers de mappage DITA.
  • Suppression des fichiers temporaires.

En général, le processus de conversion requiert que vous Préparation des fichiers d’InDesign pour la conversion annexe.md#id195DBF0045Z et Préparation du fichier de mappage pour l’InDesign à la migration DITA annexe.md#id194AF0003HT, vous devez ensuite suivre la procédure d’exécution du processus de conversion.

Effectuez les étapes suivantes pour convertir vos documents InDesign existants en document de type rubrique DITA :

  1. Connectez-vous à AEM et ouvrez le mode CRXDE Lite.

  2. Accédez au fichier de configuration par défaut disponible à l’emplacement suivant :

    /libs/fmdita/config/idml2dita_io.xml

  3. Créez un noeud de recouvrement du config dans le dossier apps noeud .

  4. Accédez au fichier de configuration disponible dans le apps node:

    /apps/fmdita/config/idml2dita_io.xml

    Configurez les paramètres suivants dans le idml2dita_io.xml fichier :

    • Dans le inputDir , indiquez l’emplacement du dossier input dans lequel vos documents d’InDesign source sont disponibles. Par exemple, si vos documents d’InDesign sont stockés dans un dossier nommé indesigntodita in projects , puis spécifiez l’emplacement comme suit : /content/dam/idmlfiles/indesigntodita/

    • Dans leoutputDir , spécifiez l’emplacement du dossier output ou conservez l’emplacement de sortie par défaut pour enregistrer le document DITA converti. Si le dossier de sortie spécifié n’existe pas sur DAM, le workflow de conversion crée le dossier de sortie.

    • Dans le mapStyle spécifiez l’emplacement du fichier map contenant les mappages des styles de document InDesign aux éléments DITA. Le mappage par défaut est stocké dans le fichier situé à l’emplacement suivant :

      code language-none 
      /stmap.adobeidml.xml
      note note
      NOTE
      Pour plus d’informations sur la structure de stmap.adobeidml.xml et comment le personnaliser, voir la section annexe.md#id194AF0003HT dans l’ Annexe .

  5. Enregistrez le fichier idml2dita_io.xml.

  6. Après avoir configuré les paramètres requis dans la variable idml2dita_io.xml , connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets.

  7. Accédez à l’emplacement du dossier d’entrée (indesigntodita).

  8. Téléchargez les documents d’InDesign source dans ce dossier. Pour plus d’informations sur le chargement de contenu sur DAM, voir Chargement de contenu DITA existant.

Migration de documents XHTML id1949B04L0Y4

AEM Guides vous permet de convertir vos documents XHTML existants en documents de type rubrique DITA. Vous devez spécifier les emplacements de dossiers d’entrée et de sortie avec d’autres paramètres et les documents sont convertis au format DITA. Vous pouvez utiliser deux méthodes pour convertir vos documents de HTML structurés :

  • Télécharger tous les documents dans le dossier input ou
  • Créez un fichier ZIP de tous les documents avec les fichiers multimédias et chargez-le dans le dossier input. Cette approche est généralement utilisée pour un ensemble de fichiers de HTML liés les uns aux autres et il existe une table des matières (index.html). Le fichier index.html contient des liens vers tous les fichiers de HTML de l’ensemble.

Que vous téléchargiez tous les fichiers individuellement ou regroupés dans un fichier ZIP, le processus de conversion crée un mappage un-à-un entre les fichiers de HTML et les fichiers DITA qui en résultent. Cela signifie essentiellement qu’un fichier .dita est créé pour chaque fichier .html dans le dossier input.

Les points suivants doivent être pris en compte pour le téléchargement de vos documents dans un fichier ZIP :

  • Toutes les rubriques référencées doivent être placées dans le fichier ZIP.

  • Tous les fichiers multimédias référencés doivent être référencés dans les fichiers de rubrique à l’aide d’un lien relatif.

  • Créez un fichier index.html et ajoutez des liens vers les rubriques que vous souhaitez ajouter dans la table des matières. Ce fichier index.html est utilisé pour créer le fichier de mappage DITA. Dans le fichier index.html, vous pouvez également créer une liste de rubriques imbriquées, comme illustré dans l’exemple de code suivant :

    code language-none 
    <?xml version="1.0" encoding="UTF-8"?>
<html
xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <title>Sample Index File</title>
    </head>
    <body>
        <h1>Sample Index</h1>
        <div class="content">
            <ul class="book">
                <li class="topicref">
                    <a href="Topic1.html">Topic 1</a>
                    <ul class="book">
                        <li class="topicref">
                            <a href="Topic1-1.html">Topic 1.1</a>
                        </li>
                        <li class="topicref">
                            <a href="Topic1-2.html">Topic 1.2</a>
                        </li>
                    </ul>
                </li>
                <li class="topicref">
                    <a href="Topic2.html">Topic 2</a>
                </li>
            </ul>
        </div>
    </body>
</html>

    Notez que chaque ul doit avoir la balise class définie sur book. De même, chaque li tag class doit être défini sur topicref.

  • Si vous utilisez des styles intégrés, convertissez-les en classes de style CSS dans votre fichier XHTML. Ensuite, utilisez le mappage des attributs de style pour convertir ces styles basés sur des classes en DITA. outputclass dans le fichier DITA converti.

    Lors de la génération d’une sortie de HTML ou AEM site à partir de ces fichiers DITA, la variable outputclass Les attributs peuvent être utilisés pour appliquer une classe de style au HTML généré ou au site AEM afin de correspondre au contenu de votre HTML source.

Outre les considérations relatives à la création du fichier ZIP, votre document XHTML doit également être bien structuré. Par exemple, votre document doit comporter une balise Titre, suivie de En-tête 1, En-tête 2, etc. Chacun des en-têtes doit contenir du contenu. Si votre document n’est pas correctement structuré, le processus de migration risque de ne pas fonctionner comme prévu.

Pour convertir votre document XHTML existant en rubrique DITA, procédez comme suit :

  1. Utilisez le gestionnaire de modules pour télécharger le fichier /libs/fmdita/config/h2d_io.xml .

  2. Personnalisez le fichier h2d_io.xml téléchargé.

  3. Ajoutez le fichier à l’emplacement suivant dans le référentiel Git de Cloud Manager :

    /apps/fmdita/config/h2d_io.xml

    La variable h2d_io.xml contient les paramètres configurables suivants :

    • Dans le inputDir , indiquez l’emplacement de votre dossier d’entrée dans lequel vos documents XHTML sources sont disponibles. Par exemple, si vos documents XHTML sont stockés dans un dossier nommé xhtmltodita in projects , puis spécifiez l’emplacement comme suit : /content/dam/projects/xhtmltodita/

    • Dans leoutputDir , indiquez l’emplacement de votre dossier de sortie ou conservez l’emplacement de sortie par défaut. Si le dossier de sortie spécifié n’existe pas sur DAM, le workflow de conversion crée le dossier de sortie.

    • Pour le createRev spécifiez si une nouvelle version de la rubrique DITA convertie doit être créée (true) ou non (false).

  4. Exécutez le pipeline Cloud Manager pour déployer la configuration mise à jour.

  5. Après avoir configuré les paramètres requis dans la variable w2d_io.xml , connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets.

  6. (Facultatif) Vous pouvez également ajouter la section des liens associés aux documents convertis. Pour activer cette fonction, procédez comme suit :

    note note
    NOTE
    Par défaut, la section des liens associés n’est pas créée dans les documents convertis.

    1. Utilisez le gestionnaire de modules pour télécharger le fichier /libs/fmdita/html2dita/h2d.xsl .

    2. Recherchez le paramètre suivant :

      <xsl:param name="generate-related-links" select="false()"/>

    3. Définissez la valeur du paramètre ci-dessus sur true().

    4. Validez le fichier mis à jour à l’emplacement suivant dans le référentiel Git de Cloud Manager :

      /libs/fmdita/html2dita/

    5. Exécutez le pipeline Cloud Manager pour déployer la configuration mise à jour.

  7. Accédez à l’emplacement du dossier d’entrée (xhtmltodita).

  8. Téléchargez les documents XHTML sources dans ce dossier. Pour plus d’informations sur le chargement de contenu sur DAM, voir Chargement de contenu DITA existant.

En utilisant la variable <config> </config> bloc, vous pouvez définir un ou plusieurs blocs de configurations pour la conversion. Le workflow de conversion est exécuté et la sortie finale sous la forme d’une rubrique DITA est enregistrée à l’emplacement spécifié dans la variable outputDir élément .

Migration de documents de FrameMaker non structurés id1949B050VUI

AEM Guides vous permet de convertir votre FrameMaker non structuré existant (.fm et .book) des documents dans des documents DITA. La première étape consiste à créer des mappages de style à l’aide de FrameMaker et à enregistrer ces paramètres dans un fichier .sts. Ensuite, si vous utilisez un DITA personnalisé, vous pouvez mapper vos éléments personnalisés aux formats de FrameMaker source dans le ditaElems.xml fichier . Par exemple, si vous avez créé un élément personnalisé nommé impnote pour gérer toutes les notes importantes, vous pouvez définir cet élément personnalisé dans la variable ditaElems.xml fichier . Une fois cet élément personnalisé défini, AEM Guides ne provoquerait pas d’erreur lors de la conversion d’un document de FrameMaker contenant impnote élément .

En outre, si vous souhaitez spécifier des attributs supplémentaires avec votre élément DITA personnalisé ou valide, vous pouvez les définir dans le fichier style2projMap.xml . Par exemple, vous pouvez spécifier la variable type avec la valeur de important à transmettre avec la variable impnote élément . Ces informations supplémentaires peuvent être spécifiées dans le fichier style2projMap.xml .

En plus de la spécification

Pour convertir vos documents de FrameMaker non structurés existants au format DITA, procédez comme suit :

  1. Créez des mappages de style dans FrameMaker et enregistrez ces paramètres dans un fichier .sts.

  2. Utilisez le gestionnaire de modules pour télécharger le fichier /libs/fmdita/config/ditaElems.xml .

  3. Si vous disposez d’éléments DITA personnalisés, définissez-les dans la variable ditaElems.xml disponible à l’emplacement suivant :

    /libs/fmdita/config/ditaElems.xml

  4. Créez une copie du fichier ditaElems.xml à l’emplacement suivant dans le référentiel Git de Cloud Manager :

    /apps/fmdita/config/ditaElems.xml

  5. Accédez au fichier de configuration disponible dans le apps node:

    /apps/fmdita/config/ditaElems.xml

    La variable ditaElems.xml contient un seul paramètre configurable :

    • Dans le elem , indiquez le nom de l’élément personnalisé que vous souhaitez utiliser dans vos documents DITA convertis. Cet élément serait transmis tel quel dans les documents DITA générés.

  6. Si vous souhaitez spécifier des attributs supplémentaires, définissez-les dans la variable style2attrMap.xml disponible à l’emplacement suivant :

    /libs/fmdita/config/style2attrMap.xml

  7. Créez un noeud de recouvrement du config dans le dossier apps noeud .

  8. Accédez au fichier de configuration disponible dans le apps node:

    /apps/fmdita/config/style2attrMap.xml

    La variable style2attrMap.xml contient les paramètres configurables suivants :

    • Dans le fmStyle , spécifiez le format source utilisé dans le document de FrameMaker que vous souhaitez mapper.

    • Dans leditaAttr , spécifiez l’attribut DITA à mapper avec le format source.

    • Dans le ditaVal , spécifiez la valeur de l’attribut mappé. Si vous ne disposez d’aucune valeur, vous pouvez laisser cette entrée vide.

  9. Enregistrez le fichier style2attrMap.xml.

  10. Après avoir configuré les paramètres requis dans la variable style2attrMap.xml , connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets.

  11. Accédez au document de FrameMaker à convertir et cliquez dessus.

    La console de mappage DITA apparaît et affiche la liste des paramètres prédéfinis de sortie disponibles pour générer la sortie.

  12. Sélectionnez le format de sortie DITA et configurez les paramètres requis.

    note note
    NOTE
    Vous devez utiliser le même fichier de paramètres (.sts) que celui créé dans FrameMaker. Spécifiez également le Nom des paramètres et le Chemin de destination.

  13. Cliquez sur le bouton Générer pour lancer le processus de génération de sortie.

En utilisant la variable <attrMap> </attrMap> bloc, vous pouvez définir un ou plusieurs blocs de configurations pour la conversion. Selon le contenu, vous pouvez avoir un fichier .dita et un fichier .ditamap comme fichiers convertis.

Migration de tout autre document structuré id1949B0590YK

AEM Guides vous permet de convertir vos documents structurés existants en documents DITA valides. Vous devez spécifier les emplacements des dossiers d’entrée et de sortie, l’emplacement de votre fichier de transformation, l’extension avec laquelle la sortie finale est enregistrée et si une nouvelle version du document est requise ou non.

Pour convertir vos documents structurés existants au format DITA, procédez comme suit :

  1. Utilisez le gestionnaire de modules pour télécharger le fichier /libs/fmdita/config/XSLConfig.xml .

  2. Créez une copie du fichier XSLConfig.xml à l’emplacement suivant dans le référentiel Git de Cloud Manager :

    /apps/fmdita/config/XSLConfig.xml

    La variable XSLConfig.xml contient les paramètres configurables suivants :

    • Dans le inputDir , indiquez l’emplacement de votre dossier input dans lequel vos documents structurés sources sont disponibles. Par exemple, si vos documents structurés sont stockés dans un dossier nommé xsltodita in projects , puis spécifiez l’emplacement comme suit : /content/dam/projects/xsltodita/

    • Dans leoutputDir , indiquez l’emplacement de votre dossier de sortie ou conservez l’emplacement de sortie par défaut. Si le dossier de sortie spécifié n’existe pas sur DAM, le workflow de conversion crée le dossier de sortie.

    • Dans le xslFolder , indiquez l’emplacement du dossier où sont stockés les fichiers de transformation XSL.

    • Dans le xslPath , spécifiez l’emplacement du fichier .XSL principal utilisé pour lancer le processus de conversion.

    • Dans le outputExt , spécifiez les extensions de fichier du fichier de sortie final créé à partir du flux de transformation.

    • Pour le createRev spécifiez si une nouvelle version de la rubrique DITA convertie doit être créée (true) ou non (false).

  3. Enregistrez le fichier XSLConfig.xml.

  4. Après avoir configuré les paramètres requis dans la variable XSLConfig.xml , connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets.

  5. Accédez à l’emplacement du dossier d’entrée (xsltodita).

  6. Chargez les documents structurés source dans ce dossier. Pour plus d’informations sur le chargement de contenu sur DAM, voir Chargement de contenu DITA existant.

En utilisant la variable <config> </config> bloc, vous pouvez définir un ou plusieurs blocs de configurations pour la conversion. Le workflow de conversion est exécuté et la sortie finale sous la forme d’une rubrique DITA est enregistrée à l’emplacement spécifié dans la variable outputDir élément .

Rubrique parente : ​ Migration de contenu existant

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178