Jekyll 的 'gist' 标签 github-pages gem 的 Liquid 语法错误

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参数的意思是"Disable custom plugins, and ignore symbolic links"，也就是说会忽略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

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

Jekyll 的 'gist' 标签 github-pages gem 的 Liquid 语法错误

Liquid syntax error for 'gist' tag with github-pages gem for Jekyll

liquid

jekyll

jekyll-extensions

github-pages