Les zones spéciales

Une zone spéciale est signalée lorsqu’une ligne commence par la répétition de trois caractères particuliers (chaque zone spéciale possède son propre caractère particulier). Les caractères qui suivent ces trois premiers caractères servent à paramètrer la zone.

La zone spéciale se termine lorsqu’une autre ligne commence par cette même répétition de trois caractères (voir les exemples pour chaque zone).

Toutes les zones sont susceptibles de posséder un numéro (exemples : Figure 11, Tableau 22) et une légende. Ce numéro et cette légende doivent être défini impérativement juste après la ligne indiquant le début de la zone Le numéro est défini en commençant une ligne par n= et la légende est définie en commençant une ligne par l=.

Zone de définition d’un tableau

Le caractère identifiant un tableau est le signe égal « = ».

Les trois signes « égal » indiquant la zone peuvent être suivi des caractères h et v. Le caractère h indique que la première ligne du tableau est une ligne d’en-tête, le caractère v indique que c’est la première colonne qui est une ligne d’entête, les deux caractères pouvant être combinées.

Il y a deux manières de représenter un tableau, le mode par défaut et le mode d’importation. On bascule en mode d’importation si un des caractères suivants est présent sur la ligne de début de zone (en plus des caractères h et v) : « t,;:|* ». En absence d’un tel caractère, on suit le mode par défaut.

Dans tous les cas, une cellule qui commence par un chiffre ou le signe moins est considéré comme un cellule contenant un nombre, ce qui a pour conséquence de l’aligner à droite (dans l’affichage par défaut).

Mode par défaut de présentation d’un tableau

À l’intérieur de la zone, chaque ligne indique le contenu d’une cellule du tableau Une ligne blanche marque un changement de ligne Une cellule contenant uniquement le caractère - est considéré comme une cellule vide.

Il est possible d’étendre une même cellule sur une ou plusieurs autres colonnes en faisant suivre sa ligne par une ou plusieurs lignes contenant uniquement le caractère « = ».

Il est possible d’étendre une même cellule sur une ou plusieurs lignes en terminant la cellule par la combinaison [+n] où n est le nombre de lignes à rajouter.

===h
n= Tableau 1.1
l= Exemple


En-tête 1
En-tête 2
En-tête 3


Cellule 1.1
valeur sur deux colonnes
=


-
La cellule précédente est vide
Cellule 2.3


Cellule 3.1
Cellule sur deux lignes [+1]


Cellule 4.1
Cellule 4.3


Cellule 5.1
Cellule sur deux lignes et deux colonnes [+1]
=


Cellule 6.1


===========

Exemple de tableau dans le mode par défaut

Ce qui donne le résultat suivant :

Tableau 1 : Exemple
En-tête 1	En-tête 2	En-tête 3
Cellule 11	valeur sur deux colonnes
	La cellule précédente est vide	Cellule 23
Cellule 31	Cellule sur deux lignes
Cellule 41	Cellule sur deux lignes	Cellule 43
Cellule 51	Cellule sur deux lignes et deux colonnes
Cellule 61	Cellule sur deux lignes et deux colonnes

Mode d’importation

Le mode d’importation est conçu pour récupérer facilement des données tabulaires à partir d’un autre programme via un copier/coller. La plupart du temps, en effet, un tableau par copier/coller se présente sous la forme d’une ligne de texte pour une ligne de tableau avec un séparateur délimitant au sein de la ligne les différentes colonnes (dans OpenOffice, il s’agit de la tabulation).

La présence d’un des caractères suivant dans la ligne de début de tableau : « t,;:|* » indique non seulement que ce qui va suivre doit être traité via le mode d’importation mais aussi le caractère à utiliser comme séparateur Le caractère t indique qu’il faut utiliser les tabulations comme séparateur

===h*
n=Tableau 2
l=Avec l'astérisque comme séparteur


Fruits*Prix au kilo*Producteur
Pommes*2,90 €*Saveurs de Normandie
Pêches*4,65 €*Soleil du midi
Abricots*3,90 €*Soleil du midi
===




===hv,
n=Tableau 3
l=Avec la virgule comme séparateur


,Nbre de tables,Nbre de chaises
Salle Victor Hugo,15,75
Salle des fêtes,4,160


