Accueil > Références croisées

Références croisées

Voyez ce que sont les références croisées et apprenez à utiliser le panneau Références croisées dans FrameMaker.

Vous pouvez fournir aux lecteurs des liens d’un document à un autre ou d’une partie d’un document à une autre. FrameMaker permet de créer des liens à l’aide des références croisées. Dans FrameMaker, les références croisées sont basées sur les marqueurs, si la position d’une référence croisée dans le document change, le lien reste intact tant que le marqueur est conservé. Par exemple, imaginons que vous créez une référence croisée pour un en-tête d’un document, puis incluez ou supprimez le contenu avant l’en-tête. La référence croisée reste intacte, même si l’emplacement de l’en-tête de destination a changé.

Pour ouvrir le panneau Références croisées :

Panneau Références croisées
Panneau Références croisées dans FrameMaker

Le panneau Références croisées affiche la liste des références croisées du document en cours.

Pour trier la liste, cliquez sur un en-tête de colonne de la liste. La liste est triée selon l’en-tête sur lequel vous cliquez.

Pour redimensionner une colonne :

  1. Passez le pointeur de la souris entre deux colonnes jusqu’à ce que le curseur change pour une flèche bidirectionnelle.

  2. Maintenez le bouton gauche de la souris enfoncé, faites glisser, puis relâchez le bouton de la souris lorsque la largeur de la colonne correspond au besoin.

Utilisez le panneau Références croisées pour :

A (Rechercher) :

Recherche de références croisées dans la liste. La fonctionnalité SAYT (recherche lors de la saisie) fonctionne sur toutes les colonnes dans la liste.

B (Insérer) :

Insérez une référence croisée dans le document. Voir Insertion de références croisées.

C (Modifier) :

Ouvrez la boîte de dialogue des références croisées pour modifier une référence croisée. Voir Modification des références croisées dans un document.

D (Supprimer) :

Supprimer une référence croisée sélectionnée Voir Suppression des références croisées dans un document.

E (Aller à l’emplacement) :

Accédez à la référence croisée sélectionnée dans le document en cours.

F (Convertir en texte) :

Convertit la référence croisée sélectionnée en texte modifiable.

Remarque : Le texte visible de la référence croisée est converti en texte modifiable. Par exemple, si vous choisissez d’inclure le numéro de page dans le texte de référence croisée, celui-ci est conservé comme texte modifiable. Pour plus d’informations sur les formats de référence croisée, voir Gestion des formats de références croisées.
G (Filtrer) :

Filtrez les références croisées sur la base du document ou du type de références. Dans la liste Document, sélectionnez l’une des options suivantes :

  • En cours

  • Documents ouverts

  • Sélectionner un document dans la liste

Pour le type de références, sélectionnez l’une des options suivantes :

H (Actualiser) :

Actualisation de la liste des références croisées disponibles.

Insertion de références croisées

Comprendre comment insérer des références croisées dans les documents FrameMaker.

Vous pouvez insérer la référence croisée dans un document pour pointer sur une autre section du document en cours, ou sur une section d’un autre document. Vous pouvez Insérer des références croisées dans des documents ou Insertion d’une référence croisée à un élément dans des documents structurés.

Boîte de dialogue Références croisées

La boîte de dialogue Références croisées permet d’insérer une référence croisée dans un document.

Boîte de dialogue Références croisées
Insertion de références croisées avec la boîte de dialogue Références croisées

Dans la boîte de dialogue Références croisées:

Document 

Sélectionnez le document contenant l’emplacement de destination de la référence croisée.

Remarque : Si la référence croisée pointe sur emplacement d’un autre document, vous devez ouvrir ce document.
Aller à la source

Accédez à l’emplacement de la référence croisée. Si la référence croisée se trouve dans un autre document, ouvrez le document et accédez à la balise du paragraphe sélectionné.

Type de source

Sélectionnez le type de contenu de l’emplacement de destination :

Paragraphe

Opération Insertion d’une référence croisée à un paragraphe d’un document

Marqueurs de référence croisée

Opération Insertion d’une référence croisée pour un marqueur RC dans un document

Éléments répertoriés dans l’ordre/Éléments répertoriés par ID

Opération Insertion d’une référence croisée à un élément dans des documents structurés.

Vous pouvez choisir de lister les éléments du document dans l’ordre dans lequel ceux-ci apparaissent dans le document. Sinon, vous pouvez répertorier les éléments par leur ID.

