Syntaxe Wiki : mise en forme du texte


Dans cette page, vous apprendrez la syntaxe qui s'applique non seulement aux pages wiki, mais aussi à d'autres supports (comme les articles, les forums et les blogues).

La syntaxe wiki n'est pas valable pour toutes les fonctionnalités. Il existe du reste un projet de publication de la syntaxe en mode RFC (Request for Comments - Demande de commentaires) à l'adresse IETF. Voir le lien suivant : RFCWiki

Les balises de la syntaxe wiki

Les combinaisons (ou balises) utilisées dans une page Wiki constituent la syntaxe wiki. Elles sont formées de caractères communs utilisés d'une façon spécifique. Certaines balises ne s'appliquent qu'en début de ligne et ne nécessitent pas de balise de fermeture. D'autres peuvent être insérées n'importe-où dans le texte, et doivent être accompagnées de la même séquence en tant que balise de fermeture. La balise d'ouverture et la balise de fermeture délimitent la portion de texte à laquelle s'applique la balise.
Dans la plupart des cas, la syntaxe wiki utilise deux fois de suite le même caractère pour les balises d'ouverture et de fermeture délimitant le texte auquel s'applique le formatage. Il arrive toutefois qu'une balise soit constituée de deux caractères différents. Dans ce cas, la balise de fin est constituée des mêmes caractères, mais inversés.
La balise permettant de fixer la taille des caractères est un bon exemple : les caractères Moins (-) Plus (+) indiquent où ça commence, et les caractères Plus (+) et Moins (-) où ça finit.

Les sections suivantes expliquent plus en détail la syntaxe Wiki.

Référence rapide - mise en forme simple du texte

Mise en forme
Caractères utilisés
Exemple
Gras
2 souligné « _ »
__texte__
Centré
2 deux-points « : »
::texte::
Coloré
2 tilde « ~ » ~~blue:texte~~
Italique
guillemets anglais « ' »
''texte''
Taille fixe
moins et plus « - » & « + »
-+text+-
Souligné
3 égal « = »
===text===
Encadré
Un car. "^"
^text^


Mise en forme simple

La syntaxe Wiki présentée dans cette section peut être insérée partout dans le texte pour mettre en exergue (évidence) certains caractères, mots ou passages du texte.

Texte coloré

Le texte peut prendre la couleur que vous désirez. Deux tildes (~) sont suivis du nom en anglais de la couleur et d'un deux-points (:) pour indiquer le début de l'activation de la couleur. Deux autres tildes (~) viennent indiquer le retour à une couleur de base.

Exemple : ~~red:Ce texte est en rouge~~ produit :
Ce texte est en rouge


Le texte coloré peut également être activé en utilisant le code HTML. En HTML, les couleurs sont désignées par une séquence de trois chiffres hexadécimaux. Une paire pour le rouge, une pour le bleu et une pour le vert. Ainsi, 00 00 00 donne blanc. La syntaxe dans ce cas est constituée de deux tildes (~) suivi d'un dièse (#) suivi des paires hexadécimales suivies du deux-points(:), puis du texte qui doit être de cette couleur. Deux tilde (~) viennent clore la coloration du texte.

Exemple : ~~#ff00ff:Ce texte est d'une couleur Magenta ~~ donne :
Ce texte est d'une couleur Magenta


Couleurs HTML recommandées pour le Web (Web Safe) (Cliquez sur le [+] pour ouvrir)

[+]

Texte en gras

Deux caractères soulignement (_) produiront du texte en gras.

Exemple : __Ce texte est en gras__ donne :
Ce texte est en gras


Texte en italique

Deux apostrophes (') produiront du texte en italique.

Exemple : ''Ce texte est en italique' donne :
Ce texte est en italique


Texte souligné

Trois caractères égal (=) produiront du texte souligné.

Exemple : ===Ce texte est souligné=== donne :
Ce texte est souligné


Texte centré

Deux caractères deux-points (:) produiront du texte centré. Le texte peut aussi être centré dans une boîte, une table ou d'autres types d'objets.

Exemple : ::Ce texte est en centré:: donne :
Ce texte est centré


Texte à espacement simple pour du code

Le texte à espacement simple est utile lorsqu'on désire afficher du code et peut être formatté de deux façons. La plus simple est de commencer chaque ligne par un ou plusieurs espaces. La combinaison de signes moins (-) et plus (+) peut aussi être utilisée pour spécifier du texte à espacement simple.

Exemple : -+Ce texte utilise l'espacement simple+- donne :
Ce texte utilise l'espacement simple

Attention: Lorsque vous utilisez l'espacement simple, assurez-vous que les lignes sont courtes. Si une ligne devient trop longue, elle dépassera l'espace d'affichage du navigateur obligeant le défilement horizontal.
Attention: La fonctionnalité d'espacement simple par un caractère d'espace au début de ligne est souvent désactivée sur les sites TikiWiki.

Boîte de texte

Insérez un accent circonflexe au début et un autre à la fin du texte que vous désirez voir encadré.

Exemple : ^Ce texte est encadré^ donne :

Ce texte est encadré


NOTA : Ce style CSS est appelé « simplebox » et peut être différent ou ne pas exister, selon la gestion des thèmes CSS sur votre site.

Décalage

Exemple : ;Saviez-vous que le texte décalé apparaît: ici ?
donne :
Saviez-vous que le texte décalé apparaît
ici ?


Utilisation des crochets

Si vous désirez utiliser les crochets dans votre texte (sans qu'ils soient interprétés comme des liens) ajoutez un crochet conditionnel au début.

Exemple :
[[Ceci ne serait pas un lien]

Donnerait...

[Ceci ne serait pas un lien]

Liens utiles

Espaces insécables

Utilisez ~hs~ pour ajouter un espace insécable correspondant au code HTML «   ».

Syntaxe Wiki : mise en page d'une image

Attention : choisir un nom de fichier qui soit bien caractérisé par rapport à l'article, car toutes les images des articles sont stockées dans le même répertoire. Cela évitera les écrasements accidentels par d'autres personnes. Par exemple, faites figurer vos initiales et le nom du logiciel en plus d'une indication sur la nature de l'image.

  • Images simple
{img src="img/wiki_up/seven1.jpg" }

  • Images miniatures
{THUMB(image=>img/wiki_up/seven1.jpg,max=>600,float=>none)}{THUMB}

Adaptez la valeur max pour avoir la taille de miniature souhaitée.

Sinon, utilisez l'attribut link de la balise img classique, en réduisant la taille de l'image à l'aide de l'attribut width
{img src="img/wiki_up/seven1.jpg" width=300 desc="Légende de votre image" link="img/wiki_up/seven1.jpg" }


  • Images miniatures (galerie de fichiers) et affichage taille réelle par clic
{img src="tiki-download_file.php?fileId=84&thumbnail" alt="" link="tiki-download_file.php?fileId=84&display" rel="shadowbox[g];type=img"}

  • Images miniatures (galerie d'images) et affichage taille réelle par clic
{img src="img/wiki_up/seven3.png?thumbnail" width="400" imalign="right" alt="" link="img/wiki_up/seven3.png?display" rel="shadowbox[g];type=img"}

img srclien vers l'image
thumbnailminiature
widthlargeur de l'image
imalignalignement horizontal (right ou left ou center)
altLégende de l'image
linklien de l'image
rel="shadowbox[g];type=img"affiche l'image de taille réelle et centrée