Barre d’outils de l’éditeur

La barre d’outils s’affiche lorsque vous ouvrez une rubrique ou un mappage à modifier dans l’éditeur. Les fonctionnalités disponibles dans la barre d’outils sont les suivantes :

Menu déroulant

La liste déroulante Menu permet d’accéder aux actions de modification, Rechercher et remplacer, Historique des versions, Libellé de version, Fusionner, Créer une tâche de révision et Afficher le menu (qui inclut le Suivi des modifications, les Balises, un espace insécable).

{width="350"}

Ces fonctionnalités sont expliquées en détail comme suit :

Modification des actions

Lorsque vous modifiez une rubrique dans l’éditeur, accédez aux différentes actions d’édition telles que Couper ou Ctrl+X , Copier ou Ctrl+C , Undo ou Ctrl+Z ou Ctrl+Y et Delete ​ ​présentes dans la liste déroulante Menu .

Rechercher et remplacer

La fonction Rechercher et remplacer est disponible dans les modes d’affichage Auteur et Source. Lorsqu’elle est activée, la barre de texte Rechercher et remplacer s’affiche au bas de la zone d’édition de la rubrique. Vous pouvez utiliser les touches de raccourci Ctrl+F pour appeler la barre de recherche et de remplacement.

À l’aide de l’icône de paramètres ( ), vous pouvez activer ou désactiver les options de recherche Ignorer la casse et Mot entier uniquement. Pour effectuer une recherche qui ne respecte pas la casse, activez l’option Ignorer la casse en (ou sélectionnez). Sinon, si vous souhaitez effectuer une recherche sensible à la casse, désactivez l’option Ignorer la casse. Vous pouvez également choisir de rechercher un mot entier.

La recherche est instantanée, ce qui signifie que lorsque vous saisissez l’expression ou le mot à rechercher dans le champ Rechercher, le terme est immédiatement recherché et sélectionné dans le sujet. De même, pour remplacer un texte dans votre rubrique, saisissez le terme de recherche et son remplacement dans les champs respectifs et sélectionnez le bouton Remplacer ou Tout remplacer.

Dans la vue Source, la fonction Rechercher et remplacer est extrêmement utile pour rechercher un élément ou un attribut spécifique. Par exemple, si vous souhaitez remplacer la valeur de l’attribut @product, vous pouvez facilement le faire à partir de la vue Source. La vue Auteur ne vous permet pas d’effectuer une recherche sur la base d’un attribut ou d’un élément. Toutefois, vous devez faire preuve de prudence lors de l’utilisation de la fonction Tout remplacer, car elle peut remplacer le code XML.

Historique des versions

La fonction Historique des versions de l'éditeur vous permet de vérifier les versions disponibles de vos fichiers DITA, de les comparer et de revenir à n'importe quelle version de l'éditeur lui-même. Vous pouvez comparer le contenu et les métadonnées de la version actuelle (qui peut également être une copie de travail) avec n’importe quelle version précédente du même fichier. Vous pouvez également afficher les libellés et les commentaires des versions comparées.

Libellés de version

Les libellés vous permettent d’identifier l’étape à laquelle une rubrique spécifique se trouve dans le DDLC (cycle de vie du développement de document). Par exemple, lorsque vous travaillez sur une rubrique, vous pouvez définir le libellé comme « Approuvé ». Une fois qu’une rubrique est publiée et mise à la disposition des clients, vous pouvez lui attribuer le libellé « Publié ».

Experience Manager Guides vous permet de spécifier des libellés dans un format de texte libre ou d’utiliser un ensemble de libellés prédéfinis. Le libellé personnalisé permet à tout auteur ou autrice du système de spécifier un libellé en fonction de son choix. Cela donne de la flexibilité ; cependant, cela introduit des libellés incohérents dans le système. Pour résoudre ce problème, les administrateurs et administratrices peuvent configurer un ensemble de libellés prédéfinis. Pour plus d’informations sur la configuration des libellés prédéfinis, consultez Configuration et personnalisation de l’éditeur web XML dans la section Installation et configuration d’Adobe Experience Manager Guides as a Cloud Service.

