Skriv Markup Language

Il y a quelques temps, j’ai écrit un article au sujet des syntaxes wiki-like de Creole et Markdown. Au fil des commentaires, j’ai expliqué que j’avais développé ma propre syntaxe, principalement inspirée par Creole.

J’ai récemment développé un outil de gestion de projets, interne à mon entreprise. Je l’ai nommé Skriv, du nom de mon projet-arlésienne. Je ne désespère d’ailleurs pas d’en faire une version open-source que je pourrais publier ; ça en vaudrait la peine, je suis très fier du résultat − mais j’aurais l’occasion de vous en reparler sur ce blog.

Bref, au sein de ce projet, j’ai fait évoluer ma syntaxe wiki. L’interpréteur est développé sur la base de la bibliothèque WikiRenderer, créée par Laurent Jouanneau. Je vais bientôt publier cet interpréteur, mais pour le moment je vais surtout présenter les éléments de la syntaxe.

À terme, je pense mettre en place un site dédié, avec une explication détaillée de chaque éléments de la syntaxe (et des raisons qui ont conduit à chaque choix), et un système d’extension permettant d’ajouter des nouvelles fonctionnalités.

Base

Styles de base

Skriv Résultat Origine

**gras**

gras txt2tags, Creole

''italique''

italique MediaWiki

--barré--

barré txt2tags

__souligné__

souligné txt2tags, Creole

##monospace##

monospace Creole, AsciiDoc

texte ^^exposant^^

texte ^exposant Creole

texte ,,indice,,

texte _indice Creole

Titres

Skriv HTML généré Origine

=Titre 1
==Titre 2
===Titre 3
====Titre 4
=====Titre 5
======Titre 6

<h1>Titre 1</h1>
<h2>Titre 2</h2>
<h3>Titre 3</h3>
<h4>Titre 4</h4>
<h5>Titre 5</h5>
<h6>Titre 6</h6>

Creole

=Titre 1=
==Titre 2==
===Titre 3===
====Titre 4====
=====Titre 5=====
======Titre 6======

<h1>Titre 1</h1>
<h2>Titre 2</h2>
<h3>Titre 3</h3>
<h4>Titre 4</h4>
<h5>Titre 5</h5>
<h6>Titre 6</h6>

txt2tags, MediaWiki, Creole

Blocs de texte

Paragraphes

Skriv Résultat Origine

Une ou plusieurs lignes de
texte forment un paragraphe.
Les paragraphes sont séparés
par une ligne vide.

Au sein d'un
paragraphe,
les retours-
chariots sont
préservés.

Une ou plusieurs lignes de texte forment un paragraphe. Les paragraphes sont séparés par une ligne vide.

Au sein d’un
paragraphe,
les retours-
chariots sont
préservés.

Markdown Extra

Texte préformaté

Skriv Résultat Origine

 il suffit d'au moins un
 espace **au début** de ''chaque ligne''

il suffit d'au moins un
espace au début de chaque ligne

MediaWiki

[[[
les triples crochets
fonctionnent aussi,
mais la **syntaxe wiki**
n'est pas ''interprétée''
]]]

les triples crochets
fonctionnent aussi,
mais la **syntaxe wiki**
n'est pas ''interprétée''

Skriv

Blocs de texte stylisés

Paragraphes avec classes CSS

Skriv Résultat Origine

{{{justify italic
Cette syntaxe permet de
spécifier une ou plusieurs
classes CSS.

Le style s'applique à tous
les paragraphes concernés.
}}}

Cette syntaxe permet de spécifier une ou plusieurs classes CSS.

Le style s’applique à tous les paragraphes concernés.

Skriv

{{{italic
Il est possible d'imbriquer les
blocs stylisés.
{{{bold
Ce qui peut être très pratique.
{{{blue
Mais un peu difficile à lire.
}}}
}}}
{{{ {{{ underline
Pour faciliter la lecture, il est
possible d'ajouter des accolades
ouvrantes et fermantes.
}}} }}}
C'est quand même mieux.
}}}

Il est possible d’imbriquer les blocs stylisés.

Ce qui peut être très pratique.

Mais un peu difficile à lire.

Pour faciliter la lecture, il est possible d’ajouter des accolades ouvrantes et fermantes.

C’est quand même mieux.

Skriv

Code source

Skriv Résultat Origine

[[[php
$a = 12;
]]]

$a = 12;

Skriv

Éléments avancés

Listes

Skriv Résultat Origine

* liste à points
* élément 2
** sous-élément

• liste à points
• élément 2
  • sous-élément

Creole / MediaWiki

# liste numérotée
# élément 2
## sous-élément

1. liste numérotée
2. élément 2
   1. sous-élément