Listes Type de source

Selon le type de source sélectionné ci-dessus, la liste de gauche ci-dessous affiche les balises de paragraphe, les références croisées ou les types d’éléments du document sélectionné.

La zone de liste de droite affiche les paragraphes, les références croisées ou les éléments spécifiques.

Balise d’élément

Sélectionnez la balise d’élément (par exemple XRef) à utiliser pour la référence croisée. Pour plus de détails, reportez-vous à la section Insertion d’une référence croisée à un élément dans des documents structurés.

Format

Sélectionnez un format pour afficher la référence croisée dans le document en cours. Pour plus de détails, reportez-vous à la section Gestion des formats de références croisées.

Modifier un format

Par défaut, FrameMaker fournit la liste des formats de références croisées. Sélectionnez cette option pour ajouter, modifier ou supprimer dans cette liste. Pour plus de détails, reportez-vous à la section Gestion des formats de références croisées.

Convertir en texte

Affiche la boîte de dialogue de conversion des références croisées texte.

Cette boîte de dialogue permet de convertir en texte modifiable :

  • des références croisées sélectionnées ;

  • des références croisées avec un format spécifique ;

  • des références croisées avec une balise Elément spécifique ;

  • toutes les références croisées du document en cours.

Insérer / Remplacer

Insère une référence croisée à l’emplacement spécifié. Voir Insérer des références croisées dans des documents. Si vous sélectionnez une référence croisée existante, l’option Remplacer permet de mettre à jour la référence croisée. Voir Mise à jour des références croisées dans un document.

Insérer des références croisées dans des documents

Il est possible d’insérer une référence croisée pour un paragraphe (par exemple, des en-têtes) dans un document ou des encarts de texte au sein d’un document.

De la même manière, il est possible d’insérer une référence croisée pour un mot ou à une expression d’un document. Dans un document structuré, il est également possible d’insérer des références croisées à des éléments de la hiérarchie structurée.

Insertion d’une référence croisée à un paragraphe d’un document

  1. Placez le point d’insertion à l’endroit du document en cours où vous souhaitez insérer la référence croisée.

  2. Cliquez sur Insérer dans le panneau Références croisées.

    Sinon, sélectionnez le menu Insérer > Référence croisée.

    La Boîte de dialogue Références croisées s’affiche.

  3. Dans la liste déroulante Document, sélectionnez le document contenant le paragraphe de destination.

    Important: Pour insérer une référence croisée dans un autre document, vous devez ouvrir le document de destination dans FrameMaker.
  4. Sélectionnez le texte de paragraphe et le paragraphe spécifique.

  5. Dans la liste Format, sélectionnez le format d'affichage de la référence croisée.

    Par exemple, le format See Heading & Page (Voir en-tête et page) donne l’affichage :

    See “Creating cross-references” on page 1
  6. Cliquez sur Insérer.

Si vous déplacez le paragraphe d’un document à un autre, FrameMaker utilise le marqueur Résolution de références croisées non résolues dans un document.

Tip: Pour conserver les références croisées que déplacez sur un document, vous devez également déplacer les marqueurs RC.
Important: Si le paragraphe de destination existe dans un document distinct, vous devez vérifier que vous disposez des autorisations en écriture sur ce document. Par exemple, si vous utilisez un système de gestion de contenu, vous pourriez être amené à extraire les documents source et de destination.

Insertion d’une référence croisée à un paragraphe dans un encart de texte

Si vous avez un document comportant une référence d’encarts de texte à un autre document, vous pouvez insérer une référence croisée aux paragraphes contenus dans les encarts de texte. Si un utilisateur suit le lien de la référence croisée dans le document principal, celui-ci est redirigé vers l’encart de texte du document proprement dit.

  1. Placez le point d’insertion à l’endroit du document en cours où vous souhaitez insérer la référence croisée.

  2. Cliquez sur Insérer dans le panneau Références croisées.

    Sinon, sélectionnez le menu Insérer > Référence croisée.

    La Boîte de dialogue Références croisées s’affiche.

  3. Dans la liste déroulante Document, sélectionnez le document qui est référencé dans l’encart de texte contenant le paragraphe de destination.

    Important: Pour insérer une référence croisée dans un autre document, vous devez ouvrir le document de destination dans FrameMaker.
  4. Sélectionnez le texte de paragraphe et le paragraphe spécifique.

  5. Dans la liste Format, sélectionnez le format d'affichage de la référence croisée.

    Par exemple, le format See Heading & Page (Voir en-tête et page) donne l’affichage :

    See “Creating cross-references” on page 1
  6. Cliquez sur Insérer.

