25.8. %topicref-atts; et %topicref-atts-no-toc;

L'entité de paramètre %topicref-atts; représente un groupe d'attributs utilisés dans nombre d'éléments de carte, tels que <map>, <topicref>, <relcolspec>, <relcell>, <topichead> et <topicgroup>. Le jeu est identique à celui de l'entité %topicref-atts-no-toc; sauf que %topicref-atts; ne fournit pas de valeur par défaut pour l'attribut toc.

Attributs :

Le tableau ci-dessous représente le jeu d'attributs %topicref-atts;. Pour les éléments qui utilise le jeu %topicref-atts-no-toc;, tels que <reltable>, la valeur par défaut de l'attribut toc est "no".

Nom Description Type de donnée Valeur par défaut Obligatoire ?
collection-type Les types de collection décrivent comment les liens sont liés les uns aux autres. Une collection de type "family" représente un regroupement étroit dans lequel chacun des thèmes référencés non seulement est lié au thème courant mais aussi aux autres. La valeur "sequence" indique que l'ordre des sous-thèmes importe ; les processeurs de sortie établiront typiquement des liens entre eux dans l'ordre. La valeur "unordered" indique que l'ordre n'importe pas. La valeur "choice" indique que l'un des sous-thèmes devrait être sélectionné. Si aucune valeur n'est spécifiée, les processeurs devrait adopter par défaut la valeur "unordered", quoique la DTD ne définisse aucune valeur par défaut. Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur l'attribut conref.

L'utilisation de l'attribut collection-type sur les éléments <reltable> et <relcolspec> n'est pas définie pour l'instant, et réservée à plus tard.

(unordered | sequence | choice | family | -dita-use-conref-target) #IMPLIED non
type Décrit la cible d'une référence croisée. Cf. la section 25.10.2. L'attribut type pour des informations détaillées sur les valeurs gérées et les implications de traitement. CDATA #IMPLIED (traité comme si la cible était de type "topic", ou hérité d'un ancêtre) non
scope L'attribut scope identife l'étroitesse de la relation entre le document courant et la ressource cible.
  • Mettez scope="local" si la ressource fait partie de l'ensemble de contenu courant ;
  • Mettez scope="peer" si la ressource fait partie de l'ensemble de contenu courant mais n'est pas accessible lors de la construction ;
  • Mettez scope="external" si la ressource ne fait pas partie de l'ensemble d'information courant et devrait s'ouvrir dans une nouvelle fenêtre de navigateur ;
  • Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur la valeur "-dita-use-conref-target".
La valeur de traitement par défaut est "local". Si aucune valeur n'est spécifiée, mais que l'attribut est défini sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche.
(local | peer | external | -dita-use-conref-target) #IMPLIED non
locktitle Cet attribut, si présent, assure l'utilisation l'attribut navtitle ; si locktitle n'a pas la valeur "yes", l'attribut navtitle est ignoré et le texte est récupéré de la cible.
yes
L'attribut navtitle dans la carte est utilisé.
no
Défaut. L'élément <navtitle> ou <title> du thème est utilisé.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(yes | no | -dita-use-conref-target) #IMPLIED non
format L'attribut format identifie le format de la ressource référencée. Cf. la section 25.10.3. L'attribut format pour des détails sur les valeurs gérées. CDATA #IMPLIED non
linking Définit les caractéristiques de liaison spécifiques de l'emplacement courant d'un thème. Si la valeur n'est pas spécifiée localement, mais sur un ancêtre, la valeur sera héritée d'un ancêtre.
targetonly
Le thème peut seulement être lié (be linked to) mais ne peut pas se lier (link to) à d'autres thèmes.
sourceonly
Le thème ne peut pas être lié mais peut se lier à d'autres thèmes.
normal
Le thème peut être lié et peut se lier à d'autres thèmes. Utilisez cette valeur pour neutraliser la valeur de l'attribut linking d'un thème parent.
none
Le thème ne peut pas être lié et ne peut pas se lier à d'autres thèmes.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(targetonly | sourceonly | normal | none | -dita-use-conref-target) #IMPLIED non
toc Spécifie si un thème apparaît dans la table des matières (<toc>). Si la valeur n'est pas spécifiée localement, mais sur un ancêtre, l'attribut héritera de la valeur sur l'ancêtre. (yes | no | -dita-use-conref-target) #IMPLIED non
print Spécifie si le thème devrait être inclus dans un fichier de format de document portable (PDF). Si la valeur n'est pas spécifiée localement mais sur un ancêtre, l'attribut héritera de la valeur sur l'ancêtre.
yes
Inclut le thème dans un fichier PDF.
no
N'inclut pas le thème dans un fichier PDF.
printonly
Dirige le traitement afin de passer (skip) le thème parent pour les sorties non imprimables de la carte.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(yes | no | printonly | -dita-use-conref-target) #IMPLIED non
search Décrit si la cible est disponible pour une recherche. Si la valeur n'est pas spécifiée localement mais sur un ancêtre, l'attribut héritera de la valeur sur l'ancêtre.
yes
no
-dita-use-conref-target
(yes | no | -dita-use-conref-target) #IMPLIED non
chunk Lors de la transformation d'un ensemble de thèmes en utilisant une carte, l'attribut chunk permet de découper les documents à plusieurs thèmes en fichiers plus petits, et de combiner plusieurs thèmes individuels en documents plus grands.

Pour une description détaillée de l'attribut chunk et de son utilisation, cf. la section 4.5. Composition de la spécification architecturale DITA 1.1.

CDATA #IMPLIED non