Creole / MediaWiki

Liens

Skriv Résultat Origine

http://skriv.org

http://skriv.org Skriv

ftp://tres.longue.url.com/vraiment/tres/longue

ftp://tres.longue.url.com/vraiment/tres/… Skriv

amaury@amaury.net

amaury@amaury.net Skriv

[[http://skriv.org]]

http://skriv.org Creole

[[http://tres.longue.url.com/vraiment/tres/longue]]

http://tres.longue.url.com/vraiment/tres… inspiré de Creole

[[Skriv|http://skriv.org]]

Skriv inspiré de Creole et de Markdown

**''[[Skriv|http://skriv.org]]''**

Skriv Creole

[[Un ''lien'' **génial**|http://skriv.org]]

Un lien génial Skriv

Images

Skriv Résultat Origine

{{http://www.comprendrechoisir.com/img/logoPJ.png}}

inspiré de Creole

{{PagesJaunes|http://www.comprendrechoisir.com/img/logoPJ.png}}

inspiré de Creole

Tableaux

Skriv Résultat Origine

!! titre 1 !! titre 2
|| cell 1  || cell 2
|| cell 3  || cell 4

Skriv

titre 1 titre 2
cell 1 cell 2 cell 3 cell 4

Séparations horizontales

Skriv HTML généré Origine

----

(au moins 4 tirets ; que des tirets sur la ligne)

<hr />

Creole

Citations

Skriv Résultat Origine

> texte citation qui respecte les
paragraphes
>
> comme d'habitude

texte de citation qui respecte les paragraphes

comme d'habitude

Markdown

Notes de bas de page

Skriv Résultat Origine

texte ((note de bas de page))

texte ¹

1. note de bas de page

Skriv

texte ((titre|note de bas de page))

texte ^titre
titre. note de bas de page Skriv

texte ((lien vers [[Skriv|http://skriv.org]]))

texte ³

3. lien vers Skriv

Skriv

Abréviations

Skriv Résultat Origine

??OABP|Open AddressBook Protocol??

OABP WikiRenderer

Smileys

:-) ☺

:-( ☹

:-D 😃

:-p 😋

:-| 😐

;-) 😉

:-o 😲

:-x 😶

:'-( 😥

:-@ 😠

:-* 😘

:sun: ☀

:cloud: ☁

:umbrella: ☂

:star: ★

:phone: ☎

:check: ✔

:mult: ✖

:plus: ✚

:skull: ☠

:radioactive: ☢

:biohazard: ☣

:peace: ☮

:yinyang: ☯

:moon: ☽

:square: ■

:circle: ●

:triangle: ▲

:arrow: ➔

:arrowhead: ▶

:bullet: ◉

:love: ♥

:heart:

:spade: ♠

:diamond: ♦

:club: ♣

:note: ♩

:recycle: ♻

:_1_: ➊

:_2_: ➋

:_3_: ➌

:_4_: ➍

:_5_: ➎

:_6_: ➏

:_7_: ➐

:_8_: ➑

:_9_: ➒

:_10_: ➓

:_11_: ⓫

:_12_: ⓬

:_13_: ⓭

:_14_: ⓮

:_15_: ⓯

:_16_: ⓰

:_17_: ⓱

:_18_: ⓲

:_19_: ⓳

:_20_: ⓴

:dice1: ⚀

:dice2: ⚁

:dice3: ⚂

:dice4: ⚃

:dice5: ⚄

:dice6: ⚅

:flag: ⚑

:scale: ⚖

:atom: ⚛

:warning: ⚠

/!\

:clock: ⌚

:command: ⌘

:hourglass: ⌛

:enter: ⎆

:infinity: ∞

:_1/2_: ½

:_1/3_: ⅓

:_2/3_: ⅔

:_1/4_: ¼

:_3/4_: ¾

:_1/5_: ⅕

:_2/5_: ⅖

:_3/5_: ⅗

:_4/5_: ⅘

:_A_: Ⓐ

:_B_: Ⓑ

:_C_: Ⓒ

:_D_: Ⓓ

:_E_: Ⓔ

:_F_: Ⓕ

:_G_: Ⓖ

:_H_: Ⓗ

:_I_: Ⓘ

:_J_: Ⓙ

:_K_: Ⓚ

:_L_: Ⓛ

:_M_: Ⓜ

:_N_: Ⓝ

:_O_: Ⓞ

:_P_: Ⓟ

:_Q_: Ⓠ

:_R_: Ⓡ

:_S_: Ⓢ

:_T_: Ⓣ

:_U_: Ⓤ

:_V_: Ⓥ

:_W_: Ⓦ

:_X_: Ⓧ

:_Y_: Ⓨ

:_Z_: Ⓩ