Actions de filtrage inclure et exclure

Dans les outils de publication classiques, les actions de filtrage et de marquage à appliquer lors de la publication sont définies dans un fichier ditaval.

Le fichier de valeurs DITA (ditaval) permet d'indiquer quelles sont les conditions de publication à appliquer lors du traitement du document source DITA vers un format de lecture. Les actions des conditions sont spécifiées dans un fichier ditaval, plus précisément dans l'attribut action de l'élément prop. Les actions valides sont les suivantes :

exclude: exclut du document de sortie tout élément possédant des attributs de metadonnées spécifiques
flag: met en relief, avec une couleur de police, une couleur d'arrière plan ou une image, tout élément possédant des attributs de metadonnées spécifiques
passthough: ignore l'attribut mais ne le supprime pas du document de sortie
include: inclut dans le document de sortie tout élément possédant des attributs de metadonnées spécifiques

L'exemple ci-dessous est un extrait de code ditaval qui permet de mettre en relief les éléments possédant un attribut produit dont la valeur est impress avec une petite image au début de l'élément :

<prop att="product" val="impress" action="flag">
  <startflag imageref="delta_olive.gif">
    <alt-text>Début de produit - Impression</alt-text>
  </startflag>
</prop>

Bien qu'il y ait une action inclure dans la logique ditaval, cette action n'a pas d'objet. Par défaut, tout le contenu est inclus. Même dans un ensemble d'éléments imbriqués, un élément de niveau supérieur marqué comme étant à inclure n'aura aucun effet même si des éléments de niveau inférieur sont marqués comme étant à exclure. Par défaut, aucun contenu n'est marqué.

Les attributs sont généralement utilisés pour marquer les éléments qui sont spécifiques ou exculifs à un produit, une plateforme, un public ou à d'autres impératifs. Il est conseillé de baliser ces éléments uniquement si vous souhaitez les marquer ou les exclure.

Si vous utilisez des conditions multiples (c'est-à-dire plusieurs valeurs pour un même attribut, comme audience="admin manager"), l'élément sera exclu du document de sortie uniquement si toutes les conditions d'exclusion sont remplies. En d'autres termes, si un paragraphe possède les attributs admin et manager, et que la ditaval spécifie que le contenu doit être exclu pour le public admin et inclus pour le public manager, le paragraphe doit être alors être inclus.

Remarque : Vous pouvez modifier le comportement par défaut de la ditaval, qui consiste à inclure tout le contenu, en insérant la propriété suivante de façon à ce qu'elle soit le premier nœud sous l'élément val du fichier ditaval :

<prop action="exclude" />