Si vous insérez une référence croisée de paragraphe dans un encart de texte, le marqueur de cette référence croisée risque d’être perdu lors de la mise à jour de l’encart. Pour empêcher la perte du marqueur, insérez tout d’abord une référence croisée au paragraphe dans le document source de l’encart de texte.

  1. Ouvrez la source de l’encart en cliquant deux fois sur ce dernier, puis en cliquant sur Ouvrir source dans le panneau Caractéristiques de l’encart de texte.

  2. Insérez une référence croisée vers le paragraphe à n’importe quel endroit dans le document source.

  3. Supprimez le texte de la référence croisée. Le marqueur est toujours présent.

  4. Enregistrez le document source, puis mettez à jour l’encart de texte à l’aide de la commande Edition > Mettre à jour les références dans le document contenant l’encart de texte.

  5. Insérez une référence croisée localisée, cette fois dans le document contenant l’encart. La référence croisée utilise le marqueur dans l’encart mis à jour.

Insertion d’une référence croisée pour un marqueur RC dans un document

Vous pouvez insérer une référence croisée pour n’importe quel emplacement d’un document à l’aide du marqueur de type RC. Le marqueur RC permet d’établir un lien à un mot ou à une expression dans un paragraphe ou un cadre ancré, et même au texte d’une cellule d’un tableau. Vous pouvez établir un lien à tout emplacement d’un document où il est possible d’insérer un marqueur RC.

  1. Placez le point d’insertion à l’emplacement de destination, puis ouvrez la boîte de dialogue Marqueur (Insérer > Marqueur).

  2. Dans la boîte de dialogue Marqueur, sélectionnez le type de marqueur RC.

  3. Spécifiez le texte du marqueur, puis cliquez sur Nouveau marqueur.

    Le texte du marqueur peut être un intitulé quelconque que vous spécifiez pour le nom. Sélectionnez cette boîte de dialogue Référence croisée lorsque vous insérez la référence croisée.

    Un nouveau marqueur est inséré à l’emplacement de destination.

  4. Placez le point d’insertion à l’emplacement pour créer la référence croisée.

    Remarque : Les emplacements des références croisées et des marqueurs peuvent être dans les mêmes documents ou des documents distincts.
  5. Ouvrez la boîte de dialogue Boîte de dialogue Références croisées.

  6. Dans la liste déroulante Type de source, sélectionnez Marqueurs de référence croisée.

  7. Dans la liste Type de marqueur, sélectionnez RC (Cross-Ref).

  8. Dans la liste Marqueurs de référence croisée, sélectionnez le marqueur (par nom) que vous avez créé dans les étapes 1 à 3.

Pour insérer la référence croisée, exécutez le reste des étapes selon la procédure décrite dans Insertion d’une référence croisée à un paragraphe d’un document.

Important: Si la référence croisée de destination existe dans un document distinct, vous devez vérifier que vous disposez des autorisations en écriture sur ce document. Par exemple, si vous utilisez un système de gestion de contenu, vous pourriez être amené à extraire les documents source et de destination.

Insertion d’une référence croisée à un élément dans des documents structurés

Dans un document structuré, outre les références croisées renvoyant aux paragraphes et les marqueurs RC (Cross-ref), vous pouvez également insérer des références croisées renvoyant à des éléments dans le document en cours ou d’autres documents structurés.

  1. Placez le point d’insertion à l’endroit du document en cours où vous souhaitez insérer les références croisées.

  2. Cliquez sur Insérer dans le panneau Références croisées.

    Sinon, sélectionnez le menu Insérer > Référence croisée.

    La boîte de dialogue Insérer une référence croisée s’affiche.


    Insérez la boîte de dialogue Références croisées dans FrameMaker

  3. Sélectionnez l’élément DITA à utiliser pour insérer la référence croisée.

    Remarque : Les éléments de cette liste dépendent des éléments de référence croisée définis dans l’application structurée.
  4. Dans la zone Cible, choisissez si le fichier, l’espace de touche ou ces deux éléments contiennent l’élément de destination.

    Remarque : Si vous sélectionnez Fichier, sélectionnez le fichier contenant la destination cible. Si vous sélectionnez Clé, sélectionnez la clé cible. Si vous choisissez les deux éléments, vous devez sélectionner la source de votre référence croisée dans la liste déroulante Paramètres pour. Vous pouvez également rechercher l’élément requis en réalisant une saisie dans la zone de texte Filtre.
  5. Sélectionnez l’élément cible dans la liste.

    La liste contient des informations concernant le type d’élément, l’ID et le contenu à l’emplacement où l’élément est utilisé.

  6. Dans la zone Affichage entrez le texte de la référence croisée, ou sélectionnez le format dans la liste déroulante.

    Par exemple, le format See_Title_and_Page (Voir en-tête et page) donne l’affichage :

    See “Creating cross-references” on page 1
  7. Cliquez sur Insérer.

