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

Question

我有一个托管在 Github Pages 上的 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-gistgem。

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

我从几个不同的来源拼凑起来。太糟糕了，他们没有明确告诉你这样做。