audience

L'élément de métadonnée <audience> indique le public visé pour un thème au travers de la valeur de son attribut type. Puisqu'un thème peut avoir plusieurs publics, on peut inclure plusieurs éléments <audience>. Pour chaque public spécifié, on peut identifier la tâche de niveau supérieur (<job>) qu'il essaye d'accomplir et le niveau d'expérience (<experiencelevel>) attendu. On peut employer l'élément <audience> pour fournir une définition plus détaillée que l'attribut audience des valeurs utilisées pour la carte ou le thème.

Exemple

Soit un thème de référence de commande destiné à des programmeurs expérimentés, voici ce qui pourrait être une indication appropriée de ce public :

<audience type="programmer" job="programming" experiencelevel="expert" />

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary, map, bookmap pas de contenu

Contenu par :

Doctype Parents
ditabase, topic, task, concept, reference metadata
bookmap topicmeta, bookmeta
map topicmeta

Héritage :

- topic/audience

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
type Indique le type de personne à qui est destiné le contenu du thème. Notez que cet attribut diffère de l'attribut type sur plusieurs autres éléments DITA. Les valeurs admissibles sont :
user
Un utilisateur du produit.
purchaser
Un acheteur du produit.
administrator
Un administrateur du produit.
programmer
Un programmeur.
executive
Un cadre.
services
Quelqu'un qui fournit des services liés au produit.
other
Utilise la valeur spécifiée par l'attribut othertype.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(user | purchaser | administrator | programmer | executive | services | other | -dita-use-conref-target) #IMPLIED non
othertype Indique un autre type de public, lorsque le type n'est pas disponible dans la liste des valeurs de l'attribut type. Cette valeur est le public indiqué par l'utilisateur lorsque l'attribut type="other". CDATA #IMPLIED non
job Indique la tâche de niveau supérerieur que le public du thème est censé accomplir. Des publics différents peuvent lire le même thème selon différentes tâches de niveau supérieur ; par exemple, un administrateur peut lire le thème en administrant alors qu'un programmeur peut lire le même thème en personnalisant. Les valeurs admissibles sont : "installing", "customizing", "administering", "programming", "using", "maintaining", "troubleshooting", "evaluating", "planning", "migrating", "other", "-dita-use-conref-target". installing | customizing | administering | programming | using | maintaining | troubleshooting | evaluating | planning | migrating | other | -dita-use-conref-target #IMPLIED non
otherjob Si l'attribut job="other", la valeur de cet attribut est utilisée pour identifier un autre type de travail que ceux fournis par défaut avec l'attribut job. CDATA #IMPLIED non
experiencelevel Indique le niveau d'expérience que le public est censé posséder. Des publics différents peuvent avoir des niveaux d'expérience différents par rapport au même thème ; par exemple, un thème peut nécessiter une connaissance générale selon un programmeur mais une connaissance experte selon un utilisateur. Le valeurs admissibles sont :
novice
Un primo-utilisateur.
general
L'utilisateur le plus courant.
expert
Un utilisateur expérimenté.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(novice | general | expert | -dita-use-conref-target) #IMPLIED non
name Employé pour lier l'élément <audience> aux valeurs utilisées dans l'attribut audience. CDATA #REQUIRED oui
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-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 Attributs communs, décrit à la section 25.9. Autres attributs DITA communs