{width="300"}

Si vous disposez de droits de modification sur les fichiers de carte, vous pourrez également modifier les fichiers. Pour plus d'informations sur l'ouverture et la modification d'une rubrique via un plan DITA, consultez la section Modifier des rubriques via un plan DITA.

Les options suivantes sont disponibles pour un fichier de mappage dans la vue Carte :

Vous pouvez effectuer les actions suivantes à l’aide du menu Options du fichier de mappage :

La capture d’écran suivante présente le menu Options d’un fichier en mode Carte :

Vous pouvez effectuer les actions suivantes à l’aide du menu Options :

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 entre les sessions. Cela signifie que vous n'avez pas à ajouter à nouveau vos fichiers DITA pour y accéder ultérieurement.

Vous pouvez simplement faire glisser 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. Pointez sur un fichier pour afficher le titre du fichier et son chemin d’accès sous forme d’info-bulle.

Pour ajouter un fichier DITA à votre panneau Contenu réutilisable, utilisez l'une des méthodes suivantes :

Une fois le fichier ajouté, vous pouvez afficher tous les éléments de contenu réutilisables du fichier dans le panneau Contenu réutilisable . Le contenu réutilisable s’affiche avec leur identifiant et leur nom 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, pointez sur le titre du fichier avec la souris et l’UUID du fichier s’affiche dans l’info-bulle.

{width="400"}

Actualiser : vérifie à nouveau tout le contenu réutilisable et affiche une nouvelle liste de contenu réutilisable.

Pour insérer du contenu à partir du panneau Contenu réutilisable, utilisez l’une des méthodes suivantes :

Esquisse

Lorsque vous sélectionnez l’icône Composition, vous obtenez la vue hiérarchique des éléments utilisés dans le document.

{width="300"}

Le mode Plan offre les fonctionnalités suivantes :

Afficher la configuration

À l’aide de l’option Afficher configurer, vous pouvez choisir d’afficher les éléments suivants :

Si un élément de bloc possède son propre texte, il est affiché avec cet élément de bloc. S’il ne dispose pas de son propre texte, le texte du premier élément enfant est affiché avec cet élément de bloc.

{width="550"}

Si votre administrateur a créé un profil pour les attributs, vous obtiendrez ces attributs ainsi que leurs valeurs configurées. Vous pouvez également attribuer les attributs d’affichage configurés par votre administrateur sous l’onglet Attributs d’affichage dans le Paramètres. Les attributs définis pour un élément sont affichés en mode Mise en page et Plan.