Ces libellés s’affichent sous la forme d’une liste déroulante à l’intention des auteurs qui souhaitent spécifier un libellé. Cela permet de s’assurer que seuls des libellés prédéfinis et cohérents sont utilisés dans le système.

Il existe différentes méthodes d’application des libellés à vos rubriques : panneau Historique des versions dans l’interface utilisateur d’Assets, Lignes de base interface utilisateur et éditeur. La fonction Libellé de version de l’éditeur permet aux auteurs d’attribuer rapidement et facilement des libellés à leurs rubriques.

Fusionner

Lorsque vous travaillez dans un environnement multi-auteurs, il devient difficile de suivre les modifications que les autres auteurs ont apportées à une rubrique ou à un mappage. La fonction de fusion vous permet de mieux contrôler non seulement l’affichage des modifications, mais également les modifications conservées dans la dernière version du document.

Créer une tâche de révision

Vous pouvez créer une tâche de révision de la rubrique active ou mapper le fichier directement à partir de l'éditeur. Ouvrez le fichier pour lequel vous souhaitez créer la tâche de révision et sélectionnez Créer une tâche de révision dans la liste déroulante du menu pour lancer le processus de création de révision.

Afficher le menu

Le menu Afficher comprend les fonctionnalités suivantes :

Options d'insertion de contenu

Element -

Insère un élément valide à l’emplacement valide actuel ou suivant. Vous pouvez également utiliser le raccourci clavier Alt+Entrée pour ouvrir la boîte de dialogue Élément. Par exemple, si vous modifiez un paragraphe, une liste d’éléments pouvant être insérés dans le paragraphe apparaît dans la boîte de dialogue Élément. Sélectionnez l’élément à insérer. Vous pouvez utiliser le clavier pour faire défiler la liste des éléments et appuyer sur Entrée pour insérer l’élément requis.

Vous pouvez afficher deux types d’éléments valides :

Par exemple, si vous vous trouvez dans l’élément de <b> intégré, vous pouvez insérer des éléments tels que <u>, <xref> ou <i> à l’emplacement actuel. En revanche, vous pouvez insérer des éléments tels que <table> et <topic> en dehors de l’emplacement actuel.

Vous pouvez également saisir un caractère ou une chaîne dans la zone de recherche et rechercher les éléments qui commencent par lui.

{width="300"}

Saisissez 't' pour rechercher tous les éléments valides commençant par 't'.

Si vous travaillez dans un élément de bloc tel qu'un note, utilisez l'icône Insérer un élément pour insérer un nouvel élément après l'élément de note. Dans la capture d’écran suivante, un élément note a été inséré dans l’élément p (paragraph) :

Si vous appuyez sur Entrée dans l’élément de note, un nouveau paragraphe est créé dans l’élément de note lui-même. Pour insérer un nouvel élément en dehors d’une note, sélectionnez l’élément p (mis en surbrillance dans la capture d’écran) dans le chemin de navigation des éléments, puis sélectionnez l’icône Élément ou appuyez sur Alt+Entrée pour ouvrir la boîte de dialogue Insérer un élément . Sélectionnez ensuite l’élément souhaité et appuyez sur Entrée pour insérer l’élément sélectionné après l’élément de note.

Vous pouvez également ajouter un élément entre deux éléments lorsqu’un curseur en forme de bloc clignotant s’affiche.

{width="300"}

Par exemple, si vous travaillez sur une rubrique DITA et que le curseur de bloc clignote entre la description courte et le corps, vous pouvez ajouter prolog élément , puis ajouter les détails copyright, auteur et autres.

Le menu contextuel vous permet également de saisir un nouvel élément. Effectuez un clic droit à n’importe quel emplacement de votre document pour appeler le menu contextuel. Dans ce menu, choisissez Insérer un élément pour afficher la boîte de dialogue Insérer un élément et choisissez l'élément à insérer.

{width="300"}

Paragraphe -

Insérer l’élément de paragraphe à l’emplacement valide actuel ou suivant.

Liste à puces -

Crée une liste à puces à l’emplacement valide actuel ou suivant. Si vous vous trouvez dans une liste à puces et sélectionnez cette icône, l’élément est converti en paragraphe normal.

Liste numérotée -

