Utilisation de la spécialisation DITA-OT et DITA personnalisée id181GAJ0005Z
Le DITA Open Toolkit (DITA-OT) est un ensemble d’outils Java Open Source qui fournissent le traitement des mappages DITA et du contenu des rubriques. AEM Guides vous permet d’importer et d’utiliser facilement des modules externes DITA-OT personnalisés. Une fois importé, AEM Guides peut être configuré pour utiliser le plug-in DITA-OT personnalisé pour générer une sortie dans n’importe quel format. Au moment de générer la sortie, sélectionnez simplement l’option DITA-OT et AEM Guides utilise le plug-in DITA-OT personnalisé pour générer la sortie requise.
Si vous souhaitez traiter les paramètres Ant lors de la publication d’une sortie, AEM Guides vous offre un moyen simple de le faire. Vous pouvez spécifier les paramètres Ant que vous souhaitez utiliser et les mêmes paramètres sont ensuite traités par le processus de publication.
Utilisation des modules externes DITA-OT personnalisés id181NH1020L7
Il existe deux façons d’utiliser le module externe DITA-OT personnalisé pour la publication. La première méthode consiste à charger le module externe DITA-OT personnalisé dans le référentiel AEM. L’autre méthode consiste à enregistrer le module externe DITA-OT personnalisé sur votre serveur, à créer un profil et à fournir l’emplacement du module externe DITA-OT personnalisé dans votre profil.
Par défaut, AEM Guides est fourni avec un profil préconfiguré qui contient les configurations des modèles par défaut à utiliser pour la modification et la publication de contenu. Vous pouvez créer des profils personnalisés avec des modèles personnalisés à utiliser lors de la modification de documents et de modules externes DITA-OT personnalisés pour publier du contenu.
Le package DITA-OT par défaut disponible avec AEM Guides est fourni avec le processeur Apache FOP XSL-FO, qui ne prend pas en charge le rendu des équations MathML. Si vous utilisez des équations MathML dans votre contenu, assurez-vous d’avoir intégré un module externe de moteur de rendu MathML pour Apache FOP ou d’utiliser un autre processeur XSL-FO.
Effectuez les étapes suivantes pour charger le module externe DITA-OT personnalisé dans le référentiel AEM :
-
Connectez-vous à AEM et ouvrez le mode CRXDE Lite.
-
Téléchargez le fichier
DITA-OT.ZIP.L’emplacement du fichier
DITA-OT.ZIPest/libs/fmdita/dita_resources/DITA-OT.zip.
-
Extrayez le contenu du fichier zip sur votre serveur.
-
Utilisez un mécanisme d’intégration de module externe DITA-OT pour intégrer la nouvelle version de DITA-OT à votre module externe DITA-OT personnalisé.
note note NOTE Le séparateur de chemin de classe dans le fichier ZIP du module externe dépend du système d’exploitation, ce qui signifie que si votre serveur est hébergé sous Windows, le séparateur de chemin de classe sera différent de celui utilisé sous Linux. Pour plus d’informations sur l’intégration manuelle des plug-ins, consultez la rubrique Installation manuelle des plug-ins de la documentation DITA-OT. -
Créez à nouveau le fichier ZIP en conservant le même nom (
DITA-OT.ZIP) et la structure de dossiers. -
Téléchargez à nouveau le fichier ZIP mis à jour dans le référentiel AEM.
Vérifiez les vérifications suivantes avant de télécharger le fichier ZIP :
- Exécutez l’intégrateur (pour installer le module externe personnalisé) sur un système d’exploitation Mac/Linux afin d’éviter des problèmes de séparateurs de fichiers. Comme Windows et Linux OS ont des séparateurs de fichiers différents, le module externe intégré à Mac/Linux OS est compatible avec la configuration de Windows et Linux.
- Assurez-vous que le fichier
DITA-OT.ZIPcontient un dossier nommé "DITA-OT" qui contient tous les modules externes et fichiers appropriés. - Vérifiez que le fichier
DITA-OT.ZIPque vous créez est de type mime : "nt:file" (il correspond au type principal du fichier ZIP lors de son téléchargement vers AEM). Utilisez un outil WebDAV ou un déploiement de code pour télécharger ce fichier ZIP vers le chemin d’accès souhaité dans AEM. (N’utilisez pas AEM gestionnaire de packages pour déployer ce fichier ZIP, car ce fichier ZIP n’est pas un module de contenu AEM mais simplement un fichier d’archive.)
note note NOTE Il est recommandé de ne pas remplacer le package DITA-OT par défaut. Vous devez charger votre package DITA-OT personnalisé contenant votre plug-in à un autre emplacement sous le dossier apps. -
Ouvrez le profil DITA par défaut pour le modifier et enregistrez-le (sans effectuer de mise à jour) pour que les modifications soient prises en compte.
Pour créer un profil et le configurer afin d’utiliser le module externe DITA-OT personnalisé stocké sur votre serveur, procédez comme suit :
-
Stockez le module externe DITA-OT personnalisé sur votre serveur.
note note NOTE La structure de dossiers pour le stockage du module externe DITA-OT personnalisé doit être : \*<parent-folder\>*\DITA-OT. -
Cliquez sur le lien Adobe Experience Manager en haut de l’écran et sélectionnez Outils.
-
Sélectionnez Guides dans la liste des outils.
-
Cliquez sur la mosaïque Profils DITA .
note note NOTE Les informations Profil par défaut s’affichent sur la page Profils . Si vous avez mis à niveau AEM Guides de la version 2.2 vers la version 2.5.1 ou 2.6, toutes les modifications effectuées via le gestionnaire de configuration sont automatiquement sélectionnées et stockées dans le profil par défaut. -
Vous pouvez choisir de modifier le profil par défaut, de créer un nouveau profil ou de dupliquer les paramètres du profil par défaut pour créer un nouveau profil.
note note NOTE Vous pouvez mettre à jour le profil par défaut, mais vous ne pouvez pas le supprimer. Cependant, tous les nouveaux profils que vous créez peuvent être modifiés et supprimés. -
Configurez les propriétés suivantes pour utiliser le module externe DITA-OT personnalisé :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 Nom de la propriété Description Propriétés du profil Nom du profil Attribuez un nom unique à ce profil. Réutiliser la sortie (Facultatif) Si votre profil est basé sur un profil existant, sélectionnez cette option. La sélection de cette option garantit qu’AEM Guides n’extrait pas à nouveau le contenu du package DITA-OT et réutilise le package DITA-OT existant. Chemin d’extraction de profil (Facultatif) Spécifiez le chemin où DITA-OT est conservé sur le disque. Par défaut, AEM Guides regroupe un package DITA-OT dans son référentiel et il est extrait sur le disque à ce chemin.
Remarque Vous pouvez définir ce chemin à l’aide de n’importe quelle variable ou propriété système existante. Pour plus d’informations, voir la description de la propriété Variables d’environnement DITA-OT .Chemin attribué (Facultatif) Spécifiez le chemin d’accès dans votre référentiel de contenu pour lequel ce profil est applicable. Vous pouvez spécifier plusieurs emplacements. Propriétés DITA-OT Délai d’expiration DITA-OT (Facultatif) Spécifiez l’heure (en secondes) pendant laquelle AEM Guides attend une réponse du module externe DITA-OT. Si aucune réponse n’est reçue à l’heure indiquée, AEM Guides met fin à la tâche de publication et la tâche est marquée comme en échec. En outre, les logs d’échec sont rendus disponibles dans le fichier journal de génération de sortie.
Valeur par défaut : 300 secondes (5 minutes)Arguments du PDF DITA-OT Spécifiez les arguments de ligne de commande qui sont traités par le module externe DITA-OT personnalisé pour générer la sortie du PDF. Pour tous les profils DITA-OT personnalisés, spécifiez l’argument de ligne de commande suivant : -lib plugins/org.dita.pdf2.fop/lib/Arguments AEM DITA-OT (Facultatif) Spécifiez les arguments de ligne de commande personnalisés qui sont traités par le plug-in DITA-OT personnalisé pour générer la sortie AEM Site. Chemins de la bibliothèque DITA-OT (Facultatif) Spécifiez les chemins de bibliothèque supplémentaires du module externe DITA-OT. XML de création DITA-OT (Facultatif) Spécifiez le chemin d’accès du script de génération Ant personnalisé fourni avec le module externe DITA-OT personnalisé. Ce chemin d’accès est relatif au répertoire DITA-OT de votre système de fichiers. Dossier de script Ant DITA-OT (Facultatif) Spécifiez le chemin d’accès du dossier de script Ant DITA-OT. Ce chemin d’accès est relatif au répertoire DITA-OT de votre système de fichiers. Variables d’environnement DITA-OT (Facultatif) Spécifiez les variables d’environnement à transmettre au processus DITA-OT. Par défaut, AEM Guides ajoute quatre variables : ANT_OPTS,ANT_HOME,PATHetCLASSPATH.
Vous pouvez réutiliser n’importe laquelle des variables ou propriétés d’environnement système existantes pour créer de nouvelles variables d’environnement. Par exemple, si vous avezJAVA_HOMEvariable système définie dans votre système et que vous souhaitez définir une nouvelle variable d’environnement appeléeJAVA_BINcréée à l’aide deJAVA_HOME. Vous pouvez ensuite ajouter la définition deJAVA_BINcomme suit :JAVA_BIN= ${JAVA_HOME}/bin
Remarque Vous pouvez également utiliser les propriétés du système Java pour créer des variables d’environnement. Par exemple, si AEM script de démarrage définit une propriété système Javajava.io.tmpdirsur un répertoire temporaire, vous pouvez utiliser cette propriété pour définir la nouvelle variable comme suit :${java.io.tmpdir}/fmdita/dita_ot.
Important Pour réutiliser une variable ou propriété système existante, elle doit être incluse dans${}.Remplacer la sortie DITA-OT (Facultatif) Si cette option est sélectionnée, vous pouvez spécifier le package DITA-OT disponible sur votre système local pour générer la sortie à l’aide de DITA-OT. Cette configuration est définie lors de l’activation de ConfigManager.
Si vous souhaitez spécifier le chemin d’accès d’un package DITA-OT stocké sur AEM serveur, désélectionnez cette option.AEM DITA-OT Zip Path/Local DITA-OT Directory Path Selon votre sélection dans la sortie de remplacement de DITA-OT, spécifiez le chemin d’accès complet où le fichier DITA-OT.zip personnalisé est stocké. Il peut s’agir du chemin d’accès dans votre référentiel AEM ou système local. Chemin du module externe DITA-OT Chemin d’accès du plug-in personnalisé. Ce module externe est automatiquement intégré au module DITA-OT principal. Intégration de catalogues (Facultatif) Chemin d’accès aux fichiers DTD et XSD catalog.xml personnalisés dans le référentiel AEM. Cela ne doit être fourni que lorsque les catalogues sont manquants dans le package DITA-OT. Ces catalogues sont automatiquement intégrés avec le DITA-OT principal en tant que module externe. Ajout d’un catalogue d’identifiants système (Facultatif) Sélectionnez cette option uniquement s’il manque des entrées d’ID public dans le catalogue ou si les fichiers DITA utilisent uniquement les ID système relatifs au chemin d’accès au serveur à partir duquel ils sont chargés. Chemin temporaire DITA-OT (Facultatif) Spécifiez un emplacement temporaire où les fichiers DITA sont copiés pour traitement. Avant que DITA-OT ne traite les fichiers, ils sont copiés à cet emplacement temporaire. Par défaut, l’emplacement de stockage temporaire est :
Remarque Vous pouvez définir ce chemin à l’aide de n’importe quelle variable ou propriété système existante. Pour plus d’informations, voir la description de la propriété Variables d’environnement DITA-OT .note note NOTE Le programme d’installation d’AEM Guides crée deux variables d’environnement que vous pouvez utiliser pour spécifier le chemin d’accès des fichiers de module externe DITA-OT personnalisés. Ces variables d’environnement sont les suivantes : DITAOT_DIR, qui contient le chemin d’accès au répertoire DITA-OT sur le système de fichiers, et DITAMAP_DIR, qui contient le chemin d’accès à l’emplacement où le contenu de la carte DITA est extrait sur le système de fichiers. -
Cliquez sur Terminé pour enregistrer le profil.
Intégration de la spécialisation DITA id211MB0E00XA
La spécialisation DITA est le processus de création de structures DITA en ajoutant de nouveaux éléments ou en supprimant des éléments existants. Pour créer un élément DITA, vous pouvez prendre un élément DITA existant comme base et le modifier selon vos besoins de création. Essentiellement, la spécialisation DITA vous permet de créer des modèles d’informations personnalisés qui répondent aux besoins de votre entreprise tout en conservant les avantages de l’architecture DITA existante.
Vous pouvez utiliser la fonction Profil pour stocker des paramètres de spécialisation DITA personnalisés. Ces paramètres peuvent ensuite être utilisés au moment de la création et de la publication de contenu DITA personnalisé. AEM Guides vous permet d’utiliser l’ID public et l’ID système dans vos DTD/XSD personnalisés.
Effectuez les étapes suivantes pour créer un nouveau profil et le configurer afin d’utiliser des DTD et des XSD spécialisés dans AEM Guides :
-
Créez sur votre ordinateur local un dossier de spécialisation contenant les DTD et les XSD spécialisés.
-
Indiquez les détails de la DTD dans le fichier
catalog.xmlqui doit également être inclus dans le dossier de spécialisation.note note NOTE Dans le cas de DITA 1.3, l’emplacement par défaut du fichier DTD catalog.xmldans le référentiel AEM est :/libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml. -
Spécifiez les détails XSD dans le fichier
catalog.xmlqui doit également être inclus dans le dossier de spécialisation.note note NOTE Dans le cas de DITA 1.3, l’emplacement par défaut du fichier XSD catalog.xml dans le référentiel AEM est : /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml. -
Téléchargez le dossier à l’emplacement suivant :
/apps/fmdita/dita_resources -
Cliquez sur le lien Adobe Experience Manager en haut de l’écran et sélectionnez Outils.
-
Sélectionnez Guides dans la liste des outils.
-
Cliquez sur la mosaïque Profils DITA .
note note NOTE Les informations Profil par défaut s’affichent sur la page Profils . Si vous avez mis à niveau AEM Guides de la version 2.2 vers la version 2.5.1 ou 2.6, toutes les modifications effectuées via le gestionnaire de configuration sont automatiquement sélectionnées et stockées dans le profil par défaut. -
Vous pouvez choisir de modifier le profil par défaut, de créer un nouveau profil ou de dupliquer les paramètres du profil par défaut pour créer un nouveau profil.
note note NOTE Vous ne pouvez pas supprimer le profil par défaut. Cependant, tous les nouveaux profils que vous créez peuvent être modifiés et supprimés. -
Dans les paramètres Schema > Catalog , spécifiez le chemin des fichiers personnalisés DTD et XSD
catalog.xmldans votre référentiel AEM.note note NOTE Si vous utilisez le schéma personnalisé, vous devez définir le chemin d’accès des fichiers DTD et XSD catalog.xml dans le référentiel AEM dans l’option Intégrer les catalogues . -
Sélectionnez l’option Ajouter le catalogue d’identifiants système .
note note NOTE Sélectionnez cette option uniquement s’il manque des entrées d’ID public dans le catalogue ou si les fichiers DITA utilisent uniquement les ID système relatifs au chemin d’accès au fichier local à partir duquel ils sont chargés. Pour plus d’informations sur d’autres propriétés sur la page Profils, consultez le tableau des propriétés de l’ étape 6 de la section Utilisation des modules externes DITA-OT personnalisés .
-
Cliquez sur Terminé pour enregistrer le profil.