Familiarisez-vous avec les rubriques DITA dans FrameMaker.
DITA utilise une approche axée sur les rubriques pour l’écriture. Une rubrique de DITA est l’entité la plus granulaire des informations. Selon les spécifications DITA, une rubrique doit être suffisamment courte pour être facilement lisible, mais suffisamment longue pour pouvoir être comprise sans autre contexte.
Pour couvrir un contenu distinct comme des concepts, des tâches et des références, la norme DITA spécifie différents types d’informations. Chaque type d’information définit des éléments structurés facilitant l’écriture de contenu pertinent. Par exemple, le type de tâches définit des éléments comme <contexte>
, <exemple>
, <étapes>
et <résultat>
.
Apprenez à créer et à gérer une rubrique DITA dans FrameMaker.
Dans le menu Fichier, accédez à
.Le sous-menu DITA affiche les types de rubriques DITA et les types de mappage que vous pouvez créer.
FrameMaker prend en charge les types de rubrique DITA suivants :
Pour du contenu spécifique, utilisez les types task, concept, reference, glossentry ou glossgroup.
Consultez les spécifications des rubriques DITA.
Pour un contenu associé à une tâche comme des explications de type « comment faire » ou des procédures.
Consultez les spécifications des rubriques de tâche.
Pour un contenu comme « En quoi consiste ? ». Cela couvre les informations conceptuelles relatives à une fonctionnalité ou une fonction.
Voir les spécifications des rubriques de concept.
Pour un contenu de référence. Par exemple, des spécifications du produit, une référence API et des listes d’équipements ou de pièces.
Consultez les spécifications des rubriques de référence.
Pour un terme de glossaire et une définition uniques.
Consultez les spécifications des rubriques d’entrée du glossaire.
Pour un groupe d’éléments glossentry.
Glossgroup peut aussi contenir d’autres éléments glossgroup pour créer une structure de glossaire hiérarchique.
Consultez les spécifications des rubriques de groupes du glossaire.
Elément de conteneur de niveau supérieur qui peut inclure les types de rubrique décrits ci-dessus.
Consultez les spécifications du conteneur DITA.
Sélectionnez un type de rubrique.
Pour afficher la structure hiérarchique de la rubrique créée, sélectionnez
.Une rubrique DITA est un document structuré. Cela signifie que dans FrameMaker, vous utilisez la structure de rubrique DITA de la même manière que vous utilisez des documents structurés fondés sur d’autres applications structurées.
Pour plus d’informations sur la création d’un contenu dans une rubrique structurée, voir frm_structauth_sa.html#WS053b9687b4c35b124e2fd7a146eb68148c-8000.
Apprenez à ajouter des liens vers du contenu associé à l’aide de la boîte de dialogue Lien DITA dans FrameMaker.
Utilisez la boîte de dialogue Lien DITA pour insérer un lien direct et indirect au contenu DITA.
Sélectionnez l’élément de lien à utiliser.
Par défaut, l’élément est <link>
.
Consultez les spécifications des liens.
Sélectionnez cette option pour créer un lien à l’aide d’un référencement direct.
Voir Création d’un lien DITA.
Sélectionnez cette option pour créer un lien à l’aide d’un référencement indirect et sélectionnez une touche dans la liste déroulante Paramètres de touche.
Voir Création d’un lien DITA.
Sélectionnez cette option pour créer un lien à l’aide d’un référencement direct ou indirect.
Si la cible est définie sur Fichier, sélectionnez une rubrique DITA dans la liste des rubriques actuellement ouvertes pour des références directes. Vous pouvez également sélectionner une rubrique qui n’est pas déjà ouverte.
Si la cible est définie sur Touche, sélectionnez une touche pour référence indirecte. Vous pouvez également ouvrir la boîte de dialogue Gestionnaire d’espace de touche DITA. Cette boîte de dialogue permet la Création d’un espace de touche et la définition de l’espace de touche par défaut pour la rubrique actuelle.
Recherchez la rubrique ou la touche requise vers laquelle vous souhaitez créer un lien. Cette recherche dynamique filtre les éléments lorsque vous commencez à saisir le nom dans la zone Filtrer texte. Vous pouvez filtrer le contenu à partir de la balise, de l’ID ou de texte de l’élément (contenu).
Une fois que vous avez trouvé la rubrique requise, sélectionnez un élément à inclure en tant que lien. L’élément de lien définit une relation à une autre rubrique.
Sélectionnez l’élément qui fournit l’étiquette ou la ligne de texte d’un lien.
Par défaut, l’élément est <linktext>
.
Consultez les spécifications des textes de lien.
Sélectionnez l’élément qui fournit l’étiquette ou la ligne de texte d’un lien.
Par défaut, l’élément est <linktext>
.
Consultez les spécifications des textes de lien.
Spécifiez le texte du lien à afficher comme texte.
Sélectionnez Format et choisissez un format de lien dans la liste déroulante :
Affichage du titre de la rubrique de référence.
Afficher Voir <titre de rubrique> à la page <numéro de page>
.
Afficher <titre de rubrique> dans <page>
Insertion d’un lien vers une ressource externe (non DITA). Dans la boîte de dialogue Lien externe DITA, indiquez la source pour le lien externe. Reportez-vous au champ Touche ou Cible du lien (href).
Si vous le souhaitez, vous pouvez spécifier un texte pour le lien. Sinon, le lien saisi dans le champ Cible du lien (href) est utilisé pour le texte du lien. Vous pouvez également insérer un lien externe via le menu principal (
ou le menu contextuel.Si vous insérez le premier lien dans l’élément de liens associés, placez le point d’insertion à droite de l’élément de liens associés.
À partir du panneau Elément (<link>
.
La Boîte de dialogue Lien DITA s’affiche.
Sélectionnez l’élément de lien DITA à utiliser.
Sélectionnez une cible du lien.
Vous pouvez ajouter un lien comme référence directe ou indirecte au contenu cible. Pour plus de détails, reportez-vous à la section Référencement DITA.
Pour ajouter un lien direct, sélectionnez la rubrique DITA (fichier .xml) pour laquelle vous souhaitez créer un lien :
Sélectionnez l’option Fichier pour Cible, puis sélectionnez le fichier contenant la rubrique de référence.
Vous pouvez sélectionner une rubrique de référence dans la rubrique actuelle, toute rubrique actuellement ouverte, ou utiliser le bouton Parcourir pour sélectionner une rubrique non ouverte.
Dans la liste Éléments, sélectionnez la rubrique à référencer.
Pour ajouter un lien indirect, vous devez utiliser des références de touche DITA. Pour plus d’informations sur les références de touche, voir Utilisation des espaces de touche pour gérer des références de touche DITA.
Sélectionnez l’option Touche pour Cible, puis cliquez sur Gestionnaire d’espace de touche.
Dans la boîte de dialogue Gestionnaire d’espace de touche DITA, sélectionnez la touche dans la liste Touches définies, puis cliquez sur OK.
Dans la liste déroulante Afficher avec, sélectionnez l’élément pour afficher le texte du lien.
Spécifiez le texte ou le format à afficher dans le lien.
Cliquez sur Insérer.