Crée une liste numérotée à l’emplacement valide actuel ou suivant. Si vous vous trouvez sur une liste numérotée et sélectionnez cette icône, l’élément est converti en paragraphe normal.

Tableau -

Insère un tableau à l’emplacement valide actuel ou suivant. Sélectionnez l'icône Tableau pour ouvrir la boîte de dialogue Insérer un tableau simple.

{width="550"}

Vous pouvez indiquer le nombre de lignes et de colonnes requis dans le tableau. Si vous souhaitez conserver la première ligne comme en-tête du tableau, sélectionnez l’option Définir la première ligne comme en-tête. Pour ajouter un titre à votre tableau, saisissez-le dans le champ Titre .

Une fois un tableau inséré, vous pouvez le modifier à l’aide du menu contextuel.

{width="550"}

À l’aide du menu contextuel du tableau, vous pouvez :

Image -

Insère une image à l’emplacement valide actuel ou suivant. Sélectionnez l’icône Image pour ouvrir la boîte de dialogue Insérer une image , puis recherchez et sélectionnez l’image à insérer.

{width="300"}

Vous pouvez ajouter un titre d’image/d’illustration et un texte secondaire pour l’image dans la boîte de dialogue Insérer une image .

À l’aide de l’option Sélectionner un fichier, vous pouvez rechercher le fichier image requis par nom de fichier. Vous pouvez également filtrer les résultats de la recherche par Chemin (pour rechercher dans), Collections, Type de fichier et Balises. Une fois que vous avez trouvé le fichier image requis, sélectionnez-le et choisissez Sélectionner pour insérer l’image dans votre document. Vous pouvez insérer différents formats de fichiers image, tels que .png, .svg, .gif, .jpg, .eps, .ai, .psd, etc.

Une fois que vous avez inséré une image, vous pouvez modifier sa hauteur, sa largeur, son emplacement et ses attributs à partir du panneau Propriétés du contenu . Sélectionnez le fichier image, puis apportez des modifications dans le panneau Propriétés du contenu du panneau de droite.

Le champ Source affiche l’UUID du fichier image inséré. Vous pouvez obtenir le chemin d’accès complet au fichier image inséré en plaçant le pointeur de la souris sur le champ Source. Le chemin d’accès s’affiche dans l’info-bulle.

Vous pouvez redimensionner une image en fournissant une valeur de Hauteur ou de Largeur pour le fichier image. Les proportions de l’image sont conservées automatiquement. Si vous le souhaitez, vous pouvez également choisir de ne pas conserver les proportions du fichier image en sélectionnant l’icône de cadenas (ou Conserver les proportions) et en fournissant les valeurs Hauteur et Largeur .

Vous pouvez également définir le paramètre Emplacement de l’image sur Intégré ou Saut. Si vous choisissez d’utiliser l’option d’emplacement Saut , vous pouvez ensuite choisir où aligner l’image (Gauche, Centre ou Droite).

Vous pouvez également ajouter d’autres propriétés pour un fichier image en sélectionnant les propriétés requises dans le champ Attributs.

Menu contextuel des fichiers image ou multimédia

Vous pouvez également effectuer certaines opérations courantes pour les images et les fichiers multimédias à l’aide du menu contextuel. Cliquez avec le bouton droit de la souris à n’importe quel emplacement de votre image pour appeler le menu contextuel.

Le menu contextuel propose des options permettant de couper, copier ou coller l’image ou le média. Vous pouvez insérer un élément avant ou après l’élément sélectionné. Vous avez également la possibilité de renommer ou de déplier un élément. Vous pouvez localiser l’image ou le média sélectionné dans le référentiel ou afficher l’aperçu du fichier dans l’interface utilisateur d’Assets.

Les autres options du menu contextuel vous permettent de copier un chemin d’accès, de modifier une zone cliquable, de renommer un élément, de créer un fragment de code ou de générer des identifiants pour l’élément sélectionné.

Insérer/Modifier une zone cliquable

Insère une zone cliquable sur l’image sélectionnée. Une image avec des zones cliquables pointant vers des rubriques ou des pages web est appelée zone cliquable.

Sélectionnez une image dans la rubrique active, puis sélectionnez l’icône Insérer/Modifier la zone cliquable pour ouvrir la boîte de dialogue Insérer une zone cliquable.

