orangelop

Jekyll 使用避坑

2022-08-15

我在使用过程中遇到的坑都会列在这里

  • 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.md2022-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

Previous Physics Formulas


Content
Return Click here...