改进此页面

Liquid 选项

可以通过设置 error_mode 来配置 Liquid 对错误的响应。选项如下：

• lax — 忽略所有错误。
• warn — 为每个错误在控制台上输出警告。（默认）
• strict — 输出错误消息并停止构建。

在 _config.yml 中，默认配置如下：

liquid:
  error_mode: warn

上述示例描述了“warn”值，该值已默认设置 - error_mode: warn。这会导致在构建过程中指出任何问题，但仍会继续构建（如果可能）。

还可以通过将 strict_variables 和/或 strict_filters 分别设置为 true 来配置 Liquid 的渲染器以捕获未分配的变量和不存在的过滤器。 3.8.0

请注意，虽然 error_mode 配置了 Liquid 的解析器，但 strict_variables 和 strict_filters 选项配置了 Liquid 的渲染器，因此是正交的。

在 _config.yml 中设置这些变量的示例如下：

liquid:
  error_mode: strict
  strict_variables: true
  strict_filters: true

如上所述进行配置将停止构建/服务，并指出有问题的错误并停止。当希望通过停止构建或服务流程来捕获与 Liquid 相关的错误并允许处理任何问题时，这非常有用。