Skip to content

Migration facilitée de la syntaxe spécifique à SPIP vers Markdown

License

Notifications You must be signed in to change notification settings

nhoizey/spip2markdown

Repository files navigation

SPIP → Markdown

Plugin pour le CMS SPIP facilitant la migration de sa syntaxe spécifique vers Markdown.

Mode d'emploi

  1. Installez et activez le plugin et ses dépendances Saisies et zippeur
  2. Chargez la page d'un article dans le back office
  3. Voilà en colonne de gauche des liens pour voir ou télécharger le contenu de l'article en Markdown — ou plutôt Kramdown, une variante —, avec les méta données présentées dans le YAML Front Matter, ainsi que les éventuelles pièces jointes (images et documents)
  4. Vous pouvez aussi utiliser le filtre |spip2markdown dans vos propres squelettes

Éléments de syntaxe gérés

  • intertitres
  • gras
  • italiques
  • liens, y compris internes vers des articles
  • notes de bas de page
  • codes en ligne et en bloc
  • images
  • documents
  • citations
  • listes ordonnées et non ordonnées, sur plusieurs niveaux

Licence

MIT

To do

  • compléter les éléments de syntaxe manquants (tableaux, etc.)
  • faire des squelettes pour les autres types de contenus (rubriques, brèves, etc.)
  • compléter les liens internes (->rub…, ->doc…, etc.)
  • rendre paramétrables certaines fonctionnalités :
  • forçage du téléchargement (avec nom de fichier prédéfini) vs affichage dans le navigateur
  • présence du YAML Front Matter
  • syntaxe Kramdown ou autre
  • syntaxe très spécifique des vidéos Youtube lazyloadées avec Jekyll Youtube Lazyloading et des embeds de tweets
  • proposer un export global du site en arborescence Jekyll
  • écrire des tests unitaires
  • migrer en textwheel ?