Lorsque vous insérez une référence croisée renvoyant à un élément d’un document structuré, FrameMaker utilise les attributs ID et IDRef des éléments de destination et sources, respectivement.

Si vous insérez une référence croisée renvoyant à un élément dont l’attribut ID n’a pas actuellement de valeur affectée, FrameMaker affecte une valeur unique à l’attribut. Cependant, si l’attribut ID n’est pas en lecture seule, vous pouvez définir manuellement la valeur d’attribut.

Vous devez vérifier que l’élément de destination contient l’attribut ID défini. Dans le cas contraire, vous devez utiliser un autre élément ou la définition d’application structurée doit être modifiée.

Important: Si l’élément de destination existe dans un document distinct, vous devez vérifier que vous disposez des autorisations en écriture sur ce document. Par exemple, si vous utilisez un système de gestion de contenu, vous pourriez être amené à extraire les documents source et de destination.

Gestion des références croisées

Apprenez à gérer, à modifier, à supprimer et à mettre à jour des références croisées dans FrameMaker, à travailler avec des formats de références croisées ainsi qu'à identifier et à gérer des références croisées non résolues.

Vous pouvez modifier (voir Modification des références croisées dans un document) ou supprimer (voir Suppression des références croisées dans un document) les références croisées existantes dans un document. Vous pouvez également, modifier les formats des références croisées pour changer la façon dont la référence croisée apparaît dans la sortie du document. Par exemple, vous pouvez choisir de n’afficher que le texte de l’intitulé, sans inclure le numéro de page dans la référence croisée. Pour plus de détails, reportez-vous à la section Gestion des formats de références croisées. Vous pouvez mettre à jour les références croisées du document. Par exemple, si le contenu de destination est modifié. Voir Mise à jour des références croisées dans un document. En outre, les modifications apportées au contenu de destination peuvent provoquer la rupture des références croisées dans le document en cours. Pour identifier et gérer des références croisées non résolues, voir Gestion des références croisées non résolues.

Modification des références croisées dans un document

La boîte de dialogue Références croisées permet de modifier n’importe quelle propriété associée à une référence croisée existante, y compris la destination de la référence croisée.

Modification de la référence croisée dans un document

  1. Pour une référence croisée existante, cliquez deux fois sur la référence croisée dans le document.

    Alternativement, sélectionnez le panneau Référence croisée (Affichage > Panneaux > Références croisées), sélectionnez la référence croisée dans le panneau et cliquez sur Modifier.

    La boîte de dialogue Référence croisée apparaît.

  2. Elle permet de mettre à jour :

    • Le document de destination et le paragraphe, la référence croisée ou l’élément ;

    • Balise d’élément - si la référence croisée est un élément d’un document structuré ;

    • Le format de la référence croisée

      Cliquez sur Modifier un format pour ouvrir leBoîte de dialogue Modifier le format de référence croisée. Cette boîte de dialogue permet d’ajouter, de modifier ou de supprimer des formats de références croisées. Pour plus de détails, reportez-vous à la section Gestion des formats de références croisées.

    • Convertir des références croisées du document en texte.

  3. Pour mettre à jour la référence croisée, cliquez sur Remplacer.

Suppression des références croisées dans un document

Si vous supprimez une référence croisée d’un document, à l’instar du texte, la référence croisée est supprimée. Par exemple, si la référence croisée suivante est insérée dans un document :

See “Creating cross-references” on page 1

Si vous supprimez la référence croisée, celle-ci est supprimée du catalogue du document et le texte (Voir « Création de références croisées » à la page 1) est supprimé du document.

