11.2. draft-comment

L'élément <draft-comment> permet de revoir et discuter simplement les contenus des thèmes au sein du contenu balisé. Utilisez l'élément <draft-comment> pour poser une question ou laisser un commentaire que d'autres pourraient examiner. Pour indiquer la source du commentaire de brouillon ou le statut du commentaire, utilisez les attributs author, time ou disposition.

Les systèmes de traitement devraient fournir un drapeau ou paramètre d'exécution qui provoqueraient l'affichage spécial du contenu de cet élément seulement en impression brouillon (draft output). Par défaut, il est supprimé afin d'empêcher la publication par erreur de commentaires internes.

Exemple

<draft-comment author="EBP">Where's the usage information for this 
section?</draft-comment>

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept ( données textuelles ou ph ou codeph ou synph ou filepath ou msgph ou userinput ou systemoutput ou b ou u ou i ou tt ou sup ou sub ou uicontrol ou menucascade ou term ou xref ou cite ou q ou boolean ou state ou keyword ou option ou parmname ou apiname ou cmdname ou msgnum ou varname ou wintitle ou tm ou p ou lq ou note ou dl ou parml ou ul ou ol ou sl ou pre ou codeblock ou msgblock ou screen ou lines ou fig ou syntaxdiagram ou imagemap ou image ou object ou table ou simpletable ou data ou data-about ou foreign ou unknown) (un nombre quelconque)
map, bookmap ( données textuelles ou ph ou term ou xref ou cite ou q ou boolean ou state ou keyword ou tm ou p ou lq ou note ou dl ou ul ou ol ou sl ou pre ou lines ou fig ou image ou object ou table ou simpletable ou data ou data-about ou foreign ou unknown) (un nombre quelconque)

Contenu par :

Doctype Parents
bookmap p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, organizationname
map p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry
ditabase p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, glossdef, screen, codeblock, pd
topic p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, screen, codeblock, pd
task p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, screen, codeblock, pd
concept p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, screen, codeblock, pd
reference p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, screen, codeblock, pd
glossary p, note, lq, sli, li, itemgroup, dd, pre, lines, ph, stentry, entry, abstract, section, example, glossdef, screen, codeblock, pd

Héritage :

- topic/draft-comment

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
author Désigne l'auteur du commentaire brouillon (draft comment). CDATA #IMPLIED non
time Décrit la date de création du commentaire brouillon. CDATA #IMPLIED non
disposition Statut du commentaire brouillon. Les valeurs peuvent être : "issue", "open", "accepted", "rejected", "deferred", "duplicate", "reopened", "unassigned" ou "completed". CDATA #IMPLIED non
translate Indique si le contenu de l'élément devrait être traduit ou non. Une valeur "yes" remplacera la valeur par défaut. La spécification architecturale DITA contient une liste de tous les éléments DITA OASIS et leur valeur de traitement par défaut pour translate ; puisque l'élément utilise une valeur par défaut réelle, il sera toujours traité avec translate="no", sauf remplacement comme décrit. yes | no | -dita-use-conref-target "no" non
xml:lang Spécifie la langue du contenu de l'élément. Si aucune valeur xml:lang n'est fournie, la langue supposée est l'anglais par défaut. Par exemple, si l'attribut xml:lang d'un élément <note> a la valeur "es", alors l'intitulé de la note, normalement affiché « Note », s'affichera « Nota » en espagnol. Les valeurs xml:lang admises sont celles du document RFC 4646 Étiquettes d'identification des langues (cf. W3C — Étiquettes de langue en HTML et XML). NMTOKEN #IMPLIED non
dir Spécifie la directionnalité du texte : gauche-à-droite ("ltr", traitement par défaut) ou droite-à-gauche ("rtl"). Cf. la spécification architecturale DITA pour les pratiques exemplaires liées à cet attribut, et d'autres aspects de DITA et la traduction. (ltr | rtl | lro | rlo | -dita-use-conref-target) #IMPLIED non
%id-atts; (id, conref) Un ensemble d'attributs liés, décrit à la section 25.3. %id-atts; entité paramètre sans objet pour une entité paramètre sans objet
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) Un ensemble d'attributs liés, décrit à la section 25.5. %select-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, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs