Onglet Lien/Xref
L'onglet Lien/Xref vous permet d'insérer des liens ou des références croisées dans les rubriques DITA. Si vous sélectionnez > ou cliquez sur le bouton Lien de la barre d'outils et que le Gestionnaire de ressources n'est pas ouvert, le Gestionnaire de ressources s'ouvre et l'onglet Lien/Xref s'active. Cet onglet est disponible dans le Gestionnaire de ressources lors de la modification d'une rubrique ou d'une spécialisation de rubrique.
L'onglet Lien/Xref présente deux états différents. Le premier permet d'insérer des liens ou des références croisées vers des documents locaux. Le deuxième permet d'insérer des liens ou des références croisées vers des documents Internet.
Options d'insertion de liens ou de références croisées vers des documents locaux
Pour insérer des liens ou des références croisées vers des documents locaux, l'onglet Lien/Xref offre les options suivantes :
• Rechercher dans : détermine l'emplacement du contenu affiché dans le navigateur du Gestionnaire de ressources.
Sélectionnez un emplacement dans la liste déroulante. Ce champ indique toujours l'emplacement disponible actif dans le navigateur. Lorsque vous double-cliquez sur un dossier dans le navigateur, il s'affiche dans le champ Rechercher dans. Si vous sélectionnez Le Web dans cette liste, l'onglet Lien/Xref change d'état pour vous permettre d'insérer des références vers des documents Internet.
La liste contient un choix
Emplacements favoris
. Cette sélection déplace l'emplacement affiché dans le navigateur vers le noeud
Emplacements favoris contenant une liste des emplacements favoris que vous avez enregistrés.
La liste contient également une option
Historique
. Cette option permet de remplacer l'emplacement indiqué dans le navigateur par le noeud
Historique, qui contient une liste de tous les emplacements que vous avez visités au cours de la session courante.
• Bouton
Menu
: affiche un menu qui contient les options suivantes :
◦ Ouvrir (avec suffixe Document) : si vous avez sélectionné un document dans le navigateur, cette option ouvre ce document dans une nouvelle fenêtre.
Les documents XML, DITA, SGML et HTML sélectionnés s'affichent dans une nouvelle fenêtre Arbortext Editor. Les autres types de documents ou de graphiques s'ouvrent dans l'application qui leur est associée. Par exemple, un graphique s'affiche dans votre application graphique par défaut.
◦ Effacer l'historique : dans le navigateur, efface du noeud Historique la liste des emplacements visités.
Cette option n'est disponible que si le noeud Historique est sélectionné.
◦ Ajouter aux favoris : ajoute l'emplacement sélectionné à la liste Emplacements favoris.
Cette option n'est disponible que si un dossier de système de fichiers, un dossier de système de gestion de contenu (CMS) ou un emplacement similaire est sélectionné dans le navigateur.
◦ Supprimer des favoris : supprime l'emplacement sélectionné de la liste Emplacements favoris.
Cette option n'est disponible que si un élément de la liste Emplacements favoris est sélectionné.
◦ Déplacer vers le haut : déplace un élément de la liste Emplacements favoris d'un niveau vers le haut dans la liste.
Cette option n'est disponible que si un élément de la liste Emplacements favoris est sélectionné.
◦ Déplacer vers le bas : déplace un élément de la liste Emplacements favoris d'un niveau vers le bas dans la liste.
Cette option n'est disponible que si un élément de la liste Emplacements favoris est sélectionné.
◦ Exporter les favoris : ouvre la boîte de dialogue Enregistrer sous permettant de sauvegarder dans un fichier XML la liste de vos emplacements favoris.
Cette option n'est disponible que si le noeud Emplacements favoris est sélectionné dans le navigateur. Cette option permet de sauvegarder vos favoris dans un fichier XML qui peut ensuite être importé en tant que liste de favoris via l'option de menu Importer les favoris. Ce fichier XML ne doit pas être modifié, car il sert uniquement à sauvegarder une liste de favoris.
◦ Importer les favoris : ouvre la boîte de dialogue Ouvrir dans laquelle vous pouvez sélectionner un fichier XML contenant une liste de favoris Gestionnaire de ressources exportés.
Cette option n'est disponible que si le noeud Emplacements favoris est sélectionné dans le navigateur. Cette option vous permet d'importer une liste de favoris précédemment exportés via l'option de menu Exporter les favoris.
Après que vous avez sélectionné un fichier dans la boîte de dialogue Ouvrir et cliqué sur Ouvrir, une autre boîte de dialogue s'affiche vous proposant de fusionner avec la liste de favoris active ou de la remplacer. Cliquez sur Fusionner pour ajouter à votre liste de favoris les emplacements de la liste importée non inclus dans la liste actuelle. Cliquez sur Remplacer pour remplacer entièrement votre liste de favoris actuelle par la liste importée.
◦ Récupérer et modifier : ouvre l'objet CMS sélectionné dans Arbortext Editor pour le modifier.
Si l'objet n'est pas récupéré, le Gestionnaire de ressources le récupère (le verrouille) à votre place. Si l'objet comporte des objets enfants, vous avez la possibilité de les récupérer en même temps. Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC.
◦ Récupérer : récupère (verrouille) l'objet CMS déverrouillé actuellement sélectionné.
Si l'objet comporte des objets enfants, vous avez la possibilité de les récupérer en même temps. Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC.
◦ Annuler la récupération : annule la récupération d'un objet CMS, en ignorant les modifications apportées à l'objet depuis sa récupération.
Après l'annulation de la récupération d'un objet, l'objet de document est alors accessible en lecture seule s'il est ouvert dans Arbortext Editor. Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC.
◦ Propriétés : affiche la boîte de dialogue
Propriétés de l'objet qui contient les propriétés de l'objet sélectionné.
Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC.
◦ Rechercher CMS : affiche la boîte de dialogue
Rechercher.
Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC. La boîte de dialogue Rechercher vous permet de saisir une requête pour trouver tous les objets CMS répondant à certains critères. Les résultats de la recherche s'affichent dans la section Résultats de la recherche CMS du navigateur du Gestionnaire de ressources.
◦ Effacer les résultats de la recherche CMS : efface tout objet CMS ayant été ajouté à la section Résultats de la recherche CMS du navigateur du Gestionnaire de ressources.
Cette option de menu n'est disponible que pour les adaptateurs CMS pris en charge. Cette option ne supprime pas ces objets du CMS, seulement du navigateur Gestionnaire de ressources.
Cette option de menu n'est disponible dans l'onglet Lien/Xref que lorsque vous créez un lien vers un graphique intelligent. Si vous utilisez le menu dans la version de l'onglet Lien/Xref pour modifier un lien, cette option de menu est appelée Modifier le lien de surbrillance. Si vous utilisez ce menu dans la boîte de dialogue Ajouter un lien, cette option de menu est appelée Ajouter un lien de surbrillance.
Cette option de menu n'est disponible dans l'onglet Lien/Xref que lorsque vous créez un lien vers un graphique intelligent. Si vous utilisez le menu dans la version de l'onglet Lien/Xref pour modifier un lien, cette option de menu est appelée Modifier le lien d'animation. Si vous utilisez ce menu dans la boîte de dialogue Ajouter un lien, cette option de menu est appelée Ajouter un lien d'animation.
Cette option de menu n'est disponible dans l'onglet Lien/Xref que lorsque vous créez un lien vers un graphique intelligent. Si vous utilisez le menu dans la version de l'onglet Lien/Xref pour modifier un lien, cette option de menu est appelée Modifier le lien de vue. Si vous utilisez ce menu dans la boîte de dialogue Ajouter un lien, cette option de menu est appelée Ajouter un lien de vue.
◦ Synchroniser l'emplacement pour tous les onglets : détermine si le premier emplacement auquel vous accédez dans le navigateur du Gestionnaire de ressources est conservé lorsque vous ouvrez un autre onglet ou une autre boîte de dialogue du Gestionnaire de ressources.
La valeur de la préférence avancée ditasynctabs détermine si cette fonctionnalité est activée ou désactivée par défaut.
• Bouton
Dossier précédent : remplace l'emplacement indiqué dans le navigateur par le dernier dossier consulté dans ce navigateur.
Le Gestionnaire de ressources gère un historique des dossiers consultés dans la session en cours et ce bouton vous permet de parcourir l'historique dans la vue du navigateur. Si un seul dossier a été consulté dans la session, ce bouton est désactivé.
• Bouton
Monter d'un niveau
: remonte l'emplacement indiqué dans le navigateur d'un niveau dans la hiérarchie en cours.
Si vous vous trouvez sur le niveau supérieur de la hiérarchie, ce bouton est désactivé.
• Bouton
Actualiser
: met à jour l'affichage du navigateur pour tenir compte des modifications apportées aux objets affichés dans ce dernier.
• Bouton
Parcourir le Web
: change l'état de l'onglet
Lien/Xref pour vous permettre d'insérer des références à partir d'Internet.
• Bouton
Document courant
: ouvre le document courant dans l'affichage du navigateur.
• Bouton
Utiliser le navigateur d'objets CMS
: affiche le
Navigateur pour la
Connexion au serveur PTC ou un adaptateur de référentiel.
Ce bouton n'est disponible que lorsque vous êtes connecté à un système de gestion de contenu (CMS) par l'intermédiaire de la Connexion au serveur PTC ou d'un adaptateur de référentiel.
• Bouton
Rechercher CMS
: active la boîte de dialogue
Rechercher.
Ce bouton est uniquement disponible pour les objets Connexion au serveur PTC. La boîte de dialogue Rechercher vous permet de saisir une requête pour trouver tous les objets CMS répondant à certains critères. Les résultats de la recherche s'affichent dans la section Résultats de la recherche CMS du navigateur du Gestionnaire de ressources.
• Filtrer : permet de filtrer la liste des fichiers et des éléments de document affichés dans le navigateur.
Lorsque vous saisissez du texte dans cette option, la liste des fichiers et éléments de document affichés dans le navigateur est filtrée de manière à afficher uniquement les fichiers ou éléments dont les libellés contiennent le texte que vous avez saisi. Dans ce cas, l'option Filtrer et le navigateur adoptent la couleur d'arrière-plan jaune clair pour indiquer que le contenu du navigateur est actuellement filtré.
Par exemple, si vous saisissez "essai", seuls les objets avec des libellés contenant "Essai", "essais", "jeu d'essais", etc. s'affichent dans le navigateur. Si vous avez développé un document pour afficher les éléments qu'il contient, les éléments affichés sont également filtrés. Dans ce cas, le document reste affiché dans le navigateur même si son libellé ne contient pas le texte du filtre.
Le filtrage ne fait pas la distinction entre les majuscules et les minuscules. Les dossiers et objets similaires ne font pas l'objet d'un filtrage. Si vous saisissez plusieurs termes dans l'option Filtrer, les libellés correspondants doivent contenir l'ensemble des termes.
• Navigateur du Gestionnaire de ressources : offre un système de fichiers, un système de gestion du contenu (CMS) ou une hiérarchie de documents.
Le navigateur du Gestionnaire de ressources vous permet de localiser un contenu dans un système de fichiers ou dans un système CMS et de l'insérer dans un document. Le navigateur fournit une représentation hiérarchique des contenus du système de fichiers ou du CMS. Outre les dossiers et les fichiers, il vous permet également d'afficher le contenu des documents DITA. Lorsque vous activez l'onglet Lien/Xref, par exemple, le navigateur affiche les éléments d'un document DITA qui peuvent être utilisés comme lien ou référence croisée à partir du contexte en cours dans le document. Si un titre existe pour un élément, il s'affiche dans le navigateur en regard de l'élément. L'ID de l'élément est également affiché, selon le paramétrage de la préférence avancée ditahideids.
Si le document contient des graphiques intelligents, une icône spécifique
est associée à ces graphiques. Cette icône s'affiche en dessous du graphique dans le navigateur et indique le type de lien vers des graphiques intelligents que vous pouvez insérer pour ce graphique (par exemple,
Insérer un lien de surbrillance). Les graphiques intelligents vous permettent de créer des liens qui, une fois sélectionnés, modifient ces graphiques. Grâce aux graphiques intelligents, les liens peuvent ouvrir différentes vues d'un graphique, démarrer des animations ou mettre en surbrillance certaines parties du graphique. Si vous souhaitez créer ces types de lien pour un graphique intelligent, sélectionnez le graphique, puis double-cliquez sur les options
du navigateur, ou utilisez le bouton
Menu ou le menu de raccourcis du
Gestionnaire de ressources pour indiquer le type de lien à créer. Si vous souhaitez uniquement insérer un lien normal vers le graphique, cliquez simplement sur le bouton
Insérer.
Si vous parcourez le contenu d'un plan DITA contenant des définitions de clés, vous pouvez développer ce plan (les définitions de clés sont représentées par une icône de clé
). Si vous sélectionnez une définition de clé, le nom de la clé est inséré dans l'option
Keyref. Si vous insérez la référence avec la définition de clé sélectionnée, la valeur des attributs
href,
scope,
type et
format de la définition de clé est appliquée au lien ou à la référence croisée ajoutés. La valeur de l'attribut
navtitle est utilisée pour le texte du lien. Le paramètre de la préférence avancée
ditakeyrefui détermine si cette option est disponible dans le navigateur du
Gestionnaire de ressources.
Le navigateur inclut un noeud
Emplacements favoris qui contient la liste des emplacements favoris que vous avez enregistrés. Double-cliquez sur un favori pour afficher l'emplacement dans le navigateur. Lorsqu'un emplacement favori est indisponible, s'il a été supprimé ou s'il s'agit d'un dossier CMS et que vous n'êtes pas connecté au CMS par exemple, le dossier arbore l'icône
pour vous en informer.
Le navigateur comporte également un noeud
Historique, qui contient une liste de tous les emplacements que vous avez visités au cours de la session courante. Double-cliquez sur un emplacement pour l'afficher dans le navigateur.
Cliquez sur le signe plus ( + ) dans la hiérarchie pour ouvrir un niveau ou le contenu d'un document. Cliquez sur le signe moins (–) pour fermer un niveau ou un document. Cliquez sur un objet dans la hiérarchie pour le sélectionner. Double-cliquez sur un dossier pour le mettre en surbrillance dans le navigateur. Double-cliquez sur un élément du document pour insérer un lien ou une référence croisée à cet élément dans votre document.
Vous pouvez insérer une référence au contenu affiché dans le navigateur dans le document de plusieurs manières :
◦ en sélectionnant un élément, puis en cliquant sur le bouton Insérer ;
◦ en double-cliquant sur un élément ;
◦ par glisser-déplacer.
Si vous double-cliquez sur le noeud Le Web dans le navigateur, l'onglet Lien/Xref change d'état pour vous permettre d'insérer des références vers des documents Internet.
• Type : détermine le type de document affiché dans le navigateur du Gestionnaire de ressources.
Cette liste déroulante permet de filtrer les documents affichés dans le navigateur par type de document. Vous pouvez choisir les types de document suivants :
◦ Rubrique : afficher uniquement les documents DITA de type rubrique.
◦ Rubrique ou plan : afficher les documents DITA de type plan ou de type rubrique.
◦ Plan : afficher uniquement les documents DITA de type plan.
◦ Image : afficher uniquement les fichiers graphiques.
◦ PDF : afficher uniquement les documents PDF.
◦ HTML : afficher uniquement les documents HTML.
◦ N'importe lequel : afficher tous les types de documents.
• Afficher : détermine le type des éléments affichés pour les documents DITA dans le navigateur du Gestionnaire de ressources.
Cette liste déroulante permet de filtrer les éléments affichés pour les documents répertoriés dans le navigateur par type d'élément.
• Insérer : détermine le type d'élément à insérer dans le document.
Cette liste déroulante vous permet de sélectionner le type d'élément à insérer dans votre document. Pour les rubriques DITA non spécialisées, seuls les éléments xref ou link sont disponibles.
• Keyref : permet d'entrer, si besoin est, un nom de clé à insérer dans l'attribut keyref pour la référence.
Utilisez cette option lorsque vous souhaitez insérer une référence de clé dans la référence en cours d'ajout. Le paramètre de la préférence avancée ditakeyrefui détermine si cette option est disponible dans le Gestionnaire de ressources. Si des clés sont définies dans l'un des plans de définition de clés configurés dans l'une ou l'autre des préférences avancées ditakeycontext ou ditakeybaselist pour l'objet sélectionné dans le navigateur, ces clés apparaissent alors dans la liste déroulante par défaut.
• Bouton Insérer : insère un lien ou une référence croisée vers l'élément de document sélectionné dans le document en cours d'édition.
Si le contexte actif dans votre document n'est pas un point d'insertion valide, ce bouton est désactivé.
Options d'insertion de liens ou de références croisées vers des documents Internet
Pour insérer des liens ou des références croisées vers un document Internet, l'onglet Lien/Xref offre les options suivantes :
• Rechercher dans : détermine l'état de l'onglet Lien/Xref.
Cette option prend toujours la valeur Le Web lors de l'insertion d'un lien ou d'une référence croisée vers un document Internet. Si vous sélectionnez un autre emplacement dans la liste déroulante, l'état de l'onglet change pour vous permettre d'insérer des références vers des documents locaux.
Bouton
Menu : affiche un menu qui contient les options suivantes :
◦ Ouvrir (avec suffixe Document) : cette option est désactivée.
◦ Rechercher CMS : affiche la boîte de dialogue
Rechercher.
Cette option de menu n'est disponible que pour les objets Connexion au serveur PTC.
◦ Effacer les résultats de la recherche CMS : efface tout objet CMS ayant été ajouté à la section Résultats de la recherche CMS du navigateur du Gestionnaire de ressources.
◦ Synchroniser l'emplacement pour tous les onglets : détermine si le premier emplacement auquel vous accédez dans le navigateur du Gestionnaire de ressources est conservé lorsque vous ouvrez un autre onglet ou une autre boîte de dialogue du Gestionnaire de ressources.
La valeur de la préférence avancée ditasynctabs détermine si cette fonctionnalité est activée ou désactivée par défaut.
• Bouton
Dossier précédent : remplace l'emplacement indiqué dans le navigateur par le dernier dossier consulté dans ce navigateur.
Si le dernier emplacement affiché dans le navigateur n'est pas Le Web, l'état de l'onglet change pour vous permettre d'insérer des références vers des documents locaux.
• Bouton
Monter d'un niveau : ce bouton est désactivé.
• Bouton
Actualiser : ce bouton est désactivé.
• Bouton
Parcourir le Web : ce bouton est désactivé.
• Bouton
Document courant : ouvre le document courant dans l'affichage du navigateur.
L'état de l'onglet change pour vous permettre d'insérer des liens vers des documents locaux.
• Bouton
Utiliser le navigateur d'objets CMS : affiche le
Navigateur pour la
Connexion au serveur PTC ou un adaptateur de référentiel.
Ce bouton n'est disponible que lorsque vous êtes connecté à un système de gestion de contenu (CMS) par l'intermédiaire de la Connexion au serveur PTC ou d'un adaptateur de référentiel.
• Bouton
Rechercher CMS : active la boîte de dialogue
Rechercher.
Ce bouton est uniquement disponible pour les objets Connexion au serveur PTC. La boîte de dialogue Rechercher vous permet de saisir une requête pour trouver tous les objets CMS répondant à certains critères. Les résultats de la recherche s'affichent dans la section Résultats de la recherche CMS du navigateur du Gestionnaire de ressources.
• URL : affiche l'URL à insérer pour le lien ou la référence croisée.
Vous pouvez modifier ce champ pour ajouter l'URL souhaitée ou cliquer sur le bouton Obtenir URL de navigateur pour insérer dans l'option l'URL de la page Web affichée dans votre navigateur Web actif.
• Ouvrir le navigateur : ouvre votre navigateur Web par défaut.
Si une URL est renseignée dans l'option
URL, le navigateur Web s'ouvre en affichant la page Web correspondante. Notez que vous devez disposer d'un navigateur Web défini par défaut dans votre système d'exploitation ou dans les préférences
Emplacements des fichiers de la boîte de dialogue
Préférences pour utiliser cette option.
• Obtenir URL de navigateur : insère dans l'option URL l'URL de la page Web affichée dans votre navigateur Web actif.
Notez que vous devez disposer d'un navigateur Web défini par défaut dans votre système d'exploitation ou dans les préférences
Emplacements des fichiers de la boîte de dialogue
Préférences pour utiliser cette option.
• Insérer : détermine le type d'élément à insérer dans le document.
Cette liste déroulante vous permet de sélectionner le type d'élément à insérer dans votre document. Pour les rubriques DITA non spécialisées, seuls les éléments xref ou link sont disponibles.
• Keyref : permet d'entrer, si besoin est, un nom de clé à insérer dans l'attribut keyref pour la référence.
Utilisez cette option lorsque vous souhaitez insérer une référence de clé dans la référence en cours d'ajout. Le paramètre de la préférence avancée ditakeyrefui détermine si cette option est disponible dans le Gestionnaire de ressources. Si des clés sont définies dans l'un des plans de définition de clés configurés dans l'une ou l'autre des préférences avancées ditakeycontext ou ditakeybaselist pour l'URL affichée dans le navigateur, ces clés apparaissent alors dans la liste déroulante par défaut.
• Bouton Insérer : insère un lien ou une référence croisée vers l'URL désignée dans le document en cours d'édition.
Si le contexte actif dans votre document n'est pas un point d'insertion valide, ce bouton est désactivé.