Suppression d’une référence croisée dans un document

  1. Ouvrez le panneau Références croisées (Affichage > Panneaux > Références croisées).

  2. Sélectionnez la référence croisée dans le panneau, cliquez sur Supprimer.

Vous pouvez également sélectionner la référence croisée dans le document, puis appuyer sur la touche Suppr. du clavier. A noter que dans ce cas, vous risquez de également de supprimer accidentellement n’importe quel texte contigu.

Gestion des formats de références croisées

Lorsque vous insérez une référence croisée dans un document, vous devez sélectionner un format à associer au document.

Par exemple, le format See Heading & Page (Voir en-tête et page) donne l’affichage :

See “Creating cross-references” on page 1

La liste déroulante Format affiche les formats disponibles. Vous pouvez choisir l’un des formats lorsque vous insérez une référence croisée dans un document. Vous pouvez également modifier ces formats ou en créer d’autres. Les formats de référence croisée sont spécifiques du document FrameMaker. Cependant, vous pouvez utiliser les formats mis à jour dans un autre document via Importation de formats de référence croisée.

Boîte de dialogue Modifier le format de référence croisée

La boîte de dialogue Modifier le format de référence croisée permet de créer, modifier ou supprimer des formats de référence croisée dans le document en cours.

Boîte de dialogue Modifier le format de référence croisée
Modifier la boîte de dialogue Références croisées dans FrameMaker

Utilisez la boîte de dialogue Modifier le format de référence croisée pour :

Nom:

Mettre à jour le nom d’un format existant ou spécifier un nom pour un nouveau format.

Définition :

Définir le format de référence croisée.

Pour définir un format, vous pouvez entrer n’importe quel texte fixe (par exemple : Illustration qui s’affichera lorsque vous spécifiez le texte dans la définition). Vous pouvez également utiliser la liste Composantes des définitions pour afficher des informations contextuelles.

Par exemple, le format Heading & Page par défaut est défini comme :

“<$paratext>” on page\ <$pagenum>

Les parties composantes de la définition sont incluses entre des chevrons (<>) et précédées d’un signe dollar ($). Lorsque FrameMaker rencontre cette nomenclature dans un format de référence croisée, il interprète cela en fonction des définitions de composantes. Dans l’exemple ci-dessus, FrameMaker interprète :

<$textepara>

Texte de paragraphe du paragraphe en référence croisée

<$numpage>

Numéro de page du paragraphe en référence croisée

La référence croisée résultante apparaît comme :

“Inserting cross-references” on page 25

Pour plus de détails, reportez-vous à la section Composantes du format de référence croisée.

Si la définition contient des caractères qui ne sont pas selon la nomenclature des composantes, ces caractères s’affichent tels qu’ils sont saisis dans la définition. Disons que dans l’exemple ci-dessus, vous ayez défini le format En-tête et page de la forme suivante :

“<$paratext>” on page\ <$PageNum>

La référence croisée résultante apparaît comme :

“Inserting cross-references” on page <$PageNum>
Ajoutez des éléments

Création d’un format. Voir Création de formats de références croisées.

Modifier

Modification d’un format existant. Voir Modification des formats de références croisées.

Supprimer

Suppression d’un format existant. Voir Suppression des formats de référence croisée.

Création de formats de références croisées

Vous pouvez créer des formats de référence croisée, puis les utiliser dans le document en cours. Pour utiliser les nouveaux formats dans un autre document, voir Importation de formats de référence croisée.

  1. Dans Boîte de dialogue Modifier le format de référence croisée, attribuez un nom à la référence croisée dans le champ Nom.

  2. Dans le champ Définition, définissez le format de référence croisée.

    Pour définir le format, vous pouvez saisir n’importe quel texte (lettres, caractères ou nombres) qui s’affiche tel quel dans la référence croisée.

    Utilisez les composantes pour afficher des informations contextuelles dans la référence croisée.

    Pour ajouter une composante à la définition, placez le point d’insertion à l’emplacement approprié, puis cliquez sur la définition dans la liste Composantes.

    Vous pouvez également saisir la définition de composante en incluant la définition entre chevrons (<>) et en faisant précéder la définition du signe dollar ($).

    Pour plus de détails, reportez-vous à la section Composantes du format de référence croisée.

  3. Pour créer un format de référence croisée, cliquez sur Ajouter.

Modification des formats de références croisées

