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.

Le conteneur d'une carte est l'élément <map>, qui admet les attributs title et id. Dans la carte, utilisez l'élément <topicref> pour ajouter et organiser les références aux thèmes, et les éléments <topicgroup> et <reltable> pour fournir des relations non hiérarchiques. On peut utiliser l'élément <map> pour fixer les valeurs par défaut de tous les éléments <topicref> dans la carte.

En option, l'élément <title> peut être utilisé pour fournir un titre à la carte. L'élément <title> est admis à compter de DITA 1.1, et est préféré à l'attribut title. Dans certains cas, le titre est purement informationnel et sa présence est une aide pour l'auteur. Dans d'autres, il peut être utile voire obligatoire. Par exemple, si une carte est convertie en une aide Eclipse, le système Eclipse imposera un titre pour la table des matières produite. Dans la spécialisation de carte bookmap, l'élément <title> fournit un titre au livre représenté par cette carte.

Exemple

Dans cet exemple, il y a six éléments <topicref>. Ils sont imbriqués et ont une relation hiérarchique. Le fichier bats.dita est le thème parent et les autres thèmes sont ses sous-thèmes. Cette hiérarchie pourrait être utilisée pour générer un fichier PDF, un panneau de navigation dans un référentiel, un sommaire des thèmes ou des liens apparentés entre le thème parent et ses enfants.

<map id="mybats">
 <title>Bats</title>
 <topicref href="bats.dita" type="topic">
  <topicref href="batcaring.dita" type="task"></topicref>
  <topicref href="batfeeding.dita" type="task"></topicref>
  <topicref href="batsonar.dita" type="concept"></topicref>
  <topicref href="batguano.dita" type="reference"></topicref>
  <topicref href="bathistory.dita" type="reference"></topicref>
 </topicref>
</map>

Contient :

Doctype Modèle de contenu
map ( ( title) (optionnel) puis ( topicmeta) (optionnel) puis ( navref ou anchor ou topicref or topichead ou topicgroup or reltable ou data ou data-about) (un nombre quelconque) )
bookmap ( ( title) (optionnel) puis ( topicmeta) (optionnel) puis ( navref ou anchor ou topicref ou topichead ou topicgroup ou reltable ou data ou data-about) (un nombre quelconque) )

Contenu par :

Doctype Parents
   

Héritage :

- map/map

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
title Un titre d'identification pour la carte. Peut être utilisé ou ignoré, en fonction des capacités du mécanisme d'affichage. Notez qu'en DITA 1.1, la carte peut inclure un élément <title>, qui est préféré à l'attribut title. CDATA #IMPLIED non
id Cet attribut peut être utilisé pour les besoins du débogage, par exemple pour identifier la carte depuis laquelle le lien a été généré. ID #IMPLIED non
conref Cet attribut sert à référencer un identificateur sur une carte réutilisable. Cf. la section 25.10.1. L'attribut conref pour des exemples et des détails à propos de la syntaxe. CDATA #IMPLIED non
anchorref Identifie un emplacement dans un autre fichier de carte où cette carte sera ancrée (ajoutée à l'exécution, en utilisant l'intégration de navigation Eclipse). Par exemple, l'attribut anchorref="map1.ditamap/a1" entraîne l'insertion de cette carte à l'emplacement du point d'ancrage « a1 » dans l'autre carte map1.ditamap. CDATA #IMPLIED non
xmlns:ditaarch Déclare l'espace de noms DITA par défaut. CDATA #FIXED "http://dita.oasis-open.org/architecture/2005/"  
DITAArchVersion Désigne la version de l'architecture en vigueur. CDATA "1.1" (dépend de la version ; ira en augmentant) non
domains Indique les domaines spécialisés inclus dans la définition DTD ou le schéma. CDATA (map mapgroup-d) (topic indexing-d) non
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk) Un ensemble d'attributs liés. Cf. la section 25.8. %topicref-atts; et %topicref-atts-no-toc;. entité paramètre sans objet pour une entité paramètre sans objet
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) Un ensemble d'attributs liés, décrit à la section 25.5. %select-atts; entité paramètre sans objet pour une entité paramètre sans objet
%localization-atts; (translate, xml:lang, dir) Un ensemble d'attributs liés, décrit à la section 25.6. %localization-atts;. entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs