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 blocsummary
. - 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é ;-)
1 De Tomek -
J’ai envie de dire que c’est super cool !
2 De Biou -
Super classe! Même plus besoin de tooltips quand on a des disclosures :) Pour l’access, attention à ce que tu autorises dans le summary. Tout ce qui va passer dans le summary va perdre sa sémantique il me semble : les titres, les liens, …
3 De Franck -
Ah oui Biou c’est une limite, en effet ; a priori ça ne sera que du texte simple, sinon il faudra rebasculer sur la syntaxe avec macro.
4 De Biou -
Non mais du texte simple c’est parfait. Il faut éviter de pouvoir faire des trucs très moches justement.
5 De JcDenis -
Je m’incruste ici juste pour dire que je ne peux pas voir le billet suivant (27/10/2021) c’est tout cassé avec une belle page blanche.
6 De JcDenis -
Ah, c’est réparé :p tu peux supprimer mes deux commentaires !
7 De Franck -
M’enfin ? :-)