Vous pouvez modifier des formats de référence croisée existants, puis les utiliser dans le document en cours. Pour utiliser les formats mis à jour dans un autre document, voir Importation de formats de référence croisée.

  1. Dans Boîte de dialogue Modifier le format de référence croisée, sélectionnez un format existant dans la liste Formats.

    Remarque : Vous pouvez modifier le nom du format dans le champ Nom.
  2. Dans le champ Définition, modifiez la définition du format de référence croisée.

    Vous pouvez saisir n’importe quel texte (lettres, caractères ou nombres) qui s’affiche tel quel dans la référence croisée.

    Utilisez les composantes pour afficher des informations contextuelles dans la référence croisée.

    Pour ajouter une composante à la définition, placez le point d’insertion à l’emplacement approprié, puis cliquez sur la définition dans la liste Composantes.

    Vous pouvez également saisir la définition de composante en incluant la définition entre chevrons (<>) et en faisant précéder la définition du signe dollar ($).

    Pour plus de détails, reportez-vous à la section Composantes du format de référence croisée.

  3. Cliquez sur Modifier, et pour mettre à jour le format de référence croisée sélectionné, cliquez sur Terminé.

    La boîte de dialogue Mettre à jour les références croisées apparaît.

  4. Si vous mettez à jour la définition de format, vous devez mettre à jour les références :

    • Dans le document actif

    • Dans tous les documents ouverts référencés par des références croisées dans le document en cours

    • Dans tous les documents référencés par des références croisées dans le document en cours

    Ou cliquez sur Annuler pour ne pas tenir compte des modifications apportées aux formats dans chacune des références croisées.

Suppression des formats de référence croisée

Vous pouvez choisir de supprimer des formats de référence croisée non utilisés dans le document. Vous pouvez également décider de supprimer des formats de référence croisée actuellement utilisés. Si vous supprimez un format de référence croisée utilisé dans le document en cours, vous êtes alors averti que toutes les références croisées qui utilisent le format seront converties en texte modifiable.

  1. Dans Boîte de dialogue Modifier le format de référence croisée, sélectionnez un format existant dans la liste Formats.

  2. Cliquez sur Supprimer et pour supprimer du catalogue du document le format de référence croisée sélectionné, cliquez sur Terminé.

    Vous êtes invité à changer en texte modifiable toutes les références croisées qui utilisent le format supprimé.

Importation de formats de référence croisée

Les formats de référence croisée que vous ajoutez ou modifiez sont utilisables dans le document en cours. Vous devez importer les formats pour rendre les accessibles dans d’autres documents.

  1. Ouvrez le document contenant le format de référence croisée à importer dans d’autres documents.

  2. Ouvrez le document dans lequel vous devez importer les formats.

    Assurez-vous que le document dans lequel vous devez importer les formats est actuellement sélectionné.

  3. Ouvrez la boîte de dialogue Importer des formats (Fichier > Importer > Formats).

  4. Dans la liste déroulante Importer du document, sélectionnez le document source et vérifiez que seule la case à cocher Formats de références croisées est sélectionnée.

    Vous pouvez commencer par utiliser le bouton Tout désélectionner pour désactiver toutes les cases à cocher et sélectionner ensuite la case à cocher Formats de références croisées.

  5. Pour importer les formats de références croisées, cliquez sur Importer.

Composantes du format de référence croisée

Lorsque vous ajoutez ou modifiez un format de référence croisée, les composantes permettent d’afficher des informations contextuelles dans la référence croisée. Les sections suivantes décrivent les composantes utilisables pour créer des formats de référence croisée.

Composantes d’informations de fichier source

Les composantes suivantes fournissent des informations sur le fichier source du document contenant la référence croisée :

Composante

Description

<$filename>

Nom du document source.

<$fullfilename>

Chemin d’accès complet au document source.

<$volnum>

Numéro de volume du document contenant le paragraphe source

<$chapnum>

Numéro de chapitre du document contenant le paragraphe source

Paragraphe source

Les composantes suivantes fournissent des informations sur le paragraphe source référencé par la référence croisée :

Composante

Description

<$pagenum>

Numéro de page du paragraphe source

<$paratext>

Texte du paragraphe source, sans son numéro automatique. Si le format de caractère du texte du paragraphe source a été modifié par l’application d’un format du Catalogue de caractères, les familles de polices ainsi que les caractéristiques d’exposant et d’indice sont conservées dans le texte de la référence croisée.

<$paratag>

Etiquette du paragraphe source.

<$paranum>

