|
||||||||||||||||
FonctionnementDuWiki > 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.
1. 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: 1.1. Modificateurs ponctuels.Les modificateurs ponctuels n'agissent qu'à l'endroit où ils sont insérés. 1.1.1. retour à la ligne.Insérer trois caractères % (pourcent) accolés produit un saut de ligne à l'endroit où ils sont insérés. 1.1.2. séparateur horizontal.Mettre (au moins) quatre - (tiret) seuls sur une ligne (sans espaces) produit une ligne horizontale de séparation. 1.1.3. Smiley.
Vous pouvez entrer simplement des smiley, et ceux-ci seront remplacés par des petites images correspondantes. 1.1.4. 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. 1.1.4.1. 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é.
1.1.4.2. 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.
1.2. 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!
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__ 1.3. 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. 1.3.1. 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, ... 1.3.1.1. Numérotation.Les titres peuvent être numérotés, il suffit pour cela d'ajouter un # (dièse) directement après les !. 1.3.2. Listes.Les listes sont des styles de ligne qui peuvent être imbriqués. Les types possibles de listes sont:
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é. 1.3.3. 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. 1.3.4. 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. 1.4. 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. 1.4.1. 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 ---- 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.
On termine un tableau par un caractère } (accolade fermante) en début de ligne, le reste de cette ligne est ignoré! 1.4.1.1. 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.
Il y a aussi des options pour changer la couleur de fond du tableau, les couleurs disponibles sont
2. Liens.Il existe plusieurs façons d'insérer des liens dans des pages de wiki. 2.1. 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 2.2. 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 2.3. 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. 2.3.1. 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.
2.3.2. 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. 2.3.3. 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.
Voir le source de cette page
(dernière édition 22/03/2018 12h55 par Réginald Ratz)
[diff])
Version: 34 Arborescence de la page :: Version imprimable :: Liste des pages :: Dernières modifications :: Cacher les commentaires |
||||||||||||||||
![[Wiki]](images/tchantchux.png)
