Vous pouvez rédiger vos billets à l'aide de la syntaxe wiki ou xhtml. Dans les Préférences utilisateur vous déterminerez la syntaxe utilisée par défaut. Celle-ci peut être différente pour un billet particulier en choisissant la syntaxe depuis le petit menu déroulant figurant dans le menu d'édition du billet.
Une présentation synthétique de la description ci-dessous est disponible dans l'aide de l'éditeur de billets.
Présentation : A l'aide de balises simples, la syntaxe wiki permet d'enrichir la présentation sans connaissances particulières. Ces balises sont ensuite interprétées par le moteur du blog et converties en xhtml. Si vous ne maîtrisez pas parfaitement le xhtml et n'utilisez pas le mode wysiwyg il est fortement recommandé d'utiliser le wiki pour éviter ainsi tout risque d'erreur qui risquerait de générer des dysfonctionnement de l'affichage du blog.
wiki : Laissez une ligne vide entre chaque bloc de même nature.
wiki : texte libre, terminé par une ligne vide si suivi d'un second paragraphe.
Correspondance xhtml : <p>Le premier paragraphe.</p><p>Le deuxième paragraphe.</p>
wiki : !!! titre, !! titre ou ! titre pour des titres plus ou moins importants
Correspondance xhtml :
<h1>Titre</h1><h2>Titre</h2><h3>Titre</h3><h4>Titre</h4><h5>Titre</h5>Note :
le niveau <h1> étant déjà utilisé pour le titre du blog et le niveau <h2> pour le titre des billets, il est recommandé de n'utiliser que les niveaux h3 et inférieurs au sein des billets.wiki : —- (quatre traits d'union isolés sur une ligne)
Correspondance xhtml : <hr />
wiki : lignes débutant par * pour des listes à puce ou # pour des listes numérotées
Vous pouvez faire des listes imbriquées en mélangeant les codes de liste. Par exemple :
* item 1 ** item 1.1 ** item 1.2 * item 2 * item 3 *# item 3.1 ...
Correspondance xhtml de l'exemple ci-dessus :
<ul>
<li>item 1
<ul>
<li>item 1.1</li>
<li>item 1.1</li>
</ul></li>
<li>item 2</li>
<li>item 3
<ol>
<li>item 3.1</li>
</ol></li>
</ul>
wiki : ligne débutant par = pour le terme à définir et par : pour la définition du terme.
Exemple :
= item 1 à définir : définition de l'item 1 = item 2 à définir : définition de l'item 2 ...
Correspondance xhtml de l'exemple ci-dessus :
<dl> <dt>item 1 à définir</dt> <dd>définition de l'item 1</dd> <dt>item 2 à définir</dt> <dd>définition de l'item 2</dd> </dl>
wiki : espace avant chaque ligne de texte.
Correspondance xhtml : <pre>lignes de texte préformaté</pre>
wiki : > devant chaque ligne de texte.
Correspondance xhtml : <blockquote><p>Les paragraphes de la citation.</p></blockquote>
wiki : ) devant chaque ligne de texte.
Correspondance xhtml : <aside><p>Les paragraphes du bloc de côté.</p></aside>
wiki : deux apostrophes
''texte''
Correspondance xhtml : <em>texte</em>
wiki : deux soulignés
__texte__
Correspondance xhtml : <strong>texte</strong>
wiki :
texte.%%%
Correspondance xhtml : <br />
wiki : deux plus
++texte++
Correspondance xhtml : <ins>texte</ins>
wiki : deux traits d'union
--texte--
Correspondance xhtml : <del>texte</del>
wiki : un accent circonflexe
^texte^
Correspondance xhtml : <sup>texte</sup>
wiki : un souligné
_texte_
Correspondance xhtml : <sub>texte</sub>
wiki :
Correspondance xhtml :
<a href="url-cible">url-cible</a><a href="url-cible">nom</a><a href="url-cible" hreflang="fr">nom</a><a href="url-cible" hreflang="fr" title="titre">nom</a>wiki :
((url|texte alternatif))
((url|texte alternatif|position))
((url|texte alternatif|position|description longue))
La position peut prendre les valeurs L ou G (gauche), R ou D (droite) ou C (centré).
Correspondance xhtml :
<img src="url" alt="texte alternatif" /><img src="url" alt="texte alternatif" style="display:block; float:left; margin:0 1em 1em 0" /> (si position : L ou G)<img src="url" alt="texte alternatif" style="display:block; float:right; margin:0 0 1em 1em" longdesc="description longue" /> (si position : R ou D)wiki : ~ancre~
Correspondance xhtml : <a name="ancre"></a>
wiki : ??acronyme|titre??
Correspondance xhtml : <acronym title="titre">acronyme</acronym>
wiki :
{{citation}}
{{citation|langue}}
{{citation|langue|url}}
Correspondance xhtml :
<q>citation</q><q lang="fr">citation</q><q lang="fr" cite="url">citation</q>wiki : @@code ici@@
correspondance xhtml : <code>code ici</code>
wiki : texte$$Corps de la note$$
Correspondance xhtml :
texte<sup>[<a href="url-blog#pnote-xxx-x" id="rev-pnote-xxx-x">x</a>]</sup> (...) <div class="footnotes"><h4>Notes</h4> <p>[<a href="url-blog/#rev-pnote-xxx-x" id="pnote-xxx-x">x</a>] Corps de la note</p></div>
Pour insérer un caractère sans que celui-ci soit reconnu comme un caractère de formatage, ajoutez le caractère \ avant celui-ci. Par exemple :
\[texte entre crochet qui n'est pas un lien\]
Vous pouvez ponctuellement avoir besoin d'insérer du code HTML dans votre texte au format Wiki. Pour cela, utilisez le code suivant en laissant une ligne vide avant et après cette insertion :
///html <p style="color:red;">mon texte en rouge</p> ///
Pour insérer du code HTML dans le courant d'un paragraphe en Wiki (inline), il faut utiliser la syntaxe suivante :
Début du paragraphe, ``<span style="color:blue;">Plop</span>``, fin du paragraphe
Wiki powered by Dokuwiki.