Configuration des paramètres de génération de sortie id181AI0B0E30

AEM Guides contient de nombreuses options de configuration vous permettant de personnaliser le processus de génération de sortie. Cette rubrique couvre toutes les configurations et personnalisations qui vous aideront à configurer votre processus de génération de sortie.

Configuration de l’onglet Ligne de base dans le tableau de bord de la carte DITA id223MD0D0YRM

Vous pouvez configurer et masquer l’onglet Ligne de base disponible dans le tableau de bord de la carte.

La variable Masquer l’onglet Ligne de base n’est pas activée par défaut et vous devez l’activer à partir de configMgr. Effectuez les étapes suivantes pour activer l’option par défaut dans l’éditeur web :

Configuration du FrameMaker Publishing Server id1678G0Z0TN6

Vous pouvez utiliser le FrameMaker Publishing Server (FMPS) pour générer une sortie pour votre contenu DITA. La configuration de FMPS vous permet de générer une sortie dans plusieurs formats pris en charge par FMPS.

Pour configurer AEM Guides afin d’utiliser FMPS, mettez à jour les propriétés suivantes du com.adobe.fmdita.config.ConfigManager dans la console web.

Configuration de la publication mixte dans un site AEM existant id1691I0V0MGR

Si vous disposez d’un site AEM qui contient du contenu DITA, vous pouvez configurer la sortie AEM site pour publier du contenu DITA vers un emplacement prédéfini de votre site. Par exemple, dans la capture d’écran suivante d’une page AEM Site, la variable ditacontent est réservé au stockage du contenu DITA :

{width="300"}

Les autres noeuds de la page sont créés directement à partir de l’éditeur de site AEM. La configuration du paramètre de publication pour publier du contenu DITA vers un emplacement prédéfini garantit qu’aucun de vos contenus non DITA existants n’est modifié par le processus de publication AEM Guides.

Vous devez effectuer les configurations suivantes sur votre site existant pour permettre la publication de contenu DITA sur un noeud prédéfini :

Effectuez les étapes suivantes pour configurer les propriétés de modèle de votre site existant :

La capture d’écran suivante montre les propriétés ajoutées dans le noeud de modèle par défaut des AEM Guides :

{width="800"}

La prochaine fois que vous publierez du contenu DITA à l’aide des configurations de modèle de votre site, le contenu sera publié dans les noeuds spécifiés dans la variable topicContentNode et topicHeadNode propriétés.

Toutefois, pour les sites existants, vous devez ajouter manuellement la variable topicContentNode et topicHeadNode noeuds.

Effectuez les étapes suivantes pour ajouter les noeuds requis à votre site existant :

Personnalisation de la sortie AEM site id166TG0B30WR

AEM Guides prend en charge la création de sorties dans les formats suivants :

Pour la sortie Site AEM, vous pouvez affecter différents modèles de conception avec différentes tâches de sortie. Ces modèles de conception peuvent rendre le contenu DITA dans différentes mises en page. Par exemple, vous pouvez spécifier différents modèles de conception pour les audiences internes et externes.

Vous pouvez également utiliser des modules externes DITA Open Toolkit (DITA-OT) personnalisés avec AEM Guides. Vous pouvez charger ces modules externes DITA-OT personnalisés pour générer une sortie PDF d’une manière spécifique.

Personnaliser le modèle de conception pour générer la sortie customize_xml-add-on

AEM Guides utilise un ensemble de modèles de conception prédéfinis pour générer une sortie AEM site. Vous pouvez personnaliser les modèles de conception des Guides d’AEM pour générer la sortie conforme à la valorisation de marque de votre entreprise. Un modèle de conception est un ensemble de différents styles (CSS), scripts (côté serveur et côté client), ressources (images, logos et autres ressources) et noeuds JCR qui lient toutes ces ressources. Un modèle de conception peut être aussi simple qu’un seul script côté serveur avec quelques noeuds JCR ou une combinaison complexe de styles, de ressources et de noeuds JCR. Les modèles de conception sont utilisés par AEM sous-système de publication Guides lors de la génération de la sortie AEM site et contrôlent la structure, l’aspect et l’aspect de la sortie générée.

Il n’y a aucune restriction quant à l’emplacement des ressources du modèle de conception sur le serveur, mais elles sont généralement logiquement organisées selon leur fonction. Par exemple, le modèle par défaut contient tous ses fichiers JavaScript et CSS stockés sous /etc/designs/fmdita/clientlibs/siteoutput/default dossier. Où que ces fichiers soient situés, ils sont liés ensemble par une collection de noeuds JCR. Ensemble, ces noeuds JCR et les fichiers constituent l’ensemble du modèle de conception.

