Aide > Présentation de l'environnement de création DITA > Interface utilisateur de la prise en charge DITA > Gestionnaire de ressources > Onglet Référence de contenu
  
Onglet Référence de contenu
L'onglet Référence de contenu vous permet d'insérer des références de contenu dans les rubriques et plans DITA. Si vous sélectionnez Insérer > Référence de contenu et que le Gestionnaire de ressources n'est pas ouvert, le Gestionnaire de ressources s'ouvre et l'onglet Référence de contenu s'active. Dans le cas d'un plan DITA, l'onglet Référence de contenu s'affiche dans une boîte de dialogue Gestionnaire de ressources distincte non ancrée.
Si aucun ID n'est associé à l'élément que vous insérez en tant que référence de contenu, un ID est généré pour l'élément (si vous bénéficiez d'un accès en écriture au fichier source). Si le document ne contient aucun élément de référence correct, le Gestionnaire de ressources y insère automatiquement un nouvel élément vide et le définit comme la cible de la référence de contenu. Cet onglet est disponible dans le Gestionnaire de ressources lors de la modification d'une rubrique, d'un plan ou d'une spécialisation de rubrique ou de plan.
L'onglet Référence de contenu comprend 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.
La liste contient un choix Emplacements favoris. En sélectionnant cette option, vous déplacez l'emplacement affiché dans le navigateur vers le noeud Emplacements favoris où se trouve 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 le noeud 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é au noeud 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.
Synchroniser l'emplacement pour tous les onglets : détermine si l'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 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 Référence de contenu, par exemple, le navigateur affiche les éléments d'un document DITA qui peuvent être utilisés comme référence de contenu à partir du contexte du document. Le type de l'élément, un bref extrait de son contenu et son ID (selon le paramètre défini pour la préférence avancée ditahideids) s'affichent également dans le navigateur.
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é ). Le navigateur présente uniquement les définitions de clés possédant la même valeur dans l'attribut format que le document actuel. Il est possible de développer la définition de clé de façon à afficher les balises du document référencé par la clé. Si vous sélectionnez une balise dans la définition de clé, le nom de la clé est inséré dans l'option Conkeyref. Si vous ajoutez la référence avec une balise dans la définition de clé sélectionnée, les valeurs des attributs conref et keyconref sont appliquées à la référence de contenu insérée. 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 une référence de contenu à 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.
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 :
Plan : afficher uniquement les documents DITA de type plan.
Plan ou rubrique : afficher les documents DITA de type plan ou de type rubrique.
Rubrique : afficher uniquement les documents DITA de type rubrique.
N'importe lequel : afficher tous les types de documents.
Afficher : détermine le type des éléments affichés pour les documents 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.
Conkeyref : permet d'entrer, si besoin est, une référence de clé à insérer dans l'attribut conkeyref pour la référence.
Utilisez cette option lorsque vous souhaitez insérer une référence de clé de contenu 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.
Insérer : insère une référence à 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é.