[SPIP Zone] MarkDown et SPIP

Archives Zone
21

Le 20/05/2019 à 10:28, Cerdic a écrit :

Je fais un nouveau fil parce que les discussions partent dans tous les sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des catégories de plugin.

J'ai reporté les liens et tenté une synthèse de ces fils sur la page
https://contrib.spip.net/convertir-spip-en-md

bisous
JL

JL disait :

> Au passage, le rapprochement avec github va donner de plus en plus envie aux développeurs d'utiliser md.
>
> Dans la logique d'immersion des singularités de SPIP dans le grand bain mondialisé d'inter-développements php,
il sera utile de disposer d'un convertisseur raccourcis-SPIP vers l'un des dialectes md le plus approprié.

Je sais pas si c’est un outil de conversion dont on a besoin ou si c’est de passer vraiment à MD, c’est une vraie question.
Mais pour la conversion on peut soit faire SPIP -> HTML -> MarkDown (il y a une lib MarkDownify que j’utilise dans Newsletters pour générer les versions texte qui marche pas mal)
Soit effectivement écrire un outil de conversion, peut-être en adaptant les wheels de TextWheel pour générer du MD au lieu du HTML, mais peut-être plus simplement en faisant de la substitution de raccourcis, à voir

Eric disait lui:

> Il existe déjà un plugin Markdown pour écrire en md dans SPIP mais je ne sais pas si il fait à aussi une fonction d'export spip vers md.
> Maintenant, j'ai expérimenté md depuis quelques temps, c'est bien... limité.
> J'espère que ce n'est pas la voie qu'on prend…

Je pense au contraire que c’est bien la voie qu’il faudrait prendre. Quelles sont les limites que tu trouves ? Un peu de retex serait bien utile.
Tu parles du MD natif basique, dans un éditeur desktop, ou de l’utilisation de MD dans SPIP avec le plugin SPIP ?
Pour info le plugin SPIP permet d’utiliser MD, en continuant à utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP, et les modèles SPIP.

Je ne sais vois pas trop à quelles limites tu fais allusion…

--
Cédric

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

22

Hello,

N’oubliez pas l’étude comparée des deux syntaxes que j’avais faite :

http://romy.tetue.net/syntaxe-spip-versus-markdown

À retenir : absence de recouvrement des syntaxes : aucun raccourci SPIP ne sert à autre chose dans Markdown et réciproquement.

Si ça peut aider la réflexion :wink:

Le 10 juin 2019 à 09:45, JLuc <jluc@no-log.org> a écrit :

Le 20/05/2019 à 10:28, Cerdic a écrit :

Je fais un nouveau fil parce que les discussions partent dans tous les sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des catégories de plugin.

J'ai reporté les liens et tenté une synthèse de ces fils sur la page
Convertir spip en markdown

bisous
JL

JL disait :

Au passage, le rapprochement avec github va donner de plus en plus envie aux développeurs d'utiliser md.

Dans la logique d'immersion des singularités de SPIP dans le grand bain mondialisé d'inter-développements php,

il sera utile de disposer d'un convertisseur raccourcis-SPIP vers l'un des dialectes md le plus approprié.
Je sais pas si c’est un outil de conversion dont on a besoin ou si c’est de passer vraiment à MD, c’est une vraie question.
Mais pour la conversion on peut soit faire SPIP -> HTML -> MarkDown (il y a une lib MarkDownify que j’utilise dans Newsletters pour générer les versions texte qui marche pas mal)
Soit effectivement écrire un outil de conversion, peut-être en adaptant les wheels de TextWheel pour générer du MD au lieu du HTML, mais peut-être plus simplement en faisant de la substitution de raccourcis, à voir
Eric disait lui:

Il existe déjà un plugin Markdown pour écrire en md dans SPIP mais je ne sais pas si il fait à aussi une fonction d'export spip vers md.
Maintenant, j'ai expérimenté md depuis quelques temps, c'est bien... limité.
J'espère que ce n'est pas la voie qu'on prend…

Je pense au contraire que c’est bien la voie qu’il faudrait prendre. Quelles sont les limites que tu trouves ? Un peu de retex serait bien utile.
Tu parles du MD natif basique, dans un éditeur desktop, ou de l’utilisation de MD dans SPIP avec le plugin SPIP ?
Pour info le plugin SPIP permet d’utiliser MD, en continuant à utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP, et les modèles SPIP.
Je ne sais vois pas trop à quelles limites tu fais allusion…
--
Cédric
----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

-- tetue

23

Je prend la discussion au vol, avec beaucoup de retard

Le lun. 20 mai 2019 à 11:41, JLuc a écrit :

Le 20/05/2019 à 11:17, Eric Lupinacci a écrit :

Hello,

Le lun. 20 mai 2019 à 10:28, Cerdic <cedric@yterium.com mailto:[cedric@yterium.com](mailto:cedric@yterium.com)> a écrit :
Je sais pas si c’est un outil de conversion dont on a besoin ou si c’est de passer vraiment à MD, c’est une vraie
question.

Si SPIP passe natif en md, les anciens raccourcis pourront resteront compréhensibles
(ou en natif comme avec le plugin md actuellement ou en option ou en plugin)
mais pour ne pas disperser les efforts de développement et maintenance,
et bénéficier aussi de tous les devs autour de md
il y aura intérêt rapidement à pouvoir convertir les textes historiques des sites historiques
au format raccourcis en format md.

Je ne sais plus avec qui j’avais eu ce genre de discussion il y a bien des mois, mais mon avis est que la syntaxe de marquage/balisage devrait être géré par plugins… Et que les différentes tables devraient avoir un champ « syntaxe » (ou « format » ? mais je trouve ce mot plus ambigu) dont la valeur serait par défaut « spip » (du moins pour les anciennes installations et en dehors de tout autre plugin, et donc pas besoin de convertir avec le risque de ne pas arriver à prendre en compte les personnalisations). On pourra alors proposer du Markdown ou du Restructuré au même du WikiCreole pourquoi pas ?

Oui attention je parle de mon expérience qui est somme toute limitée avec quelques éditeurs online (CodIMD) et desktop.
La grosse limitation je l’ai vu dans les tableaux où c’est hyper basique : il faut toujours un titre, pas de colspan…

Parmi les dialectes md, je suis tombé sur le multimarkdown qui a une syntaxe enrichie
https://rawgit.com/fletcher/MultiMarkdown-6-Syntax-Guide/master/index.html
http://fletcher.github.io/MultiMarkdown-4/

et qui permet les colspans : http://fletcher.github.io/MultiMarkdown-4/tables

Il me semble que MultiMarkdown, sauf si je confons, est une tentative de fusion rationelle des divers dialectes prédominants… En tout cas, contrairement à ce qu’on peut penser, Markdown est de base très très limité ; et les diverses extensions que j’ai vu ne sont pas entièrement compatibles entre elles, et pourtant aucune n’a vraiment tord dans son interprétation (ça me rappelle la glorieuse époque du BASIC)

En fait, SPIP a été fait pour rédiger du contenu « journalistique » et j’ai l’impression que md est plus fait pour rédiger
du contenu technique.
Oui c’est mon impression aussi, mais les dialectes permettent visiblement plus que la seule doc technique.

Je ne crois même pas que Md ait été conçu dans l’idée de la doc technique (je dirai même que c’était juste une belle synthèse des différentes manière de faire du pure texte dans les mails et les lisez-moi de logiciels) Mail il est vrai que les extensions faites, essentiellement par et pour les forges de codes, ont été pour pallier des manques techniques.

Je suis cependant resté sur ma faim même dans ce cas (doc technique) où j’arrivais à faire mieux avec d’autres balisages.

24

Le lun. 10 juin 2019 à 12:50, tetue@rezo.net a écrit :

Hello,

N’oubliez pas l’étude comparée des deux syntaxes que j’avais faite :

http://romy.tetue.net/syntaxe-spip-versus-markdown

Merci pour cette comparaison complète.

J’y ai retrouvé certaines de mes déceptions Markdown (par exemple les ancres et les notes de bas de page, les liens d’images bien compliqués et le paragraphe indenté qui se transforme en bloc de code…)

