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 blogs).

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.



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 (~) suivies d'un dièse (#) suivi des paires hexadécimales suivies du deux-points(:), puis du texte qui doit être de cette couleur. Deux tildes (~) viennent clore la coloration du texte.

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.

Texte en italique

Deux apostrophes (') produiront du texte en italique.

Texte souligné

Trois caractères égal (=) produiront du texte 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.

Texte à espacement simple pour du code

Le texte à espacement simple est utile lorsqu'on désire afficher du code et peut être formaté 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.


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 encadrer.

Exemple : ^Ce texte est encadré^ donne :



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

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]

• Le Color Picker II est disponible sur http://www.pagetutor.com/pagetutor/makapage/picker/
• Extension WebDevlopper pour Mozilla Firefox

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 caractérise bien 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 src	lien vers l'image
thumbnail	miniature
width	largeur de l'image
imalign	alignement horizontal (right ou left ou center)
alt	Légende de l'image
link	lien de l'image
rel="shadowbox[g];type=img"	affiche l'image de taille réelle et centrée