Structure des sources xml |
Comme indiqué dans l'introduction, la structure d'une source xml correspond au format suivant: structure générale d'un fichier XML source <?xml version="1.0" encoding="UTF-8"?> <documents> <document> <page>...</page> </document> <document> <page>...</page> <page>...</page> <page>...</page> </document> <document> <page>...</page> <page>...</page> </document> </documents> |
La première ligne ne doit pas vous inquiéter pour l'instant, c'est du charabia xml pour indiquer quel est le type d'encodage utilisé pour les caractères accentués. Pour le reste, une source xml contient un élément racine <documents>, qui ne contient que des éléments <document>, qui à leur tour, ne contiennent généralement que des éléments <page>. |
<documents> |
L'élément racine <documents>Toute source xml au format ULB doit contenir un élément racine appelé <documents> (en d'autres termes, on doit trouver une balise ouvrante <documents> au début de la source xml, et une balise fermante </documents> tout à la fin de la source xml). Contenu:L'élément racine <documents> ne peut contenir que des éléments <document> (au minimum 1). Ces éléments peuvent éventuellement être précédés d'éléments <contenu-bloc>, <contenu-toc> ou <contenu-texte> utilisé pour des inclusions de code xml, ainsi que des éléments <options> pour définir des options. Attributs:L'élément <documents> peut posséder (c'est facultatif) les attributs suivants:
Exemple <?xml version="1.0" encoding="UTF-8"?> <documents page-accueil-fr="ulb:format-xml:index" langue="fr"> <document> ... </document> </documents> |
<document> |
Les éléments <document>Chaque élément <document> contient la définition d'une ou plusieurs pages représentées par des éléments <page> (les avantages de cette structure sont décrits ici, elle permet notamment de lier les pages entre-elles par des liens du type page suivante/page précédente). Contenu:Un élément <document> peut contenir (dans cet ordre) :
Attributs:Un élément <document> peut posséder les attributs (facultatifs) suivants:
Exemple <?xml version="1.0" encoding="UTF-8"?> <documents> <document docref="demo" filename="demo" langue="fr" version-en="demo-anglais"> <info> <titre>Manuel d'utilisation de l'intranet xml</titre> <mots-clés>aide, XML, exemple, manuel</mots-clés> <description>manuel décrivant la structure des documents XML sources utilisés à l'ULB</description> </info> <page> ... </page> <page> ... </page> </document> </documents> |
<page> |
Les éléments <page>Chaque élément <page> génère une seule page html. Le contenu de cet élément est constitué d'un ou plusieurs sous-éléments qui décrivent et qui mettent en page l'information à afficher. Contenu:Un élément <page> peut contenir (dans cet ordre) :
Attributs:L'élément <page> peut posséder les attributs (facultatifs) suivants:
Exemple <?xml version="1.0" encoding="UTF-8"?> <documents> <document docref="demo"> <page langue="fr" docref="demo-francais-page1" version-en="demo-anglais-page1"> <info> <titre>Manuel d'utilisation de l'intranet xml</titre> <mots-clés>aide, XML, exemple, manuel</mots-clés> <description>manuel décrivant la structure des documents XML sources utilisés à l'ULB</description> </info> <titre1>Comment utiliser l'intranet xml?</titre1> <p>...</p> <p>...</p> ... </page> <page langue="fr" docref="demo-francais-page2" version-en="demo-anglais-page2"> <titre1>...</titre1> <p>...</p> <p>...</p> ... </page> </document> </documents> |