Noter que pour les listes, il n’est pas nécessaire de tabuler, mais d’utiliser 2/3/4 blancs (par contre il faut rester cohérent, comme pour le langage Python ou le YAML, sinon le programme d’interprétation derrière peut s’y perdre). Bon, ce n’est pas toujours accessible/évident dans une fenêtre web (mais très agréable quand on peut utiliser son éditeur de texte)

À retenir : absence de recouvrement des syntaxes : aucun raccourci SPIP ne sert à autre chose dans Markdown et réciproquement.

Excellente remarque ! Il serait potentiellement possible d’unir les deux mondes au lieu de juste vouloir migrer de l’un (riche et complet) à l’autre.

Si ça peut aider la réflexion :wink:

Le 10 juin 2019 à 09:45, JLuc <jluc@no-log.org> a écrit :

Le 20/05/2019 à 10:28, Cerdic a écrit :

Je fais un nouveau fil parce que les discussions partent dans tous les sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des catégories de plugin.

J’ai reporté les liens et tenté une synthèse de ces fils sur la page
https://contrib.spip.net/convertir-spip-en-md

bisous
JL

JL disait :

Au passage, le rapprochement avec github va donner de plus en plus envie aux développeurs d’utiliser md.

Dans la logique d’immersion des singularités de SPIP dans le grand bain mondialisé d’inter-développements php,
il sera utile de disposer d’un convertisseur raccourcis-SPIP vers l’un des dialectes md le plus approprié.
Je sais pas si c’est un outil de conversion dont on a besoin ou si c’est de passer vraiment à MD, c’est une vraie question.
Mais pour la conversion on peut soit faire SPIP → HTML → MarkDown (il y a une lib MarkDownify que j’utilise dans Newsletters pour générer les versions texte qui marche pas mal)
Soit effectivement écrire un outil de conversion, peut-être en adaptant les wheels de TextWheel pour générer du MD au lieu du HTML, mais peut-être plus simplement en faisant de la substitution de raccourcis, à voir
Eric disait lui:
Il existe déjà un plugin Markdown pour écrire en md dans SPIP mais je ne sais pas si il fait à aussi une fonction d’export spip vers md.
Maintenant, j’ai expérimenté md depuis quelques temps, c’est bien… limité.
J’espère que ce n’est pas la voie qu’on prend…
Je pense au contraire que c’est bien la voie qu’il faudrait prendre. Quelles sont les limites que tu trouves ? Un peu de retex serait bien utile.
Tu parles du MD natif basique, dans un éditeur desktop, ou de l’utilisation de MD dans SPIP avec le plugin SPIP ?
Pour info le plugin SPIP permet d’utiliser MD, en continuant à utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP, et les modèles SPIP.
Je ne sais vois pas trop à quelles limites tu fais allusion…
–
Cédric

25

Le mar. 11 juin 2019 20:05, j’ai tapuscrit :

Je prend la discussion au vol, avec beaucoup de retard

Le lun. 20 mai 2019 à 11:41, JLuc a écrit :

[…]

Oui attention je parle de mon expérience qui est somme toute limitée avec quelques éditeurs online (CodIMD) et desktop.
La grosse limitation je l’ai vu dans les tableaux où c’est hyper basique : il faut toujours un titre, pas de colspan…

Parmi les dialectes md, je suis tombé sur le multimarkdown qui a une syntaxe enrichie
https://rawgit.com/fletcher/MultiMarkdown-6-Syntax-Guide/master/index.html
http://fletcher.github.io/MultiMarkdown-4/

et qui permet les colspans : http://fletcher.github.io/MultiMarkdown-4/tables

Il me semble que MultiMarkdown, sauf si je confons, est une tentative de fusion rationelle des divers dialectes prédominants…

Confusion ; je pensais à CommonMark qui essaie de faire un boulot comparable à WikiCreole (maintenant supporté par tout wiki qui se respecte, en plus de son propre dialecte) https://commonmark.org/

En tout cas, contrairement à ce qu’on peut penser, Markdown est de base très très limité ; et les diverses extensions que j’ai vu ne sont pas entièrement compatibles entre elles, et pourtant aucune n’a vraiment tord dans son interprétation (ça me rappelle la glorieuse époque du BASIC)