Numéro automatique complet du paragraphe source, incluant tout texte figurant dans le format de numéro automatique

<$paranumonly>

Compteurs de numéros automatiques du paragraphe source, incluant tous les caractères situés entre ceux-ci

Paragraphe précédant le paragraphe source

Une référence croisée à une sous-section identifie souvent la section qui la contient. Par exemple, cette référence croisée à un sous-intitulé identifie l’intitulé principal sous lequel il se trouve : Voir « Types de limites des plaques » dans « Tectonique des plaques ». Dans cet exemple, Types de limites des plaques constitue le paragraphe source et Tectonique des plaques l’intitulé principal sous lequel se trouve le paragraphe source.

Dans chaque composante, remplacez etiq (entre crochets) par l’étiquette du paragraphe auquel vous souhaitez faire référence, mais ne supprimez pas les crochets. Par exemple, pour faire référence au texte du paragraphe précédent étiqueté EnTête1, utilisez la formulation <$textepara[EnTête1]>.

Composante

Description

<$pagenum[tag]>

Numéro de page du paragraphe précédent avec l’étiquette spécifiée.

<$paratext[tag]>

Texte du paragraphe précédent avec l’étiquette spécifiée, sans son numéro automatique. Si le format de caractère du texte du paragraphe source a été modifié par l’application d’un format du Catalogue de caractères, les familles de polices ainsi que les caractéristiques d’exposant et d’indice sont conservées dans le texte de la référence croisée.

<$paratag[tag]>

Etiquette du paragraphe précédent avec l’étiquette spécifiée.

<$paranum[tag]>

Numéro automatique complet du paragraphe précédent avec l’étiquette spécifiée, y compris tout texte figurant dans le format de numéro automatique.

<$paranumonly[tag]>

Compteurs de numéros automatiques du paragraphe précédent avec l’étiquette spécifiée, y compris tous les caractères situés entre ceux-ci.

Important: n’utilisez pas d’étiquette de paragraphe comportant des crochets ([ ]).
Eléments de documents structurés

Utilisez les composantes suivantes pour créer des formats de références croisées qui se rapportent à des éléments de document structurés.

Composante

Description

<$elempagenum>

Numéro de page de l’élément source

<$elemtext>

Texte de l’élément source (jusqu’au premier saut de paragraphe) sans son numéro automatique, mais avec tout préfixe et suffixe spécifié dans la définition de l’élément.

<$elemtextonly>

Texte de l’élément source (jusqu’au premier saut de paragraphe) sans son numéro automatique ni préfixe ou suffixe spécifié dans la définition de l’élément.

<$elemtag>

Etiquette de l’élément source.

<$elemparanum>

Numéro automatique complet du premier paragraphe de l’élément source (ou du paragraphe contenant l’élément source), y compris tout texte figurant dans le format de numéro automatique.

<$elemparanumonly>

Compteurs de numéros automatiques du premier paragraphe de l’élément source (ou du paragraphe contenant l’élément source), y compris tous les caractères situés entre ceux-ci

<$attribute[name]>

Valeur de l’attribut avec le nom spécifié (ou valeur par défaut si aucune valeur n’est spécifiée)

Mise à jour des références croisées dans un document

Si le contenu source des références croisées est mis à jour, vous devez mettre à jour les références croisées dans le document en cours. Par exemple, si vous créez une référence croisée de paragraphe pour un intitulé et modifiez ensuite le texte de l’intitulé, vous devez mettre à jour la référence croisée dans le document contenant la référence croisée.

Les références croisées du document sont mises à jour chaque fois qu’un document est ouvert. Vous pouvez également mettre à jour manuellement les références dans un document déjà ouvert. En outre, vous pouvez empêcher FrameMaker de mettre à jour les références croisées à chaque ouverture d’un document.

Mise à jour des références croisées d’un document

  1. Dans le menu Edition, sélectionnez Mettre à jour les références.

  2. Dans la boîte de dialogue qui s’ouvre, vérifiez les références croisées, puis cliquez sur Mettre à jour.

Si FrameMaker ne parvient pas à résoudre les références croisées, la zone de dialogue Mettre à jour les références croisées non résolues s’affiche. Pour plus d’informations sur les références croisées non résolues, voir Gestion des références croisées non résolues.

Suppression de la mise à jour automatique des références croisées

