jekyll - Jekyll 的 github-pages gem 的 'gist' 标签的液体语法错误

Question

我有一个托管在 Github Pages 上的 Jekyll 网站。我试图在推送到 Github 之前让我的网站在本地呈现，但在运行 bundle exec jekyllserve --safe 时出现以下错误:

Liquid Exception: Liquid syntax error (line 13): Unknown tag 'gist'

我的_config.yml包含以下内容(除其他外):

gems:
  - jekyll-gist

我的Gemfile如下:

source 'https://rubygems.org'
gem 'github-pages'

并且 bundle show jekyll-gist 显示已安装的 gem 的路径。

我被难住了!

Answer 1

--safe 参数表示“禁用自定义插件，并忽略符号链接(symbolic link)”，这意味着它将忽略 jekyll-gist gem。

https://jekyllrb.com/docs/configuration/

您可以通过修改 _config.yml 来解决此问题，以匹配 Github 在其服务器上呈现您的网站时将使用的内容。

github: [metadata]
kramdown:
  input: GFM
  hard_wrap: false
gems:
  - jekyll-coffeescript
  - jekyll-gist
  - jekyll-mentions
  - jekyll-paginate
  - jekyll-redirect-from
whitelist:
  - jekyll-coffeescript
  - jekyll-gist
  - jekyll-mentions
  - jekyll-paginate
  - jekyll-redirect-from

我从几个不同的来源将其拼凑在一起。可惜他们没有明确告诉你这样做。