Intégration et utilisation du plug-in DITA-OT personnalisé

Introduction

Dans mon projet récent, j’ai rencontré un scénario dans lequel je devais incorporer un plug-in DITA-OT personnalisé dans le module complémentaire XML. Dans mon article suivant, je vais vous guider à travers les étapes pour intégrer le plugin.

Prérequis

Pour cela, vous aurez besoin

1. AEM 6.4 avec le module complémentaire de documentation XML 3.8.
2. Fichier zip du plug-in DITA-OT personnalisé. (Pour notre cas, nous utiliserons DOCX ou Word Plugin par exemple)

Que faisons-nous?

Avant de passer directement aux étapes, nous allons discuter de ce que nous allons réellement faire. Comme nous le savons tous, le module complémentaire XML est basé sur DITA-OT. Ainsi, nous allons d’abord intégrer le plug-in personnalisé au DITA-OT, puis configurer le module complémentaire XML pour l’utiliser.

Étapes pour intégrer le plugin

1. Dans un premier temps, nous allons télécharger le DITA-OT.zip fichier utilisé par le module complémentaire XML. Il peut être trouvé à deux endroits, un à /apps/fmdita/dita_resources/DITA-OT.zip et un autre à /etc/fmdita/dita_resources/DITA-OT.zip. Nous allons utiliser le DITA-OT.zip qui est présent sous le applications dossier, car AEM par défaut utilise d’abord celui sous le dossier apps.
2. Maintenant que le zip est téléchargé, nous allons intégrer le plugin personnalisé. Pour faire ça,
   1. Décompressez le dossier DITA-OT.zip.
      
   2. Accédez au fichier ../DITA-OT/bin
   3. Ouvrez le terminal à cet emplacement et exécutez la commande DITA-OT ci-dessous,
      dita –install .zip
      Une fois le plugin installé, il affichera « Ajouté com.elovirta.ooxml“.
      Par exemple. dita –install ~/Downloads/com.elovirta.ooxml.zip
      
      

      Commande d’installation du plug-in Dita

   4. Zippez/compressez à nouveau l’intégralité du dossier DITA-OT.
3. Chargez/remplacez le nouveau dossier DITA-OT.zip exactement au même emplacement dans l’AEM.

Nous avons maintenant téléchargé le dossier zip DITA-OT avec notre plugin personnalisé, mais ces modifications ne sont pas encore en vigueur. Pour ce faire, suivez les étapes ci-dessous,

1. Dans AEM, accédez à Outils > Documentation XML > Profils Dita ou utilisez le lien ci-dessous http://localhost:4502/libs/fmdita/profiles/profiles.html
2. Sélectionnez le Profil par défaut ou le profil désiré, et cliquez sur le Editer le profil option du rail supérieur.
3. Cliquez sur Fait pour que les changements prennent effet.

Comment l’utiliser?

Le plug-in DITA-OT personnalisé est en place. Maintenant, pour l’utiliser, nous pouvons ajouter le préréglage du plugin personnalisé soit individuellement pour chaque ditamap, soit pour tous les ditamaps à la fois dans le monde. Ci-dessous, je vais vous montrer les étapes pour ce dernier.

Ajout d’un préréglage de sortie globalement (configuration du plug-in à utiliser)

1. Dans AEM, accédez à Outils > Documentation XML > Profils de dossier ou utilisez le lien ci-dessous http://localhost:4502/libs/fmdita/folderprofiles/profiles.html
2. Cliquez sur ouvrir le Profil global ou le profil souhaité et accédez au Préréglage de sortie section.
3. À partir du rail supérieur, sélectionnez Créer option qui ajoutera un nouveau préréglage à configurer.
   
   1. Pour le Le type de sortie sélectionnez le Personnalisé option,
      

      Préréglage personnalisé

   2. Entrez le nom de la transformation de votre plugin dans le champ Nom de transformation champ. Dans notre cas, c’est «docx”.
      
      

      Nom de transformation

   3. Mettre à jour le Chemin de destination champ,
      
      

      Chemin de destination
   4. Entrez le nom de l’étiquette pour ce préréglage de sortie dans Nom du paramètre champ, dans notre cas, c’est « DOCX”. Cliquez sur Enregistrer.
      
      

      Nom du paramètre

4. Pour rendre ce préréglage disponible sur tous les ditamaps, cochez la case à côté du nouveau préréglage (c’est-à-dire DOCX) et cliquez sur Appliquer les modifications prédéfinies du rail supérieur.
   
   

   Option Appliquer les modifications prédéfinies

5. Lorsque vous cliquez sur Appliquer les modifications prédéfinies bouton, vous obtiendrez un Appliquer les modifications prédéfinies pop-up, sur lequel sélectionnez le D’accord option.
   
   

   Appliquer les modifications prédéfinies

6. Lorsque vous faites cela, vous serez présenté avec le Confirmer l’action pop-up, sélectionnez à nouveau le D’accord option.
   
   

   Confirmer l’action

   
   Remarque : Cela prendra un certain temps. Cela dépend du nombre de ditamaps que vous avez dans le dossier.

Une fois le processus Appliquer le préréglage terminé, vous pouvez ouvrir n’importe quel ditamap et générer la sortie.

Conclusion

En suivant l’approche ci-dessus, vous pouvez intégrer n’importe quel plug-in DITA-OT personnalisé.