Raccourcis wiki
Tous les wikis proposent des raccourcis qui permettent d'éviter le HTML jugé trop rébarbatif. Le problème est que chaque wiki a sa propre syntaxe et il n'est pas si évident que, par exemple, le sous-titre de niveau 4 de cette page lien interne soit plus facile à écrire en utilsant la syntaxe de MediaWiki (cf WikiPedia) soit !!!!lien interne!!!!, qu'en utilisant la syntaxe HTML standard. Le choix d'en rester au HTML est discutable et on pourra envisager d'introduire progressivement des raccourcis dont le plus agréable serait certainement celui remplaçant la balise retour chariot vraiment laide, qui pourrait être simplement constitué par quatre tirets : ---- . Pour l'instant il a donc été choisi de n'utiliser les raccourcis wiki que dans l'écriture des liens, qui reste non exclusive d'une écriture en pur HTML.
Les raccourcis wiki sont créés en encadrant certaines portions de texte de crochets ou d'accolades ouvrants et fermants. Le moteur wiki se charge de transformer ces expressions en balises HTML proprement formées. Notez que tous les caractères ne sont pas autorisés dans les portions de texte ; la présence d'un caractère non autorisé annule la transformation. Précisions à venir ..., en attendant, le cas échéant, testez jusqu'à ce que le lien soit créé.
lien interne
un lien vers une page du wiki s'écrit en encadrant le "nom de la page" de double crochets ouvrants et fermants, par exemple [[sandbox]] -> sandbox. Si la page existe le lien est coloré en rouge, sinon il est affiché en gris et conduira à l'édition d'une page vide.
lien quelconque
un lien vers une adresse quelconque s'écrit en encadrant l'expression "texte du lien|adresse" de double crochets ouvrants et fermants. Par exemple :
- [[
PIXAR|http://www.pixar.com ]] -> PIXAR - [[
ladybug|data/ladybug.jpg ]] -> ladybug - [[
bac à sable|index.php?page=sandbox ]] -> bac à sable ; noter que dans ce cas il est préférable d'utiliser la syntaxe précédente.
une adresse e-mail s'écrit en encadrant l'expression "nom@domaine" de double crochets ouvrants et fermants : [[
image
un lien vers une image s'écrit en encadrant l'expression "adresse de l'image|hauteur en pixels|infobulle" d'accolades ouvrante et fermante, exemple : {
.
groupe d'images
il est possible de regrouper des images avec un affichage amélioré en séquence. Merci à Loresh Dhakar (et à d'autres) pour les superbes effets d'affichage. L'expression suivante (rappel : parenthèses à remplacer par des accolades) :
[[produit l'affichage suivant :test|[ [ "data/forest1.jpg", "forest 1" ], [ "data/forest2.jpg", "forest 2" ], [ "data/forest3.jpg", "forest 3" ] ]|100 ]]
autres ressources
il est également possible d'insérer d'autres ressources comme les sons et les videos, mais il faudra utiliser la syntaxe HTML, les raccourcis n'apportent pas grand chose de plus. Dans les deux exemples qui suivent les syntaxes sont simplifiées et pour tout dire non conforme aux recommandations XHTML.
- exemple de lien vers une étrange suite musicale de YASUAKI SHIMIZU (mp3/228ko):
- exemple de lien vers une animation (mov/484 ko) :
- exemple de lien vers un fichier vectoriel (SVG) :
- on ne peut pas pour des raisons de sécurité insérer du code Javascript directement dans une page, mais on peut afficher dans un bloc iframe un fichier contenant du javascript :
- on peut également intégrer du flash, et d'autres choses encore ...
en somme
En somme tout est affaire de mesure ! Un tour vers le site wiki.archlinuxfr.org permet de constater qu'on peut vouloir simplifier les choses et les encombrer notablement. Bien sûr le codage HTML n'est pas évident au premier abord, mais il reste simple pour ce qui concerne les choses simples et il a sur toutes les syntaxes wiki de la planète un immense avantage : il est standard et tout le monde peut apprendre à manipuler les balises fondamentales ! Non seulement on est sûr de l'investissement en temps et en effort dans l'apprentissage des balises, mais en outre les pages écrites utilisant les balises HTML sont lisibles directement dans un navigateur hors wiki, les liens utilisant les raccourcis wiki apparaissant simplement entre crochets. A la limite, l'utilisation exclusive des raccourcis wiki pour les liens internes (entre pages du wiki) assure la meilleure portabilité des pages. C'est un choix. Un jour prochain, les éditeurs WYSIWYG intégrés dans les navigateurs nous ramèneront progressivement vers une situation plus conviviale !
le coin du développeur
Liste des caractères autorisés dans les raccourcis wiki :
- traitement des liens internes :
nom_page = 0-9a-zA-Zéèêàâçù .:#'_- - traitement des liens absolus :
nom_page = 0-9a-zA-Zéèêàùâç .:#'_-
URL = 0-9a-zA-Zéèêàùâç .:\/?=#'_- - traitement des adresses mail :
adresse = 0-9a-z._-
arrobase = @
domaine1 = 0-9a-z._-
domaine2 = .ab, deux caractères alpha - traitement des images :
URL_image = 0-9a-zA-Z ./_-
point = .
extension = .jpg, .gif, .png
taille = 0-9 avec + ou -
infobulle = 0-9a-zA-Zéèêàùâç ':.()_- - traitement des groupes d'images
nom_liste = 0-9a-zA-Z_
liste = chaine [ "qq", "qq" ], ..., [ "qq", "qq" ]
taille = 0-9 avec + ou - - traitement des marquages :
marque = ouvert ou invert - affichage de code HTML :
code = chaine quelqconque
Passons à quelques points divers.