25.5. %select-atts;

Les attributs qui gèrent à la fois le filtrage et le marquage sont les attributs props, platform, product, audience et otherprops. L'attribut base est un attribut générique pour la spécialisation ; il peut être spécialisé pour des valeurs qui ont une syntaxe simple comme les attributs de filtre mais n'est pas lui-même un attribut de filtrage ou de marquage. L'attribut rev permet seulement de marquer une information qui correspond à un paramètre d'exécution. L'attribut importance fournit une gamme de valeurs que les applications peuvent utiliser au besoin. L'entité %select-atts; contient également d'autres entités qui lui permettent d'inclure les spécialisations des attributs props et base. Cf. la spécification architecturale DITA pour plus d'informations sur le filtrage ou le marquage avec des attributs, ainsi que pour des informations sur la spécialisation des attributs base et props.

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
props L'attribut racine à partir duquel on peut spécialiser de nouveaux attributs de métadonnée. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. L'attribut prend un ensemble de valeurs délimitées par des espaces. Par contre, agissant comme conteneur pour des attributs généralisés, le modèle de contenu sera plus complexe ; ce modèle est décrit à la section Généralisation des attributs de la spécification architecturale DITA. CDATA #IMPLIED non
base Un attribut générique sans utilisation spécifique mais destiné à servir de base pour les attributs spécialisés qui ont une syntaxe de valeur simple comme les attributs de traitement conditionnel (une ou plusieurs valeurs alphanumériques séparées par des blancs). L'attribut prend un ensemble de valeurs délimitées par des espaces. Par contre, lorsqu'il sert de conteneur pour des attributs généralisés, le modèle de contenu sera plus complexe ; ce modèle est documenté à la section Généralisation des attributs de la spécification architecturale DITA. CDATA #IMPLIED non
platform Indique le système d'exploitation et le matériel. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage et du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
product Contient le nom du produit auquel le thème s'applique. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
audience Indique le public visé pour l'élément. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
otherprops Cet attribut est utilisable pour toutes les autres propriétés qui seraient nécessaires pour décrire un public ou pour fournir des critères de sélection pour l'élément. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
importance Un ensemble de valeurs qui décrit l'importance ou la priorité attribuées à un élément. Par exemple, dans les étapes d'une tâche, l'attribut indique si une étape est optionnelle ou obligatoire. obsolete | deprecated | optional | default | low | normal | high | recommended | required | urgent | -dita-use-conref-target #IMPLIED non
rev Indique le niveau de révision d'un élément. Il est utile pour marquer les sorties fondées sur une révision. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié 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. CDATA #IMPLIED non
status Le statut de l'élément courant. new | changed | deleted | unchanged | -dita-use-conref-target #IMPLIED non

Exemple :

L'entité de paramètre %select-atts; est utilisée dans les définitions DTD DITA comme définition commune des attributs disponibles pour la plupart des éléments qui préparent le contenu à une meilleure récupérabilité ou à une sélection. Voici un exemple typique :

The <keyword platform="Linux">chmod</keyword> command...
<ph product="WhiteknuckleHandsoap">Amalgamated Cleansers get the grime!</ph>
<msgph audience="programmer administrator">Divide by -1 error.</msgph>
<ph otherprops="java">When using Java, use the 
  <apiname>com.ibm.obscureclass</apiname> to calculate the value.</ph>
<p importance="recommended" rev="3.2">Update anti-virus software often.</p>

Notez que ces attributs, à part ceux avec des valeurs prédéfinies, admettent des valeurs multiples. Ainsi, l'attribut audience dans l'exemple indique que le message s'adresse à la fois aux programmeurs et aux administrateurs.

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

Section précédente 25.4. %rel-atts;

Section suivante 25.6. %localization-atts;

Retour au sommaire.

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