En fait, SPIP a été fait pour rédiger du contenu « journalistique » et j’ai l’impression que md est plus fait pour rédiger
du contenu technique.
Oui c’est mon impression aussi, mais les dialectes permettent visiblement plus que la seule doc technique.

Je ne crois même pas que Md ait été conçu dans l’idée de la doc technique (je dirai même que c’était juste une belle synthèse des différentes manière de faire du pure texte dans les mails et les lisez-moi de logiciels) Mail il est vrai que les extensions faites, essentiellement par et pour les forges de codes, ont été pour pallier des manques techniques.

Je suis cependant resté sur ma faim même dans ce cas (doc technique) où j’arrivais à faire mieux avec d’autres balisages.

Tiens, en lisant la « page d’intro à RTD » <https://docs.readthedocs.io/page/intro/getting-started-with-sphinx.html> ; j’ai suivi le lien vers un « billet d’Eric Holscher en mars 2016 » <http://www.ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/> qui remarquait justement que MD est d’une part limité pour la doc technique (n’ayant pas été pensé pour cela, comme .rst et .adoc, on se retrouve à devoir rajouter du balisage HTML ci et là) et d’autre part trop mal spécifié (ce qui a conduit à diverses saveurs qui sont en fait des dialectes incompatibles) pour être valable pour de la documentation longue (ça convient bien comme remplaçant du BBcode pour les commentaires) et sur du long terme pérennement (les incompatibilités des différentes saveurs font qu’on se retrouve coincé pour convertir)

26

Le 20/05/2019 à 10:28, Cerdic a écrit :

Hello,

Je fais un nouveau fil parce que les discussions partent dans tous les
sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des
catégories de plugin.

(…)

Pour info le plugin SPIP permet d’utiliser MD, en continuant à
utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP,
et les modèles SPIP.

Salut,

je sais pas trop où le signaler, mais le balisage <md> du plugin
Markdown semble incompatible avec l'option d' "Amélioration
typographique des abréviations avec exposants" du plugin OrthoTypo.

Concrètement, si l'option est activée, le d de la balise <md> passe en
exposant, et le texte en Markdown n'est plus traité.

Testé avec un Spip et des plugins à jour, et en local sur un site avec
uniquement les deux plugins.

(merci pour ces super plugins !)

++

--
Cédric

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

27

C’est manifestement orthotypo qui faute et ne devrait pas faire un tel remplacement !

--
Cédric
Le 27 oct. 2019 à 10:52 +0100, ari <ari@rebellyon.info>, a écrit :

Le 20/05/2019 à 10:28, Cerdic a écrit :
> Hello,
>
> Je fais un nouveau fil parce que les discussions partent dans tous les
> sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des
> catégories de plugin.
>
(…)

> Pour info le plugin SPIP permet d’utiliser MD, en continuant à
> utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP,
> et les modèles SPIP.

Salut,

je sais pas trop où le signaler, mais le balisage <md> du plugin
Markdown semble incompatible avec l'option d' "Amélioration
typographique des abréviations avec exposants" du plugin OrthoTypo.

Concrètement, si l'option est activée, le d de la balise <md> passe en
exposant, et le texte en Markdown n'est plus traité.

Testé avec un Spip et des plugins à jour, et en local sur un site avec
uniquement les deux plugins.

(merci pour ces super plugins !)

++

>
>
> --
> Cédric
>
> ----
> spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

28

La version 1.5.0 devait corriger ça sans autre bug si j’ai rien cassé :stuck_out_tongue:

--
Cédric
Le 27 oct. 2019 à 10:52 +0100, ari <ari@rebellyon.info>, a écrit :

Le 20/05/2019 à 10:28, Cerdic a écrit :
> Hello,
>
> Je fais un nouveau fil parce que les discussions partent dans tous les
> sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des
> catégories de plugin.
>
(…)

> Pour info le plugin SPIP permet d’utiliser MD, en continuant à
> utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP,
> et les modèles SPIP.

Salut,

je sais pas trop où le signaler, mais le balisage <md> du plugin
Markdown semble incompatible avec l'option d' "Amélioration
typographique des abréviations avec exposants" du plugin OrthoTypo.

