2.6. abstract

L'élément <abstract> se place entre le titre et le corps du thème, comme contenu initial d'un thème. Il peut avoir un contenu de paragraphes ainsi qu'un ou plusieurs éléments <shortdesc> utilisables pour fournir des aperçus ou des résumés de lien. L'élément <abstract> ne peut pas être modifié par les cartes mais son contenu d'éléments <shortdesc> peut l'être dans le but de créer des résumés ou des aperçus de lien.

Utilisez l'élément <abstract> lorsque le premier paragraphe d'un thème ne convient pas comme aperçu de lien ou pour des résumés, par exemple, parce qu'il contient des listes ou des tableaux, ou parce que seule une partie du paragraphe convient. Notez que si le premier paragraphe convient pour un résumé, ce contenu devrait être placé dans un élément <shortdesc> plutôt que dans un élément <abstract>. L'élément <abstract> autorise une plus grande gamme de contenus dans le paragraphe initial, tels que des listes ou des tableaux, et permet d'identifier utilement des parties du contenu pour des aperçus ou des résumés en y incorporant des éléments <shortdesc>.

Lorsque l'élément <shortdesc> apparaît au sein d'un contenu de niveau phrase, il est traité comme un contenu de niveau phrase et ne devrait pas créer un paragraphe séparé dans la sortie du thème. Lorsque l'élément contenu <shortdesc> apparaît à parité (peer) d'un contenu de niveau paragraphe, il est traité comme un contenu de niveau bloc et devrait créer un paragraphe séparé dans la sortie du thème. Lorsque plusieurs éléments <shortdesc> sont inclus dans un élément <abstract>, ils sont concaténés dans une sortie d'aperçus de lien ou de résumés (séparés par des espaces).

Exemple : <abstract> avec description courte de niveau phrase

<abstract>The abstract is being used to provide more complex content. 
	<shortdesc>The shortdesc must be directly contained by the abstract.</shortdesc>
The abstract can put text around the shortdesc.
</abstract>
Sortie du thème
The abstract is being used to provide more complex content. The shortdesc must be directly contained by the abstract. The abstract can put text around the shortdesc.
Sortie en aperçu/résumé
The shortdesc must be directly contained by the abstract.

Exemple : <abstract> avec description courte de niveau bloc

<abstract><p>The abstract is being used to provide more complex content.</p> 
	<shortdesc>The shortdesc must be directly contained by the abstract.</shortdesc>
<p>The abstract can put text around the shortdesc.</p>
</abstract>
Sortie du thème

The abstract is being used to provide more complex content.

The shortdesc must be directly contained by the abstract.

The abstract can put text around the shortdesc.

Sortie en aperçu/résumé
The shortdesc must be directly contained by the abstract.

Exemple : <abstract> avec plusieurs descriptions courtes

<abstract>The abstract is being used to provide more complex content. 
	<shortdesc>The shortdesc must be directly contained by the abstract.</shortdesc>
	<p>The abstract can put text around the shortdesc.</p>
	<shortdesc>There can be more than one shortdesc.</shortdesc>
</abstract>
Sortie du thème

The abstract is being used to provide more complex content. The shortdesc must be directly contained by the abstract.

The abstract can put text around the shortdesc.

There can be more than one shortdesc.

Sortie en aperçu/résumé
The shortdesc must be directly contained by the abstract. There can be more than one shortdesc.

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary ( 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 draft-comment ou required-cleanup ou fn ou indextermref ou indexterm ou data ou data-about ou foreign ou unknown ou shortdesc) (un nombre quelconque)

Contenu par :

Doctype Parents
ditabase topic, concept, task, reference
topic topic
task topic, task
concept topic, concept
reference topic, reference
glossary topic, concept

Héritage :

- topic/abstract

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
%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, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs