Jekyll在Github上的页面:在Markdown中添加脚注的任何方式?

时间:2013-10-20 23:13:25

标签: jekyll github-pages

我最近转而在Github Pages上使用Jekyll为我的各种博客,并且喜欢我可以将Markdown推送到Github并且他们处理这些处理。我想继续以这种方式使用它(而不是在本地运行Jekyll,只是将预先生成的站点推送到Github),因为如果我不在自己的机器上,Github UI可以轻松添加和调整帖子。

只有一件事我无法弄明白:我无法让Markdown脚注工作。我正在使用这种风格:

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

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

我确实找到一个帖子(某个地方)建议为redcarpet降价处理器启用脚注扩展,但这也不是这样做的:

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

在将静态网站推送到Github之前,有没有办法使用Markdown脚注而不预先生成静态网站?

3 个答案:

答案 0 :(得分:58)

我使用kramdown进行降价解析,它可以很好地处理脚注。

_config.yml文件中更改此行:

markdown: redcarpet

为:

markdown: kramdown

答案 1 :(得分:13)

截至Jekyll 3.0.0,kramdown is the default Markdown processor,因此OP问题中的示例现在开箱即用。模式是:

Some text[^1].

Some other text[^2].

The identifier in the square brackets does not have to be numeric[^my_footnote].

[^1]: Some footnote.
[^2]: Other footnote.
[^my_footnote]: This also works fine.

答案 2 :(得分:7)

隆重的接待

如果您想使用redcarpet,现在似乎没有方便的解决方案。 虽然Redcarpet 3 supports footnotes具有您使用的语法,但它不包含在Jekyll中,因为Redcarpet 3删除了Ruby 1.8兼容性(source)。

解决方案1:使用分叉的Redcarpet 2

请参阅Jerod Santo的this solution

使用以下内容将名为Gemfile的文件添加到Jekyll文件夹的根目录:

source "https://rubygems.org"

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

或者djui/redcarpet

Theny将您的_config.yml调整为

markdown: redcarpet
redcarpet:
  extensions: [footnotes]

解决方案2:Fork Jekyll并包含Redcarpet 3

我不知道最简单的方法是什么。欢迎提出意见。

Maruku

似乎支持脚注(sourcesource)。