Tout est dans le détail

Hier, j’insérais un bloc details dans mon billet pour permettre de cacher à l’affichage la solution d’une petite question que je posais, à grand coups de macro html :

///html
<details>
    <summary>Explication…</summary>
///

En fait le code proposé est équivalent à :

///hljs javascript
content = content + (excerpt ? `${excerpt}<hr />` : '');
///

Ce qui ne donnera pas du tout le même résultat que :

///hljs javascript
content = (excerpt ? `${excerpt}<hr />` : '') + content;
///

Vous voyez ?

///html
</details>
///

Et puis je me suis dit que ça serait cool que la syntaxe wiki de Dotclear prenne en charge ce genre de bloc, que je pourrais être amené à utiliser plus fréquemment !

Alors je me suis mis en mode TDD et j’ai commencé à coder les tests unitaires puis ensuite le code du wiki pour obtenir ce que je souhaitais.

Ça sera dans la prochaine version de Dotclear, la 2.20, qui devrait sortir mi-novembre si pas de souci entretemps \o/

La syntaxe retenue est la suivante :

  • Le début du bloc details se fera à l’aide d’un caractère pipe | placé en tout début de ligne et suivi par le texte qui sera intégré dans le bloc summary.
  • La fin du bloc se fera à l’aide du même caractère | placé en tout début de ligne et suivi de rien d’autre
  • Entre les deux, vous mettrez tout ce que vous voudrez, comme pour un billet normal

Exemple avec ce que je mettais hier dans mon billet :

|Explication…
En fait le code proposé est équivalent à :

///hljs javascript
content = content + (excerpt ? `${excerpt}<hr />` : '');
///

Ce qui ne donnera pas du tout le même résultat que :

///hljs javascript
content = (excerpt ? `${excerpt}<hr />` : '') + content;
///

Vous voyez ?
|

Et voilà, ça sera tout de même plus simple :-)

Cerise sur le gâteau, avec un attribut §§open§§ en fin de 1re ligne, ça permettra d’afficher le bloc ouvert plutôt que fermé ;-)

Ajouter un commentaire

Les champs suivis d'un * sont obligatoires

Les commentaires peuvent être formatés en utilisant la syntaxe Markdown Extra.

Ajouter un rétrolien

URL de rétrolien : https://open-time.net/trackback/15141

Haut de page