我在使用过程中遇到的坑都会列在这里
-
2021-07-30更新
目前不要使用ruby3.0,会导致Jekyll初始化失败,推荐选择ruby2.7来搭建环境 -
2022-08-30更新
文本内不要出现{% 类似于这样 %}
的形式,会被jekyll解析报错
jekyll转义:
方法一:使用”\“(反斜杠)转义
方法二:在两个大括号之间添加一个空格
方法三:使用HTML转义符
方法四:使用raw语法,具体使用如下:
{% raw %} content {% endraw %}
-
2022-10-01更新01
文件命名不要出现类似于2022-01-01-11-11.md
或2022-01-01-pyplot使用简记-matplotlib使用札记01.md
的样式,-
似乎是保留字符串,会导致404错误
也不要出现汉字(一二三四五的一):一
和中文破折号:——
,同样会被解析为-
! -
2022-10-01更新02
当jekyll运行时,不要将头文件复制到新的md文件中再进行修改,会404! -
2022-10-02更新
有时jekyll在本地会抽风404,push之后就不了 -
2022-10-03更新 需要生成目录的话需要在.md文件中加上
* content
{:toc}
- 2022-11-20更新
使用vercel或cloudflare等其它托管时,jekyll的环境需要自己配置,_config.yml里的插件都需要自己安装
例如我在使用vercel时使用了如下command:
gem install jekyll && gem install 'jekyll-feed' && gem install 'jekyll-seo-tag' && gem install 'jemoji' && gem install 'jekyll-paginate
_config.yml包含以下内容:
plugins:
- jekyll-feed
- jekyll-seo-tag
- jemoji
- jekyll-paginate