Jekyll 的 github-pages gem 的“gist”标签的液体语法错误

Question

我有一个托管在 Github 页面上的 Jekyll 网站。我试图在推送到 Github 之前让我的网站在本地呈现，但是在运行 bundle exec jekyll serve --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 参数表示“禁用自定义插件，并忽略符号链接”，这意味着它将忽略 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

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