{width="650"}

Choisissez la forme préférée de rectangle, Cercle ou Polygone pour définir une zone sur une image que vous voulez utiliser comme lien. Une fois la zone définie, la boîte de dialogue Référence s’affiche. Vous devez alors spécifier le lien vers le contenu interne ou externe :

{width="650"}

Si des zones se chevauchent, vous pouvez avancer ou reculer la forme en cliquant sur l'icône correspondante dans la barre d'outils. Vous pouvez également supprimer une zone en la sélectionnant et en cliquant sur l’icône Supprimer . Double-cliquez sur une zone pour ouvrir la boîte de dialogue Référence dans laquelle vous pouvez modifier le lien de destination. Une fois que vous avez marqué les zones requises sur votre image, enregistrez les modifications en sélectionnant Terminé.

Multimédia

Insère différents types de fichiers multimédias. Sélectionnez l’icône déroulante Multimédia et choisissez le type de fichier à insérer. Les formats multimédias pris en charge sont les suivants :

Lorsque vous sélectionnez l’option Fichier audio ou vidéo , la vue du référentiel s’affiche et vous permet de rechercher et de sélectionner le fichier souhaité. Si vous choisissez YouTube ou Vimeo, la boîte de dialogue Insérer un fichier multimédia s’affiche. Collez le lien du fichier vidéo dans le champ Lien web et sélectionnez Insérer pour ajouter la vidéo à l’emplacement valide actuel ou suivant dans votre document.

Vous pouvez également ajouter le fichier audio ou vidéo à partir de la boîte de dialogue Insérer un fichier multimédia. Sélectionnez l’option Fichier audio/vidéo , puis sélectionnez l’icône de navigation pour lancer la vue du référentiel. Sélectionnez le fichier audio ou vidéo dans le référentiel, puis sélectionnez Sélectionner pour ajouter le lien du fichier dans le champ Fichier audio/vidéo . Si vous choisissez un fichier vidéo, un aperçu du fichier s’affiche également dans la zone Aperçu . Vous pouvez lire le fichier vidéo pour en afficher l’aperçu.

{width="650"}

Référence croisée

Insérer des références de type Référence de contenu, Référence de clé de contenu, Référence de fichier, Lien web ou Lien e-mail.

Sélectionnez l’icône Sélectionner un fichier (pour la référence de contenu et la référence de fichier) ou Sélectionner la carte racine icône (pour la référence de clé de contenu et la référence de clé) et sélectionnez le fichier ou le contenu à lier.

{width="650"}

Un lien de la référence sélectionnée est ajouté dans le document. Le menu contextuel du lien vous donne les options suivantes :

Vous pouvez également effectuer une recherche à l’aide de l’UUID du fichier que vous souhaitez référencer. Pour les liens Contenu et Référence de clé, saisissez l’UUID du fichier vers lequel vous souhaitez créer un lien afin que le fichier soit automatiquement recherché et affiché dans la section Aperçu . Lorsque vous spécifiez l’UUID du fichier, vous n’avez pas besoin de mentionner explicitement l’extension de fichier pour les fichiers .xml. L’extension .xml est ajoutée automatiquement à l’UUID.

{width="650"}

Si votre administrateur a activé l’option UUIDs dans XMLEditorConfig, l’UUID du contenu référencé s’affiche dans la propriété Link.

Filtrer la recherche

Vous pouvez rechercher du texte dans les fichiers présents sur le chemin d’accès sélectionné du référentiel AEM. Par exemple, la recherche « général » est effectuée dans la capture d’écran ci-dessous. Vous pouvez également affiner votre recherche à l’aide de filtres améliorés. Vous pouvez rechercher tous les fichiers DITA tels que les rubriques DITA et les plans DITA présents sur le chemin d'accès sélectionné.

Vous pouvez rechercher des fichiers non-DITA tels que des fichiers image, des fichiers multimédias et des documents dans le chemin d'accès sélectionné. Vous pouvez également rechercher des valeurs spécifiques dans les attributs des éléments DITA. Vous pouvez également rechercher les fichiers qui sont extraits par l’utilisateur spécifié.

{width="650"}

