19. Éléments de carte

Une carte décrit les relations dans un ensemble de thèmes DITA. Voici quelques exemples de relations que l'on peut décrire dans une carte :

• Hiérarchique (parent/enfant). Les thèmes imbriqués créent une relation hiérarchique. Le thème qui réalise l'imbrication est le parent, et les thèmes qui sont imbriqués sont les enfants ;
• Ordonnée. Les sous-thèmes (child topics) peuvent être étiquetés comme ayant une relation d'ordre, ce qui signifie qu'ils sont référencés dans une séquence définie ;
• Familiale. Les sous-thèmes peuvent être étiquetés comme ayant une relation de famille, ce qui signifie qu'ils se réfèrent tous aux autres.

Les relations définies dans une carte peuvent servir à créer une table des matières (TOC), à agréger des thèmes en un document PDF ou à créer des liens entre les thèmes en sortie.

1. 19.1. map
   L'élément <map> sert à définir une carte qui décrit les relations dans un ensemble de ressources, telles que des thèmes DITA. Les cartes se composent de références vers des thèmes et d'autres ressources organisées en hiérarchies, groupes et tables. Les cartes fournissent un moyen d'exprimer ces relations dans un seul format commun utilisable pour des sorties différentes.
2. 19.2. anchor
   L'élément <anchor> est utilisé pour l'intégration de la navigation à l'exécution. Il fournit un point d'intégration vers lequel une autre carte peut pointer afin d'insérer sa navigation dans l'arbre de navigation courant. Ceux qui sont familiarisés avec les systèmes d'aide Eclipse y reconnaîtront la même utilisation que l'élément <anchor> dans ce système. La gestion de cet élément n'est pas assurée pour tous les formats de sortie.
3. 19.3. navref
   L'élément <navref> représente un pointeur vers une autre carte qui devrait être conservé comme lien transcluant plutôt que résolu. Les formats de sortie qui gèrent une telle liaison intègreront la cible lors de l'affichage de la carte appelante pour l'utilisateur final.
4. 19.4. reltable
   La table de relation (<reltable>) définit les relations entre les thèmes, d'après le modèle de table familier de rangées (<relrow>), colonnes (<relheader>) et cellules (<relcell>). Les éléments <relcell> peuvent contenir des éléments <topicref>, lesquels sont ensuite liés aux autres éléments <topicref> dans la même rangée (mais pas forcément dans la même cellule). Par défaut, le contenu d'un élément <reltable> n'a pas de sortie pour une navigation ou une table des matières (TOC), et ne sert qu'à définir les relations exprimables comme des liens de thème-à-thème.
5. 19.5. relrow
   Un élément <relrow> est une rangée dans la table de relation. Cela crée une relation entre les cellules de la rangée, qui s'exprimera par des liens entre les éléments <topicref> dans les cellules.
6. 19.6. relcell
   Un élément <relcell> est une cellule dans la table de relation. Les éléments <topicref> qu'il contient seront liés aux éléments <topicref> dans les autres cellules de la même rangée. Par défaut, les éléments <topicref> dans la même cellule ne sont pas liés les uns aux autres, à moins de changer l'attribut collection-type de l'élément <relcell> pour indiquer qu'ils le sont.
7. 19.7. relheader
   L'élément <relheader> est une rangée de définitions de colonne (éléments <relcolspec>) dans une table de relation. Chaque table ne peut avoir qu'un seul ensemble de définitions de colonne.
8. 19.8. relcolspec
   Une définition de colonne dans la table de relation. On peut utiliser des définitions de colonne <relcolspec> pour établir les valeurs par défaut des attributs des éléments <topicref> dans la colonne. Par exemple, on peut déclarer type="concept" pour traiter tous les éléments <topicref> non typés dans la colonne comme des concepts.
9. 19.9. topicmeta
   L'élément <topicmeta> définit les métadonnées qui s'appliquent à un thème lorsqu'il apparaît dans une carte, et aux autres thèmes de la carte contenus par le même élément qui le contient. Lors de la création de liens, on peut aussi l'utiliser pour modifier le titre et la description courte du thème. En outre, on peut s'en servir pour ajouter des entrées d'index à un contenu référencé avec l'élément <keywords>.
10. 19.10. topicref
    L'élément <topicref> identifie un thème (tel qu'un concept, une tâche ou une référence) ou une autre ressource. Un élément <topicref> peut contenir d'autres éléments <topicref>, ce qui permet d'exprimer des hiérarchies de navigation ou de table des matières, ainsi que d'impliquer des relations entre l'élément <topicref> et ses sous-éléments. On peut fixer la valeur de l'attribut collection-type du <topicref> conteneur pour déterminer comment ses sous-éléments sont liés les uns aux autres. On peut aussi exprimer des relations entre les éléments <topicref> en utilisant des structures de groupe et de table (avec les éléments <topicgroup> et <reltable>). Les relations s'expriment comme des liens en sortie (chaque membre de la relation ayant par défaut des liens vers les autres membres).

OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.