En fait, le même terme recouvre deux choses bien distinctes, ce qui apporte parfois quelque confusion dans nos esprits égarés de débutants, trois même pour les utilisateurs de DotClear. En voici une explication (très) sommaire.

Un type de site web

Un wiki (de wiki wiki, « rapide » en polynésien), c'est un site web dont la particularité est d'offrir la possibilité à chacun d'éditer les pages et de les modifier. C'est le cas par exemple de Wikipédia, une encyclopédie contributive, ou de la page des Paris Carnet, où chacun peut annoncer sa future participation à nos rencontres mensuelles de blogueurs parisiens, chaque premier mercredi du mois (notez au passage la publicité subliminale d'une grande subtilité).

« LE » wiki de DotClear

Si vous fréquentez le forum de DotClear, vous avez sans doute croisé à plusieurs reprises des messages allusifs type « Tu trouveras ça sur le wiki » ou « Les plugins listés sur le wiki », etc. Il s'agit, comme vous l'aurez deviné à la lecture du paragraphe précédent de l'espace contributif des utilisateurs et acteurs de DotClear. On y trouve de la documentation, des ressources, etc. Il est actuellement en refonte pour enrichir la documentation et améliorer son ergonomie mais reste accessible.

Une syntaxe

Et puis il y a la syntaxe wiki. DotClear embarque dans ses outils un wiki2xhtml qui permet une saisie simplifiée des billets, le moteur se chargeant de la conversion vers XHTML lors de l'affichage dans le blog. Pour ma part, j'utilise systématiquement cette syntaxe, quitte à effectuer après saisie et sauvegarde du billet une conversion vers xhtml (un bouton est prévu à cet effet dans l'éditeur de billet) si j'ai besoin de balises non prévues en wiki.
Attention, si le principe de la syntaxe wiki est le même partout, des variations de balises existent d'un moteur de wiki à l'autre.


Syntaxe Wiki pour DotClear

Les marques de formatage Wiki peuvent être insérées dans le texte en les protégeant par le caractère "\".

Blocs
  • Laisser une ligne vide entre chaque bloc de même nature ;
  • Paragraphe : du texte et une ligne vide ;
  • Titre : !!!, !!, ! pour des titres plus ou moins importants ;
  • Trait horizontal : ---- ;
  • Liste : ligne débutant par * ou #. Il est possible de mélanger les listes (*#*) pour faire des listes de plusieurs niveaux. Respecter le style de chaque niveau ;
  • Texte préformaté : espace devant chaque ligne de texte ;
  • Bloc de citation : > ou ;: devant chaque ligne de texte.
Éléments en ligne
  • La correction de ponctuation est active. Un espace insécable remplacera automatiquement tout espace précédant les marque ";","?",":" et "!". ;
  • Emphase : deux apostrophes ''texte'' ;
  • Forte emphase : deux soulignés __texte__ ;
  • Retour forcé à la ligne : %%% ;
  • Insertion : deux plus ++texte++ ;
  • Suppression : deux traits d'union --texte-- ;
  • Lien : [url], [nom|url], [nom|url|langue] ou [nom|url|langue|titre].
    • Si vous voulez insérer un lien vers une ancre dans la même page, remplacez url par #nom-de-votre-ancre ;
  • Image : ((url|texte alternatif)), ((url|texte alternatif|position)) ou ((url|texte alternatif|position|description longue)).
    • La position peut prendre les valeur L ou G (gauche), R ou D (droite) ou C (centré). ;
  • Ancre : ~ancre~ ;
  • Acronyme : ??acronyme?? ou ??acronyme|titre?? ;
  • Citation : {{citation}}, {{citation|langue}} ou {{citation|langue|url}} ;
  • Code : @@code ici@@ ;
  • Note de bas de page : $$Corps de la note$$.

Combiner wiki2xhtml et xhtml

Depuis sa version 1.2.1, DotClear autorise l'insertion de xhtml dans une saisie en wiki :

Saisie en wiki comme à l'habitude.
///html
<p>Saisie en html.</p>
<p>Ne pas oublier de bien saisir toutes les balises utiles.</p>
///

Quelques liens :
L'entrée “Wiki” de Wikipédia.
wiki2xhtml, la page de son créateur, Olivier Meunier (bah oui ! « notre » Olivier Meunier ;-)
Wiki Custom une page d'aide à la personnalisation pour les utilisateurs de DotClear]. La révolution wiki est en vue, un article du Journal du Net.