Lien vers une page ou un document écrit dans une autre langue

Pour faire apparaître un lien "english version" dans le menu d'une page (en version française, néerlandaise ou chinoise), il suffit d'ajouter l'attribut version-en dans la balise <document> ou dans la balise <page> correspondante.

Pour faire apparaître un lien "version française" dans le menu d'une page (en version anglaise, néerlandaise ou chinoise), il suffit d'ajouter l'attribut version-fr dans la balise <document> ou dans la balise <page> correspondante.

Pour faire apparaître un lien "nederlandse versie" dans le menu d'une page (en version française, anglaise ou chinoise), il suffit d'ajouter l'attribut version-nl dans la balise <document> ou dans la balise <page> correspondante.

Pour faire apparaître un lien "中文版" dans le menu d'une page en version (française, anglaise ou néerlandaise), il suffit d'ajouter l'attribut version-zh dans la balise <document> ou dans la balise <page> correspondante.

La valeur définie au niveau <page> est prioritaire par rapport à celle définie au niveau <document>.

La valeur à donner à ces attributs est l'identificateur de la page ou du document visé. Il peut s'agir d'un identificateur local ou absolu.

Placer l'attribut dans l'élément <document>

Placer cet attribut version-fr, version-en, version-nl ou version-zh dans l'élément <document> permet de renvoyer à la page principale (ou page sommaire) d'un document traduit dans l'autre langue. On le placera là lorsque la version traduite d'un document ne contient pas exactement le même nombre de pages ou la même structure que la version non traduite.

L'exemple qui suit illustre des liens croisés "english version", "version française", "nederlandse versie" et "中文版" entre deux documents de plusieurs pages (les liens dans chacune des pages pointeront vers la page principale du document dans l'autre langue).

<documents>
   <document docref="francaise1" langue="fr" version-en="anglaise1" version-nl="neerlandaise1" version-zh="chinoise1">
      <info>
         <titre>Exemple 1 en français</titre>
      </info>
      <page>...</page>
      <page>...</page>
      <page>...</page>
   </document>

   <document docref="anglaise1" langue="en" version-fr="francaise1" version-nl="neerlandaise1" version-zh="chinoise1">
      <info>
         <titre>Sample 1 in english</titre>
      </info>
      <page>...</page>
      <page>...</page>
      <page>...</page>
   </document>

   <document docref="neerlandaise1" langue="en" version-fr="francaise1" version-en="anglaise1" version-zh="chinoise1">
      <info>
         <titre>Voorbeeld 1 in nederlands</titre>
      </info>
      <page>...</page>
      <page>...</page>
      <page>...</page>
   </document>

   <document docref="chinoise1" langue="zh" version-fr="francaise1" version-en="anglaise1" version-nl="neerlandaise1">
      <info>
         <titre>实施例1在中国</titre>
      </info>
      <page>...</page>
      <page>...</page>
      <page>...</page>
   </document>
<documents>

Placer l'attribut dans l'élément <page>

Placer cet attribut version-fr, version-en, version-nl ou version-zh dans l'élément <page> permet de renvoyer à une page précise, plutôt que vers la page principale d'un document. On le placera là lorsque chaque page d'un document possède sa page équivalente traduite dans l'autre langue.

L'exemple suivant illustre un lien croisé "english version/version française" entre les différentes pages de deux documents (chaque page possèdera sa propre traduction).

<documents>
   <document docref="francaise2" langue="fr">
      <info>
         <titre>Exemple 2 en français</titre>
      </info>

      <page docref="page1" version-en="anglaise2:page1">...</page>
      <page docref="page2" version-en="anglaise2:page2">...</page>
      <page docref="page3" version-en="anglaise2:page3">...</page>
   </document>

   <document docref="anglaise2" langue="en">
      <info>
         <titre>Sample 2 in english</titre>
      </info>
      <page docref="page1" version-fr="francaise2:page1">...</page>
      <page docref="page2" version-fr="francaise2:page2">...</page>
      <page docref="page3" version-fr="francaise2:page3">...</page>
   </document>
</documents>