如何使用 Jekyll 搭建博客?

Jekyll 官方中文文档 写的太好了!!!我就不再重复的写一遍了。

但是呢?这篇文章不能到这里就完了,我要和你聊聊使用过程中的坑!

1 速度慢

上文中的官方文档我不知道你能不能直接访问,反正在我写这篇文章时是需要科学的方法才能上的。

其次在安装好 bundlegem 之后,使用它们的安装和更新其他包是及其慢的,建议更换源。

1
2
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
bundle config mirror.https://rubygems.org https://gems.ruby-china.com

请参考 ruby-china

2 依赖版本问题

当你在一个新的 jekyll 项目文件夹下时,需要安装相关依赖:

1
bundle install

此时如果你直接运行jekyll s 就有可能出现版本问题。需要你手动的卸载其他包才能运行。

1
gem uninstall $package_name

截止选择你要卸载的版本,重复上述步骤直至没有错误出现。

3 Tips

添加 jekyll-admin

在 Gemfile 中添加

1
gem 'jekyll-admin', group: :jekyll_plugins

然后在主目录下运行

1
bundle install

添加 LaTex 公式支持

1
2
3
4
5
6
7
8
# 找到你的主题包的位置,我们这里使用的是 minima
bundle show minima

# 先进入主题目录,我们这里假设是 $minima_dir,实际使用请替换
cd $minima_dir

# 接着拷贝出 _layouts/default.html 到你的项目相同目录下,如果没哟的话就新建 _laytouts 文件夹
cp $minima_dir/_layouts/default.html $your_project_dir/_layouts/default.html

接着打开 default.html ,在 <body> 标签之后,加入:

1
2
3
4
<script src="https://cdn.bootcss.com/mathjax/2.7.5/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({tex2jax: {inlineMath: [['$', '$']]}, messageStyle: "none"});
</script>

搞定!

试试在文章中加入 LaTeX 数学公式吧,比如输入:$\sigma^2$,它就会显示成:$\sigma^2$。

4 问题

1
2
3
4
5
# question
WARN: Unresolved specs during Gem::Specification.reset:

# solution
bundle clean --force

5 资料

作者

Ailln

发布于

2017-10-25

更新于

2024-03-02

许可协议

评论