, 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.
Syntaxe wiki et correspondances xhtml
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.
Éléments de bloc
Blocs
wiki : Laissez une ligne vide entre chaque bloc de même nature.
Paragraphes
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>
Titres
wiki : !!! titre, !! titre ou ! titre pour des titres plus ou moins importants
Correspondance xhtml :
-
!!!!!Titre →
<h1>Titre</h1> -
!!!!Titre →
<h2>Titre</h2> -
!!!Titre →
<h3>Titre</h3> -
!!Titre →
<h4>Titre</h4> -
!Titre →
<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.
Trait horizontal
wiki : —- (quatre traits d’union isolés sur une ligne)
Correspondance xhtml : <hr />
Listes
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>
Listes de définition
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>
Texte préformaté
wiki : espace avant chaque ligne de texte.
Correspondance xhtml : <pre>lignes de texte préformaté</pre>
Bloc de citation :
wiki : > devant chaque ligne de texte.
Correspondance xhtml : <blockquote><p>Les paragraphes de la citation.</p></blockquote>
Bloc de côté :
wiki : ) devant chaque ligne de texte.
Correspondance xhtml : <aside><p>Les paragraphes du bloc de côté.</p></aside>
Éléments de formatage
Emphase
wiki : deux apostrophes
''texte''
Correspondance xhtml : <em>texte</em>
Forte emphase :
wiki : deux soulignés
__texte__
Correspondance xhtml : <strong>texte</strong>
Retour forcé à la ligne
wiki :
texte.%%%
Correspondance xhtml : <br />
Insertion
wiki : deux plus
++texte++
Correspondance xhtml : <ins>texte</ins>
Suppression
wiki : deux traits d’union
--texte--
Correspondance xhtml : <del>texte</del>
Exposant
wiki : un accent circonflexe
^texte^
Correspondance xhtml : <sup>texte</sup>
Indice
wiki : un souligné
_texte_
Correspondance xhtml : <sub>texte</sub>
Liens
wiki :
-
[url]
-
[nom|url]
-
[nom|url|langue]
-
[nom|url|langue|titre]
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>
Images
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)
Ancre
wiki : ~ancre~
Correspondance xhtml : <a name="ancre"></a>
Acronyme
wiki : ??acronyme|titre??
Correspondance xhtml : <acronym title="titre">acronyme</acronym>
Citation en ligne
wiki :
-
{{citation}} -
{{citation|langue}} -
{{citation|langue|url}}
Correspondance xhtml :
-
<q>citation</q> -
<q lang="fr">citation</q> -
<q lang="fr" cite="url">citation</q>
Code
wiki : @@code ici@@
correspondance xhtml : <code>code ici</code>
Note de bas de page
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>
Compléments
Empêcher le formatage du texte
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\]
Insérer du code HTML au sein de la syntaxe wiki
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