============================

Deux exemples de tableau en mode d’importation

Ce qui donne les résultats suivants :

Tableau 2 : Avec l’astérisque comme séparateur
Fruits	Prix au kilo	Producteur
Pommes	2,90 €	Saveurs de Normandie
Pêches	4,65 €	Soleil du midi
Abricots	3,90 €	Soleil du midi

Tableau 3 : Avec la virgule comme séparateur
	Nbre de tables	Nbre de chaises
Salle Victor Hugo	15	75
Salle des fêtes	4	160

Précisons qu’en mode d’importation, il n’y a ni traitement typographique (remplacement de l’apostrophe, espaces insécables) ni traitement des possibilités de mise en forme des caractères, ceci à fin de réduire le risque de pertes d’information à l’importation.

Zone d’insertion d’une image

Une image peut être insérée de deux manières dans une fiche, soit comme une zone spéciale (procédure décrite ici), soit à l’intérieur d’un paragraphe (voir la fiche sur la mise en forme au niveau des paragraphes)). La procédure par zone est la plus appropriée pour asssocier des informations à l’image comme une légende, le crédit photo etc. La procédure par zone est également la seule pour le moemnt qui permet de faire un lien avec un album.

Il y a trois manières de faire une référence à une image suivant sa localisation !

par une URL absolue, par exemple s=http://www.basedefiches.net/images/exemples/schema.png
par une URL relative, par exemple s=exemples/schema.png, cette URL relative sera résolue à partir de l’URL de base des images définie dans la configuration de la base de fiches
par une référence à une illustration d’un album, par exemple, i=image/2

Le caractère identifiant le début d’une zone d’insertion d’image est le deux-points « : ». Les caractères qui suivent sur cette ligne ont la signification suivante :

si le premier caractère est un i ou s’il n’y aucun caractère, cela définit une « image-bloc » : cette image sera centrée au milieu de la page, le reste du texte se positionnant au dessus et au dessous, c’est le meilleur mode pour les grosses images, les schémas, etc
si le premier caractère est un l, il s’agit d’une « lettrine », c’est à dire que l’image va être positionné à gauche (si le premier l est suivi d’un autre l) ou à droite (si le premier l est suivi d’un r) du paragraphe qui l’a suit qui va donc « s’écouler » autour de la photo ; ce mode est approprié pour les petites images décoratives (qui souvent n’auront même pas de légende)

Pour indiquer l’URL de l’image, on commence une ligne par s= suivi de l’URL, sauf dans le cas d’une illustration d’un album, où la ligne commence par i=. Les autres lignes optionnelles sont les suivantes :

c= : crédit photo ;
w= : largeur de l’image ;
h= : hauteur de l’image ;
a : URL extérieure vers qui renvoie l’image

Il est également possible d’indiquer le crédit photo (c’est à dire indiquer l’auteur de la page).

Une « image-bloc » :
:::
n=Schéma 1.2
l= Extrait de schéma


s=exemples/schema.png
w=408
h=106
a=http://www.exemole.fr
::::


Une « lettrine » à gauche :
:::ll
s=illu_paragraphe17.jpg
c=Semences paysannes
:::


Une « lettrine » à droite :
:::lr
s=http://www.semencespaysannes.org/images/illustrations/illu_question9.jpg
c=Extrait du site Semences paysannes
a=http://www.semencespaysannes.org/index.php?rubrique_id=117
:::

Plusieurs exemples

Ce qui donne le résultat suivant :

Schéma 12 : Extrait de schéma

Semences paysannes

Paragraphe « s’écoulant » à droite de l’image en lettrine gauche;

Tout comme le paragraphe suivant

Extrait du site Semences paysannes

Vient ensuite l’exemple de la lettrine à droite :

Zone d’insertion de code

Le caractère identifiant une zone de code est le signe plus « + » Une zone de script sert à insérer du code informatique, des extraits de code XML ou toutes sortes d’éléments techniques comme les exemples de syntaxe de cette page.

Il est possible de préciser le type de code en faisant suivre les trois + de la première ligne par une lettre particulière. Les lettres disponibles sont « x » pour indiquer que c’est du code XML et « s » pour indiquer qu’il s’agit d’un script informatique.

