Identificateur des pages générées

L'identificateur complet d'une page

l'identificateur complet ou absolu d'une page est constitué de l'identificateur du projet contenant la page (défini par la Cellule web dans la configuration du site) suivi d'un deux-points et de l'identificateur de la page au sein du projet (appelé l'identificateur local de la page).

Par exemple, cette page-ci possède l'identificateur complet site:help:format-xml-ulb:xmlulb:identificateur où site:help:format-xml-ulb est l'identificateur du projet (donné par la Cellule web) et xmlulb:identificateur est l'identificateur local de la page (que vous choisissez).

L'identificateur complet ou absolu sert à établir des liens hypertextes absolus entre les pages des différents projets et de manière plus générale à identifier sans ambiguité la page en question.

L'identificateur local d'une page

l'identificateur local d'une page est égal à l'identificateur complet dont on aurait enlevé la première partie (l'identificateur du projet et les deux-points de séparation). Cet identificateur local n'a de raison d'être qu'au sein d'un même projet (en dehors d'un projet, il faut utiliser l'identificateur complet).

Par exemple, cette page-ci possède l'identificateur local xmlulb:identificateur.

L'identificateur local sert à établir des liens hypertextes relatifs entre les pages d'un même projet.

Où trouver l'identificateur d'une page

Pour connaitre l'identificateur complet ou relatif d'une page, il suffit d'afficher la page en question et de regarder dans sa source HTML (pour cela, utilisez l'option view source ou afficher la source ou code source de la page de votre navigateur, grâce à un clic-droit ou en utilisant le menu intitulé View ou Affichage).

L'identificateur complet et l'identificateur local y sont mentionnés dans un commentaire situé dans l'en-tête (tout au début de la source HTML), à la suite de la mention page's full id: pour l'identificateur complet ou page's local id: pour l'identificateur local.

Vous pouvez également retrouver ces identificateurs dans l'application de gestion du site web, soit dans la liste des pages générées de votre projet (par exemple, en cliquant sur le bouton informations détaillées, puis sur voir les pages en prévisualisation ou voir les pages sur le site), ou encore en utilisant l'outil de recherche qui vous permet de localiser n'importe quelle page du site web (y compris celles qui ne font pas partie des projets que vous gérez). Cet outil de recherche est accessible via l'option recherche dans le menu de gauche, en sélectionnant recherche d'une page.

Faites le test sur cette page-ci, vous devriez trouver l'identificateur complet site:help:format-xml-ulb:xmlulb:identificateur et l'identificateur local xmlulb:identificateur.

Construction des identificateurs

On l'a vu, l'identificateur complet ou absolu d'une page est constitué de l'identificateur du projet contenant la page (défini par la Cellule web dans la configuration du site) suivi d'un deux-points et de l'identificateur local de la page au sein du projet.

Cet identificateur local est construit sur base des attributs docref de l'élément <document> et de l'élément <page> de la page en question, en les séparant par des deux-points ':'. C'est vous qui choissisez librement la valeur de ces attributs, en prenant soin de n'utiliser que des lettres minuscules non-accentuées, des chiffres et/ou des tirets (caractère '-'). Vous ne pouvez pas, bien sûr, donner le même identificateur à plusieurs documents ou à plusieurs pages différentes.

<documents>
   <document docref="exemple">
     <info>
       <titre>Exemple 1</titre>
     </info>
     <page docref="page1">...</page>
     <page docref="page2">...</page>
     <page docref="page3">...</page>
   </document>
</documents>

Dans cet exemple, les trois pages générées possèderont les identificateurs locaux suivants:

En supposant que l'identificateur du projet soit site:help:format-xml-ulb:exemple-id1, les trois pages générées possèderont les identificateurs complets suivants:

Cet attribut docref n'est pas obligatoire, ni dans l'élément <document>, ni dans l'élément <page>.

Absence de l'attribut docref dans <document>

Si l'attribut docref n'est pas présent dans l'élément <document>, on utilisera simplement la position du document (1, 2, 3...) au sein de l'élément <documents>.

<documents>
   <document>
     <page docref="page1">...</page>
   </document>

   <document>
     <page docref="page1">...</page>
     <page docref="page2">...</page>
     <page docref="page3">...</page>
   </document>
</documents>

Dans cet exemple, les élements <document> ne possèdent pas d'attribut docref et donc les quatre pages générées recevront les identificateurs suivants:

Absence de l'attribut docref dans <page>

De même, si l'attribut docref n'est pas présent dans l'élément <page>, on utilisera la position de la page (1, 2, 3...) au sein du document.

Toutefois, si la page est la page sommaire du document ou si elle est la première page du document et qu'il n'y a pas de page sommaire, on omettra d'utiliser cette position et on n'utilisera que l'identificateur du document (cette page sommaire recoit, en quelque sorte, l'identificateur du document).

<documents>
   <document docref="exemple3">
     <info>
       <titre>Exemple 3</titre>
     </info>
     <page>...</page>
     <page>...</page>
     <page>...</page>
   </document>
</documents>

Dans cet exemple, les trois pages générées dans le document possèderont les identificateurs suivants:

Remarquez que le première page ne possède pas de numéro, car elle est la première page du document (elle sert de page sommaire et reçoit donc l'identificateur du document).