Accueil > Rubriques DITA

Rubriques DITA

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

Création d’une rubrique DITA

Apprenez à créer et à gérer une rubrique DITA dans FrameMaker.

  1. Dans le menu Fichier, accédez à Nouveau > DITA.

    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 :

    rubrique

    Pour du contenu spécifique, utilisez les types task, concept, reference, glossentry ou glossgroup.

    Consultez les spécifications des rubriques DITA.

    task

    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.

    concept

    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.

    référence

    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.

    glossentry

    Pour un terme de glossaire et une définition uniques.

    Consultez les spécifications des rubriques d’entrée du glossaire.

    glossgroup

    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.

    ditabase

    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.

  2. Sélectionnez un type de rubrique.

  3. Pour afficher la structure hiérarchique de la rubrique créée, sélectionnez Structure > Vue de la structure.

  4. 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.

Ajouter des liens au contenu associé

Apprenez à ajouter des liens vers du contenu associé à l’aide de la boîte de dialogue Lien DITA dans FrameMaker.

Boîte de dialogue Lien DITA

Utilisez la boîte de dialogue Lien DITA pour insérer un lien direct et indirect au contenu DITA.

Boîte de dialogue Lien DITA
Insertion de liens directs ou indirects vers du contenu DITA à l’aide de la boîte de dialogue Lien DITA

La boîte de dialogue Lien DITA vous permet d’effectuer les tâches suivantes :

A (Élément DITA) :

Sélectionnez l’élément de lien à utiliser.

Par défaut, l’élément est <link>.

Consultez les spécifications des liens.

B (Cible > Fichier) :

Sélectionnez cette option pour créer un lien à l’aide d’un référencement direct.

Voir Création d’un lien DITA.

C (Cible > Touche) :

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.

D (Cible > Les deux) :

Sélectionnez cette option pour créer un lien à l’aide d’un référencement direct ou indirect.

E (Fichier/Paramètres de touche) :

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.

F (Filtrer texte) :

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.

G (Afficher avec) :

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.

H (Afficher avec) :

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.

H (Texte)

Spécifiez le texte du lien à afficher comme texte.

I (Format)

Sélectionnez Format et choisissez un format de lien dans la liste déroulante :

Format DITA par défaut

Affichage du titre de la rubrique de référence.

See_Title_and_Page

Afficher Voir <titre de rubrique> à la page <numéro de page>.

Title_and_Page

Afficher <titre de rubrique> dans <page>

J (Lien externe) :

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 ( Insérer > Références externesou le menu contextuel.

Création d’un lien DITA

  1. 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.

    Placement du point d’insertion à droite de l’élément de liens associés
    Placement du point d’insertion à droite de l’élément de liens associés

  2. À partir du panneau Elément (Affichage > Panneaux > Catalogue d’éléments), insérez l’élément <link>.

    La Boîte de dialogue Lien DITA s’affiche.

  3. Sélectionnez l’élément de lien DITA à utiliser.

  4. 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 :

    1. 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.

    2. 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.

    1. Sélectionnez l’option Touche pour Cible, puis cliquez sur Gestionnaire d’espace de touche.

    2. 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.

  5. Dans la liste déroulante Afficher avec, sélectionnez l’élément pour afficher le texte du lien.

  6. Spécifiez le texte ou le format à afficher dans le lien.

  7. Cliquez sur Insérer.