Le type de code va influer sur le calcul de « l’indentation » du code. En HTML, en effet, la tabulation n’existe pas, elle est traitée comme un espace blanc. L’indentation rend le code plus lisible en montrant les regroupements Lorsque la zone de code est de type Xml, l’indentation est calculé en fonction des balises ouvrantes et fermantes Lorsque la zone est de type script, l’indentation est calculée en fonction des blocs d’accolades {}. Quand aucun type n’est indiqué, l’indentation peut être précisée en commençant la ligne par des caractères « _ » , leur nombre indiquant la profondeur de l’identation ( voir les exemples).

Dans les zones de code, les lignes blanches sont prises en compte sauf celles de début et de fin et il n’y a pas de possibilité de mise en forme.

Zone Xml :


+++x
l= Xml d'une fiche
<fiche>
<entete><titre>Titre</titre>
<soustitre>Sous-titre</soustitre>
</entete>
</fiche>
+++


Zone de script


+++s
n=Script 2.2
l=Fonction d'affichage


function affiche(id) {
var el = document.getElementById(id);
if (el != null) {
el.style.display="visible";
}
}


+++


Zone sans indication avec indentation précisée :


+++
Sommaire du guide
_Chapitre 1 : la prise en main
__1.1 se connecter
__1.2 saisir des fiches
_Chapitre 2 : aller plus loin
+++

Différents exemples de zone de code

Ce qui donne le résultat suivant :

<fiche>
   <entete><titre>Titre</titre>
      <soustitre>Sous-titre</soustitre>
   </entete>
</fiche>

Xml d’une fiche

function affiche(id) {
   var el = document.getElementById(id);
   if (el != null) {
      el.style.display="visible";
   }
}

Script 22 : Fonction d’affichage

Sommaire du guide
   Chapitre 1 : la prise en main
      1.1 se connecter
      1.2 saisir des fiches
   Chapitre 2 : aller plus loin

Zone de définition d’un encadré

Le caractère identifiant une zone d’encadré est point d’exclamation « ! ». Après spécification de la légende et du numéro éventuels de l’encadré, une zone d’encadré se comporte exactement comme du texte normal : on peut y inclure des niveaux de titres, des tableaux, des images, etc. La seule zone que l’on ne peut pas inclure c’est un autre encadré (pas de « sous-encadré).

!!!
n=Encadré 1
l= exemple de code


Texte normal avec toutes les possibilités comme {l'italique} et le {{gras}}.
+++
plus une zone de code !
+++
Fin de l'encadré
!!!

Exemple d’encadré avec du code

Ce qui donne le résultat suivant :

Texte normal avec toutes les possibilités comme l’italique et le gras

plus une zone de code !

Fin de l’encadré

Encadré 1 : exemple de code

Zone d’insertion de code HTML

Lorsque la base est destinée à produire un site web, il peut être utile d’insérer du code HTML spécial, notamment pour insérer le lecteur vidéo d’un site de type DailyMotion ou autre. Les zones d’insertion de code HTML sont considérées comme une sous-catégorie des zones de définition d’un encadré : elles sont identifiées par trois points d’exclamation suivis de la chaine cdata (ou simplement du caractère |cs|c]]).

!!!cdata
n=
l= Une minute de Monsieur Cyclopède sur le site de l'INA




<script type="text/javascript" src="http://www.ina.fr/js/global/controle/ogp_player_embed.js"></script><script type="text/javascript" src="http://www.ina.fr/player/embed/w/512/h/384/id_notice/CPC83050801/id_utilisateur/933564/hash/0959b0147abdfc7de3956ceae7d5e1bf"></script><div align="center" style="background-color:#000; font:11px/18px Arial,Helvetica,Verdana,sans-serif; color:#b4d2fe; width:512px;"> retrouver ce média sur <a href="http://www.ina.fr/divertissement/humour/video/CPC83050801/evaluons-le-quotient-intellectuel-de-beethoven.fr.html" target="_blank" style="font-weight:bold; color:#b4d2fe">www.ina.fr</a> </div>


!!!

Ce qui donne :

retrouver ce média sur www.ina.fr

Une minute de Monsieur Cyclopède sur le site de l’INA