Accueil > Tableaux de relations DITA

Tableaux de relations DITA

Familiarisez-vous avec les concepts de rubriques associées dans un document structuré et avec la manière dont un tableau de relations permet de créer des liens pour les rubriques associées dans FrameMaker.

Dans un ensemble de rubriques DITA, vous avez certainement des rubriques qui sont reliées les unes aux autres. Dans ce cas, vous pourriez souhaiter inclure un ensemble de liens (Voir aussi) associés à la fin de chaque rubrique. Les lecteurs bénéficient ainsi de davantage de références de lecture, si nécessaire.

Par exemple, si vous traitez les options Enregistrer sous comme des rubriques distinctes dans FrameMaker :

Dans ce cas, à la fin de chacune de ces sections, vous pouvez inclure des liens associés aux trois autres rubriques.

Utilisation des mappages DITA

Dans FrameMaker, les tableaux de relations permettent de créer des liens associés dans des rubriques DITA. Utilisez des tableaux de relations avec des mappages DITA. Cela signifie que vous devez créer un mappage DITA, puis inclure les rubriques dans votre rubrique définie dans le mappage DITA. Ajoutez ensuite les tableaux de relations au mappage. Dans les tableaux de relations, définissez les rubriques associées contenues dans le mappage DITA.

Types de rubrique DITA à ajouter

Vous pouvez ajouter les types de rubrique DITA suivants à un tableau de relations :

  • Rubrique

  • Tâche

  • Concept

  • Référence

Ajout de rubriques associées à une ligne du tableau de relations

Pour spécifier que dans un mappage DITA deux rubriques ou plus sont associées, vous devez ajouter ces éléments à une seule ligne du tableau de relations. Pour les étapes de création d’un tableau de relations, voir Création d’un tableau de relations.

Par exemple, pour indiquer que les rubriques Enregistrer sous, Enregistrer au format PDF, Enregistrer en tant que PDF de révision et Enregistrer au format XML sont les rubriques associées :

Tableau de relations dans la vue Document

Remarque : Dans FrameMaker, lorsqu’il apparaît dans la vue Document, le tableau de relations a le même aspect qu’un tableau FrameMaker que vous incluez comme faisant partie de votre contenu.

Vous pouvez ajouter un nombre quelconque de lignes à un tableau de relations. FrameMaker traite toutes les rubriques d’une ligne comme associées.

Vous pouvez ajouter un nombre quelconque de tableaux de relations à un mappage DITA. Ce procédé permettrait ainsi de regrouper des ensembles de rubriques associées.

Spécification de l’ordre des rubriques associées dans une ligne du tableau de relations

L’ordre des rubriques associées dans une ligne du tableau définit la séquence d’affichage des rubriques dans la section Liens associés de la sortie du mappage DITA.

Dans l’exemple suivant, la section Liens associés de la rubrique Enregistrer au format PDF doit apparaître comme suit :

  • Enregistrer sous

  • Enregistrer en tant que PDF de révision

  • Enregistrer au format XML

Tableau de relations dans la vue Document
Tableau de relations dans la vue Document de FrameMaker

Cela signifie que si vous changez l’ordre des rubriques dans le tableau, la séquence dans la section Liens associés s’affiche différemment.

Création d’un tableau de relations

