如何更有效地将脚注插入到Hexo帖子中?

时间:2016-04-19 16:39:20

标签: markdown hexo footnotes

我一直试图在我的Hexo帖子中插入脚注(用Markdown编写,如果他们的标记语言相关)。我来自使用Jekyll为我的网站提供动力的背景,当我使用Jekyll时,我会添加[^n](其中n是正整数,即n∈{1,2,3,...})in文字和类似的东西:

[^1]: footnote #1
[^2]: footnote #2
[^3]: footnote #3
...

在帖子的末尾,footnote #1#2#3被替换为我的实际脚注。虽然Hexo的东西看起来有点复杂。我在https://hexo.io/plugins/查找了一个脚注插件,但我没有成功添加,然后我使用Google搜索答案并找到了这个要点https://gist.github.com/kuanyui/d1728c2a526a615de56c。我试图通过将它添加到我的Hexo网站的script文件夹来使用这个要点,但是这个失败了(有关完整的错误详细信息,请参阅要点,因为我在那里评论了详细信息)。然后,我通过检查我的Jekyll帖子的生成内容尝试了一个HTML技巧,该帖子通过上述方法添加了脚注。即,添加:

<sup id="fnref:n"><a href="#fn:n" class="footnote">n</a></sup>

(其中n又是正整数)在文本中我希望我的脚注出现并且:

<ol>
  <li id="fn:1">Footnote #1.<a href="#fnref:1" class="reversefootnote">↩</a></li>
  <li id="fn:2">Footnote #2.<a href="#fnref:2" class="reversefootnote">↩</a></li>
  <li id="fn:3">Footnote #3.<a href="#fnref:3" class="reversefootnote">↩</a></li>
  ...
</ol>

到帖子的结尾。问题是这种方法虽然有效,但也很繁琐(即每个脚注需要比我想要的更多的打字),所以我尝试创建这个ejs模板(对应于文本脚注),我放在我的layouts文件夹中,名称为footnotes.ejs

<sup id ="fnref:<%= n %>"><a href="#fn:<%= n %>"><%= n %></a></sup>

并将其插入我的帖子中:

<%- include('layouts/footnotes', {n:1}); %>

但是这也失败了(失败了,我的意思是当我生成我的hexo网站时,这个文本引文完全没有格式化)。

所以我在这里要求一种更有效的方法将脚注插入Hexo帖子。即每个脚注尽可能少打字的人。

1 个答案:

答案 0 :(得分:6)

我刚创建了一个支持markdown脚注的hexo-plugin:

因此,您只需使用

安装软件包
npm install hexo-footnotes --save

如果Hexo自动检测所有插件,那就是全部。

如果不是这种情况,请在_config.yml文件中注册插件:

plugins:
  - hexo-footnotes

以下是语法

basic footnote[^1]
here is an inline footnote[^2](inline footnote)
and another one[^3]
and another one[^4]

[^1]: basic footnote content
[^3]: paragraph
footnote
content
[^4]: footnote content with some [markdown](https://en.wikipedia.org/wiki/Markdown)

结果如下

footnotes