Adobe FrameMaker User Guide
Cliquer ici pour voir cette page dans le contexte complet
Familiarisez-vous avec les références contextuelles dans un document structuré et découvrez comment les utiliser pour créer une référence au contenu d’une autre rubrique DITA.
Une référence contextuelle (conref) permet de créer une référence à un contenu (éléments) à partir d’une rubrique DITA ou d’un mappage DITA dans une autre rubrique DITA. Une référence contextuelle (conref) permet de réutiliser un contenu (éléments) sur plusieurs rubriques DITA. Une conref est basée sur l’Attribut ID DITA assignée à l’élément. Cela signifie que si la position d’un élément dans la rubrique change, la référence reste intacte tant que l’ID demeure intact.
Vous pouvez utiliser un référencement direct pour pointer directement sur la rubrique DITA (fichier .xml) contenant les rubriques ou éléments cibles. Vous pouvez également utiliser le référencement indirect pour pointer sur des touches définies dans des espaces de touche. Pour plus d’informations, voir Référencement DITA.
Vous pouvez créer des références contextuelles (conrefs) pour pratiquement n’importe quel élément du catalogue des éléments DITA. Créez des références contextuelles (conrefs) pour une rubrique DITA afin de rendre une rubrique entière réutilisable. Vous pouvez également créer une référence contextuelle pour un <mot-clé> ou pour un élément <ph> à lier à un terme ou même à un mot. <> La seule exigence pour la création d’une référence contextuelle (conref) est que l’élément doit définir l’Attribut ID DITA.
Apprenez à configurer une rubrique pour utiliser des références contextuelles (conref) dans FrameMaker.
Pour créer une référence contextuelle (conref) dans vos rubriques DITA, vous devez d’abord créer une rubrique DITA (référencement direct) ou un mappage DITA (référencement indirect) contenant le contenu (éléments) que vous prévoyez de réutiliser. Par exemple, vous prévoyez de réutiliser un tableau, une liste ordonnée et une image sur plusieurs rubriques. Vous devez ajouter ces éléments à la rubrique source. Si vous utilisez un référencement indirect, la rubrique est alors ajoutée au mappage DITA. En outre, pour rendre un élément réutilisable, vous devez lui affecter un ID unique. Pour plus d’informations sur la façon de rendre un contenu DITA réutilisable, voir Configurer un contenu de référence.
Apprenez à ajouter des références contextuelles directes et indirectes à du contenu DITA dans FrameMaker à l’aide de la boîte de dialogue Référence contextuelle DITA.
La boîte de dialogue Référence contextuelle DITA permet d’ajouter des références contextuelles (conref) directes et indirectes au contenu DITA.
Sélectionnez .
Sélectionnez cette option pour insérer une conref via Référencement DITA. Voir Créer une référence contextuelle (conref).
Sélectionnez cette option pour insérer une conref via Référencement DITA. 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élection d’un élément comme dernier élément de la plage des éléments en référence contextuelle (conref). Pour plus de détails, reportez-vous à la section Création d’une référence contextuelle (conref) pour une plage d’éléments.
Apprenez à utiliser les références contextuelles et à créer ou mettre à jour des références contextuelles dans Adobe FrameMaker.
Vous pouvez créer une référence contextuelle dans une rubrique ou un mappage DITA avec Boîte de dialogue Référence contextuelle DITA.
Cette section traite des rubriques suivantes :
Pour créer une référence contextuelle pour une rubrique ou un mappage DITA dans Configurer un contenu de référencevotre rubrique ou mappage actuel, vous devez d’abord dans les rubriques ou mappages cible.
Ensuite vous créez une référence directe ou indirecte au contenu DITA cible.
Placez le point d’insertion à l’emplacement pour insérer la référence contextuelle (conref) dans une rubrique ou un mappage.
Pour insérer une référence contextuelle (conref) dans un emplacement de la rubrique, vous devez placer le point d’insertion pertinent pour l’élément de référence contextuelle (conref) :
Un élément conref <li> (élément de liste) doit être placé dans une liste <ol> ou <ul>.
Une <ligne> de tableau doit être placée
dans un <tableau> ou un <tableau simple>.
Dans le cas d’une <entrée> de tableau, vous ne pouvez pas placer le point d’insertion dans la <ligne> du tableau ; vous devez sélectionner une <entrée> existante à remplacer.
Sélectionnez .
La Boîte de dialogue Référence contextuelle DITA s’affiche.
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 créer une référence directe au contenu cible, procédez comme suit :
Sélectionnez l’option Fichier pour Cible, puis sélectionnez le fichier contenant la rubrique de référence.
Après avoir sélectionné la rubrique DITA, la liste d’éléments affiche les éléments auxquels des ID uniques sont affectés.
Les éléments figurant dans la rubrique DITA de la balise d’éléments sélectionnée qui ont un ID unique affecté apparaissent dans la liste d’éléments. Si un élément n’a pas d’ID unique affecté, vous pouvez Attribution d’un ID unique à un élément.
Sélectionnez un élément à insérer comme référence contextuelle (conref) dans la rubrique actuelle.
La liste présente également l’ID et le contenu (dans le cas d’éléments de texte) des éléments.
Si vous apportez des modifications à un élément de référence contextuelle (conref) dans la rubrique source, vous devez enregistrer la rubrique source et mettre à jour la rubrique du conteneur pour afficher les mises à jour.<>
Pour créer une référence indirecte au contenu cible, procédez comme suit :
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 clé dans la liste Touches définies, puis cliquez sur OK.
Pour plus d’informations sur la façon d’ajouter des références de touche, voir Utilisation des espaces de touche pour gérer des références de touche DITA.
Après avoir sélectionné la touche, la liste de balises d’éléments affiche les types de rubrique DITA intégrés dans l’espace de touche. Pour en savoir plus sur ce sujet, voir Création d’un espace de touche.
Sélectionnez une balise d’élément.
Les éléments figurant dans la rubrique DITA de la balise d’éléments sélectionnée qui ont un ID unique affecté apparaissent dans la liste d’éléments. Si un élément n’a pas d’ID unique affecté, vous pouvez Attribution d’un ID unique à un élément.
Sélectionnez un élément à insérer comme référence contextuelle (conref), puis cliquez sur OK.
Cliquez sur Insérer.
Vous pouvez créer une référence contextuelle (conref) pour une plage d’éléments. Par exemple, vous disposez de plusieurs éléments <p> (paragraphes) que vous souhaitez référencer contextuellement (conref) dans une plage. Vous pouvez alors créer une référence contextuelle (conref) pour tous les éléments <p>.
Pour sélectionner le premier élément d’une plage, exécutez les étapes décrites dans la section Créer une référence contextuelle (conref)<, mais ne cliquez pas sur Insérer>.
Dans la liste déroulante Elément de fin de référence contextuelle, sélectionnez le dernier élément de la plage à inclure dans la référence contextuelle (conref).
Cliquez sur Insérer.
Si vous mettez à jour un élément réutilisable après l’avoir référencé dans une autre rubrique, vous devez mettre à jour les références contextuelles (conref) dans la rubrique pour afficher les mises à jour.
Pour mettre à jour les références contextuelles (conref) dans une rubrique :
Sélectionnez .
La boîte de dialogue Références de mise à jour DITA s’affiche.
Sélectionnez Mettre à jour toutes les références contextuelles du fichier.
Toutes les références contextuelles (conref) de la rubrique actuelle sont mises à jour.