new - Jekyll en Github Pages: ¿alguna forma de agregar notas al pie en Markdown?

liquid jekyll

Question

Recientemente, cambié a usar Jekyll en Github Pages para mis diversos blogs, y me encanta poder simplemente empujar Markdown a Github y ellos se encargan del procesamiento. Me gustaría continuar usándolo de esta manera (en lugar de ejecutar Jekyll localmente y simplemente enviar el sitio generado previamente a Github), ya que la interfaz de usuario de Github hace que sea más fácil agregar y modificar publicaciones si no estoy en mi propia máquina.

Hay una sola cosa que no he podido entender: no puedo hacer que funcionen las notas al pie de página de Markdown. Estoy usando este estilo:

I bet you''d like more information about this sentence [^1].

[^1]: Well lucky for you, I''ve included more information in footnote form.

Encontré una publicación (en algún lugar) que sugería habilitar una extensión de notas al pie para el procesador de reducción de marcas Redcarpet, pero esto tampoco lo hace:

markdown: redcarpet
redcarpet:
  extensions: ["footnotes"]

¿Hay alguna forma de usar notas al pie de Markdown sin generar previamente el sitio estático antes de enviarlo a Github?

Answer 1

Alfombra roja

Cuando quieres usar redcarpet , parece que no hay una solución conveniente en este momento. Aunque Redcarpet 3 admite notas al pie con la sintaxis que ha usado, no está incluido en Jekyll, porque Redcarpet 3 elimina la compatibilidad con Ruby 1.8 ( source ).

Solución 1: Utilice Redcarpet 2 bifurcado

Vea esta solución por Jerod Santo:

Agregue un archivo llamado Gemfile a la raíz de su carpeta Jekyll con este contenido:

source "https://rubygems.org"

gem "jekyll"
gem "redcarpet", github: "triplecanopy/redcarpet"

o alternativamente djui/redcarpet

Entonces ajuste su _config.yml a

markdown: redcarpet
redcarpet:
  extensions: [footnotes]

Solución 2: Tenedor Jekyll e incluir Redcarpet 3

No sé cuál es la forma más fácil de hacer esto. Los comentarios son bienvenidos.

Maruku

Parece apoyar notas al pie ( source , source ).

Answer 2

A partir de Jekyll 3.0.0, kramdown es el procesador Markdown predeterminado , por lo que el ejemplo en la pregunta de OP ahora funciona de manera inmediata . El patrón es:

Some text[^1].

Some other text[^2].

[^1]: Some footnote.
[^2]: Other footnote.

Answer 3

Uso kramdown para el análisis de rebajas y se maneja bien las notas al pie.

Cambie esta línea en su archivo _config.yml :

markdown: redcarpet

a:

markdown: kramdown