====== Les syntaxes de saisie ======

Vous pouvez rédiger vos billets à l'aide de la syntaxe wiki ou xhtml. Dans les [[user-preferences|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 [[entries#choisir-le-type-de-saisie|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 [[:glossary#wysiwyg|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.
</note>

=== 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 :
<code>
  * item 1
  ** item 1.1
  ** item 1.2
  * item 2
  * item 3
  *# item 3.1
  ...
</code>

**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 :
<code>
  = item 1 à définir
  : définition de l'item 1
  = item 2 à définir
  : définition de l'item 2
  ...
</code>

**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 <code>''texte''</code>

**Correspondance xhtml :** ''<em>texte</em>''

=== Forte emphase : ===

**wiki :** deux soulignés <code>__texte__</code>

**Correspondance xhtml :** ''<strong>texte</strong>''

=== Retour forcé à la ligne ===

**wiki :** <code>texte.%%%</code>

**Correspondance xhtml :** ''<br />''

=== Insertion ===

**wiki :** deux plus <code>++texte++</code>

**Correspondance xhtml :** ''<ins>texte</ins>''

=== Suppression ===

**wiki :** deux traits d'union <code>--texte--</code>

**Correspondance xhtml :** ''%%<del>texte</del>%%''

=== Exposant ===

**wiki :** un accent circonflexe <code>^texte^</code>

**Correspondance xhtml :** ''%%<sup>texte</sup>%%''

=== Indice ===

**wiki :** un souligné <code>_texte_</code>

**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** :
  * <code>((url|texte alternatif))</code>
  * <code>((url|texte alternatif|position))</code>
  * <code>((url|texte alternatif|position|description longue))</code>
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 :** 
  * <code>{{citation}}</code>
  * <code>{{citation|langue}}</code>
  * <code>{{citation|langue|url}}</code>

**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 :**
<code>
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>
</code>

==== 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 =====

  * [[http://giminik.developpez.com/xhtml/|Toutes les balises xhtml]]
  * [[http://validator.w3.org/|Contrôle de validité xhtml]] (en anglais)