Github页面上的Jekyll:有没有办法在降价中添加脚注?
我最近在我的各种博客的Github页面上使用了Jekyll,我很高兴我可以将Markdown下推到Github上,然后他们就可以处理了。我希望继续以这种方式使用它(而不是在本地运行Jekyll并将预生成的站点推送到Github),因为Github UI可以让我在不在自己的机器上的情况下轻松添加和调整帖子 只有一件事我还没有弄明白:我不能让降价脚注起作用。我使用的是这种风格:Github页面上的Jekyll:有没有办法在降价中添加脚注?,jekyll,github-pages,Jekyll,Github Pages,我最近在我的各种博客的Github页面上使用了Jekyll,我很高兴我可以将Markdown下推到Github上,然后他们就可以处理了。我希望继续以这种方式使用它(而不是在本地运行Jekyll并将预生成的站点推送到Github),因为Github UI可以让我在不在自己的机器上的情况下轻松添加和调整帖子 只有一件事我还没有弄明白:我不能让降价脚注起作用。我使用的是这种风格: I bet you'd like more information about this sentence [^1].
I bet you'd like more information about this sentence [^1].
[^1]: Well lucky for you, I've included more information in footnote form.
我确实在某个地方找到一篇帖子,建议为红毯降价处理器启用脚注扩展,但这也不行:
markdown: redcarpet
redcarpet:
extensions: ["footnotes"]
在将静态站点推送到Github之前,有没有办法不用预先生成静态站点就使用标记脚注?我使用kramdown进行标记解析,它可以很好地处理脚注 在
\u config.yml
文件中更改此行:
markdown: redcarpet
致:
红地毯
当您想使用红地毯时,目前似乎没有方便的解决方案。
尽管使用了您所使用的语法,但它并没有包含在Jekyll中,因为红毯3删除了Ruby 1.8兼容性()
解决方案1:使用分叉红地毯2
见杰罗德·桑托:
使用以下内容将名为Gemfile
的文件添加到Jekyll文件夹的根目录中:
source "https://rubygems.org"
gem "jekyll"
gem "redcarpet", github: "triplecanopy/redcarpet"
或者
然后将\u config.yml
调整为
markdown: redcarpet
redcarpet:
extensions: [footnotes]
解决方案2:叉果冻,包括红地毯3
我不知道最简单的方法是什么。欢迎评论
丸谷
从Jekyll 3.0.0开始,似乎支持脚注(,)。,因此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.
更新日期:2020年1月3日:
- GitHub有自己的标记处理器GFM,它是CommonMark的扩展。kramdown和GFM都可以用于渲染
- 脚注为,这意味着上述示例在GitHub代码库中无法正确呈现
- 克拉姆敦仍然是杰基尔的首选。使用kramdown,上述示例在基于GitHub页面的站点上正确呈现
- @BrockBoland我也非常喜欢你。不幸的是,kramdown可能意味着由``生成的代码块(这里的文本``不'有正确排序的换行符,但我可以用三个tilda来解决这个问题:~~~~在文本前后。这对大多数人来说可能不是问题,但我有很多这样的代码块,因此在标记样式中的更改需要我编辑一些帖子。仅供参考:
扩展:[脚注]
适用于Jekyll 2.2.0(但我不知道它是什么时候添加的),这不是最好的源代码吗?
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.