Retour à la page sommaire

Un lien "sommaire" peut être ajouté à vos pages afin de renvoyer vers une autre page contenant, par exemple, une table des matières pour un document ou un site particulier. C'est le cas de cette page-ci (le lien sommaire apparaît dans le haut de la page, en dessous du menu ainsi que dans le bas de la page).

Pour créer ce lien "sommaire" (ou "content" si vos pages sont écrites en anglais), il y a deux manières de procéder:

• soit vous placez un attribut type="sommaire" dans la page d'un document contenant plusieurs pages. On appelera cette page la page sommaire;

• soit vous utilisez un attribut sommaire dans l'élément <document> ou <page> avec comme valeur l'identificateur de la page sommaire voulue;

Page sommaire avec un attribut type="sommaire"

Placer un attribut type="sommaire" dans un élément <page> permet de désigner cette page comme page "sommaire". Toutes les autres pages du document seront alors générées avec un lien "sommaire" qui renverra à la page en question. Voir retour au sommaire dans les documents de plusieurs pages.

Document ou page avec un attribut "sommaire"

Si un attribut sommaire est utilisé dans un élément <document> ou <page>, la valeur de cet attribut doit être l'identificateur de la page que vous comptez utiliser comme sommaire. Il peut s'agir d'un identificateur local ou complet.

La valeur donnée dans <page> est prioritaire à celle donnée dans <document> et à celle donnée par l'attribut type="sommaire".

<documents>
   <document sommaire="site:help:format-xml-ulb:xmlulb:page-sommaire">
      <page>
        ...
      </page>
      <page>
        ...
      </page>
      <page sommaire="site:help:format-xml-ulb:xmlulb">
        ...
      </page>
   </document>
</documents>

Dans cet exemple, les deux premières pages possèderont un lien "sommaire" qui renverra à la la page que vous êtes en train de lire (l'indentificateur mentionné dans le document est celui de cette page-ci; pour le vérifier, affichez la source html de cette page). La troisième page, quant à elle, renverra vers le sommaire principal de ce document.