Le modèle de conception par défaut fourni avec AEM Guides vous permet de personnaliser les composants de page d’entrée, de rubrique et de recherche. Vous pouvez faire une copie de la conception par défaut et des modèles de référence correspondants et spécifier différents composants pour générer la sortie souhaitée.

Effectuez les étapes suivantes pour spécifier votre propre modèle de conception à utiliser pour AEM génération de sortie de site :

Pour plus d’informations, voir Création de votre site web First Adobe Experience Manager 6.3 et Principes de base de développer votre propre site web sur AEM.

Utiliser le titre du document pour générer AEM sortie du site

Lors de la génération de la sortie AEM site, la manière dont les URL sont générées joue un rôle important dans la découverte de votre contenu. Si vous utilisez des noms de fichier UUID, la génération d’URL basées sur l’UUID de vos fichiers ne serait pas compatible avec la recherche. En tant qu’administrateur ou éditeur, vous avez le contrôle sur la manière dont vous souhaitez générer les URL pour votre sortie de site AEM. AEM Guides vous donne une configuration par laquelle vous pouvez choisir de générer les URL d’AEM sortie de site à l’aide du titre du fichier plutôt que des noms de fichier basés sur l’UUID. Par défaut, pour les systèmes de fichiers UUID, cette option est activée. Cela impliquait que lorsque vous générez AEM sortie Site pour les systèmes de fichiers UUID, les titres du fichier sont utilisés pour générer les URL et non les UUID des fichiers.

Lors de la génération de la sortie AEM site, la manière dont les URL sont générées joue un rôle important dans la découverte de votre contenu. Dans le cas de systèmes de fichiers non basés sur l’UUID, la sortie AEM Site est générée à l’aide des noms de fichier et non des titres du fichier. En tant qu’administrateur ou éditeur, vous avez le contrôle sur la manière dont vous souhaitez générer les URL pour votre sortie de site AEM. AEM Guides vous donne une configuration par laquelle vous pouvez choisir de générer les URL d’AEM sortie de site à l’aide du titre du fichier plutôt que des noms de fichier. Par défaut, cette option est désactivée. Cela impliquait que lorsque vous générez AEM sortie Site, les noms de fichier sont utilisés pour générer les URL et non le titre du fichier. Vous pouvez choisir de générer les URL en fonction des titres du fichier en activant cette option.

Pour configurer la génération des URL dans AEM sortie Site, procédez comme suit :

Configuration des règles d’assainissement des noms de fichier pour la création de rubriques et la publication AEM sortie du site id2164D0KD0XA

En tant qu’administrateur, vous pouvez définir une liste de caractères spéciaux valides autorisés dans les noms de fichier, qui forment éventuellement l’URL d’une sortie Site AEM. Dans les versions antérieures, les utilisateurs étaient autorisés à définir des noms de fichier contenant des caractères spéciaux, tels que @, $, >, etc. Ces caractères spéciaux entraînaient l’encodage d’URL lors de la génération de pages de site AEM.

À compter de la version 3.8, des configurations ont été ajoutées pour définir une liste de caractères spéciaux autorisés dans les noms de fichier. Par défaut, la configuration du nom de fichier valide contient "a-z A-Z 0-9 - _". Cela signifie que lors de la création d’un fichier, vous pouvez avoir n’importe quel caractère spécial dans le titre du fichier, mais en interne, il sera remplacé par un trait d’union (-) dans le nom du fichier. Par exemple, le titre du fichier peut être Introduction 1 ou Introduction@1, le nom de fichier correspondant généré pour ces deux cas serait Introduction-1.

Lorsque vous définissez une liste de caractères valides, n’oubliez pas que ces caractères "*/:[\]|#%{}?&<>"/+" et a space sera toujours remplacé par un trait d’union (-).

Pour configurer les caractères spéciaux valides dans les noms de fichier et AEM sortie du site, procédez comme suit :

Configuration de l’aplatissement de AEM structure de noeuds Site

Lorsque vous générez AEM sortie Site, un noeud pour chaque élément des rubriques est créé en interne. Pour un mappage DITA contenant des milliers de rubriques, cette structure de noeud peut devenir trop profonde. Ce type de structure de noeuds profondément imbriqués peut présenter des problèmes de performances pour les sites plus volumineux. L’instantané suivant affiche la structure de noeuds profondément imbriqués pour une sortie AEM Site :

{width="300"}

Dans l’instantané ci-dessus, notez qu’un noeud est créé pour chaque p et ses sous-éléments suivants, ainsi qu’une structure similaire, sont créés pour chaque autre élément utilisé dans la rubrique.

