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

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

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

Section parente 25. Attributs couramment référencés

Section précédente 25.7. %univ-atts;

Section suivante 25.9. Autres attributs DITA communs

Retour au sommaire.