AEM site id205BE3008SW
Les options suivantes sont disponibles pour la sortie AEM site :
Vous pouvez créer AEM paramètre prédéfini de site de deux manières :
Dans l’éditeur Web : Dans le panneau Repository, ouvrez le fichier de mappage DITA en mode Carte, puis, dans l’onglet Output, sélectionnez l’icône + pour créer un paramètre prédéfini de sortie, puis sélectionnez AEM site dans la liste déroulante type de la boîte de dialogue Add preset (Ajouter un paramètre prédéfini). Dans l'éditeur Web, les paramétrages ont été organisés sous les onglets Général et Avancé :
Général
La variable Général contient les configurations suivantes :
- Nom du site
- Chemin d’accès de sortie
- Pages de sortie existantes
- Suppression de pages de site orphelines
- Appliquer les conditions à l’aide de (si les conditions sont définies pour une carte)
- Utiliser la ligne de base (si une ligne de base est créée pour une carte)
- Processus de génération de publication
Avancé
L'onglet Avancé contient les paramétrages suivants :
- Téléchargement de fichiers temporaires
- Générer un PDF distinct pour chaque rubrique
- Utiliser les propriétés de carte comme valeur par défaut
Pour plus d’informations, voir Configuration AEM site.
Depuis le tableau de bord de la carte
Pour ouvrir les paramètres prédéfinis de sortie pour AEM Site, cliquez sur un fichier de mappage DITA dans l’interface utilisateur d’Assets, puis cliquez sur Paramètres prédéfinis de sortie, puis sur l’option de sortie AEM site. Dans le tableau de bord de mappage, cliquez sur . Modifier dans la partie supérieure pour mettre à jour les différentes configurations, puis cliquez sur Enregistrer.
Configuration AEM site id_aem_site_config
Les options suivantes sont disponibles pour la sortie AEM site :
Un noeud du référentiel AEM est créé avec le nom spécifié ici. Si vous ne spécifiez pas le nom du site, le noeud du site est créé avec le nom du fichier de mappage DITA.
Le nom du site que vous indiquez ici est également utilisé comme titre dans l’onglet du navigateur.
Vous pouvez également utiliser des variables lors de la définition du nom du site. Pour plus d’informations sur l’utilisation des variables, voir Utilisez des variables pour définir le chemin de destination, le nom du site ou le nom de fichier..
Pour plus d’informations sur l’utilisation de modèles de conception personnalisés pour générer une sortie, contactez votre administrateur de publication.
user-guide
et le chemin de destination comme /content/output/aem-guides
, la sortie finale est générée sous le /content/output/aem-guides/user-guide
noeud .Vous pouvez également utiliser des variables lors de la définition du chemin de destination. Pour plus d’informations sur l’utilisation des variables, voir Utilisez des variables pour définir le chemin de destination, le nom du site ou le nom de fichier..
Aucun appliqué: sélectionnez cette option si vous ne souhaitez appliquer aucune condition sur la sortie publiée.
Fichier DITAVal: sélectionnez le ou les fichiers DITAVal pour générer du contenu conditionnel. Vous pouvez sélectionner plusieurs fichiers DITAVal à l’aide de la boîte de dialogue de navigation ou en saisissant le chemin du fichier. Pour le supprimer, utilisez l’icône croisée située à proximité du nom du fichier. Les fichiers DITAVal sont évalués dans l’ordre spécifié. Par conséquent, les conditions spécifiées dans le premier fichier sont prioritaires sur les conditions correspondantes spécifiées dans les fichiers ultérieurs. Vous pouvez conserver l’ordre des fichiers en ajoutant ou en supprimant des fichiers. Si le fichier DITAVal est déplacé vers un autre emplacement ou supprimé, il n’est pas automatiquement supprimé du tableau de bord de la carte. Vous devez mettre à jour l’emplacement au cas où des fichiers seraient déplacés ou supprimés. Vous pouvez placer le pointeur de la souris sur le nom du fichier pour afficher le chemin d’accès dans le référentiel AEM où le fichier est stocké. Vous ne pouvez sélectionner que les fichiers DITAVal et une erreur s’affiche si vous sélectionnez un autre type de fichier.
Paramètre prédéfini de condition: sélectionnez un paramètre prédéfini de condition dans la liste déroulante pour appliquer une condition lors de la publication de la sortie. Cette option est visible si vous avez ajouté une condition pour le fichier de mappage DITA. Les paramètres conditionnels sont disponibles dans l’onglet Paramètres prédéfinis de condition de la console de mappage DITA. Pour en savoir plus sur le paramètre prédéfini de condition, voir Utilisation des paramètres de condition prédéfinis.
Sélectionnez la variable Suppression et création pour forcer la suppression de toutes les pages existantes lors de la publication. Cette option supprime le noeud de page ainsi que son contenu et toutes les pages enfants qu’il contient. Utilisez cette option si vous avez modifié le modèle de conception de votre paramètre prédéfini de sortie ou si vous souhaitez supprimer des pages supplémentaires déjà présentes dans la destination.
Supposons que vous ayez publié une carte DITA, qui contient les rubriques a.dita, b.dita et c.dita. Avant de publier à nouveau la carte, vous avez supprimé la rubrique b.dita de la carte. Désormais, si vous avez sélectionné cette option, tout le contenu lié à b.dita est supprimé de la sortie AEM Site et seuls a.dita et c.dita sont publiés.
Cette fonctionnalité ne supprime pas les mappages enfants publiés. Par exemple, si votre carte parent contient une carte enfant et que vous supprimez la carte enfant entière, le contenu de la carte enfant n’est pas supprimé de la sortie publiée. Cependant, si vous supprimez une rubrique d’un mappage enfant et que vous la republiez, le contenu de la rubrique supprimée est supprimé de la sortie du site.
En outre, s’il existe un contenu référencé et que ce contenu est supprimé avant de le republier, les données du contenu référencé ne sont pas supprimées.
Remarque: les informations sur les pages orphelines supprimées sont également capturées dans les journaux de génération de sortie. Pour plus d’informations sur l’accès aux fichiers journaux, voir Afficher et vérifier le fichier journal.
Après avoir généré la sortie, sélectionnez la variable Téléchargement de fichiers temporaires pour télécharger le dossier ZIP contenant les fichiers temporaires.
Remarque: si vous sélectionnez certaines propriétés de fichier, puis téléchargez les fichiers temporaires, vous obtenez également la variable metadata.xml dans le dossier ZIP.
Dans le champ Chemin du PDF partagé , spécifiez le chemin de stockage des PDF générés pour chaque rubrique.
Remarque: AEM Guides utilise le plug-in DITA-OT nommé pdfx pour générer le PDF pour chaque rubrique. Ce module externe est fourni avec le module DITA-OT fourni d’usine. Vous pouvez personnaliser ce module externe pour générer un PDF en fonction de vos besoins. Si vous utilisez un module externe DITA-OT personnalisé, assurez-vous d’intégrer le module externe pdfx pour bénéficier de la fonctionnalité de génération de PDF au niveau de la rubrique.
Important: lorsque vous générez une sortie incrémentielle pour le site AEM, la sortie est créée à l’aide de la version actuelle des fichiers et non de la ligne de base jointe.
Voir Utilisation de la ligne de base pour plus de détails.
Remarque: les propriétés de métadonnées sont sensibles à la casse.
Si vous avez sélectionné une ligne de base, les valeurs des propriétés sont basées sur la version de la ligne de base sélectionnée. Si vous n’avez pas sélectionné de ligne de base, les valeurs des propriétés sont basées sur la dernière version.
Vous pouvez également transmettre les métadonnées à la sortie à l’aide de la publication DITA-OT. Pour plus d’informations, voir Transmission des métadonnées à la sortie à l’aide de DITA-OT.
Remarque: si vous n’avez pas défini la variable
cq:tags
dans l’option Propriétés , puis les valeurs de cq:tags
sont sélectionnés dans la copie de travail en cours, même si vous avez sélectionné une ligne de base pour la publication.Seules les propriétés String, Date ou Long (unique et à plusieurs valeurs) peuvent être transmises aux pages AEM site. Les valeurs de métadonnées d’une propriété de type chaîne ne prennent pas en charge les caractères spéciaux (tels que
@, #, " "
).* Cette option doit être utilisée avec la variable
Properties
.Remarque supplémentaire sur le site AEM
Génération d’une sortie basée sur des articles à partir de l’éditeur web
Vous pouvez générer la sortie Site AEM pour une ou plusieurs rubriques, ou le mappage DITA entier à partir de l’éditeur web. Vous devez créer des paramètres prédéfinis de sortie pour votre carte DITA, puis vous pouvez facilement générer la sortie AEM Site pour votre carte. Si vous avez mis à jour quelques rubriques dans votre carte, vous pouvez également générer la sortie Site AEM uniquement pour ces rubriques à partir de l’éditeur web. Pour plus d’informations, voir Publication basée sur des articles à partir de l’éditeur web.
Générer des rubriques de liaison de sortie à partir d’autres mappages
Il est très courant de disposer d’un large ensemble de documents répartis dans plusieurs dossiers et mappages DITA. Il devient extrêmement complexe de publier du contenu lié à différents emplacements. Par défaut, tous les liens <xref>
sont créées à l’aide de la fonction local
@scope
. La publication de ces rubriques n’implique aucun problème, car elle utilise un lien direct vers la rubrique. Si la rubrique se trouve en dehors du mappage DITA actuel, le lien n’affiche pas le contenu lié.
Une autre méthode de liaison de contenu consiste à créer un lien à l’aide de la variable peer
@scope
. Pour ce contenu, le lien est résolu au moment de l’exécution en sélectionnant le titre du fichier et le contexte configuré pour la rubrique liée dans le contexte de publication de la carte DITA. La capture d’écran suivante présente le panneau Propriétés d’un lien comportant la variable peer
@scope
:
{width="800"}
Pour simplifier la publication de cartes et de rubriques complexes qui renvoient à d’autres rubriques dans d’autres cartes, AEM Guides vous permet de définir le contexte de publication de chaque paramètre prédéfini de sortie.
Le contexte de publication vous permet de spécifier la rubrique à utiliser à partir de laquelle mapper la publication d’une sortie spécifique. Comprenons cela à l'aide d'un exemple — disons que vous avez quatre dossiers : exemple a, exemple b, exemple c et exemple d. Chaque dossier contient un mappage DITA : mappage DITA A, mappage DITA B, mappage DITA C et mappage DITA D. La liaison entre les mappages se produit lorsqu’une rubrique du mappage DITA A est liée à une rubrique dans les mappages DITA B, C ou D. Dans la capture d’écran suivante, un exemple de rubrique de concept contient des liens (ou des références) vers des fichiers qui font partie d’autres mappages DITA.
{width="350"}
Désormais, lorsque vous configurez les paramètres de publication de site AEM pour le fichier de mappage qui contient cette rubrique, vous pouvez sélectionner le contexte de publication du contenu lié utilisé lors de la publication. Un contexte de publication est une combinaison de mappage DITA et de son paramètre prédéfini de sortie. Le paramètre prédéfini de sortie, à son tour, contient une version spécifique du contenu et des paramètres prédéfinis conditionnels. Cette combinaison complète de la carte DITA, du paramètre prédéfini de sortie, de la version (files) et des conditions définit le contexte de publication pour une carte liée.
Effectuez les étapes suivantes pour spécifier le contexte de publication des fichiers liés entre eux :
-
Ouvrez le Paramètres prédéfinis de sortie de la carte DITA que vous souhaitez publier.
-
Sélectionnez la variable AEM site paramètre prédéfini de sortie.
Les onglets Paramètres AEM et Contexte de publication s’affichent.
{width="800"}
-
Ouvrez le Contexte de publication .
Une liste des rubriques dépendantes s’affiche. Il s’agit des rubriques liées à une rubrique de la carte actuelle, mais elles sont disponibles dans d’autres cartes DITA.
note note NOTE L’onglet Contexte de publication affiche les rubriques liées à l’aide de la variable peer
@scope
uniquement. Pour les liens aveclocal
@scope
, vous n’avez pas besoin de spécifier le contexte de publication.Par défaut, le dernier paramètre prédéfini de sortie et le mappage sont sélectionnés pour toutes les rubriques liées.
{width="800"}
-
Pour modifier la sélection par défaut du mappage et du paramètre prédéfini DITA, cliquez sur Modifier (dans la barre d’outils principale).
-
Si vous souhaitez utiliser la dernière sortie publiée de chaque fichier dépendant dans la carte, sélectionnez Utiliser le contexte de publication généré le plus récemment pour toutes les rubriques dépendantes.
-
Dans le Carte parente dans la liste déroulante, sélectionnez le fichier map avec lequel vous souhaitez lier la sortie de la carte actuelle.
Lors de la sélection d’un fichier de carte, l’UUID de la carte s’affiche dans la colonne UUID de carte parente. Les paramètres prédéfinis de sortie associés à la carte sélectionnée sont répertoriés dans la liste Parent Map’s Preset.
-
Dans le Parent Map's Preset , sélectionnez le paramètre prédéfini de sortie avec lequel vous souhaitez lier la sortie de la carte actuelle.
-
Sélectionnez la carte requise et son paramètre prédéfini de sortie pour toutes les rubriques dépendantes, puis cliquez sur Terminé.
Le contexte des rubriques dépendantes est maintenant défini. Vous pouvez générer la sortie pour la carte actuelle. Pour plus d’informations sur la génération d’une sortie, voir Générer la sortie d’un mappage DITA à partir de la console de mappage.
Publication fusionnée
AEM Guides prend en charge la publication de contenu DITA sur votre site AEM existant. Par exemple, si vous disposez d’un site existant, vous pouvez utiliser la sortie AEM site pour publier uniquement le contenu DITA sur ce site. Dans ce processus, le contenu existant non DITA n’est pas modifié par le processus de publication. Pour plus d’informations sur la configuration de votre site pour publier uniquement du contenu DITA, contactez votre administrateur de publication.
Publication conref
Si vous utilisez conref
dans votre contenu, il est publié en tant que contenu normal ou incorporé avec le contenu de la rubrique source (ou référence). La variable conref
le contenu est rendu avec le contenu principal et aucune page de site distincte n’est créée pour le même contenu. Lorsque vous recherchez le contenu référencé dans la variable conref
, puis seule la rubrique ou la page principale contenant la variable conref
le contenu s’affiche dans les résultats de la recherche.
conref
contenu utilisant AEM Guides version 3.5 ou antérieure, il est recommandé de nettoyer/supprimer ces pages à l’aide de la méthode Suppression de pages de site orphelines .Recherche d’une chaîne dans le contenu
Vous pouvez rechercher une chaîne dans la sortie AEM Site. Par défaut, vous pouvez rechercher la chaîne uniquement dans les titres. Pour rechercher la chaîne dans le contenu ou le corps de la sortie AEM site, contactez votre administrateur système pour activer la propriété flattening.enabled .
{width="650"}
Pour plus d’informations, voir Configuration de l’aplatissement de AEM structure de noeuds Site dans le guide d’installation et de configuration de Adobe Experience Manager Guides.
Rubrique parente : Présentation des paramètres prédéfinis de sortie