Puisque nous parlons des wiki, nous allons aborder le côté technique et montrer quelques petits trucs et voir comment on écrit en wiki pour créer un nouveau billet dans notre blog.

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. Attention, le principe de la syntaxe wiki est le même partout, mais des variations de balises existent d'un moteur de wiki à l'autre.

Voici la 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 (italique) : deux apostrophes ''texte'' --> texte ;
  • Forte emphase (gras) : deux underscores __texte__ --> texte ;
  • Retour forcé à la ligne : %%% ;
  • Insertion (souligné) : deux plus ++texte++ --> texte;
  • Suppression (barré) : deux traits d'union --texte-- --> 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~ --> lien vers le début de cet article;
  • 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$$ --> [1].

Combiner wiki2xhtml et xhtml

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

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

Liens utiles

Notes

[1] Corps de la note