La liste des fichiers filtrés contenant le texte recherché s’affiche. Par exemple, dans la capture d’écran ci-dessus, les fichiers contenant le texte « général » sont répertoriés. Vous pouvez également prévisualiser le contenu du fichier.

Contenu réutilisable -

Réutilisez le contenu existant dans tout autre document du projet. Vous pouvez insérer du contenu en établissant un lien direct vers le contenu d’un fichier ou en utilisant une référence de clé, afficher Résoudre les références de clé. Lorsque vous sélectionnez l’icône Contenu réutilisable , la boîte de dialogue Réutiliser le contenu s’affiche :

{width="650"}

Dans la boîte de dialogue Réutiliser le contenu, sélectionnez le fichier DITA pour les références de fichier ou le fichier DITA map qui contient les références clés. Une fois la rubrique ou les références clés sélectionnées, elles s’affichent dans la boîte de dialogue. Vous pouvez sélectionner l’ID/la clé de la rubrique à insérer et sélectionner Terminé pour insérer le contenu dans la rubrique.

Pour insérer une référence de contenu, vous pouvez également saisir l’UUID du fichier et le contenu réutilisable de ce fichier est répertorié dans la section Aperçu .

Selon le paramètre d’insertion de liens, vous pouvez afficher l’UUID du contenu inséré ou le chemin d’accès relatif dans le panneau Propriétés ou dans l’affichage du code Source. Le lien est toujours créé à partir de l’UUID du contenu référencé. Affichez Configurer des liens basés sur l’UUID dans la section Installation et configuration d’Adobe Experience Manager Guides as a Cloud Service.

Vous pouvez également incorporer le contenu référencé dans la rubrique en cliquant avec le bouton droit sur le contenu référencé et en choisissant Remplacer la référence par le contenu dans le menu contextuel.

Symbole -

Insère des caractères spéciaux dans votre rubrique. Sélectionnez l’icône Symbole pour ouvrir la boîte de dialogue Insérer un caractère spécial .

{width="350"}

Dans la boîte de dialogue Insérer un caractère spécial, vous pouvez rechercher un caractère spécial en utilisant son nom. Tous les caractères spéciaux sont stockés dans différentes catégories. Utilisez la liste déroulante Sélectionner une catégorie et sélectionnez une catégorie. Les caractères spéciaux disponibles dans la catégorie sélectionnée s’affichent. Vous pouvez parcourir la liste des caractères spéciaux à l’aide des touches fléchées ou sélectionner le caractère que vous souhaitez insérer. Le nom et le code hexadécimal du caractère spécial sélectionné s’affichent sous la liste. Sélectionnez Insérer pour insérer le caractère sélectionné dans votre document.

Mot-clé -

Insérer un mot-clé défini dans votre plan DITA. Sélectionnez l’option Mot-clé pour ouvrir la boîte de dialogue Référence de clé .

{width="550"}

Les mots-clés sont répertoriés dans l’ordre alphabétique et vous pouvez également rechercher le(s) mot(s)-clé(s) en saisissant une chaîne de recherche dans la zone Rechercher . Le résultat de la recherche renvoie les mots-clés contenant la chaîne dans l’ID ou la Valeur. Les mots-clés définis dans votre plan DITA sont répertoriés dans cette boîte de dialogue. Choisissez le mot-clé à insérer et sélectionnez Insérer.

Vous pouvez également modifier les attributs du mot-clé inséré en cliquant avec le bouton droit sur le mot-clé et en sélectionnant l’option Attributs . La boîte de dialogue **Attributs pour le mot-clé) s’ouvre :

{width="550"}

Vous pouvez modifier les attributs du mot-clé ou ajouter un nouvel attribut au mot-clé.

Fragments de code -

Insérez un fragment de code à l’emplacement valide actuel ou suivant. Pour que cette fonctionnalité fonctionne, des fragments de code doivent être définis dans votre système. Pour plus d’informations sur l’ajout d’un extrait de code, consultez la description de la fonctionnalité Extrait de code dans la section Panneau de gauche.

Lorsque vous sélectionnez l’option Fragments de code, le catalogue Insérer un fragment de code s’affiche. Le catalogue est contextuel, ce qui indique qu’il n’affichera les fragments de code que s’ils sont autorisés à l’emplacement actuel.