AEM Guides vous permet de configurer la manière dont AEM structure de noeud de sortie de site est créée en interne. Vous pouvez aplatir la structure du noeud au niveau des éléments spécifiés, ce qui signifie que vous pouvez définir un élément qui sera considéré comme l’élément principal et tous les sous-éléments qu’il contient seront fusionnés avec l’élément principal. Par exemple, si vous décidez d’aplatir la variable p , puis tout élément apparaissant dans la variable p est fusionné avec l’élément principal. p élément . Une note distincte ne serait créée pour aucun sous-élément dans la variable p élément . L’instantané suivant affiche la structure de noeud aplatie au niveau de p element:

{width="300"}

Pour aplatir AEM structure de noeuds de site, procédez comme suit :

Désormais, lorsque vous générez la sortie Site AEM, les noeuds de la variable p sont aplatis et stockés dans la variable p élément lui-même. Vous trouverez les nouvelles propriétés d’aplatissement pour la variable p dans CRXDE.

{width="650"}

Empêcher l’aplatissement de AEM structure de notes du site

Tout comme pour spécifier le noeud à aplatir dans AEM sortie Site, vous pouvez également spécifier un élément que vous souhaitez exclure de cette configuration. Par exemple, si vous souhaitez aplatir des noeuds au niveau de body , mais vous ne souhaitez pas d’éléments table element dans body pour aplatir, vous pouvez ajouter la propriété exclude dans la propriété table définition de l’élément.

Pour exclure la variable table à partir de l’aplatissement, ajoutez la propriété suivante au table définition de l’élément :

<preventancestorflattening>true|false</preventancestorflattening>

Configuration du contrôle de version pour les pages supprimées dans AEM sortie Site

Lorsque vous générez AEM sortie Site avec Supprimer et Créer ​ ​sélectionnée pour le paramètre Pages de sortie existantes , une version est créée pour la page(s) supprimée. Vous pouvez configurer le système pour arrêter la création d’une version avant la suppression.

Effectuez les étapes suivantes pour arrêter la création d’une version de la page(s) supprimée :

Utilisation de métadonnées pour publier une sortie via DITA-OT id191LF0U0TY4

AEM Guides permet de transmettre des métadonnées personnalisées lors de la publication d’une sortie à l’aide de DITA-OT. En tant qu’administrateur et éditeur, vous devez effectuer les tâches suivantes pour configurer et utiliser des métadonnées personnalisées dans la sortie publiée :

Pour ajouter les métadonnées requises dans le système, procédez comme suit :

Le nouveau paramètre s’affiche désormais sur la page Propriétés pour tous les mappages DITA.

{width="650"}

Ensuite, vous devez rendre les métadonnées personnalisées disponibles dans la console de mappage DITA. Effectuez les étapes suivantes pour rendre les métadonnées personnalisées disponibles sur le tableau de bord de mappage DITA :

Désormais, les métadonnées personnalisées s’affichent dans le Propriétés liste déroulante.

Enfin, en tant qu’éditeur, vous devez inclure les métadonnées personnalisées dans la sortie publiée. Pour traiter les métadonnées personnalisées lors de la génération de la sortie, procédez comme suit :

Les propriétés/métadonnées sélectionnées sont transmises au processus de publication et mises à disposition dans la sortie finale.

Personnalisation du mappage des éléments DITA avec les composants AEM id1679J600HEL

Les éléments DITA dans les Guides AEM sont mappés à leurs composants AEM correspondants. AEM Guides utilise ce mappage dans des processus tels que la publication et la révision pour convertir un élément DITA en composant AEM correspondant. Le mappage est défini dans la variable elementmapping.xml , accessible à partir du mode CRXDE Lite. Accédez à l’URL suivante en mode CRXDE Lite :

/libs/fmdita/config/elementmapping.xml

Vous pouvez utiliser les mappages d’éléments DITA prédéfinis ou vous pouvez mapper des éléments DITA à vos composants d’AEM personnalisés. Pour utiliser vos composants d’AEM personnalisés, vous devez comprendre la structure de la variable elementmapping.xml fichier .

structure elementmapping.xml

Présentation générale de la variable elementmapping.xml La structure est expliquée ci-dessous :

Schéma d’élément DITA

Voici un exemple du schéma d’élément DITA dans elementmapping.xml fichier :

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
    <attribute from="attrname" to="propname" ispath="true|false" rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

Le tableau suivant décrit les éléments du schéma d’élément DITA :

Remarques supplémentaires

Personnalisation de la console de mappage DITA id188HC08M0CZ

