ReglesDeMiseEnForme

Un site de type wiki est un site qui présente des pages de texte éditables (par tous ou avec des restrictions). Pour afficher ce texte, une syntaxe simple est définie pour permettre de mettre en forme le texte de façon plus pratique.%%%
Cette page décrit la totalité de la syntaxe reconnue par ce wiki, voyez la page IntroductionRapide pour démarrer avec les règles de syntaxe les plus communes.

%%tdm%%

!# Syntaxe de mise en page

Le texte s'organise en paragraphes, les paragraphes sont délimités par (au moins) une ligne vide.

Les modificateurs de mise en forme se classent essentiellement en quatre catégories:
* [Modificateurs ponctuels|ReglesDeMiseEnForme#Modificateursponctuels]
* [Modificateurs de texte|ReglesDeMiseEnForme#Modificateursdetexte]
* [Modificateurs de ligne|ReglesDeMiseEnForme#Modificateursdeligne]
* [Modificateurs de bloc|ReglesDeMiseEnForme#Modificateursdebloc]

!!# Modificateurs ponctuels

Les modificateurs ponctuels n'agissent qu'à l'endroit où ils sont insérés.

!!!# retour à la ligne

Insérer trois caractères % (pourcent) accolés produit un saut de ligne à l'endroit où ils sont insérés.

!!!# séparateur horizontal

Mettre (au moins) quatre - (tiret) seuls sur une ligne (sans espaces) produit une ligne horizontale de séparation.

!!!# Smiley

Vous pouvez entrer simplement des smiley, et ceux-ci seront remplacés par des petites images correspondantes.%%%
Les smiley supportés pour le moment sont:
:-))
:-))
:-)
:-)
;-)
;-)
:-|
:-|
:-(
:-(
:-/
:-/
:-r
:-r
:-O
:-O
8-O
8-O

!!!# Insert

Les insert sont des mots clé, entourés par des doubles % (pourcent), %%commeça%%. Les insert sont remplacés par du texte différent.

!!!!# Insert direct

Les insert direct sont immédiatement remplacés par leur valeur, avant tout autre traitement. Ils peuvent donc notamment servir dans les liens, et s'ils contiennent un mot wiki celui-ci sera bien interprété.

;page:Le nom de la page actuelle.
;parent:La page parente de la page actuelle.
;auteur:Le dernier auteur de la page.
;lilit:L'URL du site de LiLiT ;-)
;
anchor:
''nomdulien'':
permet d'insérer un anchor nommé ''nomdulien'' à cet endroit de la page, cela permet de faire référence à det endroit partidulier de la page (voir les [liens|%%page%%#Autresliens]). Ces insert n'ont aucune manifestation visuelle (mais vous pouvez vérifier leur présence dans le source html).%%%
Attention: aucune vérification n'est faite sur le nom du lien, évitez de les dupliquer (notez également que les titres génèrent tous automatiquement un anchor).
;nbsp:un espace insécable (à utiliser avec modération, au risque de faire des mises en page fantasistes).
;
count:
''nomcompteur'':
Un compteur nommé (on a un compteur différent pour chaque valeur de ''nomcompteur'') qui affiche sa valeur. À la première utilisation il est initialisé à 1, ensuite il est incrémenté à chaque utilisation.

!!!!# Post insert

Les post insert sont des insert dont le contenu dépend de toute la page en cours ou d'une partie supérieure à la ligne en cours, ils ne peuvent donc être remplacés par leur valeur qu'une fois toute la page analysée.

;tdm:La table des matières de la page, une liste hiérarchique de tous les titres de la page.
;tdmnum:La table des matières numérotées, cette liste ne contient que les [titres numérotés|%%page%%#Numérotation].
;tdmnon:La table des matières non numérotées, cette liste ne contient que les titres normaux.
;nbchar:Le nombre de caractères que contient la page (les retours à la ligne comptent comme un caractère).
;nblign:Le nombre de lignes de la page.

!!# Modificateurs de texte

Les modificateurs de texte permettent de changer la façon dont les caractères sont affichés. Ils consistent tous à entourer le texte à modifier par un caractère spécial répété deux fois.

__Attention__ : ces modificateurs ne fonctionnent qu'au sein d'une même ligne!

;__gras__:le gras se fait en entourant par des caractères _ (soulignement).
;''italique'':l'italique se fait en entourant par des caractères ' (apostrophe).
;§§télétype§§:les caractères télétypes s'obtiennent en entourant par des caractères § (paragraphe).
;--plus petit--:on a du texte plus petit en entourant par des caractères - (tiret).
;++plus grand++:on a du texte plus grand en entourant par des caractères + (plus).

__Attention:__ les modificateurs de texte ne fonctionnent que dans la ligne courante, il n'est pas possible de les séparrer sur plusieurs lignes.
__cet exemple
ne fonctionne pas__

!!# Modificateurs de ligne

Les modificateurs de ligne vont modifier la façon dont une ligne dans son entièreté est affichée. Ces modificateurs consistent en un ou plusieurs caractères particuliers placés au début de la ligne.

!!!# Titres

Les lignes commençant par des ! (points d'exclamation) sont des lignes de titre. Le nombre de ! détermine le niveau du titre, un ! donne un titre de premier niveau, deux un titre de deuxième niveau, ...

!!!!# Numérotation

Les titres peuvent être numérotés, il suffit pour cela d'ajouter un # (dièse) directement après les !.

!!!# Listes

Les listes sont des styles de ligne qui peuvent être imbriqués.

Les types possibles de listes sont:
* les listes à puces, repérées par le caractère * (étoile)
* les listes numérotées, repérées par le caractère # (dièse)
* les listes de définitions, repérées par le caractère ; (point-virgule)
* les commentaires, repérés par le caractère £ (livre sterling)

Une ligne commençant par un ou plusieur de ces caractères sera une ligne de liste, le nombre de caractère détermine le niveau d'imbrication, c'est le dernier caractère qui détermine le type de la liste.

Les listes de définitions ont une syntaxe un peu plus compliquée. Le reste de la ligne est séparé par le premier : (deux-points) trouvé, ce qui se trouve avant est le terme à définir et tout le reste est la définition. Il n'est pas nécessaire de mettre un terme à définir (rien entre le ";" et le ":"), on a alors simplement une ligne indentée.

Les commentaires utilisent la même syntaxe que les listes de définitions, mais sont affichés de façon très différente. La partie avant le ":" est l'en-tête du commentaire (il peut contenir par exemple le nom de l'auteur du commentaire). La suite est le corps du commentaire, il peut être affiché ou caché.%%%
Cela permet de faire des commentaires dans un texte suivi sans trop gêner sa lecture.

!!!# Texte préformaté

Si une ligne commence par (au moins) un espace, cette ligne est considérée comme préformatée, les espaces répétés ne sont pas enlevés. Ceci est bien adapté à l'insertion de code source pour préserver son indentation.

!!!# Lignes normales

Si aucun des modificateurs de ligne n'est présent, la ligne est considérée comme la continuation de la ligne précédente, aucun retour à la ligne n'est implicitement inséré (pour ce faire il faut mettre un triple %).

Il y a une exception à cette règle: un titre n'a une portée que sur la ligne courante, la ligne suivante commence un nouveau paragraphe.

!!# Modificateurs de bloc

Les modificateurs de bloc s'étendent sur plusieurs lignes et ne se terminent pas lors d'un nouveau paragraphe (ligne vide). Ces modificateurs sont constitués d'au moins deux parties, la partie ouvrante et la partie fermante, ils peuvent aussi comporter d'autres indications à l'intérieur du bloc.

!!!# Tableaux

Les tableaux se démarrent avec le caractère { (accolade ouvrante) en début de ligne, les autres caractères de cette ligne sont interprétés comme des modificateurs pour le comportement du tableau.

La construction [----|%%page%%#séparateurhorizontal] sur une ligne change de signification, elle sert alors à délimiter les lignes du tableau.

Un caractère | (barre verticale) délimite les cellules du tableau.
%%%Une même ligne de tableau peut être répartie sur plusieurs lignes de texte et peut donc contenir des constructions comme les modificateurs de lignes, et même d'autres tableaux.

On termine un tableau par un caractère } (accolade fermante) en début de ligne, le reste de cette ligne est ignoré!

!!!!# Modificateurs de tableaux

Les caractères suivants, ajoutés à la ligne d'ouverture du tableau, modifient la façon dont le tableau est affiché. Tous les autres caractères sont ignorés.
;b:le tableau aura une bordure (il n'y en a pas par défaut).
;t:la première ligne du tableau est une ligne de titre.
;j:le texte des cellules est justifié (comportement par défaut).
;l:le texte des cellules est aligné à gauche.
;c:le texte des cellules est centré.
;r:le texte des cellules est aligné à droite.
;u:le texte des cellules est aligné en haut.
;m:le texte des cellules est aligné au milieu (comportement par défaut).
;s:le texte des cellules est aligné en bas.

Il y a aussi des options pour changer la couleur de fond du tableau, les couleurs disponibles sont
;w:blanc
;g:vert
;y:jaune
;o:rouge
;e:bleu
;p:violet
;n:couleur normale

!# Liens

Il existe plusieurs façons d'insérer des liens dans des pages de wiki.

!!# Mots wiki

Les mots wiki, ou WikiWords, sont des mots accolés et dont la première lettre de chaque mot est mise en majuscule. Ces mots sont considérés comme des liens vers d'autres pages du wiki, ces autres pages ont ce WikiWord comme nom.

Si un MotWiki ne correspond à aucune page existante, il est affiché en rouge, et vous pouvez cliquer dessus pour créer cette page.

L'expression rationnelle (compatible perl) utilisée pour reconnaître les mots wiki est%%%
(?<![A-Za-z0-9])([A-Z][a-z]+)([A-Z][a-z0-9]*)*([A-Z][a-z0-9]+)(?![A-Za-z0-9])

!!# URL

Vous pouvez mettre des liens vers des pages web en mettant directement l'URL complète dans le texte, par exemple http://www.lilit.be

!!# Autres liens

La façon la plus générale d'écrire des liens est de les mettre entre crochets [[ et ]. Les liens peuvent être des pages du wiki (cela permet de créer des pages dont le nom n'est pas un mot wiki), des pages web, des sites ftp.

Si le fichier pointé par le lien est une image (jpg png ou gif) celle-ci est affichée directement dans la page (sauf si le lien est nommé). Attention, le wiki ne vérifie pas si l'image existe réellement.

!!!# Liens rapides

Les ''liens rapides'' évitent de retaper à la main de longues URL qui sont fréquemment utilisées. pour les utiliser on commence le lien par le mot associé au lien rapide, suivit d'un : (deux-points) et enfin le reste de l'URL.

;
wiki:
:donne l'URL du script du wiki, c'est à dire [wiki:]
;
page:
:est équivalent à wiki:?page=
;
full:
:est équivalent à wiki:?header=full&page=
;
lilit:
:donne l'URL de base du wite de LiLiT, soit [lilit:]

!!!# Liens nommés

La notation entre crochets permet également d'utiliser un texte quelconque pour afficher le lien, pour ce faire, on écrit d'abord le texte suivi d'un caractère | (barre verticale) puis le lien, le tout entre crochets.

N'importe quel lien peut être nommé de cette façon. Si le lien est en fait une image, celle-ci n'est pas insérée mais présentée avec son nom.

Si le nom est un lien vers une image reconnue elle sera insérée dans la page et servira de lien.

!!!# Références

La page d'édition permet également de définir des références pour la page, cela permet de faire des liens numériques comme ça [1]. Une référence peut également être nommée.

Si la référence est un lien vers une image, celle-ci sera affichée sur la page (encore une fois, sauf si le lien est nommé). De plus, une référence vers une image peut servir à nommer un lien, c'est alors l'image pointée par la référence qui est insérée.