Apprenez à créer un tableau de relations dans FrameMaker et découvrez un exemple de flux de tableau de relations.

  1. Dans la Vue de la structure d’un mappage DITA, placez le point d’insertion à la fin de la rubrique et au même niveau que les éléments de référence de rubrique (topicref).

  2. Pour afficher le Catalogue dynamique, appuyez sur Ctrl+1, puis sélectionnez reltable (tableau de relations).

    La boîte de dialogue Insérer un tableau s’affiche.

  3. Spécifiez le nombre de colonnes et de lignes.

    Le nombre de colonnes dépend du nombre de rubriques associées que vous envisagez de regrouper.

    Le nombre de lignes dépend du nombre de groupes de rubriques associées que vous envisagez de créer.

    Remarque : Vous pouvez également créer plusieurs tableaux de relation pour plusieurs groupes de rubriques associées.
  4. Cliquez sur Insérer.

    Un tableau de relation est ajouté au mappage DITA.

  5. Pour afficher le tableau de relations dans une vue tabulaire, accédez à la vue Document.

    Vous pouvez ajouter des rubriques à un tableau de relations à partir de la Vue de la structure, mais la vue tabulaire est plus pratique à utiliser.

    Tableau de relations par défaut (comprenant 4 colonnes et 1 ligne courante)
    Tableau de relations par défaut (comprenant 4 colonnes et 1 ligne courante) dans FrameMaker

    Dans chaque cellule d’en-tête du tableau de relations, spécifiez le type de rubrique DITA des rubriques associées que vous envisagez d’inclure dans les cellules courantes de la colonne.

    FrameMaker permet d’ajouter les types de rubrique DITA suivants dans un tableau de relations :

    • Rubrique

    • Tâche

    • Concept

    • Référence

    Remarque : Par défaut, FrameMaker prend en charge le type Rubrique. Ainsi, si vous envisagez de n’inclure que les types Rubrique dans le tableau, il n’est pas nécessaire de définir l’attribut type.
  6. Pour ajouter un type Rubrique DITA spécifique dans une colonne du tableau :

    1. Placez le point d’insertion dans la cellule d’en-tête du tableau.

    2. Ouvrez la boîte de dialogue Attributs (Elément > Modifier les attributs).

    3. Indiquez le type de la rubrique DITA dans l’attribut@type :

      Type de rubrique - valeur de l’attribut : topic

      Type de tâche - valeur de l’attribut : task

      Type de concept - valeur de l’attribut : concept

      Type de référence -valeur de l’attribut : reference

      Important: Les valeurs d’attributs respectent à la casse.

      Si vous définissez un attribut Type comme décrit ci-dessus, l’en-tête de colonne est mis à jour :

      Attributs de type mis à jour

  7. Dans chaque cellule d’une ligne du tableau de relations, ajoutez une référence de rubrique des rubriques associées. Cela signifie qu’il faut inclure un ensemble de rubriques associées dans les cellules d’une ligne du tableau.

    Pour ajouter des références de rubrique aux rubriques associées dans les cellules courantes du tableau, procédez comme suit :

    1. Placez le point d’insertion dans la cellule d’une ligne. Dans le catalogueEléments (Elément > Catalogue d’éléments), cliquez deux fois sur l’élément de référence de rubrique (topicref) pour l’ajouter à la cellule.

      La boîte de dialogue Insérer un élément apparaît.

      Le catalogue dynamique permet également d’insérer l’élément de référence de rubrique (topicref).

      Appuyez sur Ctrl+1 pour afficher le catalogue dynamique. Sélectionnez et ajoutez l’élément de référence de rubrique (topicref).

    2. Dans le champ HRef, saisissez le chemin d’accès à un fichier de rubrique, puis cliquez sur OK.

      Sinon, recherchez et sélectionnez la rubrique à l’aide du bouton Parcourir.

      La référence de rubrique est ajoutée à la ligne du tableau.

      Tip: Si vous ne pouvez pas ajouter de référence de rubrique à une cellule du tableau, sélectionnez le type de rubrique spécifié dans l’en-tête de colonne.
    3. Ajoutez une référence de rubrique (à une rubrique associée) à chaque cellule de la ligne du tableau.

Si le tableau comprend plusieurs lignes, vous pouvez ajouter plusieurs groupes de rubriques associées (références) à chaque ligne.

Exemple de flux de table de relations

Pour tester la sortie après Création d’un tableau de relations dans un mappage DITA, vous pouvez utiliser l’option Enregistrer au format PDF de FrameMaker.

  1. Vérifiez que le mappage DITA est sélectionné.

  2. Sélectionnez Fichier > Enregistrer au format PDF.

  3. Dans la boîte de dialogue Configuration PDF, cliquez sur Définir.

La sortie PDF du mappage DITA affiche les sections Liens associés pour les rubriques que vous incluez dans les cellules des tableaux de relations du mappage DITA.

Important: La fonctionnalité Enregistrer au format PDF est utilisée dans cette section à titre d’exemple. Vous pouvez également publier le mappage DITA aux formats de sortie disponibles dans la fonction Publication multicanaux de FrameMaker.

Les rubriques apparaissent dans le même ordre que celui que vous avez spécifié dans les cellules de la ligne du tableau.

En outre, les rubriques associées qui s’affichent n’incluent pas la rubrique actuelle. Dans l’exemple de tableau des relations décrit ci-dessous :

Tableau de relations dans la vue Document
Tableau de relations dans la vue Document dans FrameMaker

La section Liens associés de la rubrique Enregistrer sous affiche :

  • Enregistrer au format PDF

  • Enregistrer en tant que PDF de révision

  • Enregistrer au format XML

Elle n’affiche pas la rubrique Enregistrer sous (en cours).