Par défaut, FrameMaker met à jour les références croisées d’un document chaque fois que le document est ouvert. Cependant, si un document contient un grand nombre de références croisées, la validation des références croisées dans le document peut entraîner un accroissement important du temps de chargement du document.

Pour empêcher FrameMaker de mettre à jour les références croisées à l’ouverture d’un document :

  1. Sélectionnez Modifier > Mettre à jour les références.

  2. Dans la boîte de dialogue Mettre à jour les références, ouvrez la liste déroulante Commandes dans le coin supérieur droit et sélectionnez Annuler la mise à jour automatique.

  3. Dans la boîte de dialogue Annuler la mise à jour automatique des références, cochez Annuler la mise à jour automatique de toutes les références croisées et cliquez sur Définir.

Gestion des références croisées non résolues

Si la source de la référence croisée est modifiée sans que FrameMaker soit en mesure de mettre à jour la référence à la destination, FrameMaker signale la référence croisée comme non résolue. Cela peut se produire, par exemple, si le document source ou le contenu est supprimé.

FrameMaker signale une référence croisée comme non résolue si :

  • Le marqueur ou la source de la référence croisée ont été déplacés dans un autre fichier ou le fichier source lui-même a été déplacé ou renommé.

  • La source a été supprimée ou, s’il s’agit d’un paragraphe ou d’un marqueur de référence croisée, le marqueur indiquant la source a été supprimé.

  • Le fichier contenant le marqueur est actuellement ouvert par un autre utilisateur.

  • La valeur de l’attribut d’identification de l’élément source ou de l’attribut d'ID des références croisées (@IDRef) a été modifiée ou supprimée.

Identification des références croisées non résolues dans un document

Vous pouvez afficher la liste des références croisées non résolues dans un document dans le panneau:

  1. Ouvrez le panneau Références croisées (Affichage > Panneau > Références croisées).

  2. Dans la liste déroulante Références, sélectionnez Références croisées non résolues.

La liste affiche les références croisées non résolues. Utilisez la boîte de dialogue Mettre à jour les références pour Résolution de références croisées non résolues dans un document.

Vous avez également la possibilité de générer une liste des références croisées non résolues d’un document :

  1. Sélectionnez Insérer > Liste de > Références.

  2. Choisissez de créer la liste en tant qu’index autonome des références ou d’ajouter l’index dans un nouveau livre.

  3. Déplacez l’outil Références croisées non résolues vers la liste Inclure références et cliquez sur Définir.

La liste générée comprend le numéro de page de chaque référence croisée non résolue et indique si la source manquante est interne (dans le document en cours) ou externe (dans un autre document). Cette liste comporte des informations supplémentaires, comme la balise et le texte du paragraphe source, par exemple (pour les documents non structurés), ou l’ID, la balise d’élément et le texte de l’élément source (pour les documents structurés). Pour les références croisées du marqueur de références croisées, la liste inclut le texte des marqueurs.

Remarque : La balise et le texte ne sont pas toujours précis, car ils ne sont pas mis à jour après la première insertion de la référence croisée.

Résolution de références croisées non résolues dans un document

Pour résoudre les références croisées externes non résolues d’un document :

  1. Ouvrez la boîte de dialogue Mettre à jour les références (Modifier > Mettre à jour les références).

  2. Cliquez sur la liste déroulante Commandes et sélectionnez Mettre à jour les références croisées non résolues.

    La boîte de dialogue Mettre à jour les références croisées non résolues apparaît.

  3. Dans la liste de sélection Total de références croisées non résolues, sélectionnez le fichier qui contenait précédemment la source de la référence croisée non résolue. Le texte sous la liste indique le nombre de références croisées au fichier sélectionné non résolues.

  4. Accédez au document alternatif contenant la référence croisée, et sélectionnez-le.

  5. Pour résoudre les références croisées à n’importe quel autre fichier répertorié dans la liste de sélection Total de références croisées non résolues, répétez les étapes 3 et 4, puis cliquez sur Terminé.

Pour résoudre les références croisées pour le marqueur RC (Cross-Ref), vous devez recréer le marqueur RC (Cross-Ref) et la référence croisée. Pour plus de détails, reportez-vous à la section Insertion d’une référence croisée pour un marqueur RC dans un document.

De même, pour résoudre des références croisées pour des éléments dans des documents structurés, vous devez recréer la référence croisée. Pour plus de détails, reportez-vous à la section Insertion d’une référence croisée à un élément dans des documents structurés.