Les syntaxes de saisie

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.

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

Aller plus loin

Wiki powered by Dokuwiki.