Intégrer le contenu d’un fichier markdown dans un article

Attention, il ne s’agit pas d’un tutoriel, mais de mes notes pour faire marcher le schmilblik : n’hésitez pas à commenter et à corriger si nécessaire .Ce n’est peut-être pas la meilleur façon de faire, il y a peut-être des erreurs : n’hésitez pas à commenter et à corriger.

1- Plugin Markdown

Il faut déjà installer le plugin markdown pour SPIP. Il est sur la zone, mais il n’est pas référencé dans les dépôts, il faut donc le récupérer par SVN ou autre : http://zone.spip.org/trac/spip-zone/browser/_plugins_/markdown

2- Modèle <emb> pour les fichiers markdown

Maintenant, il nous faut une variante du modèle emb.html (du plugin Médias) qui sera utilisé automatiquement pour les fichiers markdown. Le modèle de base cherche des variantes de la forme emb_{extension}.html, on va donc créer un nouveau squelette nommé emb_md.html.
Où placer ce squelette ? Logiquement il aurait sa place dans le plugin Markdwon me semble-t-il, mais pour les tests, le dossier des squelettes fera l’affaire.

Dans notre squelette, #FICHIER|contenu_document (ou #ID_DOCUMENT|contenu_document) récupère le contenu du fichier texte.
Ensuite, il faut faire en sorte de placer le texte récupéré entre des balise <span class="base64mdblocs" title="PG1kPi4uLjwvbWQ+"></span>, au moyen du filtre |wrap{<md>}. Ainsi, il sera pris en compte par le parseur markdown.
Après ça, un coup de |propre et le tour est joué.
Ce qui donne au final, en ne gardant que l’essentiel :

<BOUCLE_tous (DOCUMENTS types_documents) {id_document=#ID} {tout}
>[(#FICHIER|contenu_document{#ENV{charset,auto}}|wrap{'<md>'}|propre)]</BOUCLE_tous>

3- Plugin Médias

Il reste un dernier problème à régler : pour l’instant le plugin Médias ne reconnaît pas l’extension .md, par défaut il identifiera ces fichiers comme étant des .m3u (liste de lecture MP3), ce qui va tout fausser.

Ajoutons cette extension dans la table spip_documents_types. C’est notamment là qu’on indique qu’il s’agit d’un type de document qu’on peut intégrer dans le texte, ce qui va nous permettre d’utiliser la balise <emb>.

À noter également le fichier base/typedoc.php qui liste les différents types de fichiers, mais j’ignore son utilité et il ne semble pas avoir d’incidence sur notre problème.

Voilà, à partir de là ça devrait marcher.
Par exemple en prenant les fichiers de tests du plugin markdown en documents joints externes :

• http://zone.spip.org/trac/spip-zone/export/86204/_plugins_/markdown/trunk/lib/parsedown/tests/data/emphasis.md
• http://zone.spip.org/trac/spip-zone/export/86204/_plugins_/markdown/trunk/lib/parsedown/tests/data/em_strong_with_link.md
• http://zone.spip.org/trac/spip-zone/export/86204/_plugins_/markdown/trunk/lib/parsedown/tests/data/atx_heading.md