https://github.com/nhoizey/spip2markdown

Migration facilitée de la syntaxe spécifique à SPIP vers Markdown
https://github.com/nhoizey/spip2markdown

markdown spip spip-plugin

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/nhoizey/spip2markdown
• Owner: nhoizey
• License: mit
• Created: 2015-04-10T21:44:52.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-06-24T14:09:03.000Z (over 2 years ago)
• Last Synced: 2024-10-11T00:19:43.884Z (3 months ago)
• Topics: markdown, spip, spip-plugin
• Language: PHP
• Homepage:
• Size: 31.3 KB
• Stars: 19
• Watchers: 7
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# SPIP → Markdown

Plugin pour le CMS [SPIP](http://spip.net) facilitant la migration de sa syntaxe spécifique vers Markdown.

## Mode d'emploi

1. Installez et activez le plugin et ses dépendances [Saisies](http://plugins.spip.net/saisies.html) et [zippeur](http://plugins.spip.net/zippeur.html)

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](http://kramdown.gettalong.org/syntax.html), une variante —, avec les méta données présentées dans le [YAML Front Matter](http://jekyllrb.com/docs/frontmatter/), 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](https://github.com/erossignon/jekyll-youtube-lazyloading) et des embeds de tweets

- proposer un export global du site en arborescence Jekyll

- écrire des tests unitaires

- migrer en textwheel ?