Jekyll功能扩展(mermaid,MathJax)
在使用Jekyll的过程中会用到一些扩展功能,这里把将这些功能添加到自己博客的步骤归纳在这里
mermaid流程图
首先,mermaid官方文档地址:https://mermaid-js.github.io/mermaid/
先在博客文件中添加mermaid.min.js
文件(按照官方文档内容,可以在https://unpkg.com/browse/mermaid@8.6.0/获取这个文件)。接着在博客根目录的_includes/head.html
文件中添加对该文件的引用即可,比如我这里将mermaid.min.js
放在了/assets/js
文件夹,所以这里添加的引用是:<script src="/assets/js/mermaid.min.js"></script>
然后就可以参照文档内容用mermaid语法绘制各种图了(注意,要用<div class="mermaid"><div>
来包裹),比如这里写一段:
1
2
3
4
<div class="mermaid">
graph LR
获取mermaid.min.js --> 引用到博客 --> 使用mermaid语法画图
</div>
显示效果:
graph LR 获取mermaid.min.js --> 引用到博客 --> 使用mermaid语法画图
其实这里应该有更完美的支持方法,但是这里为了快速有效,就先采用这个方法了
支持MathJax数学公式显示1
首先,在博客的
config.yml
文件中,添加内容:1 2
# Build settings markdown: kramdown
然后,在想要支持
MathJax
的博客上面添加标识:1
usemathjax: true
最后在博客根目录的
_includes/head.html
文件中添加引用,这里利用了之前的标识来决定当前页面是否需要支持MathJax
1
2
3
4
5
6
7
<!-- for mathjax support -->
{% if page.usemathjax %}
<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
{% endif %}
完成上面的步骤之后,我们就可以在添加了标识的博客里面自由使用MathJax
为我们带来的公式显示效果了
比如这里编写一个勾股定理公式:
1
$$a^2+b^2=c^2$$
显示效果:
\[a^2+b^2=c^2\]这个具体方法也是参考了网络上其他人的博客以及
MathJax
官方文档的内容,关于是否使用标识的那一点按自己喜好决定即可 ↩
本文由作者按照 CC BY 4.0 进行授权