Adobe FrameMaker User Guide
Cliquer ici pour voir cette page dans le contexte complet
Familiarisez-vous avec les mappages DITA et apprenez à les utiliser dans FrameMaker.
Un mappage DITA permet d’organiser les rubriques DITA en une structure hiérarchique. Vous pouvez ensuite créer une sortie pour votre contenu organisé selon différents formats de sortie.
Pour plus d’informations sur la génération de sortie DITA, voir Publication DITA.
Vous pouvez également utiliser des mappages DITA pour créer des espaces de touche utilisables pour un référencement indirect.
Voir Utilisation des espaces de touche pour gérer des références de touche DITA.
Consultez les spécifications des mappages DITA.
Apprenez à créer un mappage DITA dans FrameMaker.
Sélectionnez .
Vous pouvez aussi sélectionner . Dans la boîte de dialogue Nouveau XML, allez sur l’onglet DITA, sélectionnez le mappage.
Par défaut, un mappage DITA est ouvert dans le Gestionnaire de ressources.
Le Gestionnaire de ressources vous permet d’effectuer les tâches suivantes :
Insérer des rubriques dans le mappage DITA ;
Enregistrez le mappage DITA
Basculer sur la vue Document pour afficher le contenu du mappage DITA.
Vous pouvez utiliser les outils FrameMaker disponibles, comme la Vue de la structure et le panneau Eléments, pour travailler avec un mappage DITA.
Vous pouvez également inclure des tables de relation avec un mappage DITA.
Pour plus de détails, reportez-vous à la section Tableaux de relations DITA.
Apprenez à insérer des éléments de référence de rubrique dans un mappage DITA.
Vous pouvez ajouter des rubriques à un mappage DITA à l’aide des éléments de référence de rubrique (topicref) du catalogue Eléments. <> Vous pouvez également ajouter des rubriques à l’aide de la fonction Insérer enfant dans le Gestionnaire de ressources.
FrameMaker prend en charge les éléments de référence de rubrique (<topicref>) suivants que vous pouvez insérer dans un mappage DITA :
Identifie des rubriques comme dita, topic (rubrique), concept, task (tâche), reference (référence), glossary entry (entrée du glossaire) et glossary group (groupe de glossaire). Un élément de référence de rubrique (topicref) peut également contenir d’autres éléments de référence de rubrique (topicref) pour créer une structure hiérarchique.
Consultez les spécifications des éléments topicref.
Un élément de commodité qui équivaut à un élément de <topicref> avec l’attribut de format défini sur « ditamap ».
Consultez les spécifications relatives aux éléments mapref.
Ensemble d’éléments de référence de rubrique (topicref) réutilisables dans des mappages DITA et autres éléments d’ensemble de rubrique (topicset).<>
Consultez les spécifications des éléments d’ensemble de rubrique.
Elément de commodité utilisé pour définir des touches sans avoir les autres effets se produisant lors de l’utilisation d’un élément de référence de rubrique (topicref) : aucun contenu n’est inclus dans une sortie, aucun titre n’est inclus dans la table des matières et aucune liaison ni aucune relation n’est définie.<>
Consultez les spécifications des éléments keydef.
Fait référence à un élément d’ensemble de rubrique (topicset).<>
Consultez les spécifications des éléments d’ensemble de rubrique.
Pour insérer un élément <topicref> dans un mappage DITA :
Dans la Vue de la structure, placez le point d’insertion au niveau racine de l’élément de mappage.
Sélectionnez .
Si vous sélectionnez topicref, mapref, topicset ou keydef, la boîte de dialogue Insérer un élément s’affiche :
Pour utiliser la référence de rubrique (topicref) insérée comme référence de touche, saisissez un nom de touche.
Pour plus de détails, reportez-vous à la section Utilisation des espaces de touche pour gérer des références de touche DITA.
Dans la zone HRef, saisissez l’emplacement de la rubrique à référencer. Ou cliquez sur Parcourir pour rechercher et sélectionner la rubrique. La rubrique est ajoutée en tant que référence directe.
Si vous avez défini un espace de touche pour la rubrique actuelle, vous pouvez aussi sélectionner une référence de touche dans la liste déroulante KeyRef. La rubrique est ajoutée en tant que référence indirecte.
Pour plus d’informations sur les références de touches et le référencement indirect, voir Utilisation des espaces de touche pour gérer des références de touche DITA.
Apprenez à afficher le contenu d’un mappage DITA et à afficher ou masquer la prévisualisation des éléments de référence de rubrique (topicref) à l’aide de FrameMaker.
Après avoir inséré une ou plusieurs références de rubrique (topicref) dans un mappage DITA, vous pouvez choisir d’afficher le contenu des rubriques référencées dans la vue Document.
Vous pouvez également ouvrir les rubriques DITA référencées en tant que documents séparés dans FrameMaker.
Pour prévisualiser le contenu sur un élément de référence unique, dans la Vue de la Structure, sélectionnez l’élément de référence de rubrique (topicref).
Pour prévisualiser le contenu de tous les éléments de référence, cliquez n’importe où dans la rubrique en vous assurant qu’aucun élément n’est sélectionné. Vous êtes invité à afficher le contenu de toutes les références de rubrique. En outre, vous pouvez choisir d’afficher les cartes référencées enfants.
Pour prévisualiser le contenu, sélectionnez .
Pour masquer la prévisualisation, sélectionnez .
Si une carte DITA contient des références aux cartes enfant, les options d’affichage et de masquage de la carte DITA permettent d’afficher ou de masquer les rubriques référencées dans les cartes enfants.
Dans la vue Document, FrameMaker affiche > pour indiquer qu’une rubrique est une rubrique de niveau supérieur dans le mappage DITA. >>indique qu’une rubrique est une rubrique de deuxième niveau et >>> indique qu’une rubrique est de niveau 3 et (et plus) dans le mappage DITA.
Si un mappage DITA contient des références à une ou plusieurs rubriques, vous pouvez ouvrir toutes les rubriques référencées dans FrameMaker.
Vérifiez que le mappage DITA est sélectionné.
Appuyez sur la touche Maj, puis sélectionnez .
Dans le mappage DITA, sélectionnez .
Pour fermer toutes les références de rubrique, appuyez sur la touche Maj et sélectionnez .
Apprenez à enregistrer un mappage DITA dans FrameMaker.
La fonctionnalité Enregistrer Ditamap sous de FrameMaker () vous permet d’enregistrer le mappage DITA dans plusieurs sorties. Lorsque vous enregistrez un mappage DITA en tant que livre, vous pouvez profiter des caractéristiques hiérarchiques du livre FrameMaker comme les dossiers et les groupes. Vous pouvez utiliser les fonctionnalités du livre de FrameMaker comme le numéro de page et la table des matières.
La liste des sorties suivantes fournit une fonctionnalité spécifique :
Fichier de document FrameMaker autonome unique (.fm). Le document contient tout le contenu du mappage DITA. Par exemple, les références de rubrique. Les références de rubrique sont incorporées dans le document. Cela implique que toute modification apportée aux fichiers de rubrique n’est pas répercutée dans le document composite. Si vous partagez ce document avec un autre auteur, l’auteur ne requiert pas les documents de rubrique référencés. Cependant, vous pouvez continuer à travailler sur le document composite à l’aide des outils de structure disponibles dans FrameMaker.
Le mappage DITA est enregistré comme fichier .book, qui inclut chaque fichier de rubrique référencrée comme un document au sein du livre.
Le mappage DITA est enregistré comme une fichier .book. Chaque fichier de rubrique référencée est converti en fichier .fm.
Lorsque vous enregistrez un mappage DITA comme document composite ou comme livre avec des composants FrameMaker, vous pouvez utiliser la fonctionnalité de sortie conditionnelle DITAVAL. Dans la boîte de dialogue Enregistrer le document, si vous sélectionnez l’option Demander le fichier DitaVal, l’utilisation d’un fichier DITAVAL est proposée pour générer de manière conditionnelle le contenu au format de sortie sélectionné. Pour plus d’informations sur DITAVAL, voir DITAVAL.
Familiarisez-vous avec le référencement DITA dans FrameMaker et apprenez à configurer du contenu de référence et à mettre à jour les références DITA.
Un référencement DITA (également appelé adressage DITA) permet de référencer ou de créer des liens parmi des éléments DITA et entre des éléments DITA et des ressources non DITA.
Référencez le contenu DITA par Références contextuelles DITA. Vous pouvez créer des liens vers des ressources DITA ou non DITA, en utilisant des références croisées DITA à un contenu source unique. Vous pouvez également utiliser des liens DITA pour Ajouter des liens au contenu associé.
Les spécifications DITA définissent deux types de référencement :
Les références sont établies par pointage direct sur la cible. Par exemple, dans FrameMaker, lorsque vous créez une référence contextuelle (conref) par le biais d’un référencement direct, vous recherchez et sélectionnez la rubrique DITA (fichier .xml). De même, vous pointez directement sur la rubrique DITA (fichier .xml) pour créer un lien DITA ou une référence croisée DITA. Un référencement direct requiert des auteurs de sélectionner explicitement le fichier contenant le contenu à référencer ou lier. Cela peut s’avérer laborieux et déroutant si le nombre de contenus associés est important. Un référencement direct est préférable avec un nombre de documents en référence ou en lien peu important.
Consultez les spécifications de l’adressage URI (direct).
Les références sont établies globalement au niveau du mappage DITA par le biais de touches. Par exemple, dans FrameMaker, lorsque vous créez une référence contextuelle (conref) avec un référencement indirect, vous ne pointez pas directement sur la rubrique DITA. Au lieu de cela, vous pointez sur une touche qui est définie en Utilisation des espaces de touche pour gérer des références de touche DITA. Le référencement indirect requiert des auteurs de sélectionner des touches définies par l’utilisateur lors de la création de références ou de liens. Lors de la configuration des espaces de touche, il convient d’utiliser une nomenclature clairement définie pour nommer les touches. Un référencement indirect est recommandé si vous écrivez dans un ensemble important de contenus associés.
Consultez les spécifications de l’adressage via des touches.
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. Pour plus de détails, reportez-vous à la section Utilisation des espaces de touche pour gérer des références de touche DITA.
Pour rendre un élément réutilisable, vous devez affecter un ID unique à l’élément. Pour plus de détails, reportez-vous à la section Attribut ID DITA. FrameMaker utilise cet ID unique pour différencier les éléments de référence contextuelle (conref). Par exemple, si vous mettez à jour l’élément source, FrameMaker utilise l’ID unique pour identifier les éléments dans des rubriques de conteneur qui doivent être mises à jour.
L’attribut ID DITA fournit une méthode permettant d’identifier de façon unique le contenu (rubriques ou éléments) à référencer.
Dans une rubrique DITA, vous pouvez affecter un ID unique à un élément afin d’utiliser l’élément lorsque vous créez des références contextuelles (Références contextuelles DITA) ou des références croisées (Références croisées) à l’élément d’une autre rubrique. Par défaut, FrameMaker affecte un ID unique à la rubrique lors de la procédure suivante : Création d’une rubrique DITA.
Consultez les spécifications des attributs d’ID.
Dans la Vue de la structure, sélectionnez un élément de la rubrique de source.
Sélectionnez .
Sinon, cliquez avec le bouton droit sur l’élément et choisissez Assigner un ID à l’élément dans le menu déroulant.
Pour vérifier si un ID est affecté à un élément, dans la vue de la structure, cliquez sur le signe flèche situé à droite de l’élément.
Si vous affectez un ID unique à un élément auquel un ID a été affecté précédemment, vous êtes invité à remplacer l’ID existant
Sélectionnez une instance de l’élément auquel vous souhaitez attribuer un ID.
Sélectionnez pour ouvrir la boîte de dialogue Assigner un ID.
Par défaut, l’élément sélectionné avant de sélectionner Attribuer un ID aux éléments est sélectionné dans la liste déroulante.
Sélectionnez l’option Inclure des spécialisations pour attribuer des ID à des spécialisations de l’élément sélectionné. Si vous êtes dans un mappage DITA, sélectionnez Traiter les références de rubrique dans Ditamap pour attribuer des ID à toutes les occurrences de l’élément sélectionné dans les rubriques contenues dans le mappage DITA.
Si vous avez plusieurs fichiers ouverts, sélectionnez Tous les fichiers ouverts pour attribuer des ID à toutes les occurrences de l’élément sélectionné dans tous les fichiers ouverts.
Cliquez sur Assigner.
Dans une rubrique DITA, vous pouvez référencer directement un contenu en spécifiant le fichier de rubrique DITA (.xml). Par exemple, pour ajouter des liens dans la section des liens associés d’une rubrique DITA, vous pouvez sélectionner les fichiers de rubrique à référencer (voir Ajouter des liens au contenu associé).
Toutefois, DITA fournit également les spécifications d’utilisation des touches permettant de référencer indirectement un contenu. Consultez les spécifications de l’adressage via des touches.
A l’aide des touches, ajoute un degré d’adressage indirect au contenu référencé. En utilisant des touches, l’auteur ne fait pas référence aux fichiers de rubrique directement. Il dispose d’un espace de touche, une collection de touches définies par l’utilisateur, à référencer. L’espace de touche référence en interne un certain nombre de rubriques. L’auteur n’est alors concerné que par les touches fournies dans l’espace de touche. En outre, puisque les touches sont définies par l’utilisateur, elles peuvent être nommées de manière appropriée pour permettre à l’auteur de les identifier facilement.
Les http://docs.oasis-open.org/dita/v1.2/os/spec/langref/keydef.htmléléments keydef permettent de créer des keymaps puisque, par défaut, ces éléments ne sont pas générés dans une sortie DITA.
Un espace de touche est créé via un mappage. Pour créer un mappage DITA à utiliser comme espace de touche, vous devez ajouter des éléments de définition de touche (keydef) au mappage DITA.
Ajoutez des éléments keydef au mappage DITA. <> Pour plus de détails, reportez-vous à la section Insertion d’un élément de référence de rubrique dans un mappage DITA.
L’attribut de touches permet d’identifier une définition de touche (keydef) spécifique dans un espace de touche. Puisque l’attribut @touches est obligatoire pour un élément de définition de touche (<keydef>), vous pouvez spécifier la valeur d’attribut dans la boîte de dialogue Attributs pour nouveaux éléments ou dans le champ Nom de touche de la boîte de dialogue Insérer un élément.
Avec l’espace de touche, au lieu de se référer directement aux rubriques DITA associées, un auteur se référera uniquement aux noms des touches. C’est pourquoi vous devez spécifier des valeurs de touches qui indiquent clairement le contenu de la rubrique (sous-jacente) référencée.
Enregistrer le mappage DITA
Pour utiliser une référence de touche dans votre rubrique DITA, vous devez charger les espaces de touche du conteneur dans l’environnement de création FrameMaker.
Ouvrez la boîte de dialogue Gestionnaire d’espace de touche DITA ().
Dans la liste déroulante Espace de touche, sélectionnez un mappage DITA qui est défini comme espace de touche. Pour plus de détails, reportez-vous à la section Création d’un espace de touche.
Par défaut, la première touche dans la liste est toujours sélectionnée. Les mappages DITA ouverts dans la session en cours sont affichés dans la liste déroulante Espace de touche. Vous pouvez rechercher un espace de touche en saisissant les premiers caractères de la touche.
Si le mappage DITA requis n’est pas disponible dans la liste, cliquez sur Charger l’espace de touche, puis sélectionnez le fichier du mappage DITA. Les références de touches définies dans l’espace de touche s’affichent dans la liste Touches définies.
Si vous apportez des modifications à l’espace de touche (mappage DITA) après le chargement de l’espace de touche dans l’environnement actuel, cliquez sur l’icône Actualiser pour afficher les modifications apportées aux références de touches.
Cliquez sur OK pour appliquer l’espace de touche sélectionné à tous les mappages DITA ouverts.
Pour choisir un autre espace de touche pour un document particulier, utilisez le gestionnaire d’espace de touche défini. Vous pouvez définir un espace de touche à partir de plusieurs chemins, tels que des références croisées DITA, des liens DITA et des références contextuelles d’insertion.
Vous pouvez créer des références dans des rubriques ou des mappages DITA, en suivant l’une des méthodes ci-dessous :
Références contextuelles (voir Références contextuelles DITA)
Références croisées (voir Références croisées)
Références de rubrique (voir Insertion d’un élément de référence de rubrique dans un mappage DITA)
Si vous mettez à jour le contenu référencé, les références de la rubrique actuelle ne sont pas immédiatement mises à jour. Par exemple, si un mappage DITA référence une rubrique spécifique et que le titre de la rubrique est modifiée, le titre mis à jour n’apparaît pas immédiatement dans le mappage DITA.
Pour mettre à jour les références dans une rubrique ou un mappage sélectionné, utilisez la boîte de dialogue Références de mise à jour DITA :
Sélectionnez .
La boîte de dialogue Références de mise à jour DITA apparaît:
Pour mettre à jour les références de la rubrique actuelle ou du mappage actuel, vérifiez les options spécifiques, puis cliquez sur OK.
Vous pouvez effectuer une recherche dans un document ou de manière récursive sur plusieurs fichiers d’un dossier pour trouver des liens tels qu’une référence contextuelle, une référence de rubrique, un lien ou une référence croisée. Par défaut, la boîte de dialogue Trouver des références renseigne l’ID de la rubrique en cours et de l’élément, si un élément est sélectionné. En règle générale, vous sélectionnez l’élément référencé ailleurs, puis appelez cette option.
Sélectionnez . Ou, pour trouver la référence de l’élément en cours, cliquez avec le bouton droit de la souris au sein de l’élément, puis sélectionnez Trouver des références. L’ID de l’élément est renseigné automatiquement.
Dans la boîte de dialogue Trouver des références, entrez l’ID de l’élément si nécessaire.
Si vous le souhaitez, pour limiter la recherche à un espace de touche, sélectionnez l’espace de touche du document en cours.
Définissez l’étendue de la recherche. Si vous sélectionnez un dossier, vous pouvez lancer la recherche de manière récursive pour trouver les références de l’élément dans tous les fichiers contenus dans le dossier.
Cliquez sur Rechercher.