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.
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" />
| Doctype | Modèle de contenu |
|---|---|
| ditabase, topic, task, reference, concept, glossary, map, bookmap | pas de contenu |
| Doctype | Parents |
|---|---|
| ditabase, topic, task, concept, reference | metadata |
| bookmap | topicmeta, bookmeta |
| map | topicmeta |
- topic/audience
| 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 | 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 | 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 |
OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.