Vous disposez des options suivantes pour filtrer les fichiers et affiner votre recherche dans le référentiel Adobe Experience Manager :
- Fichiers DITA : vous pouvez rechercher toutes les rubriques DITA et les cartes DITA présentes sur le chemin sélectionné. Ils sont sélectionnés par défaut.
- Fichiers non DITA : vous pouvez rechercher des fichiers Ditaval, des fichiers image, des fichiers multimédias, des documents et des fichiers Json dans le chemin d’accès sélectionné.
Utilisez les filtres rapides pour rechercher des fichiers DITA et non DITA.
Filtrage avancé
Sélectionnez l'icône Filtrage avancé
Vous pouvez afficher les options suivantes sous les onglets Général et Avancé .
Général
- Les résultats de la recherche seront les suivants : recherchez du texte dans les fichiers présents sur le chemin d’accès sélectionné du référentiel Adobe Experience Manager. Le texte est recherché dans le titre, le nom de fichier et le contenu des fichiers.
Elle est synchronisée avec la zone de recherche de la fenêtre du référentiel. Par exemple, si vous tapez general purpose dans la zone de recherche du panneau du référentiel, il apparaît également dans la boîte de dialogue Filtre avancé et vice versa.
-
Rechercher dans : sélectionnez le chemin d’accès où vous souhaitez rechercher les fichiers présents dans le référentiel Adobe Experience Manager.
-
Extraits par : vous pouvez rechercher les fichiers que l’utilisateur spécifié extrait.
-
Dernière modification : vous pouvez rechercher les fichiers qui ont été modifiés pour la dernière fois après une date sélectionnée, mais avant une date sélectionnée.
-
Modifié avant : vous pouvez rechercher les fichiers qui ont été modifiés pour la dernière fois avant une date sélectionnée.
-
Période : vous pouvez également rechercher les fichiers qui ont été modifiés pour la dernière fois au cours des deux dernières heures, de la semaine dernière, du mois dernier ou de l’année dernière.
-
Balises : vous pouvez rechercher des fichiers auxquels des balises spécifiques sont appliquées. Vous pouvez saisir la balise ou la sélectionner dans la liste déroulante.
Avancé
-
Eléments DITA : vous pouvez également rechercher des valeurs spécifiques dans les attributs des éléments DITA spécifiés.
- Sélectionnez Ajouter un élément
- Appliquez les filtres que vous avez sélectionnés.
- Sélectionnez Ajouter un élément
-
Sélectionnez Effacer tout pour effacer tous les filtres appliqués.
-
Sélectionnez l'icône Fermer le filtre
note note NOTE L’administrateur du système peut également configurer les filtres de texte et afficher ou masquer d’autres filtres. Pour plus d’informations, reportez-vous à la section Configuration des filtres de texte de la as a Cloud Service Installer et configurer Adobe Experience Manager Guides. La liste des fichiers filtrés contenant le texte recherché s’affiche. Par exemple, les fichiers contenant le texte general purposesont répertoriés dans la capture d’écran précédente. Vous pouvez sélectionner plusieurs fichiers de la liste filtrée pour les faire glisser dans une carte ouverte à des fins d’édition.
Menu Options
Outre l’ouverture de fichiers à partir du panneau de gauche, vous pouvez également effectuer de nombreuses actions à l’aide du menu Options disponible dans la vue Repository. Selon que vous sélectionnez un dossier, un fichier de rubrique ou un fichier multimédia, différentes options s’affichent.
Options pour un dossier
Vous pouvez effectuer les actions suivantes à l’aide du menu Options disponible pour un dossier dans la vue Repository :
-
Créer : créez une rubrique DITA, un mappage DITA ou un dossier. Pour plus d’informations, voir la procédure Créer des rubriques à partir de la vue du référentiel dans la section Panneau gauche .
-
Télécharger Assets : téléchargez un fichier de votre système local vers le dossier sélectionné dans le référentiel Adobe Experience Manager. Vous pouvez également faire glisser des fichiers de votre système local vers votre rubrique de travail actuelle. Cela s’avère très utile si vous souhaitez insérer des images de votre système local dans votre rubrique.
Vous pouvez sélectionner un dossier dans lequel vous souhaitez charger le fichier et un aperçu de l’image s’affiche également. Si vous souhaitez renommer le fichier, vous pouvez le faire dans la zone de texte Nom du fichier . Cliquez sur Télécharger pour terminer le processus de téléchargement de fichier. Si vous avez fait glisser et déposé un fichier image sur une rubrique, le fichier image est ajouté à l’article et téléchargé.
Si votre administrateur a activé l’option UUID dans XMLEditorConfig, l’UUID de l’image téléchargée s’affiche dans la propriété Source.
-
Rechercher des fichiers dans le dossier : déplace la cible d’action vers la recherche de référentiel dans laquelle vous pouvez saisir le terme de recherche. La recherche est effectuée sous le dossier sélectionné dans le référentiel. Vous pouvez également appliquer un filtre pour renvoyer des fichiers DITA, des fichiers image ou les deux.
Vous pouvez également effectuer des recherches à l’aide de l’UUID d’un fichier. Dans ce cas, les résultats de recherche affichent le titre du fichier DITA/XML et, dans le cas où le fichier est un fichier image, l’UUID du fichier s’affiche. Dans l’exemple de recherche suivant, la recherche porte sur l’UUID d’un fichier image et les résultats de recherche affichent l’UUID du fichier image d’origine et le titre de la rubrique du fichier dans lequel cette image est référencée.
-
Réduire tout : réduisez tous les dossiers ouverts dans le référentiel et affichez uniquement les dossiers de niveau racine.
note note NOTE Utilisez l’icône > en regard d’un dossier pour le développer. -
Ajouter aux favoris : ajoute le dossier sélectionné aux favoris. Vous pouvez choisir de l’ajouter à une collection de favoris existante ou nouvelle.
-
Actualiser : obtenir une nouvelle liste de fichiers et de dossiers à partir du référentiel.
-
Afficher dans l’interface utilisateur d’Assets : affichez le contenu du dossier dans l’interface utilisateur d’Assets.
Options pour un fichier
Le menu Options propose différentes options selon que vous sélectionnez un fichier multimédia ou un fichier DITA. Voici quelques options courantes disponibles pour les fichiers multimédia et DITA :
- Dupliquer
- Extraction/archivage
- Prévisualisation
- Déplacer vers
- Renommer
- Supprimer
- Copier
- Tout réduire
- Ajouter aux Favoris
- Propriétés
- Affichage dans l’interface utilisateur d’Assets
Menu
Les différentes options du menu Options sont expliquées ci-dessous :
-
Modifier : ouvrez le fichier à modifier. Dans le cas d’un fichier .ditamap/.bookmap, il est ouvert dans l’ éditeur de cartes avancé pour modification.
-
Dupliquer : utilisez cette option pour créer un doublon ou une copie du fichier sélectionné. Vous avez également la possibilité de renommer le fichier dupliqué à l’invite Dupliquer la ressource . Par défaut, le fichier est créé avec un suffixe (comme filename_1.extension). Le titre du fichier reste identique à celui du fichier source et le nouveau fichier commence par la version 1.0. Toutes les références, balises et métadonnées sont copiées alors que les lignes de base ne sont pas copiées dans le fichier en double.
-
Extraire : obtenez un verrou sur le fichier sélectionné en vue de le modifier. Pour un fichier verrouillé, cette option devient Check In.
note note NOTE - Si un fichier est verrouillé ou extrait par un utilisateur, placez le pointeur de la souris sur l’icône de verrouillage pour afficher l’utilisateur (nom) qui a verrouillé le fichier.
- Lorsque vous archivez un fichier contenant des modifications non enregistrées, vous êtes invité à les enregistrer. Si vous n’enregistrez pas vos modifications, il extrait uniquement le fichier.
-
Aperçu : obtenir un aperçu rapide du fichier (.dita, .xml, audio, vidéo ou image) sans l’ouvrir. Vous pouvez redimensionner le volet d’aperçu. Si le contenu contient
<xref>ou<conref>, vous pouvez le sélectionner pour l’ouvrir dans un nouvel onglet. Le titre du fichier s’affiche dans la fenêtre. Si aucun titre n’est présent, le nom du fichier s’affiche. Pour fermer le volet Aperçu, vous pouvez sélectionner l’icône de fermeture ou cliquer n’importe où en dehors du volet.
-
Renommer : utilisez cette option pour renommer le fichier sélectionné. Saisissez le nom du nouveau fichier dans la boîte de dialogue Renommer la ressource.
- Vous pouvez renommer un fichier de n’importe quel type.
- Vous ne pouvez pas modifier l’extension d’un fichier.
- Deux fichiers ne peuvent pas porter le même nom. Ainsi, vous ne pouvez pas renommer un fichier avec un nom existant. Une erreur s’affiche.
-
Déplacer vers : utilisez cette option pour déplacer le fichier sélectionné vers un autre dossier.
- Vous pouvez saisir le nom du dossier de destination ou choisir Sélectionner le chemin pour sélectionner le dossier de destination.
- Vous pouvez déplacer un fichier de n’importe quel type vers n’importe quelle destination dans le dossier Contenu .
- Deux fichiers ne peuvent pas porter le même nom. Ainsi, vous ne pouvez pas déplacer un fichier vers un dossier dans lequel il existe déjà un fichier portant le même nom.
Si vous essayez de déplacer un fichier vers un dossier dans lequel il existe un fichier portant le même nom mais dont le titre est différent, la boîte de dialogue Renommer et déplacer le fichier s’affiche. Vous devez renommer le fichier avant de le déplacer. Le fichier déplacé dans le dossier de destination porte le nouveau nom de fichier.
note note NOTE Vous pouvez également faire glisser un fichier vers un autre dossier de destination. Scénarios d’exclusion
AEM Guides ne vous permet pas de renommer ou de déplacer un fichier dans les cas suivants :
-
Vous ne pouvez pas déplacer ou renommer un fichier s’il fait partie d’un processus de révision ou de traduction.
-
Si un autre utilisateur extrait le fichier, vous ne pouvez pas le renommer ni le déplacer, l’option Renommer ou Déplacer vers ne s’affiche pas pour le fichier.
note note NOTE Si votre administrateur vous a attribué les autorisations sur un dossier, seules les options Renommer ou Déplacer vers s’affichent. accordion Services cloud Le fait de renommer ou de déplacer un fichier n’interrompt aucune référence existante depuis ou vers le fichier, car chaque fichier comporte un UUID unique. -
Supprimer : utilisez cette option pour supprimer le fichier sélectionné. Une invite de confirmation s’affiche avant de supprimer le fichier.
-
Une invite de confirmation s’affiche avant de supprimer le fichier.
-
Si le fichier n’est référencé dans aucun autre fichier, il est supprimé et un message de réussite s’affiche.
-
Si le fichier est extrait, vous ne pouvez pas le supprimer et un message d’erreur s’affiche.
note note NOTE Si votre administrateur a empêché la suppression des fichiers extraits, le message d’erreur s’affiche uniquement. Pour plus d’informations, voir la section Empêcher la suppression des fichiers extraits de la as a Cloud Service Installer et configurer Adobe Experience Manager Guides. -
Si le fichier est ajouté à une collection de favoris, la boîte de dialogue Forcer la suppression s’affiche et vous pouvez le supprimer de force.
-
Si le fichier est référencé à partir d’un autre fichier, la boîte de dialogue Forcer la suppression avec le message de confirmation s’affiche et vous pouvez le supprimer de force :
note note NOTE Si votre administrateur a autorisé la suppression du fichier, l’option Forcer la suppression est activée. Sinon, Forcer la suppression est désactivé et un message s’affiche indiquant que vous n’êtes pas autorisé à supprimer les fichiers référencés. Pour plus d’informations, voir la section Empêcher la suppression des fichiers référencés de la as a Cloud Service Installer et configurer Adobe Experience Manager Guides. -
Si vous supprimez une rubrique référencée et que vous avez ouvert le fichier contenant des références à modifier, le lien rompu du fichier référencé s’affiche.
note note NOTE Vous pouvez également supprimer le fichier sélectionné de la même manière à l’aide de la touche Suppr du clavier. -
-
Copier : vous pouvez choisir parmi les options suivantes :
-
Copier l’UUID : copiez l’UUID du fichier sélectionné dans le Presse-papiers.
-
Copier le chemin : copiez le chemin d’accès complet du fichier sélectionné dans le Presse-papiers.
-
-
Réduire tout : réduisez tous les fichiers dans le référentiel. Seuls les dossiers de niveau supérieur du référentiel s’affichent.
-
Ajouter à : vous pouvez choisir parmi les options suivantes :
-
Favoris : ajoute le fichier sélectionné aux favoris. Vous pouvez choisir de l’ajouter à une collection de favoris existante ou nouvelle.
-
Contenu réutilisable : ajoute le fichier sélectionné à la liste Contenu réutilisable du panneau de gauche.
-
-
Propriétés : utilisez cette option pour ouvrir la page des propriétés du fichier sélectionné. Cette page de propriétés est également accessible à partir de l’interface utilisateur d’Assets en sélectionnant un fichier et en cliquant sur l’icône Propriétés de la barre d’outils.
-
Ouvrir le tableau de bord de la carte : si le fichier sélectionné est une carte DITA, cette option ouvre le tableau de bord de la carte.
-
Modifier dans Oxygen : sélectionnez cette option pour modifier le fichier sélectionné dans le module externe du connecteur Oxygen. Le fichier est ouvert pour modification.
note note NOTE Contactez votre équipe de réussite client pour que cette fonctionnalité soit activée dans l’environnement. Cette fonctionnalité n’est pas activée dans le cadre de la prise en charge prête à l’emploi. Pour plus d’informations, consultez la section Configuration de l’option à modifier dans Oxygen du Guide d’installation et de configuration. -
Afficher dans l’interface utilisateur d’Assets : utilisez cette option pour afficher un aperçu d’un fichier .dita/.xml dans l’interface utilisateur d’Assets. Dans le cas d’un fichier .ditamap/.bookmap, tous les fichiers de rubrique du mappage sont affichés dans une seule vue page par page unifiée.
-
Télécharger en tant que PDF : utilisez l’option pour générer la sortie du PDF et la télécharger.
-
Publish As : utilisez l’option pour publier une rubrique ou les éléments d’une rubrique dans un fragment de contenu.
-
Génération rapide : générez la sortie pour le fichier sélectionné. La sortie ne peut être générée que pour les fichiers faisant partie d’un paramètre prédéfini de sortie. Pour plus d’informations, voir Publication basée sur un article à partir de l’éditeur web.
Création de rubriques à partir de la vue Repository
Vous pouvez choisir de créer une rubrique, un mappage ou un dossier à partir de l’icône + en regard du panneau Référentiel ou du menu contextuel d’un dossier en mode Référentiel.
Créer une rubrique
Lorsque vous choisissez de créer une nouvelle rubrique à partir du menu, la boîte de dialogue suivante s’affiche :
Dans la boîte de dialogue Créer une nouvelle rubrique, fournissez les détails suivants :
-
Un modèle sur lequel sera basé la rubrique. Par exemple, pour une configuration d’usine, vous pouvez choisir parmi les modèles vierges, Concept, DITAVAL, Référence, Tâche, Rubrique et Dépannage .
Si un profil de dossier est configuré sur votre dossier, vous ne verrez que les modèles de rubrique configurés sur le profil de dossier.
-
Chemin d’accès où vous souhaitez enregistrer le fichier de rubrique. Par défaut, le chemin d’accès au dossier actuellement sélectionné dans le référentiel s’affiche dans le champ Chemin .
-
Titre de la rubrique.
-
(Facultatif) Nom de fichier de la rubrique. Le nom de fichier est suggéré automatiquement en fonction du titre de la rubrique.
Si votre administrateur a activé les noms de fichiers automatiques en fonction du paramètre UUID , le champ Nom n’apparaît pas comme illustré dans la capture d’écran suivante :
Lorsque vous cliquez sur Créer, la rubrique est créée à l’emplacement spécifié. En outre, la rubrique est ouverte dans l’éditeur Web pour modification.
Création d’une carte DITA
Lorsque vous choisissez de créer une carte DITA, la boîte de dialogue suivante s’affiche :
Dans la boîte de dialogue Créer une carte, fournissez les détails suivants :
-
Un modèle sur lequel la carte sera basée. Par exemple, pour une configuration prête à l’emploi, vous pouvez choisir parmi les modèles Bookmap ou DITA map .
-
Chemin d’accès où vous souhaitez enregistrer le fichier de mappage. Par défaut, le chemin d’accès au dossier actuellement sélectionné dans le référentiel s’affiche dans le champ Chemin .
-
Un Titre pour la carte.
-
(Facultatif) Nom de fichier de la carte. Le nom de fichier est suggéré automatiquement en fonction du titre de la carte.
Si votre administrateur a activé les noms de fichiers automatiques en fonction du paramètre UUID, le champ Nom ne s’affiche pas.
Lorsque vous cliquez sur Créer, la carte est créée et ajoutée dans le dossier spécifié dans le champ Chemin d’accès. En outre, la carte est ouverte dans la vue Carte. Vous pouvez ouvrir le fichier de mappage dans l’éditeur de mappage et y ajouter une rubrique. Pour plus d’informations sur l’ajout de rubriques à un fichier map, voir Création d’une carte.
Créer un dossier
Lorsque vous choisissez de créer un dossier, vous obtenez la boîte de dialogue Créer un dossier :
Saisissez un Titre pour le dossier, qui est automatiquement converti en nom de dossier. Le chemin d’accès est l’emplacement où vous souhaitez enregistrer le fichier de carte. Par défaut, le chemin d’accès au dossier actuellement sélectionné dans le référentiel s’affiche dans le champ Chemin . Lorsque vous cliquez sur Créer, le dossier est créé et ajouté dans le dossier à partir duquel l’option Créer un dossier a été exécutée.
Vue Carte -
Lorsque vous cliquez sur l’icône Affichage des cartes , vous obtenez une liste des rubriques dans le fichier de carte. Si vous n’avez ouvert aucun fichier de carte, la vue Carte apparaît vide. Double-cliquez sur un fichier de carte pour ouvrir le fichier de carte dans cette vue. Vous pouvez double-cliquer sur un fichier de la carte pour l’ouvrir dans l’éditeur Web.
Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
Lorsque vous ouvrez une carte en mode Carte, le titre de la carte active s’affiche au centre de la barre d’outils principale. Si le titre est trop long, des points de suspension s’affichent et vous pouvez également survoler le titre avec la souris pour afficher le titre complet dans l’info-bulle.
Lorsque vous définissez des attributs clés pour la rubrique ou les références de mappage, vous pouvez afficher le titre, l’icône correspondante et la clé dans le panneau de gauche. La clé s’affiche sous la forme keys=<key-name>.
Si vous disposez de droits de modification sur les fichiers de mappage, vous pourrez également modifier les fichiers. Pour plus d’informations sur l’ouverture et la modification d’une rubrique via le mappage DITA, voir Modification de rubriques via le mappage DITA.
Vous pouvez effectuer les actions suivantes à l’aide du menu Options du fichier de carte :
-
Modifier : ouvrez le fichier map en vue de le modifier dans l’éditeur de mappage avancé.
-
Sélectionner tout : sélectionnez tous les fichiers de la carte.
-
Effacer la sélection : désélectionnez les fichiers sélectionnés dans la carte.
-
Extraction et verrouillage : extraction et verrouillage des fichiers sélectionnés dans la carte.
-
Annuler l’extraction et déverrouiller : déverrouille le fichier de mappage et le rend disponible pour modification. Il ne rétablit pas les modifications apportées à la version antérieure.
-
Enregistrer comme nouvelle version et déverrouiller : créez une version plus récente et déverrouillez les fichiers sélectionnés dans la carte.
-
Aperçu : ouvrez un aperçu du fichier de mappage. Dans cette vue, tous les fichiers de rubrique dans le mappage sont affichés dans une seule vue page par page unifiée.
-
Copier : vous pouvez choisir parmi les options suivantes :
- Copier l’UUID : copiez l’UUID du fichier de mappage dans le Presse-papiers.
- Copier le chemin : copiez le chemin d’accès complet du fichier de mappage dans le Presse-papiers.
-
Locate in Repository : affiche l’emplacement du fichier map dans le référentiel (ou DAM).
-
Ajouter à : vous pouvez choisir parmi les options suivantes :
-
Favoris : ajoute le fichier de mappage aux favoris. Vous pouvez choisir de l’ajouter à une collection de favoris existante ou nouvelle.
-
Contenu réutilisable : ajoute le fichier map à la liste Contenu réutilisable dans le panneau de gauche.
-
-
Propriétés : utilisez cette option pour ouvrir la page des propriétés du fichier de carte. Cette page de propriétés est également accessible à partir de l’interface utilisateur d’Assets en sélectionnant un fichier et en cliquant sur l’icône Propriétés de la barre d’outils.
-
Ouvrir le tableau de bord de carte : ouvrez le tableau de bord de carte.
-
Afficher dans l’interface utilisateur d’Assets : utilisez cette option pour afficher un aperçu du fichier de mappage dans l’interface utilisateur d’Assets. Dans cette vue, tous les fichiers de rubrique dans le mappage sont affichés dans une seule vue page par page unifiée.
-
Télécharger la carte : sélectionnez cette option pour ouvrir la boîte de dialogue Télécharger la carte.
Dans la boîte de dialogue Télécharger la carte, vous pouvez choisir les options suivantes :
-
Utiliser la ligne de base : sélectionnez cette option pour obtenir une liste des lignes de base créées pour le mappage DITA. Si vous souhaitez télécharger le fichier de mappage et son contenu en fonction d’une ligne de base spécifique, sélectionnez la ligne de base dans la liste déroulante. Pour plus d’informations sur l’utilisation des lignes de base, voir Utilisation de la ligne de base.
-
Aplatir la hiérarchie de fichiers : sélectionnez cette option pour enregistrer toutes les rubriques et tous les fichiers multimédias référencés dans un seul dossier.
Vous pouvez également télécharger le fichier map sans sélectionner d’option. Dans ce cas, les dernières versions conservées des rubriques et des fichiers multimédia référencés sont téléchargées.
Après avoir cliqué sur le bouton Télécharger, la demande d’exportation de package de mappage est mise en file d’attente. La boîte de dialogue Succès s’affiche si le module est créé avec succès. Vous pouvez cliquer sur le bouton Télécharger dans la boîte de dialogue Succès.
Vous recevez la notification prête à être téléchargée si la carte est prête à être téléchargée. En cas d’échec du téléchargement, vous recevez la notification indiquant que le téléchargement de carte a échoué.
Vous pouvez accéder au lien de téléchargement à partir de la boîte de réception des notifications AEM. Sélectionnez la notification de carte générée dans la boîte de réception pour télécharger la carte au format .zip.
note note NOTE Par défaut, les mappages téléchargés restent pendant cinq jours dans la boîte de réception des notifications AEM. -
Générer la sortie : générez la sortie pour le fichier de mappage sélectionné. La sortie ne peut être générée que pour les fichiers faisant partie d’un paramètre prédéfini de sortie. Pour plus d’informations, voir Publication basée sur un article à partir de l’éditeur web.
-
Fermer : ferme le fichier map.
La capture d’écran suivante présente le menu Options d’un fichier dans la vue Carte DITA :
Vous pouvez effectuer les actions suivantes à l’aide du menu Options :
-
Modifier : ouvrez le fichier à modifier. Dans le cas d’un fichier .ditamap/.bookmap, il est ouvert dans l’ éditeur de cartes avancé pour modification.
-
Extraire : extrait le fichier sélectionné. Pour un fichier extrait, cette option devient Check In.
note note NOTE - Si un fichier est verrouillé ou extrait par un utilisateur, placez le pointeur de la souris sur l’icône de verrouillage pour afficher l’utilisateur (nom) qui a verrouillé le fichier.
- Lorsque vous archivez un fichier, vous êtes invité à enregistrer les modifications. Si vous n’enregistrez pas vos modifications, il extrait uniquement le fichier.
-
Aperçu : obtenir un aperçu rapide du fichier (.dita, .xml, audio, vidéo ou image) sans l’ouvrir. Vous pouvez redimensionner le volet d’aperçu. Si le contenu contient
<xref>ou<conref>, vous pouvez le sélectionner pour l’ouvrir dans un nouvel onglet. Le titre du fichier s’affiche dans la fenêtre. Si aucun titre n’est présent, le nom du fichier s’affiche. Pour fermer le volet Aperçu, vous pouvez sélectionner l’icône de fermeture ou cliquer n’importe où en dehors du volet. -
Copier : vous pouvez choisir parmi les options suivantes :
- Copier l’UUID : copiez l’UUID du fichier sélectionné dans le Presse-papiers.
- Copier le chemin : copiez le chemin d’accès complet du fichier sélectionné dans le Presse-papiers.
-
Locate in Repository : affiche l’emplacement du fichier sélectionné dans le référentiel (ou DAM).
-
Développer tout : développez toutes les rubriques des fichiers de mappage.
-
Réduire tout : réduisez toutes les rubriques qui font partie du fichier map actuel.
-
Ajouter à : vous pouvez choisir parmi les options suivantes :
-
Favoris : ajoute le fichier sélectionné aux favoris. Vous pouvez choisir de l’ajouter à une collection de favoris existante ou nouvelle.
-
Contenu réutilisable : ajoute le fichier sélectionné à la liste Contenu réutilisable du panneau de gauche.
-
-
Propriétés : utilisez cette option pour ouvrir la page des propriétés du fichier sélectionné. Cette page de propriétés est également accessible à partir de l’interface utilisateur d’Assets en sélectionnant un fichier et en cliquant sur l’icône Propriétés de la barre d’outils.
-
Afficher dans l’interface utilisateur d’Assets : utilisez cette option pour afficher un aperçu d’un fichier .dita/.xml dans l’interface utilisateur d’Assets. Dans le cas d’un fichier .ditamap/.bookmap, tous les fichiers de rubrique du mappage sont affichés dans une seule vue page par page unifiée.
-
Génération rapide : générez la sortie pour le fichier sélectionné. La sortie ne peut être générée que pour les fichiers faisant partie d’un paramètre prédéfini de sortie. Pour plus d’informations, voir Publication basée sur un article à partir de l’éditeur web.
-
Lorsque vous cliquez sur l’icône Afficher le plan, vous obtenez la vue hiérarchique des éléments utilisés dans le document.
La vue Plan offre les fonctionnalités suivantes :
-
Une arborescence de tous les éléments utilisés dans le document.
-
Si un élément comporte un identifiant, un attribut et du texte, vous pouvez les voir avec l’élément .
-
Accédez à la vue du plan dans les vues Auteur et Source.
-
Utilisez la liste déroulante de filtrage pour afficher tous les éléments ou uniquement les références rompues :
-
Cliquer sur un élément dans la vue Plan sélectionne le contenu de l’élément dans la vue Auteur ou Source. La vue Plan reste synchronisée avec la vue Auteur et Source. Si vous apportez des modifications dans n’importe quelle vue, vous pouvez les voir dans la vue Plan. Par exemple, si vous ajoutez un paragraphe ou mettez à jour un élément dans la vue Auteur, il s’affiche dans la vue Contour.
-
Effectuez un glisser-déposer d’éléments. Vous pouvez facilement remplacer un élément en y déposant un autre élément. Si vous faites glisser et déposez un élément sur un autre élément et qu’une case carrée s’affiche autour de l’élément, cela indique que l’élément sera remplacé. Il remplace l’élément sur lequel l’élément est déposé.
Si vous faites glisser et déposez un élément, un rectangle en pointillés indique que l’élément peut être placé à l’emplacement actuel. Si le glisser-déposer n’est pas valide, un message d’erreur s’affiche pour indiquer que l’opération n’est pas autorisée.
-
Le menu Options de la vue Plan vous permet d’effectuer des opérations génériques telles que Couper, Copier, Supprimer, Générer un identifiant, Insérer un élément avant ou après l’élément actif, Renommer ou remplacer un élément, Placer un élément, Placer un élément à la ligne et créer un extrait de code à partir de l’élément sélectionné.
Options d’affichage du panneau Vue synchrone
À l’aide de la liste déroulante Options d’affichage , vous pouvez choisir d’afficher les éléments suivants, si l’élément les possède :
- Afficher l’identifiant : affiche l’identifiant de l’élément.
- Afficher l’attribut : affiche l’attribut avec sa valeur.
- Afficher le texte : affiche le texte. Si le texte comporte plus de 20 caractères, des points de suspension s’affichent.
Si un élément de bloc comporte son propre texte, il est affiché avec cet élément de bloc. S’il n’a pas son propre texte, le texte du premier élément enfant s’affiche avec cet élément de bloc.
Si votre administrateur a créé un profil pour les attributs, vous obtiendrez ces attributs avec leurs valeurs configurées. Vous pouvez également attribuer des attributs d’affichage configurés par votre administrateur sous l’onglet Attributs d’affichage des paramètres de l’éditeur. Les attributs définis pour un élément sont affichés dans les vues Disposition et Contour.
Pour plus d’informations, reportez-vous à la description de la fonction Attributs d’affichage dans les Paramètres de l’éditeur de la section Panneau de gauche.
Fonction de recherche
La fonction de recherche vous permet de rechercher un élément par son nom, son identifiant, son texte ou sa valeur d’attribut.
La recherche n’est pas sensible à la casse et correspond exactement à la chaîne. Les résultats de la recherche sont triés en fonction de la position de l’élément dans le document.
Vous pouvez rechercher une chaîne dans l’élément si elle est affichée dans le panneau Vue synchrone. Par exemple, si la chaîne "Adobe" est présente dans le texte de l’élément et s’affiche dans le panneau Vue synchrone (comme vous avez sélectionné Afficher le texte dans la liste déroulante Options d’affichage), l’élément conteneur est filtré. Cependant, si le texte n’est pas affiché dans le panneau Affichage synchrone (puisque vous n’avez pas sélectionné Afficher le texte dans la liste déroulante Options d’affichage), l’élément conteneur n’est pas filtré. De même, la chaîne apparaît dans l’identifiant ou les attributs si vous les avez sélectionnés.
Contenu réutilisable -
L’une des principales fonctionnalités de DITA est la possibilité de réutiliser du contenu. Le panneau Contenu réutilisable peut stocker vos fichiers DITA à partir desquels vous insérez généralement du contenu réutilisable. Une fois ajoutés, les fichiers DITA restent dans le panneau Contenu réutilisable d’une session à une autre. Cela signifie que vous n’avez pas besoin d’ajouter à nouveau vos fichiers DITA pour y accéder ultérieurement.
Vous pouvez simplement faire glisser et déposer du contenu réutilisable du panneau sur votre rubrique actuelle et il est inséré facilement et rapidement. Vous pouvez également obtenir un aperçu du contenu avant de l’insérer dans votre document.
Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
Pour ajouter un fichier DITA à votre panneau Contenu réutilisable , utilisez l’une des méthodes suivantes :
-
Cliquez sur l’icône + en regard de Contenu réutilisable pour ouvrir la boîte de dialogue Parcourir le fichier. Sélectionnez le fichier à ajouter et cliquez sur Ajouter pour terminer le processus.
-
Dans la vue Repository, cliquez sur l’icône Options du fichier souhaité et sélectionnez Ajouter au contenu réutilisable dans le menu contextuel.
-
Cliquez avec le bouton droit sur l’onglet d’un fichier dans l’éditeur pour ouvrir le menu contextuel et choisissez Ajouter au contenu réutilisable.
Une fois le fichier ajouté, vous pouvez voir tous les éléments de contenu réutilisables du fichier dans le panneau Contenu réutilisable . Le contenu réutilisable s’affiche avec ses identifiants et noms d’élément.
Lorsque vous ajoutez un fichier à la liste Contenu réutilisable, le titre du fichier s’affiche à la place de l’UUID du fichier. Pour vérifier l’UUID du fichier, placez le pointeur de la souris sur son titre pour afficher l’UUID du fichier dans l’info-bulle.
Actualiser : recharge tous les contenus réutilisables et affiche une nouvelle liste de contenus réutilisables.
Pour insérer du contenu à partir du panneau Contenu réutilisable , utilisez l’une des méthodes suivantes :
-
Placez le pointeur de la souris sur un élément à insérer, cliquez sur l’icône Options, puis choisissez Insérer du contenu réutilisable.
note note NOTE Sélectionnez un fichier, puis Preview dans le menu Options pour prévisualiser le fichier sans l’ouvrir. Vous pouvez également prévisualiser les références présentes dans une rubrique. L’ID de référence s’affiche dans la fenêtre. L’option Aperçu est également disponible dans le menu Options d’un élément, ce qui vous donne un aperçu rapide de l’élément avant de l’insérer. -
Faites glisser et déposez l’élément de contenu réutilisable du panneau à l’emplacement souhaité dans votre document.
Glossaire -
AEM Guides vous permet de créer et d’utiliser facilement des documents de type glossaire. Vous pouvez créer des fichiers de rubrique de glossaire, puis les inclure dans un mappage de glossaire commun. Une fois cette carte ajoutée en tant que carte racine, les entrées du glossaire s’affichent dans le panneau Glossaire.
Pour insérer un terme à partir du glossaire, il vous suffit de faire glisser l’entrée du panneau vers l’emplacement souhaité de votre rubrique. Le menu Options d’un terme du glossaire vous permet d’obtenir un aperçu rapide du terme d’entrée, Copier le chemin du fichier du terme d’entrée ou de localiser le fichier du terme d’entrée dans le référentiel.
Effectuez les étapes suivantes pour rechercher des termes textuels et les remplacer par des abréviations du glossaire :
- Ouvrez la rubrique ou le mappage DITA dans lequel vous souhaitez rechercher et convertir le texte ou les termes.
- Sélectionnez le panneau du glossaire pour afficher les termes du glossaire présents dans la carte racine. Vous pouvez faire glisser et déposer ces termes pour les ajouter à la rubrique ouverte.
- Sélectionnez l’outil Zone réactive (
Vous pouvez configurer les paramètres suivants de l’outil Zone réactive :
-
Clés du glossaire : sélectionnez les clés du glossaire dans le mappage DITA que vous souhaitez utiliser pour la recherche dans la rubrique sélectionnée. Les clés sélectionnées sont affichées ci-dessous. Vous pouvez supprimer une clé sélectionnée en cliquant sur l’icône Supprimer .
-
Rubriques : sélectionnez soit la Rubrique actuelle ouverte dans l’éditeur web, toutes les Rubriques ouvertes dans la carte actuelle, soit la Carte actuelle modifiée dans l’éditeur de cartes pour rechercher les termes.
-
Filtrer les rubriques par état : vous pouvez choisir de limiter la recherche aux rubriques ayant l’état du document sélectionné. Les rubriques peuvent être à l’état Version préliminaire, Modification, En révision, Approuvé, Révisé, Terminé ou dans n’importe quel état configuré par l’organisation.
-
Action : vous pouvez choisir de rechercher les clés de glossaire Manuellement pour chaque rubrique ou Automatiquement pour toutes les rubriques. Si vous sélectionnez Manuellement pour chaque rubrique, vous êtes invité à confirmer la suppression avant de convertir chaque terme de chaque rubrique. Si vous choisissez Automatiquement pour toutes les rubriques, tous les termes de toutes les rubriques sont automatiquement convertis.
-
Convert : vous pouvez convertir un texte recherché en terme de glossaire ou terme du glossaire en texte.
-
Options : vous pouvez sélectionner l’une des options suivantes :
- Correspondance sensible à la casse : recherche un terme pour trouver la correspondance ayant la même casse. Par exemple, "USB" ne correspond pas à "usb".
- Convertir uniquement la première instance : si plusieurs instances du terme recherché sont présentes dans une rubrique, seule la première instance est convertie.
- Extraire le fichier avant la conversion : le fichier recherché est extrait avant la conversion des termes.
- Créer une version après la conversion : une nouvelle version de la rubrique est créée une fois la conversion des termes terminée.
-
Le bouton Suivant s’affiche si vous sélectionnez l’option Manuellement pour chaque rubrique . Cliquez sur Suivant pour convertir les termes de chaque rubrique en fonction des paramètres sélectionnés. Il demande la conversion des termes dans chaque rubrique et passe au fichier suivant. Vous pouvez choisir de convertir un terme ou de l’ignorer et passer au terme suivant.
-
Le bouton Convertir s’affiche si vous sélectionnez l’option Automatically for All topics (Automatiquement pour toutes les rubriques). Sélectionnez Convert pour convertir tous les termes trouvés dans le document en abréviations du glossaire liées.
Une liste des rubriques mises à jour avec les termes convertis et des rubriques avec erreur s’affiche. Passez la souris sur l’icône (
Conditions -
Le panneau Conditions affiche les attributs conditionnels définis par votre administrateur dans le profil global ou au niveau du dossier. Vous pouvez ajouter des conditions à votre contenu en faisant simplement glisser la condition souhaitée sur votre contenu. Le contenu conditionnel est mis en surbrillance à l’aide de la couleur définie pour la condition pour une identification facile.
Vous pouvez également appliquer plusieurs conditions à un élément en le faisant glisser et en le déposant sur un élément. Lorsque vous appliquez plusieurs conditions sur un élément, le panneau Propriétés affiche les conditions appliquées séparées par une virgule.
Toutefois, en mode Code, les conditions sont séparées à l’aide d’un délimiteur d’espace. Lorsque vous ajoutez ou modifiez une condition en mode Code, assurez-vous que plusieurs conditions sont séparées à l’aide d’un espace.
Pour ajouter ou définir une condition, cliquez sur l’icône + en regard du panneau Conditions pour ouvrir la boîte de dialogue Définir la condition :
Dans la liste Attribut , sélectionnez l’attribut conditionnel que vous souhaitez définir, saisissez une valeur pour la condition, puis spécifiez le libellé affiché dans le panneau Conditions . Définissez un groupe pour la condition. Vous pouvez ajouter plusieurs conditions à un groupe. Vous pouvez également définir une couleur pour la condition. Cette couleur est définie comme couleur d’arrière-plan du contenu auquel la condition est appliquée.
Vous pouvez regrouper les conditions et les structurer dans des dossiers imbriqués. Les groupes vous aident à créer des conditions à plusieurs niveaux et à les organiser mieux pour une utilisation dans le contenu.
Par exemple, vous pouvez créer des groupes de conditions de produits tels que Acrobat et AEM Guides. Vous pouvez sélectionner les attributs conditionnels pour les deux groupes. Sous chaque groupe, vous pouvez avoir des valeurs spécifiques telles que User, Admin, Reviewer et Author.
Vous pouvez utiliser / et définir des sous-groupes pour définir des sous-groupes comme AEM Guides/Cloud Service.
Pour modifier une condition, sélectionnez Modifier dans le menu Options. La boîte de dialogue Modifier la condition s’affiche :
Spécifiez les détails de la même manière que configuré lors de la définition d’une nouvelle condition.
Schéma d’objet -
Les mappages de schéma d’objet sont une forme spécialisée de cartes DITA utilisées pour définir les sujets taxonomiques et les valeurs contrôlées. Selon vos besoins, vous pouvez créer un mappage de schéma d’objet et le référencer dans votre fichier de mappage racine. AEM Guides vous permet de définir la hiérarchie imbriquée des définitions de sujet dans votre schéma d’objet.
Vous pouvez facilement créer, puis utiliser le schéma d’objet dans une carte de schéma d’objet. Une fois cette carte ajoutée en tant que carte racine, le schéma d’objet s’affiche dans le panneau Schéma d’objet . Le panneau Schéma d’objet affiche le schéma d’objet disponible d’une manière imbriquée ou hiérarchique.
AEM Guides prend également en charge les mappages de schéma d’objet au niveau imbriqué et vous pouvez avoir plusieurs schémas d’objet définis sous la carte de schéma d’objet racine.
L’exemple suivant montre comment utiliser le modèle d’objet dans AEM Guides.
-
Créez un fichier de schéma d’objet dans un outil de votre choix. Le code XML suivant crée un modèle d’objet qui lie les valeurs de l’attribut
platform.code language-xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "subjectScheme.dtd"> <subjectScheme id="GUID-4f942f63-9a20-4355-999f-eab7c6273270"> <title>rw</title> <!-- Define new OS values that are merged with those in the unixOS scheme --> <subjectdef keys="os"> <subjectdef keys="linux"> </subjectdef> <subjectdef keys="mswin"> </subjectdef> <subjectdef keys="zos"> </subjectdef> </subjectdef> <!-- Define application values --> <subjectdef keys="app" navtitle="Applications"> <subjectdef keys="apacheserv"> </subjectdef> <subjectdef keys="mysql"> </subjectdef> </subjectdef> <!-- Define an enumeration of the platform attribute, equal to each value in the OS subject. This makes the following values valid for the platform attribute: linux, mswin, zos --> <enumerationdef> <attributedef name="platform"> </attributedef> <subjectdef keyref="os"> </subjectdef> </enumerationdef> <!-- Define an enumeration of the otherprops attribute, equal to each value in the application subjects. This makes the following values valid for the otherprops attribute: apacheserv, mysql --> <enumerationdef> <attributedef name="otherprops"> </attributedef> <subjectdef keyref="app"> </subjectdef> </enumerationdef> </subjectScheme>
-
Enregistrez le fichier avec l’extension a.ditamap et téléchargez-le dans n’importe quel dossier de la gestion des ressources numériques.
note note NOTE Vous pouvez ajouter une référence au fichier de schéma d’objet dans le mappage DITA parent. 
-
Définissez le mappage parent comme mappage racine dans les préférences utilisateur. Une fois cette carte ajoutée en tant que carte racine, le schéma d’objet s’affiche dans le panneau Schéma d’objet .
-
Dans l’éditeur Web, ouvrez le fichier dans lequel vous souhaitez utiliser les définitions de schéma d’objet.
-
Appliquez le modèle d’objet à votre contenu en faisant simplement glisser et en déposant le modèle d’objet souhaité sur votre contenu. Le contenu est alors mis en surbrillance dans la couleur définie.
Gestion des définitions hiérarchiques des définitions d’objet et des énumérations
Outre la gestion des énumérations et des définitions d’objet présentes dans la même carte, AEM Guides fournit également la fonctionnalité permettant de définir des énumérations et des définitions d’objet dans deux mappages distincts. Vous pouvez définir une ou plusieurs définitions de sujet dans un mappage et les définitions d’énumération dans un autre mappage, puis ajouter la référence de mappage. Par exemple, le code XML suivant crée des définitions de sujet et des définitions d’énumération dans deux mappages distincts.
Les définitions de sujet sont définies dans subject_scheme_map_1.ditamap
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
<subjectScheme id="subject-scheme.ditamap_f0bfda58-377b-446f-bf49-e31bc87792b3">
<title>subject_scheme_map_1</title>
<subjectdef keys="os" navtitle="Operating system">
<subjectdef keys="linux" navtitle="Linux">
<subjectdef keys="redhat" navtitle="RedHat Linux">
</subjectdef>
<subjectdef keys="suse" navtitle="SuSE Linux">
</subjectdef>
</subjectdef>
<subjectdef keys="windows" navtitle="Windows">
</subjectdef>
<subjectdef keys="zos" navtitle="z/OS">
</subjectdef>
</subjectdef>
<subjectdef keys="deliveryTargetValues">
<subjectdef keys="print">
</subjectdef>
<subjectdef keys="online">
</subjectdef>
</subjectdef>
<subjectdef keys="mobile" navtitle="Mobile">
<subjectdef keys="android" navtitle="Android">
</subjectdef>
<subjectdef keys="ios" navtitle="iOS">
</subjectdef>
</subjectdef>
<subjectdef keys="cloud" navtitle="Cloud">
<subjectdef keys="aws" navtitle="Amazon Web Services">
</subjectdef>
<subjectdef keys="azure" navtitle="Microsoft Azure">
</subjectdef>
<subjectdef keys="gcp" navtitle="Google Cloud Platform">
</subjectdef>
</subjectdef>
</subjectScheme>
La définition de l'énumération est présente dans subject_scheme_map_2.ditamap.
?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
<subjectScheme id="subject-scheme.ditamap_17c433d9-0558-44d4-826e-3a3373a4c5ae">
<title>subject_scheme_map_2</title>
<mapref format="ditamap" href="subject_scheme_map_1.ditamap" type="subjectScheme">
</mapref>
<enumerationdef>
<attributedef name="platform">
</attributedef>
<subjectdef keyref="mobile">
</subjectdef>
<subjectdef keyref="cloud">
</subjectdef>
</enumerationdef>
</subjectScheme>
Ici, les définitions d’objet sont définies dans subject_scheme_map_1.ditamap alors que la définition d’énumération est présente dans subject_scheme_map_2.ditamap. La référence à subject_scheme_map_1.ditamap est également ajoutée dans subject_scheme_map_2.ditamap.
subject_scheme_map_1.ditamap et subject_scheme_map_2.ditamap sont référencés les uns avec les autres, les schémas de sujet sont résolus.Les références de l'énumération objet sont résolues dans l'ordre de priorité suivant :
- Même carte
- Carte référencée
Les références ne sont pas résolues si l’énumération est introuvable dans la même carte et la carte référencée.
Limiter les valeurs à un élément spécifique
Vous pouvez également restreindre les conditions à certains éléments d’une rubrique. Utilisez la balise <elementdef> pour définir l’élément et la balise <attributedef> pour définir la condition qui peut être appliquée à l’élément. Si vous n’ajoutez pas la balise <elementdef>, vous pouvez appliquer les conditions à tous les éléments.
Par exemple, utilisez l’énumération suivante pour restreindre l’attribut @platform à l’élément <shortdesc>. Les autres conditions sont visibles pour tous les éléments.
<enumerationdef>
<elementdef name="shortdesc">
</elementdef>
<attributedef name="platform">
</attributedef>
<subjectdef keyref="deliveryTargetValues">
</subjectdef>
<subjectdef keyref="os">
</subjectdef>
</enumerationdef>
Liste déroulante Attributs
Vous pouvez également modifier la valeur du schéma d’objet à l’aide de la liste déroulante Attributs du panneau Propriétés du contenu dans la vue Auteur.
Effectuez les étapes suivantes pour modifier la valeur :
- Sélectionnez un attribut dans la liste déroulante Attribute .
- Sélectionnez Edit
- Sélectionnez la valeur requise dans la liste déroulante Valeur.
- Cliquez sur Mettre à jour.
Vous pouvez également appliquer des valeurs à un attribut en sélectionnant plusieurs valeurs dans la liste déroulante.
Vue Source
Vous pouvez également modifier les valeurs dans la liste déroulante de l’attribut dans la vue Source. La vue Source vous empêche également d’ajouter une valeur incorrecte.
Affichez et appliquez le schéma d’objet à partir du panneau Conditions
Vous pouvez également afficher et appliquer le modèle d’objet à partir du panneau Conditions.
Pour afficher le schéma d’objet à partir du panneau Conditions, votre administrateur système doit sélectionner l’option Afficher le schéma d’objet dans le panneau Conditions sous l’onglet Condition dans Paramètres de l’éditeur. Pour plus d’informations, voir Onglet Condition.
Le panneau Conditions affiche la structure verticale plate des définitions d’objet dans le modèle d’objet.
Vous pouvez ajouter des conditions à votre contenu en faisant glisser la condition souhaitée sur votre contenu. Le contenu conditionnel est mis en surbrillance à l’aide de la couleur définie pour la condition.
Fragments de code -
Les fragments de code sont de petits fragments de contenu qui peuvent être réutilisés dans diverses rubriques de votre projet de documentation. Le panneau Fragments de code affiche une collection de fragments de contenu que vous avez créés. Pour insérer un fragment de code, faites-le glisser du panneau vers l’emplacement souhaité de votre rubrique. Le panneau Fragments de code vous permet d’ajouter, de modifier, de supprimer, de prévisualiser et d’insérer un fragment de code.
Pour ajouter un fragment de code, utilisez l’une des méthodes suivantes :
-
Cliquez sur l’icône + en regard de Fragments de code pour ouvrir la boîte de dialogue Nouveau fragment de code .
Dans la boîte de dialogue Nouveau fragment de code, fournissez un titre qui s’affiche dans le panneau Fragments de code, une description et un code XML du contenu du fragment de code que vous souhaitez créer. Cliquez sur Créer pour enregistrer et créer le fragment de code.
-
Dans la zone d’édition du contenu, cliquez avec le bouton droit sur le chemin de navigation de l’élément que vous souhaitez utiliser comme fragment de code et sélectionnez Créer un fragment de code dans le menu contextuel. La boîte de dialogue Nouveau fragment de code s’affiche avec le code XML de l’élément sélectionné renseigné dans le champ Contenu . Saisissez le Titre et la Description du fragment de code, puis cliquez sur Créer pour enregistrer le fragment de code.
-
Dans la zone d’édition du contenu, cliquez avec le bouton droit de la souris sur le contenu que vous souhaitez utiliser comme fragment de code et choisissez Créer un fragment de code dans le menu contextuel. La boîte de dialogue Nouveau fragment de code s’affiche avec le code XML de l’élément sélectionné renseigné dans le champ Contenu . Saisissez le Titre et la Description du fragment de code, puis cliquez sur Créer pour enregistrer le fragment de code.
La capture d’écran suivante met en évidence le chemin de navigation et la zone de contenu à partir de laquelle vous pouvez appeler le menu contextuel.
Pour insérer un fragment de code, utilisez l’une des méthodes suivantes :
-
Sélectionnez un fragment dans le panneau Fragments de code et faites-le glisser à l’emplacement souhaité dans votre rubrique.
-
Placez le point d’insertion à l’endroit où vous souhaitez insérer le fragment de code. Dans le menu Options du fragment de code requis, choisissez Insérer le fragment de code.
Modèles -
Le panneau Modèles est disponible uniquement pour les administrateurs. Grâce à ce panneau, l’administrateur peut facilement créer et gérer des modèles qui peuvent ensuite être utilisés par les auteurs. Par défaut, les modèles sont classés sous les modèles de type Map et Topic.
Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un modèle, vous pouvez afficher le titre du fichier et son nom sous forme d’info-bulle.
Pour créer un modèle, cliquez sur l’icône + en regard de Modèles et choisissez un modèle à créer. Si vous sélectionnez Modèle de rubrique, la boîte de dialogue Créer un modèle de rubrique s’affiche :
Choisissez le type de modèle que vous souhaitez créer dans la liste déroulante Modèle . Fournissez le Titre, qui apparaît dans le panneau Modèles . Le nom du modèle est automatiquement suggéré en fonction du titre, mais vous pouvez fournir un nom de fichier différent.
Une fois le modèle créé, vous devez l’ajouter à votre profil global ou au niveau du dossier. Une fois le modèle ajouté, les auteurs commencent à voir le nouveau modèle dans le processus de création de rubrique/carte.
À l’aide du menu Options d’un modèle existant, vous pouvez choisir de le Modifier ou de le Dupliquer. En cas de duplication, la structure et le type (du document) du modèle sont conservés et vous pouvez le réutiliser pour en créer un autre modèle.
Révision -
AEM Guides fournit la fonctionnalité permettant d’afficher toutes les tâches de révision de vos projets. Vous pouvez afficher tous les projets de révision et les tâches de révision actives dans les projets de révision, dont vous faites partie à partir du panneau Révision. Vous pouvez ensuite ouvrir les tâches de révision pour afficher les commentaires des différents réviseurs.
Le panneau de révision affiche les tâches de révision. Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
En tant qu’auteur, vous pouvez traiter les commentaires d’une rubrique à l’aide de l’éditeur Web.
Pour afficher les commentaires de révision dans les tâches de révision actives présentes dans vos projets, procédez comme suit :
-
Sélectionnez Réviser
-
Sélectionnez un projet de révision, puis une tâche de révision dans la liste pour l’ouvrir.
-
Vous pouvez également filtrer vos projets comme suit :
-
Saisissez le terme ou le texte de recherche que vous souhaitez trouver dans le titre du projet. Appuyez ensuite sur Entrée pour effectuer la recherche. Par exemple, vous pouvez rechercher tous les projets dont le titre contient le terme "espace".
-
Sélectionnez
L’option Tâches initiées par moi est activée par défaut. Il vous permet de n’afficher que les tâches que vous avez initiées. L’état de bascule de cette option est conservé même après l’actualisation de la page.
-
-
Par défaut, dans votre projet de révision, vous affichez une liste plate des rubriques auxquelles des commentaires sont associés. Appliquez les filtres requis depuis le rail de gauche pour filtrer les rubriques en fonction des commentaires de révision qu’elles contiennent :
- Afficher toutes les rubriques : répertorie toutes les rubriques présentes dans les projets.
- Afficher les rubriques avec commentaires : répertorie uniquement les rubriques contenant les commentaires de révision.
-
Vous pouvez également saisir le terme ou le texte de recherche que vous souhaitez trouver dans le titre ou le chemin d’accès au fichier de la rubrique. Les rubriques qui contiennent le terme dans le titre ou le chemin d’accès au fichier sont répertoriées.
-
Double-cliquez sur une rubrique pour l’ouvrir dans la vue de création. Vous pouvez afficher les commentaires dans le panneau Comments.
note note NOTE Le panneau Révision et le panneau Commentaires sont synchronisés en permanence. Dans le panneau Commentaires , les commentaires sont chargés en fonction de la tâche de révision chargée dans le panneau Révision. Pour plus d'informations sur la façon de traiter les commentaires, consultez Commentaires sur la révision des adresses.
Rechercher et remplacer -
L’icône Rechercher et remplacer se trouve au bas du panneau de gauche. Le panneau Rechercher et remplacer vous permet de rechercher et de remplacer du texte dans des fichiers d’une carte ou d’un dossier de votre référentiel. Vous pouvez trouver et remplacer dans toutes les rubriques d’une carte ainsi que les rubriques présentes dans les sous-cartes de la carte.
Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
Pour effectuer la recherche globale et la remplacer, procédez comme suit :
-
Ouvrez le panneau global Chercher et Remplacer .
-
Cliquez sur la liste déroulante Rechercher dans pour sélectionner l’une des options suivantes pour effectuer la recherche.
-
Carte actuelle : pour effectuer une recherche dans la carte actuellement ouverte
note note NOTE Cette option s’affiche si vous avez déjà ouvert une carte à modifier. -
Chemin : pour effectuer une recherche sur le chemin sélectionné
-
Sélectionner une carte : pour effectuer une recherche dans la carte sélectionnée
-
-
Vous pouvez cliquer sur la liste déroulante Options et choisir l’une des options suivantes :
-
Fichier d’extraction avant de remplacer : sélectionnez cette option si vous souhaitez extraire automatiquement un fichier avant de remplacer le terme recherché. Ce paramètre est plus pertinent si votre administrateur a activé la configuration pour extraire un fichier avant de le modifier. Lorsque le paramètre du serveur principal est activé, vous devez sélectionner cette option. Cela empêchera la boîte de dialogue d’extraction de fichier de vous inviter à extraire chaque fichier avant d’apporter des modifications. Si vous ne sélectionnez pas cette option, une invite s’affiche avant qu’un fichier ne soit ouvert pour modification.
-
Mot entier uniquement : sélectionnez cette option si vous souhaitez rechercher la chaîne de recherche entière. Par exemple, si vous saisissez dans la chaîne de recherche, le résultat de la recherche renvoie tous les fichiers contenant des mots tels que over et overview. Si vous souhaitez restreindre votre recherche pour renvoyer le terme exact saisi, sélectionnez cette option.
-
Créer une version après remplacement : sélectionnez cette option si vous souhaitez créer une version de la rubrique dans laquelle vous choisissez de remplacer le texte. Vous pouvez également fournir des commentaires de version qui seront ajoutés avec chaque fichier mis à jour.
Si vous ne sélectionnez pas cette option, les modifications sont enregistrées dans la version actuelle de la rubrique et aucune nouvelle version n’est créée.
-
Inclure la référence indirecte : sélectionnez cette option si vous souhaitez rechercher la chaîne dans les références indirectes également dans la carte DITA. Par défaut, cette option est désactivée. La recherche n’est donc effectuée que sur les références directes.
-
-
Saisissez le terme ou le texte à rechercher.
-
Entrez le texte avec lequel vous souhaitez remplacer le terme recherché.
-
Appuyez sur Entrée ou sélectionnez l’icône Rechercher (
-
Sélectionnez un fichier dans la liste des résultats de la recherche. Le fichier s’ouvre dans la zone d’édition du contenu avec le terme recherché en surbrillance dans le contenu.
-
Ouvrez le panneau global Chercher et Remplacer .
-
Cliquez sur la liste déroulante Rechercher dans pour sélectionner l’une des options suivantes pour effectuer la recherche.
-
Carte actuelle : pour effectuer une recherche dans la carte actuellement ouverte
note note NOTE Cette option s’affiche si vous avez déjà ouvert une carte à modifier. -
Chemin : pour effectuer une recherche sur le chemin sélectionné
-
Sélectionner une carte : pour effectuer une recherche dans la carte sélectionnée
-
-
Vous pouvez cliquer sur la liste déroulante Options et choisir l’une des options suivantes :
-
Fichier d’extraction avant de remplacer : sélectionnez cette option si vous souhaitez extraire automatiquement un fichier avant de remplacer le terme recherché. Ce paramètre est plus pertinent si votre administrateur a activé la configuration pour extraire un fichier avant de le modifier. Lorsque le paramètre du serveur principal est activé, vous devez sélectionner cette option. Cela empêchera la boîte de dialogue d’extraction de fichier de vous inviter à extraire chaque fichier avant d’apporter des modifications. Si vous ne sélectionnez pas cette option, une invite s’affiche avant qu’un fichier ne soit ouvert pour modification.
-
Mot entier uniquement : sélectionnez cette option si vous souhaitez rechercher la chaîne de recherche entière. Par exemple, si vous saisissez dans la chaîne de recherche, le résultat de la recherche renvoie tous les fichiers contenant des mots tels que over et overview. Si vous souhaitez restreindre votre recherche pour renvoyer le terme exact saisi, sélectionnez cette option.
-
Créer une version après remplacement : sélectionnez cette option si vous souhaitez créer une version de la rubrique dans laquelle vous choisissez de remplacer le texte. Vous pouvez également fournir des commentaires de version qui seront ajoutés avec chaque fichier mis à jour.
Si vous ne sélectionnez pas cette option, les modifications sont enregistrées dans la version actuelle de la rubrique et aucune nouvelle version n’est créée.
-
Inclure la référence indirecte : sélectionnez cette option si vous souhaitez rechercher la chaîne dans les références indirectes également dans la carte DITA. Par défaut, cette option est désactivée. La recherche n’est donc effectuée que sur les références directes.
-
-
Saisissez le terme ou le texte à rechercher.
-
Entrez le texte avec lequel vous souhaitez remplacer le terme recherché.
-
Appuyez sur Entrée ou sélectionnez l’icône Rechercher (
-
Sélectionnez un fichier dans la liste des résultats de la recherche. Le fichier s’ouvre dans la zone d’édition du contenu avec le terme recherché en surbrillance dans le contenu.
-
Cliquez sur Remplacer une occurrence unique (
-
Cliquez sur Tout remplacer dans le fichier (
note note NOTE Pointez sur un fichier de la liste des résultats de recherche pour afficher l’icône Tout remplacer dans le fichier à droite de celui-ci. Vous obtenez également l’icône Ignorer le fichier pour supprimer le fichier du résultat de la recherche. Les fichiers que vous ignorez sont supprimés de la liste et le terme recherché n’y est pas remplacé. -
Cliquez sur Remplacer tout (
note note NOTE Pour activer l’icône Remplacer tout, votre administrateur système doit sélectionner l’option Activer Remplacer tout sous l’onglet Général dans Paramètres de l’éditeur.
Une seule opération de remplacement peut être effectuée à la fois dans l’ensemble du système et jusqu’à ce que l’opération soit en cours, l’état "Remplacer tout en cours" s’affiche. Vous pouvez également abandonner l’opération de remplacement entre ou afficher le rapport de journal. Si vous interrompez l’opération, vous recevrez une notification à ce sujet dans votre boîte de réception. Une notification de réussite s’affiche après le remplacement de toutes les occurrences dans le fichier sélectionné.
Vous pouvez également utiliser l’option Rechercher dans la carte du menu Options d’une carte pour rechercher et remplacer le texte dans une carte. Cette option s’affiche pour une carte ouverte dans le panneau du référentiel ou dans la vue de carte.
Zone de modification du contenu id2051EB000UI
La zone d’édition du contenu est l’endroit où s’affiche le contenu de votre rubrique ou mappage. Vous effectuez toutes les modifications de contenu dans cette zone. Il donne une vue WYSIWYG du contenu que vous êtes en train de modifier. Plusieurs rubriques peuvent être ouvertes simultanément et s’affichent dans leurs onglets respectifs.
Par défaut, vous pouvez afficher les titres des fichiers dans les onglets. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
Sous l’onglet du fichier, le chemin de navigation de l’élément se trouve à l’emplacement actuel du curseur. Dans le coin supérieur droit de la zone d’édition du contenu, le numéro de version de la rubrique active s’affiche.
Panneau droit id2051EB003YK
Le panneau de droite est un panneau persistant qui contient des informations sur le document actuellement sélectionné.
Le panneau de droite vous donne accès aux fonctionnalités suivantes :
Propriétés du contenu -
Vous pouvez accéder à la fonction Propriétés du contenu en sélectionnant l’icône Propriétés du contenu dans le panneau de droite. Le panneau Propriétés du contenu contient des informations sur le type d’élément actuellement sélectionné dans le document et ses attributs.
Type : vous pouvez afficher et sélectionner les balises de la hiérarchie complète de la balise active dans la liste déroulante.
Attributs : le panneau déroulant Attributs est disponible dans les vues Disposition, Auteur et Source. Vous pouvez facilement ajouter, modifier ou supprimer les attributs.
-
Cliquez sur + Ajouter.
-
Dans le panneau déroulant Attribut, sélectionnez l’attribut dans la liste déroulante et spécifiez la valeur d’un attribut. Cliquez ensuite sur Ajouter.
-
Pour modifier l’attribut, passez la souris dessus et sélectionnez Edit
-
Pour supprimer l’attribut, passez la souris dessus et sélectionnez Delete
Si votre administrateur a créé un profil pour les attributs, vous obtiendrez ces attributs avec leurs valeurs configurées. À l’aide du panneau des propriétés de contenu, vous pouvez choisir ces attributs et les affecter au contenu approprié de votre rubrique. Vous pouvez ainsi créer du contenu conditionnel qui pourra ensuite être utilisé pour créer une sortie conditionnelle. Pour plus d’informations sur la génération de la sortie à l’aide de paramètres prédéfinis conditionnels, voir Utilisation des paramètres prédéfinis de condition.
Propriétés du fichier -
Affichez les propriétés du fichier sélectionné en cliquant sur l’icône Propriétés du fichier
Les propriétés du fichier comportent les deux sections suivantes :
Général
La section Général vous donne accès aux fonctionnalités suivantes :
- Nom : affiche le nom de fichier de la rubrique sélectionnée. Le nom du fichier est lié par un lien hypertexte à la page des propriétés du fichier sélectionné.
- ID : affiche l’identifiant de la rubrique sélectionnée.
- Balises : il s’agit des balises de métadonnées de la rubrique. Elles sont définies à partir du champ de balises de la page de propriétés. Vous pouvez les saisir ou les sélectionner dans la liste déroulante. Les balises s’affichent sous la liste déroulante. Pour supprimer une balise, cliquez sur l’icône croisée située en regard de la balise .
- Modifier d’autres propriétés : vous pouvez modifier d’autres propriétés à partir de la page des propriétés du fichier.
- Langue : affiche la langue de la rubrique. Elle est définie à partir du champ de langue de la page des propriétés.
- Créé le : affiche la date et l’heure de création de la rubrique.
- Extraits par : affiche l’utilisateur qui a extrait la rubrique.
- État du document : vous pouvez sélectionner et mettre à jour l’état du document de la rubrique actuellement ouverte. Pour plus d’informations, voir État du document.
Remarque : Vous pouvez copier les valeurs d’attribut des différents champs dans les propriétés File dans le Presse-papiers.
Références
La section Références vous donne accès aux fonctionnalités suivantes :
- Utilisé(e) dans : Utilisé(e) dans les références répertorie les documents dans lesquels le fichier actif est référencé ou utilisé.
- Liens sortants : Les liens sortants répertorient les documents auxquels il est fait référence dans le document actif.
Par défaut, vous pouvez afficher les fichiers par titres. Lorsque vous placez le pointeur de la souris sur un fichier, vous pouvez afficher le titre du fichier et le chemin du fichier sous forme d’info-bulle.
Remarque : Toutes les références utilisées dans et sortantes sont liées par un lien hypertexte vers les documents. Vous pouvez facilement ouvrir et modifier les documents liés.
Outre l’ouverture de fichiers, vous pouvez également effectuer de nombreuses actions à l’aide du menu Options de la section Références . Parmi les actions que vous pouvez effectuer, citons Modifier, Aperçu, Copier l’UUID, Copier le chemin, Ajouter aux favoris, Propriétés et Ouvrir le tableau de bord.
Révision -
Cliquez sur l’icône Réviser pour ouvrir le panneau de révision dans lequel vous pouvez créer une tâche de révision pour le document actuellement ouvert.
Si vous avez créé plusieurs projets de révision, vous pouvez en sélectionner un dans la liste déroulante et accéder aux commentaires de révision.
Le panneau de révision vous permet d’afficher et de publier des réponses aux commentaires sur le sujet. Vous pouvez accepter ou refuser les commentaires un par un.
Pour plus d’informations, voir Commentaires sur la révision des adresses.