Pour plus d’informations, reportez-vous à la description de la fonctionnalité Attributs d’affichage dans la section Paramètres du 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 ne respecte pas 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 s’il est affiché en mode Plan. Par exemple, si la chaîne « Adobe » est présente dans le texte de l’élément et est affichée dans le panneau Mode Plan (comme vous l’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 Mode Plan (car 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 se trouve dans l’ID ou les attributs si vous les avez sélectionnés.

Glossaire

Experience Manager 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 une carte de glossaire commune. Une fois que cette carte est ajoutée en tant que carte racine, les entrées du glossaire s’affichent dans le panneau Glossaire.

{width="650"}

Pour insérer un terme dans le glossaire, il vous suffit de faire glisser l’entrée du panneau vers l’emplacement souhaité dans la rubrique. Le menu Options d’un terme de glossaire vous permet d’obtenir un Aperçu rapide du terme d’entrée, Copier le chemin du fichier de terme d’entrée ou de localiser le fichier de 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 de glossaire :

Vous pouvez configurer les paramètres suivants de l’outil Zone réactive :

{width="300"}

Une liste des Rubriques mises à jour avec les termes convertis et Rubriques avec erreur s’affiche. Passez la souris sur l’icône d’informations près de Rubriques avec erreur pour afficher les détails de l’erreur.

Conditions

Le panneau Conditions affiche les attributs conditionnels définis par l’administrateur dans le profil global ou au niveau du dossier. Vous pouvez ajouter des conditions à votre contenu en faisant simplement glisser et en déposant la condition souhaitée sur votre contenu. Le contenu conditionnel est mis en surbrillance à l’aide de la couleur définie pour la condition afin de faciliter son identification.

Vous pouvez également appliquer plusieurs conditions à un élément en faisant glisser et en déposant plusieurs conditions sur un élément. Lorsque vous appliquez plusieurs conditions à 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, sélectionnez l’icône + en regard du panneau Conditions pour afficher la boîte de dialogue Définir une condition :

{width="400"}

Dans la liste Attribut , sélectionnez l’attribut conditionnel à 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 à mieux les organiser pour les utiliser 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 Utilisateur, Administrateur, Réviseur et Auteur.

Vous pouvez utiliser des / et définir des sous-groupes tels que AEM Guides/Cloud Service.

{width="300"}

Pour modifier une condition, choisissez Modifier dans le menu Options. La boîte de dialogue Modifier la condition s’affiche :

{width="400"}

Spécifiez les détails de la même manière que lors de la définition d’une nouvelle condition.

Schéma de l'objet

Les cartes de schéma d'objets sont une forme spécialisée de cartes DITA utilisées pour définir des sujets taxonomiques et des 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. Experience Manager Guides vous permet de définir la hiérarchie de niveau imbriqué des définitions d’objet dans votre schéma d’objet.

Vous pouvez facilement créer et utiliser le schéma d'objet dans une carte de schéma d'objet. Une fois que cette carte est ajoutée en tant que carte racine, le schéma d'objet est affiché dans le panneau Schéma d'objet . Le panneau Schéma d’objet affiche le schéma d’objet disponible de manière imbriquée ou hiérarchique.

Experience Manager Guides prend également en charge les mappages de schéma d'objet au niveau imbriqué. Plusieurs schémas d'objet peuvent être définis sous le mappage de schéma d'objet racine.

L'exemple suivant montre comment utiliser le schéma d'objet dans Experience Manager Guides.

<?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>

{width="300"}

Gestion des définitions hiérarchiques des objets et des énumérations

En plus de gérer les énumérations et les définitions d’objet présentes dans le même mappage, Experience Manager Guides offre également la possibilité 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 d’objet 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 d’objet et d’énumération dans deux mappages distincts.

Les définitions des objets 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_schema_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 tandis 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.

Les références d’énumération d’objet sont résolues dans l’ordre de priorité suivant :

Les références ne sont pas résolues si l’énumération n’est pas trouvée dans le même mappage et le mappage référencé.

Restreindre les valeurs à un élément spécifique

Vous pouvez également limiter 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 limiter 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 :

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 à partir de la liste déroulante de l’attribut dans la vue Source. La vue Source vous empêche également d’ajouter une valeur incorrecte.

{width="550"}

Afficher et appliquer le schéma d'objet à partir du panneau Conditions

Vous pouvez également afficher et appliquer le schéma 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 Général dans Paramètres. Pour plus d’informations, consultez la section Paramètres dans la barre d’onglets.

Le panneau Conditions affiche la structure verticale plate des définitions d'objet dans le schéma d'objet.

Vous pouvez ajouter des conditions à votre contenu en faisant glisser et en déposant 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 différentes rubriques de votre projet de documentation. Le panneau Fragments de code affiche une collection de fragments de code de contenu que vous avez créés. Pour insérer un fragment de code, faites-le glisser du panneau à l’emplacement souhaité dans 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 :

Pour insérer un fragment de code, utilisez l’une des méthodes suivantes :

Modèles

Le panneau Modèles n’est disponible que pour les administrateurs et administratrices. 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 des modèles de type map et topic.

{width="300"}

Par défaut, vous pouvez afficher les fichiers par titres. Pointez sur un modèle pour afficher le titre du fichier et le nom du fichier sous forme d’info-bulle.

Pour savoir comment créer des modèles personnalisés, consultez la section Créer des mappages basés sur des modèles personnalisés.

Citations

Dans Experience Manager Guides, vous pouvez ajouter et importer des citations et les appliquer à votre contenu. Vous pouvez ajouter ces citations à partir de n’importe quelle source de livres, de sites web et de revues.

Pour plus d’informations, consultez la section ​ Ajouter et gérer des citations dans votre contenu ​.

Variables de langue

Experience Manager Guides permet d’utiliser des variables de langue dans la sortie Native PDF. Vous pouvez utiliser des variables de langue pour définir des chaînes localisées dans la sortie PDF ou pour localiser du texte statique dans les modèles de sortie. Vous pouvez utiliser des styles CSS pour localiser les chaînes provenant d’un fichier CSS.

Pour plus d’informations, consultez la section Prise en charge des variables de langue.

Variables

Experience Manager Guides vous permet de créer et de gérer des variables pour la publication native de PDF. Pour plus d’informations, consultez Variables dans la sortie PDF.

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 les fichiers d’un mappage 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. Pointez sur un fichier pour afficher le titre du fichier et son chemin d’accès sous forme d’info-bulle.

Pour effectuer la recherche globale et le remplacement, procédez comme suit :

Pour activer l’icône Tout remplacer, votre administrateur système doit sélectionner l’option Activer tout remplacer sous l’onglet Général dans Paramètres.

Une seule opération de remplacement complet peut être effectuée à la fois dans l'ensemble du système, et tant que l'opération n'est pas exécutée, vous verrez l'état « Remplacer tout en cours ». Vous pouvez également abandonner l’opération de remplacement de tous les éléments entre les deux ou consulter le rapport de journal. Si vous abandonnez l’opération, vous recevrez une notification à ce sujet dans votre boîte de réception. Une notification de succès s’affichera après le remplacement de toutes les occurrences dans le fichier sélectionné.

{width="300"}

Vous pouvez également utiliser l'option Rechercher dans la carte du menu Options d'une carte pour rechercher et remplacer du texte dans une carte. Cette option s’affiche pour un mappage ouvert dans le panneau Référentiel ou dans la vue de mappage.

{width="550"}

Modèles PDF

Permet d’utiliser divers modèles PDF. Pour plus de détails, consultez les modèles PDF.

Révision

Experience Manager Guides permet d’afficher toutes les tâches de révision dans 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 et réviseuses.

Le panneau de révision affiche les tâches de révision. Par défaut, vous pouvez afficher les fichiers par titres. Pointez sur un fichier pour afficher le titre du fichier et son chemin d’accès sous forme d’info-bulle.

En tant qu’auteur, vous pouvez ajouter des commentaires dans une rubrique à l’aide de l’éditeur.

Pour afficher les commentaires de révision dans les tâches de révision actives présentes dans vos projets, procédez comme suit :

Zone d'édition du contenu

Le contenu de votre rubrique ou de votre carte s’affiche dans la zone d’édition du contenu. Vous apportez toutes les modifications au contenu dans cette zone. Il donne une vue WYSIWYG du contenu que vous modifiez.

Dans le coin inférieur gauche de la zone d’édition du contenu, le chemin de navigation de l’élément se trouve à l’emplacement actuel du curseur. Dans le coin inférieur droit, les vues d’éditeur disponibles s’affichent.

Pour en savoir plus sur les vues Éditeur disponibles pour un fichier de rubrique dans la zone d'édition du contenu, consultez Vues Éditeur.

Panneau de droite

Le panneau de droite contient des informations sur le document 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 pour la balise active dans la liste déroulante.

Attributs : le panneau déroulant Attributs est disponible en vues Disposition, Auteur et Source. Vous pouvez facilement ajouter, modifier ou supprimer les attributs.

Si votre administrateur a créé un profil pour les attributs, vous obtiendrez ces attributs ainsi que leurs valeurs configurées. À l’aide du panneau Propriétés du contenu , vous pouvez choisir ces attributs et les affecter au contenu approprié dans votre rubrique. Vous pouvez ainsi également créer du contenu conditionnel, qui peut ensuite être utilisé pour créer une sortie conditionnelle. Pour plus d’informations sur la génération d’une sortie à l’aide de paramètres prédéfinis conditionnels, voir Utiliser des paramètres prédéfinis de condition.

Propriétés du fichier

Affichez les propriétés du fichier sélectionné en sélectionnant l’icône Propriétés du fichier dans le panneau de droite. La fonction Propriétés du fichier est disponible dans les quatre modes ou vues : Disposition, Auteur, Source et Aperçu.

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 :

{width="300"}

Références

La section Références vous donne accès aux fonctionnalités suivantes :

{width="300"}

Par défaut, vous pouvez afficher les fichiers par titres. Pointez sur un fichier pour afficher le titre du fichier et son chemin d’accès sous forme d’info-bulle.

Outre l’ouverture de fichiers, vous pouvez également effectuer de nombreuses actions à l’aide du menu Options dans la section Références . Vous pouvez effectuer entre autres les actions suivantes : Modifier, Prévisualiser, Copier l’UUID, Copier le chemin d’accès, Ajouter aux collections et Propriétés.

Révision

Lorsque vous sélectionnez l’icône Réviser , vous ouvrez le panneau de révision dans lequel vous pouvez sélectionner une tâche de révision pour le document actuellement ouvert et afficher les commentaires.

{width="300"}

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.

Grâce au panneau de révision, vous pouvez afficher et publier les réponses aux commentaires donnés sur le sujet. Vous pouvez accepter ou rejeter les commentaires un par un.

Pour plus d’informations, voir Commentaires de révision d’adresse.

Suivi des modifications

Grâce à la fonction Modifications suivies du panneau de droite, vous pouvez afficher les informations de toutes les mises à jour effectuées dans un document. Vous pouvez également rechercher les mises à jour spécifiques apportées au document.

Schematron

« Schéma » fait référence à un langage de validation basé sur des règles utilisé pour définir des tests pour un fichier XML. L’éditeur prend en charge les fichiers Schematron. Vous pouvez importer les fichiers Schematron et les modifier également dans l'éditeur. À l'aide d'un fichier Schematron, vous pouvez définir certaines règles, puis les valider pour une rubrique DITA ou une carte.

Découvrez comment utiliser les fichiers Schematron dans Experience Manager Guides. Pour plus d'informations, consultez la section Prise en charge des fichiers Schematron.

Rubrique parente : Présentation de l’éditeur