Présentation générale des documents
Les documents du sites marketing sont présentés en XML. Le but de cette page est de donner la présentation et les diverses balises.
Pour les explications se référant au language XML ou HTML, prière de voir les nombreux sites traitant de ce sujet.
Ce document ne présuppose qu'une connaissance minimum du language HTML.
Les documents sont présentés entre deux balises indiquant le début et la fin du document <document> ...... </document>
<document>
- <entete>
- <titre>Titre du document</titre>
- <date>Date de création du document</date>
- <auteur>Prénom + Nom de l'auteur</auteur>
- <mail>e-mail de l'auteur</mail>
- </entete>
- <contenu>
- <chapitre no="No du chapitre (I, II, III, IV, V...)">
- <Tchapitre>Titre du chapitre</Tchapitre>
- <para no="No de la section (A, B, C, D, ...)">
- <Tpara>Titre de la section</Tpara>
- <texte>
- <p>...............paragraphe..............</p>
- <Spara no="No de la sous-section (1, 2, 3,...)" titre="Titre de la sous-section"/>
- ....
- ....
- ....
- </texte>
- </para>
- <para no="No de la section (A, B, C, D, ...)">
- <Tpara>Titre de la section</Tpara>
- <texte>
- <Spara no="No de la sous-section (1, 2, 3,...)" titre="Titre de la sous-section"/>
- <p>...............paragraphe..............</p>
- ....
- ....
- ....
- </texte>
- </para>
- </chapitre>
- <chapitre no="No du chapitre (I, II, III, IV, V...)">
- <Tchapitre>Titre du chapitre</Tchapitre>
- <para no="No de la section (A, B, C, D, ...)">
- <texte>
- ....
- ....
- </texte>
- </para>
- </chapitre>
- <chapitre no="No du chapitre (I, II, III, IV, V...)">
- </contenu>
Comme vous pouvez le constater ci-dessus, le document contient deux parties essentielles :
- L'<entete>...</entete> donnant les définitions du document.
L'utilisation des balises contenues dans l'entête est définie dans la présentation générale du document. - Le <contenu> .... </contenu>.
Il est important de respecter l'ordre indiqué dans la présentation générale et ci-dessous. De ces balises sera générée automatiquement la table des matières du document.<chapitre no="x"> Le paramètre x est obligatoire. Aucune erreur ne sera signalée s'il n'est pas spécifié mais le code généré créera des problèmes de mise en page et d'adressage.
les valeurs possibles sont I, II, III, IV, V, ....<Tchapitre>Titre du chapitre</Tchapitre> Donne le Titre du chapitre. Ce texte sera également utilisé dans la table des matières.
TOUT TEXTE INSERE ENTRE CETTE BALISE ET LA BALISE <para> EST IGNORE.
Voir ci-dessous comment introduire du texte avant la première section.<para no="x"> Le paramètre x est obligatoire. Aucune erreur ne sera signalée s'il n'est pas spécifié mais le code généré créera des problèmes de mise en page et d'adressage.
les valeurs possibles sont A, B, C, D, ....
Il y a cependant une exception, si l'on désire introduire du texte avant la première section, ne pas spécifier [no="x"]<Tpara>Titre de la section</Tpara> Donne le Titre de la section. Ce texte sera également utilisé dans la table des matières. <texte> C'est entre cette balise et la balise </texte> (voir ci-dessous) que l'on trouve le texte à proprement parlé avec les divers paragraphes <p> et sous-sections <Spara>. <p>xxx</p> Le paramètre x représente le contenu du paragraphe. <Spara no="x" titre="yyyy"/> Les paramètres x et yyy sont obligatoires. Aucune erreur ne sera signalée s'ils ne sont pas spécifiés mais le code généré créera des problèmes de mise en page et d'adressage.
les valeurs possibles pour x sont :1, 2, 3, 4, ....
yyy permet de mentionner le titre de la sous-section.
A noter le caractère / inclus dans la balise.</texte> Cette balise avec la balise </para> termine chaque section </para> Cette balise termine chaque section </chapitre> Cette balise termine le chapitre
Balises de mise en page
Il existe divers balises vous permettant d'effectuer les mises en page. Les paramètres spécifiés entre [..] sont optionnels.
- Les tableaux. Les balises ci-dessous correspondent à la définition HTML
<table [border="x"]> Le paramètre x suit les définitions html et précise l'épaisseur en pixel du bord.
Une valeur 0 ou l'absence de paramètre indique une absence de bordure.<tr>....</tr> Rangée de cellules de la table. <th>....</th> Cellules entête de la table. Apparaissent de cette manière. <td>....</td> Cellules de la table. Les paramètres optionnels suivants peuvent être spécifiés :
[align="v"] => l'alignement des données et la justification du texte dans une cellule. Les valeurs possibles sont : left : données repoussées à gauche/texte justifié à gauche. C'est la valeur par défaut ; center : données au centre/texte centré. C'est la valeur par défaut pour les rubriques de tables ; right : données repoussées à droite/texte justifié à droite ; justify : texte justifié.
[valign="w"] => Cet attribut spécifie la position verticale des données dans une cellule. Les valeurs possibles sont : top : les données de la cellule sont repoussées en haut de la cellule ; middle : les données de la cellule sont centrées verticalement dans la cellule. C'est la valeur par défaut ; bottom : les données de la cellule sont repoussées en bas de la cellule.
[bg="x"] => couleur d'arrière-plan des cellules à spécifier sous forme RGB (exemple :#ff0000) ou par nom de couleur (exemple :red).
[colspan="y"] => nombre de colonnes couvertes par la cellule
[rowspan="z"] => nombre de rangées couvertes par la cellule</table> Termine la table. - Les listes
<ul [style="x"]> Début d'une liste non-ordonnée.x peut prendre la valeur disc | circle | square <ol [style="x"]> Début d'une liste ordonnée.x peut prendre la valeur i | I | a | A | 1 | 01 | none <li> ... </li> Entre ces deux balises se trouvent les items de la liste </ul> Fin d'une liste non-ordonnée </ol> Fin d'une liste ordonnée - Les encadrés et textes spéciaux
<encadre> ... </encadre> Permet d'éditer un texte avec la mise en page montrée ici<exemple> ... </exemple> Permet d'éditer un texte avec la mise en page montrée ici<lois> ... <lois> Permet d'éditer un texte avec la mise en page montrée ici - Les mises en forme de texte
<br/> Saut de ligne forcé <center> .... </center> Les caractères situés entre ces deux balises sont centrés<b> .... </b> Les caractères situés entre ces deux balises sont en caractères gras. Voir également la balise <car>. <i> .... </i> Les caractères situés entre ces deux balises sont en italique. Voir également la balise <car>. <u> .... </u> Les caractères situés entre ces deux balises sont soulignés. Voir également la balise <car>. <sup> .... </sup> Les caractères situés entre ces deux balises sont écriture en lettres supérieures. <sub> .... </sub> Les caractères situés entre ces deux balises sont écriture en lettres inférieures. <souligne [color="y"]> .... </souligne> Les caractères situés entre ces deux balises ont un effet "marker". A spécifier sous forme RGB (exemple :#ff0000) ou par nom de couleur (exemple :red).
Si aucun paramètre n'est spécifié, la couleur jaune est choisie.<car> .... </car> Cette balise permet une mise en forme multiple d'un texte. Les paramètres optionnels suivants peuvent être spécifiés :
[size="v"] => Modifie la dimension des caractères. la valeur est relative par rapport à la taille de la police de l'élément parent (exprimée en em).
[color="w"] => Couleur des caractères à spécifier sous forme RGB (exemple :#ff0000) ou par nom de couleur (exemple :red).
[weight="x"] => Valeurs possibles normal | bold | bolder | lighter
[style="y"] => Valeurs possibles normal | italic | oblique
[decoration="z"] => Valeurs possibles underline || overline || line-through<span style=" .... ">....</span> Cette balise permet d'introduire toute définition CSS2 pour le texte situé entre deux balises HTML <span> - Les liens hypertexte
<target goal="x">....</target> Ces deux balises permettent de définir une ancre à l'intérieur du document target définissant la cible et link permet de pointer sur cette cible.
Voir ci-dessous les règles de définission automatique des ancres à l'intérieur d'un document.<link goal="x">....</link> <xlink href="x">....</xlink> Pointeur sur un lien externe au document. Spécifier dans x l'adresse complète HTML (http://.......). - Insertion d'images
<img>....</img> Permet d'incorporer une image. Cette dernière doit être présente sur le serveur. Il faut donc qu'elle nous soit expédiée.
Les paramètres suivants sont obligatoires :
src="a" => Adresse de l'image. Cette image étant enregistrée sur le serveur seul le nom et l'extension suffisent (exemple image.jpg)
alt="b" => Cet attribut spécifie un texte de remplacement pour les agents utilisateurs qui sont incapables d'afficher les images, les formulaires ou les applets.
title="b'" => Cet attribut donne une information complémentaire qui sera affichée lorsque le curseur est positionné sur l'image.
width="c" => Largeur de l'image en pixels
height="d" => Hauteur de l'image en pixels
Les paramètres suivants sont optionels :
[align="e"] => Valeurs possibles left | right | none. Spécifie la position de l'image par apport à son contexte.
[valign="f"] => Valeurs possibles baseline | sub | super | top | text-top | middle | bottom | text-bottom. Spécifie la position de l'image par apport à son contexte.
[border="g"] => g précise l'épaisseur en pixel du bord autours de l'image.
Règles de définition automatique des ancres
Comme indiqué ci-dessus, une table des matières est générée automatiquement. Pour exploiter cette table, des ancres sont insérées automatiquement dans le document.
Le nom de ces dernières est créé selon la règle suivante :
Partie du document | Règle | Ancre |
---|---|---|
Chapitre | Ancre est crée à partire de <chapitre no="x"> | x_ |
Section | Ancre est crée à partire de <para no="y"> | x_y |
Sous-section | Ancre est crée à partire de <Spara no="z" titre="aaaa"/> | x_yz |
Exemple de reférencement : Intro#I_C1 renvoi au chapitre I section C sous-section 1 de la page Intro
Règles d'adressage http des pages
Toutes les pages du cours marketing sont chargées par la page
https://marketing.thus.ch/loader.php?page=xxxxx. Pour l'affichage normal des pages.
Où xxxxx est le nom de la page à charger. Les programmes de chargement reconnaissent deux types de pages :
- Les pages créées à partir des documents XML
- Pour les pages "administratives" (comme celle-ci), le nom xxxxx est précédé d'un ~. Ceci indique au programme de chargement que la page n'a pas été formatée en XML, mais directement en HTML et qu'elle doit être affichée telle quelle.
Dans ce cas, le programme de chargement l'affiche en entier sans gestion de la table des matières et des chapitres.
Pour un adressage http complet des pages créées par des documents XML, utilisez la formule suivante :
https://marketing.thus.ch/loader.php?page=xxxxx-yyy#yyy_zzn
Où :
- xxxxx correspond au nom de la page
- yyy correspond au No du chapitre (I, II, III, ...)
- zzn zz indique le No de la section (A, B, C, D, ...) et n le No de la sous-section (1, 2, 3,...)
En cas d'omission du nom de la page, le système charge la page MDemploi. En cas d'omission du chapitre, le système charge le chapitre I.
Exemple : https://marketing.thus.ch/loader.php?page=Intro-II#II_D2