Jekyll sur les Pages Github: un moyen d'ajouter des notes de bas de page dans Markdown?
Je suis récemment passé à l'utilisation de Jekyll sur les Pages Github pour mes différents blogs, et j'aime que je puisse simplement pousser Markdown sur Github et qu'ils gèrent le traitement. Je voudrais continuer à l'utiliser de cette façon (plutôt que d'exécuter Jekyll localement et de simplement pousser le site pré-généré vers Github), puisque L'interface utilisateur Github facilite l'ajout et la modification de messages si Je ne suis pas sur ma propre machine.
Il y a juste une chose que je n'ai pas pu comprendre: Je ne peux pas faire fonctionner les notes de bas de page Markdown. Je suis en utilisant ce style:
I bet you'd like more information about this sentence [^1].
[^1]: Well lucky for you, I've included more information in footnote form.
J'ai trouvé un article (quelque part) qui suggérait d'activer une extension de notes de bas de page pour le processeur redcarpet markdown, mais cela ne le fait pas non plus:
markdown: redcarpet
redcarpet:
extensions: ["footnotes"]
Existe-t-il un moyen d'utiliser des notes de bas de page Markdown sans pré-générer le site statique avant de le pousser vers Github?
3 réponses
J'utilise kramdown pour l'analyse markdown et il gère bien les notes de bas de page.
Modifiez cette ligne dans votre fichier _config.yml:
markdown: redcarpet
À:
markdown: kramdown
Redcarpet
Lorsque vous souhaitez utiliser redcarpet, il ne semble pas y avoir de solution pratique pour le moment.
Bien que Redcarpet 3 supporte les notes de bas de page avec la syntaxe que vous avez utilisée, il n'est pas inclus dans Jekyll, car Redcarpet 3 supprime la compatibilité Ruby 1.8 (source ).
Solution 1: utiliser forked Redcarpet 2
Voir cette solution par Jerod Santo:
Ajoutez un fichier appelé Gemfile à la racine de votre dossier Jekyll avec ceci contenu:
source "https://rubygems.org"
gem "jekyll"
gem "redcarpet", github: "triplecanopy/redcarpet"
, Ou alternativement djui/redcarpet
Puis ajustez votre _config.yml à
markdown: redcarpet
redcarpet:
extensions: [footnotes]
Solution 2: fourchette Jekyll et inclure Redcarpet 3
Je ne sais pas quel est le moyen le plus simple de le faire. Les commentaires sont les bienvenus.
Maruku
Semble prendre en charge les notes de bas de page (source, source).
À partir de Jekyll 3.0.0, kramdown est le processeur Markdown par défaut , donc l'exemple dans la question D'OP fonctionne maintenant hors de la boîte. Le motif est:
Some text[^1].
Some other text[^2].
[^1]: Some footnote.
[^2]: Other footnote.