Autres éléments de type bloc

11.1. Avertissements


Caution = ( Title?,
            (%admon.mix;)+
          )

Important = ( Title?,
              (%admon.mix;)+
            )

Note = ( Title?,
         (%admon.mix;)+
       )

Tip = ( Title?,
        (%admon.mix;)+
      )

Warning = ( Title?,
            (%admon.mix;)+
          )

Éléments : Caution, Important, Note, Tip, Warning.

DocBook permet d'utiliser différents types d'avertissements. Tous sont constitués d'un titre (Title), facultatif, suivi d'éléments de type bloc.

Si le titre n'est pas utilisé, un titre pourra être généré automatiquement, relativement à l'élément utilisé. Une icône ou un autre symbole pourra aussi être utilisé pour mettre le passage en valeur.

DocBook n'impose pas de sémantique à ces divers avertissements. Ils pouront par exemple être utilisés dans les cas suivants :

Caution

Met le lecteur en garde.

Important

Un passage de texte important.

Note

Une note dans le texte.

Tip

Un conseil au lecteur.

Warning

Demande l'attention du lecteur.