Concrètement, si l'option est activée, le d de la balise <md> passe en
exposant, et le texte en Markdown n'est plus traité.

Testé avec un Spip et des plugins à jour, et en local sur un site avec
uniquement les deux plugins.

(merci pour ces super plugins !)

++

>
>
> --
> Cédric
>
> ----
> spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

29

Le 27/10/2019 à 13:10, Cerdic a écrit :

La version 1.5.0 devait corriger ça sans autre bug si j’ai rien cassé :stuck_out_tongue:

Merci !

autre petit bug repéré au moment de rédiger une petite doc : la balise
<md> ne peut pas être mise entre balises <code></code>.

<code><md>…</md></code> donne <span class="base64mdblocs"
title="PG1kPuKApjwvbWQ+"></span>

--
Cédric
Le 27 oct. 2019 à 10:52 +0100, ari <ari@rebellyon.info>, a écrit :

Le 20/05/2019 à 10:28, Cerdic a écrit :

Hello,

Je fais un nouveau fil parce que les discussions partent dans tous les
sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des
catégories de plugin.

(…)

Pour info le plugin SPIP permet d’utiliser MD, en continuant à
utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP,
et les modèles SPIP.

Salut,

je sais pas trop où le signaler, mais le balisage <md> du plugin
Markdown semble incompatible avec l'option d' "Amélioration
typographique des abréviations avec exposants" du plugin OrthoTypo.

Concrètement, si l'option est activée, le d de la balise <md> passe en
exposant, et le texte en Markdown n'est plus traité.

Testé avec un Spip et des plugins à jour, et en local sur un site avec
uniquement les deux plugins.

(merci pour ces super plugins !)

++

--
Cédric

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

30

ah oui mais ça c’est plus compliqué et je vais pas pouvoir le corriger à la volée.
Peux-tu mettre le détail dans une issue sur Issues · Cerdic/markdown · GitHub ?

Il faut que je prenne le temps de faire une mise à jour du plugin, de la lib parsedown, de vérifier les tests unitaires et la compat 3.3, donc comme ça j’oublierai pas de regarder ce bug !
Mets un &# au lieu du < en attendant peut-être ?

--
Cédric
Le 27 oct. 2019 à 13:35 +0100, ari <ari@rebellyon.info>, a écrit :

Le 27/10/2019 à 13:10, Cerdic a écrit :
> La version 1.5.0 devait corriger ça sans autre bug si j’ai rien cassé :stuck_out_tongue:

Merci !

autre petit bug repéré au moment de rédiger une petite doc : la balise
<md> ne peut pas être mise entre balises <code></code>.

<code><md>…</md></code> donne <span class="base64mdblocs"
title="PG1kPuKApjwvbWQ+"></span>

>
> --
> Cédric
> Le 27 oct. 2019 à 10:52 +0100, ari <ari@rebellyon.info>, a écrit :
> > Le 20/05/2019 à 10:28, Cerdic a écrit :
> > > Hello,
> > >
> > > Je fais un nouveau fil parce que les discussions partent dans tous les
> > > sens, mais je réagis à 2 mails de JLuc et Eric sur le fil des
> > > catégories de plugin.
> > >
> > (…)
> >
> > > Pour info le plugin SPIP permet d’utiliser MD, en continuant à
> > > utiliser les raccourcis de lien SPIP, les notes de bas de page SPIP,
> > > et les modèles SPIP.
> >
> >
> > Salut,
> >
> > je sais pas trop où le signaler, mais le balisage <md> du plugin
> > Markdown semble incompatible avec l'option d' "Amélioration
> > typographique des abréviations avec exposants" du plugin OrthoTypo.
> >
> > Concrètement, si l'option est activée, le d de la balise <md> passe en
> > exposant, et le texte en Markdown n'est plus traité.
> >
> > Testé avec un Spip et des plugins à jour, et en local sur un site avec
> > uniquement les deux plugins.
> >
> > (merci pour ces super plugins !)
> >
> > ++
> >
> >
> >
> >
> > >
> > >
> > > --
> > > Cédric
> > >
> > > ----
> > > spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone
> >
> >
> >
> > ----
> > spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone
>
> ----
> spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone