11.10. Messages


MsgSet = ( ( Title, TitleAbbrev? )?,
           ( MsgEntry+ | SimpleMsgEntry+ )
         )

MsgEntry = ( Msg+, MsgInfo?, MsgExplan* )

SimpleMsgEntry = ( MsgText, MsgExplan )

Msg = ( Title?, MsgMain,
        ( MsgSub | MsgRel )*
      )

MsgInfo = ( ( MsgLevel | MsgOrig | MsgAud )* )

MsgExplan = ( Title?, (%component.mix;)+ )

MsgText = ( (%component.mix;)+ )

MsgMain = (Title?, MsgText)

MsgSub = (Title?, MsgText)

MsgRel = (Title?, MsgText)

MsgLevel = ( ( #PCDATA | Replaceable | InlineGraphic |
               InlineMediaObject | IndexTerm
             )+
           )

MsgOrig = ( ( #PCDATA | Replaceable | InlineGraphic |
              InlineMediaObject | IndexTerm
            )+
          )

MsgAud = ((%para.char.mix;)+)

Éléments : MsgSet, MsgEntry, SimpleMsgEntry, Msg, MsgInfo, MsgExplan, MsgText, MsgMain, MsgSub, MsgRel, MsgLevel, MsgOrig, MsgAud, Title, TitleAbbrev. Attributs : Audience, Level, Origin.

Un ensemble de messages est représenté par l'élément MsgSet. Deux variantes d'ensembles de messages existent : une à base de messages simples (SimpleMsgEntry), et une autre à base de messages plus complets (MsgEntry).

L'élément MsgSet est constitué :

11.10.1. Messages simples

Un message simple est défini grâce à l'élément SimpleMsgEntry. Cet élément est constitué :

Il est possible de définir le public concerné par le message, le niveau d'importance du message et l'origine du message grâce aux attributs Audience, Level et Origin de l'élément SimpleMsgEntry.

Le texte du message (MsgText) est constitué d'un ou plusieurs éléments de type bloc. Le texte explicatif (MsgExplan) est constitué d'un titre (Title) facultatif et d'un ou plusieurs éléments de type bloc.


<msgset>
  <simplemsgentry audience="tous" level="erreur"
                  origin="système de fichiers">
    <msgtext>
      <simpara>Fichier non trouvé</simpara>
    </msgtext>
    <msgexplan>
      <simpara>Le fichier demandé n'existe pas ou vous
        n'avez pas les droits nécessaires pour accéder
        à ce fichier.</simpara>
    </msgexplan>
  </simplemsgentry>
</msgset>

11.10.2. Messages complets

Un message complet est défini par un élément MsgEntry, constitué :

Un message Msg est constitué d'un titre facultatif, d'un message principal MsgMain et d'un nombre quelconque de sous-messages MsgSub ou en relation MsgRel.

Les informations sur un message MsgInfo peuvent contenir :


<msgset>
  <msgentry>
    <msg>
      <msgmain>
        <msgtext>
          <simpara>Fichier non trouvé</simpara>
        </msgtext>
      </msgmain>
    </msg>
    <msginfo>
      <msglevel>erreur</msglevel>
      <msgorig>système de fichiers</msgorig>
      <msgaud>tous</msgaud>
    </msginfo>
    <msgexplan>
      <simpara>Le fichier demandé n'existe pas ou vous
        n'avez pas les droits nécessaires pour accéder
        à ce fichier.</simpara>
    </msgexplan>
  </msgentry>
</msgset>