L’exemple suivant illustre deux fragments de code préconfigurés, Avertissement et Erreur, qui peuvent être insérés à l’emplacement actuel du document.

{width="300"}

Lorsque vous choisissez un fragment de code dans la liste, il est inséré à l’emplacement valide actuel ou suivant dans le document. La capture d’écran suivante présente le fragment de code d’erreur inséré dans le document :

{width="400"}

Citations -

Créez des citations et ajoutez-les à votre contenu. Découvrez comment ajouter et gérer des citations dans votre contenu.

Requête sur les données -

Connectez-vous à votre source de données et utilisez les données pour créer du contenu. Découvrez comment utiliser les données de votre source de données.

Informations sur la version et Enregistrer comme nouvelle version

La fonctionnalité Informations sur la version et Enregistrer en tant que nouvelle version combine le suivi des versions et l’enregistrement de contenu dans une seule fonctionnalité.

Lorsque vous choisissez d’enregistrer une rubrique ou un mappage à l’aide de Enregistrer en tant que nouvelle version, la boîte de dialogue suivante s’affiche :

{width="300"}

Saisissez les commentaires et les libellés de version pour identifier les modifications, puis sélectionnez Enregistrer pour créer une nouvelle version du fichier.

Lorsque vous sélectionnez l’option Enregistrer en tant que nouvelle version, la première version de la rubrique est créée dans la gestion des ressources numériques, qui devient également la version actuellement active de votre rubrique. Par la suite, si vous revenez à une ancienne version de la rubrique, celle-ci devient votre version active actuelle de la rubrique.

Si votre administrateur ou administratrice dispose de libellés de version préconfigurés, vous verrez ces libellés dans une liste déroulante. Vous pouvez choisir un libellé dans la liste des libellés disponibles et enregistrer votre document.

{width="300"}

Au moment d’enregistrer une rubrique, vous pouvez ajouter un commentaire spécifiant les modifications que vous avez apportées à la rubrique. Ce commentaire s’affiche dans l’historique des versions de la rubrique.

Si votre rubrique est en cours de révision, vos réviseurs et réviseuses reçoivent une notification indiquant qu’une version plus récente de la rubrique est disponible. Ils peuvent facilement accéder à la dernière révision de votre document et continuer à consulter la dernière version de votre rubrique.

Lorsque vous placez le pointeur de la souris sur le titre d'une rubrique, le titre du fichier, le chemin d'accès au fichier et le numéro de version s'affichent.

Verrouiller/déverrouiller

Verrouille ou déverrouille le fichier courant. Le verrouillage d’un fichier vous donne un accès exclusif en écriture au fichier. Cela empêche d’autres utilisateurs de modifier le fichier. Déverrouillez le fichier si vous souhaitez que d’autres utilisateurs aient un accès en modification. Lorsque le fichier est déverrouillé, les modifications sont enregistrées dans la version actuelle du fichier.

Si vous êtes dans la vue Carte et que vous développez la carte parente, vous pouvez verrouiller tous les fichiers de la carte d'un seul clic. Développez simplement le fichier de mappage parent et sélectionnez le fichier parent, ce qui entraîne la sélection de tous les fichiers dans le mappage. Ensuite, vous pouvez sélectionner Verrouiller pour obtenir le verrouillage sur tous les fichiers de la carte.

Dans le panneau Référentiel, les fichiers verrouillés s’affichent avec une icône de verrouillage. Lorsque vous pointez sur cette icône de verrouillage, l’icône Verrouillé par vous/nom d’utilisateur s’affiche sous forme d’info-bulle.

{width="350"}

Si un fichier est verrouillé par un autre utilisateur, le fait de pointer sur l’icône de verrouillage dans le référentiel affiche le nom de l’utilisateur qui l’a verrouillé. Dans ce cas, le fichier s’ouvre en mode lecture seule, avec un accès en lecture seule affiché en regard des informations de version.

En tant qu’administrateur, vous avez également accès à la fonctionnalité Forcer le déverrouillage qui vous permet de déverrouiller le fichier verrouillé par d’autres utilisateurs. Utilisez cette fonctionnalité pour accéder aux droits de modification d'un fichier verrouillé par d'autres utilisateurs.

{width="350"}