AEM Guides vous offre la possibilité d’étendre les fonctionnalités de la console de mappage DITA. Si, par exemple, vous disposez d’un ensemble de rapports différent de ceux disponibles dans AEM Guides, vous pouvez ajouter ces rapports à la console de mappage. Pour personnaliser la console de mappage, vous devez créer une AEM bibliothèque cliente (ou ClientLib) qui contiendra le code pour exécuter les fonctionnalités dont vous avez besoin.

AEM Guides fournit la variable apps.fmdita.dashboard-extn catégorie pour personnaliser la console de mappage. Chaque fois que la console de mappage est chargée, la fonctionnalité créée sous apps.fmdita.dashboard-extn est exécutée et chargée.

Gérer le rendu d’image lors de la génération de la sortie id177BF0G0VY4

AEM est fourni avec un ensemble de workflows et de gestionnaires de médias par défaut pour traiter les ressources. Dans AEM, il existe des workflows prédéfinis pour gérer le traitement des ressources pour les types MIME les plus courants. En règle générale, pour chaque image que vous téléchargez, AEM crée plusieurs rendus du même format binaire. Ces rendus peuvent être de taille différente, avec une résolution différente, avec un filigrane ajouté ou d’autres caractéristiques modifiées. Pour plus d’informations sur la manière dont AEM gère les ressources, voir Traitement des ressources à l’aide des workflows et des gestionnaires de médias dans la documentation AEM.

AEM Guides vous permet de configurer le rendu d’image à utiliser lors de la génération de la sortie pour vos documents. Par exemple, vous pouvez choisir parmi l’un des rendus d’image par défaut ou en créer un et l’utiliser pour publier vos documents. Le mappage de rendu d’image pour la publication de vos documents est stocké dans la variable /libs/fmdita/config/ **renditionmap.xml** fichier . Un extrait de code de renditionmap.xml se présente comme suit :

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

La variable mimetype spécifie le type MIME du format de fichier. La variable rendition output element spécifie le type de format de sortie et le nom du rendu (par exemple, cq5dam.web.1280.1280.jpeg) qui doit être utilisé pour publier la sortie spécifiée. Vous pouvez spécifier les rendus d’image à utiliser pour tous les formats de sortie pris en charge : AEMSITE, PDF, HTML5, EPUB et PERSONNALISÉ.

Si le rendu spécifié n’est pas présent, AEM processus de publication Guides commence par rechercher le rendu web de l’image donnée. Si même le rendu web est introuvable, le rendu d’origine de l’image est utilisé.

Configuration de la période de purge automatique pour l’historique de sortie id19AAI070V8Q

Lorsque vous générez une sortie, la sortie est créée avec les logs de sortie. Pour les mappages DITA volumineux, ces journaux peuvent prendre beaucoup d’espace dans votre référentiel. Par défaut, les journaux sont stockés à l’emplacement suivant dans le référentiel :

/var/dxml/metadata/outputHistory/

Sur une certaine période, la taille collective de tous les fichiers journaux peut atteindre 1 Go. AEM Guides vous permet de configurer une période pour conserver ces fichiers journaux dans le référentiel. Après la période spécifiée, les journaux ainsi que l’historique de génération de sortie sont supprimés du référentiel.

La configuration de la fonction de purge de l’historique a un impact sur la génération de sortie pour tous les mappages DITA dans le référentiel. Dans l’onglet Sorties d’un mappage DITA, l’historique est purgé après le nombre de jours spécifié et à l’heure spécifiée dans le paramètre .

Effectuez les étapes suivantes pour définir un jour et une heure pour purger l’historique et les journaux de sortie :

Modification de la limite de la liste des sorties récemment générées id1679JH0H0O2

Vous pouvez modifier le nombre maximal de sorties générées qui s’affichent dans l’onglet Sorties pour un mappage DITA. Par défaut, une liste des 25 dernières sorties générées s’affiche. Pour modifier le nombre de sorties à afficher dans la liste, mettez à jour la variable Limite de liste des sorties dans le com.adobe.fmdita.config.ConfigManager du lot.

Optimisation des performances de génération de sortie id176LB050VUI

AEM Guides vous permet de configurer la taille du pool des processus de génération de sortie qui contrôle le nombre de processus de génération de sortie qui s’exécutent simultanément. Par défaut, la taille du pool de processus est définie sur le nombre de coeurs de traitement disponibles dans votre système plus un. Vous pouvez définir cette valeur sur 1 si vous souhaitez une publication séquentielle. Dans ce cas, la première tâche de publication est exécutée et la tâche de publication suivante est stockée dans la file d’attente de publication.

Pour modifier la taille du pool de traitement de génération de sortie, mettez à jour la variable Taille du pool de génération dans le com.adobe.fmdita.publish.manager.PublishThreadManagerImpl du lot.