Syntaxe wiki

Spécifications d'une syntaxe wiki utilisée depuis 2004 pour rédiger le contenu du site et la plupart de mes notes.

Information: 2018-01-22: Pages en cours de fusion et de réécriture.

Projet initié en 2004 afin de rédiger le contenu de ce site web, cette syntaxe wiki est devenue depuis le format de prédilection de la quasi-totalité de mes documents écrits, vu que je passe les 3/4 du temps à lire et/ou écrire des documents web et que le principal logiciel de prise de notes que j'utilise, Zim, fonctionne aussi avec des fichiers formatés en syntaxe wiki.

Les spécifications s'enrichissent au fur et à mesure des besoins mais restent guider par deux impératifs : la cible principale de rendu (le HTML) et les possibilités techniques de les traduire, notamment par le principal outil de gestion en PHP, StxManager.

Elle n'est ni mieux ni moins bien qu'une autre syntaxe wiki ; elle reprend d'ailleurs de nombreuses conventions que l'on retrouve ailleurs, certaines depuis le temps (béni) des emails sans HTML. C'est seulement celle qui m'a permis jusqu'à maintenant d'écrire tout ce que je voulais en gardant 2 objectifs en tête : simplicité et lisibilité.

Documentation

Eléments blocs

Tout élément bloc doit être précédé/suivit d'une ligne vide, à l'exception des éléments « complexes » comme les listes ou les tableaux. Pour créer un paragraphe, il suffit de sauter une ligne. Pour le reste...

Bloc générique

Spécifications

  • Un bloc doit commencer par « [block] ».
  • Toutes les lignes du bloc doivent commencer par 4 espaces (U+0020).

Exemples

[block]
    Block avec un paragraphe.
Bloc simple.
<div>
    <p>Block avec un paragraphe.</p>
</div>
Rendu HTML d'un bloc simple.
[block]
    Block avec un paragraphe.
    
    * Item 1
    * item 2
Bloc avec plusieurs éléments.

°°stx-html°° <div> <p>Block avec un paragraphe.</p> <ul> <li>Item 1</li> <li>Item 2</li> </ul> </div>

Rendu HTML d'un bloc à plusieurs éléments.

Titres

Spécifications

  • Les lignes utilisées doivent au moins posséder 20 caractères.
  • Les titres de niveau 1 sont composé par :
    • Une ligne de signes égal « = » (U+003D).
    • Une ligne portant le texte et considérée comme une collection d'éléments textuels.
    • Une ligne de signes égal « = » (U+003D).
  • Les titres de niveau 2 sont composés par :
    • Une ligne portant le texte et considérée comme une collection d'éléments textuels.
    • Une ligne de signes égal « = » (U+003D).
  • Les titres de niveau 3 sont composés par :
    • Une ligne portant le texte et considérée comme une collection d'éléments textuels.
    • Une ligne de tirets « - » (U+002D).
  • Les titres de niveau 4 sont composés par :
    • Une ligne portant le texte et considérée comme une collection d'éléments textuels.
    • Une ligne de points « . » (U+002E).
  • Les titres de niveau 5 sont composés par :
    • Une ligne portant le texte et considérée comme une collection d'éléments textuels.
    • Une ligne d'apostrophes « ' » (U+0027).

Exemples

=========================================
Titre de niveau 1
=========================================

Titre de niveau 2
=========================================

Titre de niveau 3
-----------------------------------------

Titre de niveau 4
..................

Titre de niveau 5
'''''''''''''''''

Titre de niveau 6
"""""""""""""""""
Syntaxe wiki des titres.

On peut aussi écrire les titres avec une syntaxe en ligne comme celle utilisée par DokuWiki :

====== Titre de niveau 1 ======
===== Titre de niveau 2 =====
==== Titre de niveau 3 ====
=== Titre de niveau 4 ===
== Titre de niveau 5 ==
= Titre de niveau 6 =
Syntaxe wiki alternative des titres.
<h1>Titre de niveau 1</h1>
<h2>Titre de niveau 2</h2>
<h3>Titre de niveau 3</h3>
<h4>Titre de niveau 4</h4>
<h5>Titre de niveau 5</h5>
<h6>Titre de niveau 6</h6>
Rendu HTML de la syntaxe wiki des titres.

Bloc de citation

Spécifications

  • Chaque ligne d'un bloc de citation commence par le caractère « > » (U+003E) suivit d'un espace (U+0020).
  • Le bloc est ensuite traité comme une série d'éléments blocs.
\U+003E\U+0020.+
Syntaxe d'une ligne de bloc de citation.

Examples

> Premier paragraphe de la citation.
> 
> Deuxième paragraphe de la citation.
Syntaxe wiki des blocs de citation.
<blockquote>
    <p>Premier paragraphe de la citation.</p>
    <p>Deuxième paragraphe de la citation.</p>
</blockquote>
Rendu HTML de la syntaxe wiki des citations.

Discussions

Cette notation est celle utilisée dés 1992 par Setext.

Références

Blocs préformatés

Spécifications

Les blocs préformatés sont marqués par des lignes commençant par 4 espaces (U+0020).

\U+0020{4}.+
Syntaxe d'une ligne de block préformaté.

Exemples

    bloc préformaté
    bloc préformaté
Syntaxe wiki des blocs préformatés.
<pre>bloc préformaté
bloc préformaté</pre>
Rendu HTML de la syntaxe wiki des blocs préformatés.

Références

Ressources et références

Historique

2014-01
2013-05
  • add Nouvelles syntaxes pour les listes : (1), (a), 1..
  • add Syntaxe pour les changelog.
  • upd Adoption de la notation « directive » de reStructuredText pour certaines syntaxe (inclusion, table des matières).
2013-03
2012-12
  • upd Les listes supportent des états plié / déplié.
2012-10
2012-09
  • upd Syntaxe des notes, pour coller à la syntaxe markdown.
2012-07
  • add Syntaxe pour les iframes.
  • upd Syntaxe code identique à reStructuredText et markdown.
2012-05
2012-03
2011-08
2011-07
  • upd Nouvelle syntaxe de figure : 4 tirets au lieu de 3.
2011-01
  • upd Syntaxe alternative de titres.
2010-08
  • upd Possibilité d'indenter un bloc dans un élément de description
2010-07
  • upd Nouvelle syntaxe pour figure : encadrée par un triple tiret.
2010-05
  • add Syntaxe pour les références.
2007-02
2006-01
  • upd Tableaux : lignes et cellules préfixées de double pipe.
  • upd Changement pour l'emphase forte : **texte**.
  • upd Changement pour les notes : [ftn].
2005-09
  • upd Syntaxe enrichie par le wiki2xhtml de Dotclear avec le passage au PHP.
  • add Données brutes entourées d'un triple slash.
  • add Attributs d'éléments : °°attributs°°.
  • add ??acronymes??, %%citation%%, --suppression--, ++ajout++.
  • upd Changement pour les images : ((src|alt|width|height)).
  • upd Changement pour le préformaté : indentation de 4 espaces.
2005-04
  • add Listes à puces / ordonnées imbriquées.
  • upd blockquote à plusieurs paragraphes.
2004-12