Migration de contenu non DITA id181AH0R02HT
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 :
-
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
, etu
éléments . -
Toutes les listes triées et non triées sont converties en
ol
etul
é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 :
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
Accédez au fichier de configuration par défaut disponible à l’emplacement suivant :
/libs/fmdita/config/w2d_io.xml
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
Accédez au fichier de configuration disponible dans le
apps
node:/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
inprojects
, puis spécifiez l’emplacement comme suit :/content/dam/projects/wordtodita/
-
Dans le
outputDir
, 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-xml /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.
-
-
Enregistrez le fichier
w2d_io.xml
. -
Après avoir configuré les paramètres requis dans la variable
w2d_io.xml
, connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets. -
Accédez à l’emplacement du dossier d’entrée (
wordtodita
). -
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 .
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 et Préparation du fichier de mappage pour l’InDesign à la migration DITA 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 :
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
Accédez au fichier de configuration par défaut disponible à l’emplacement suivant :
/libs/fmdita/config/idml2dita_io.xml
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
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
inprojects
, puis spécifiez l’emplacement comme suit :/content/dam/idmlfiles/indesigntodita/
-
Dans le
outputDir
, 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-xml /stmap.adobeidml.xml
note note NOTE Pour plus d’informations sur la structure de stmap.adobeidml.xml
et comment le personnaliser, voir la section Préparation du fichier de mappage pour l’InDesign à la migration DITA dans Annexe.
-
-
Enregistrez le fichier
idml2dita_io.xml
. -
Après avoir configuré les paramètres requis dans la variable
idml2dita_io.xml
, connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets. -
Accédez à l’emplacement du dossier d’entrée (
indesigntodita
). -
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-xml <?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 baliseclass
définie surbook
. De même, chaqueli
tagclass
doit être défini surtopicref
. -
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 :
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
Accédez au fichier de configuration par défaut disponible à l’emplacement suivant :
/libs/fmdita/config/h2d_io.xml
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
Accédez au fichier de configuration disponible dans le
apps
node:/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
inprojects
, puis spécifiez l’emplacement comme suit :/content/dam/projects/xhtmltodita/
-
Dans le
outputDir
, 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
).
-
-
Enregistrez le fichier
h2d_io.xml
. -
Après avoir configuré les paramètres requis dans la variable
h2d_io.xml
, connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets. -
(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. -
Accédez au fichier h2d.xsl à l’emplacement suivant :
/libs/fmdita/html2dita/
-
Recherchez le paramètre suivant :
<xsl:param name="generate-related-links" select="false()"/>
-
Définissez la valeur du paramètre ci-dessus sur
true()
. -
Enregistrez et fermez le fichier.
-
-
Accédez à l’emplacement du dossier d’entrée (
xhtmltodita
). -
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 :
-
Créez des mappages de style dans FrameMaker et enregistrez ces paramètres dans un fichier .sts.
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
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
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
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.
- Dans le
-
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
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
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 le
ditaAttr
, 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.
-
-
Enregistrez le fichier
style2attrMap.xml
. -
Après avoir configuré les paramètres requis dans la variable
style2attrMap.xml
, connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets. -
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.
-
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. -
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 :
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
Accédez au fichier de configuration par défaut disponible à l’emplacement suivant :
/libs/fmdita/config/XSLConfig.xml
-
Créez un noeud de recouvrement du
config
dans le dossierapps
noeud . -
Accédez au fichier de configuration disponible dans le
apps
node:/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
inprojects
, puis spécifiez l’emplacement comme suit :/content/dam/projects/xsltodita/
-
Dans le
outputDir
, 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
).
-
-
Enregistrez le fichier
XSLConfig.xml
. -
Après avoir configuré les paramètres requis dans la variable
XSLConfig.xml
, connectez-vous à AEM et ouvrez l’interface utilisateur d’Assets. -
Accédez à l’emplacement du dossier d’entrée (
xsltodita
). -
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