Liquid 選項

Liquid 對錯誤的回應可以透過設定 error_mode 來設定。選項如下:

  • lax — 忽略所有錯誤。
  • warn — 在主控台上針對每個錯誤輸出警告。(預設)
  • strict — 輸出錯誤訊息並停止建置。

在 _config.yml 中,預設設定如下:

liquid:
  error_mode: warn

上述範例描述「warn」值,而這已經是預設設定 - error_mode: warn。這會導致任何問題在建置程序中被呼叫出來,但如果可能的話,仍會繼續建置。

你也可以設定 Liquid 的渲染器來捕捉未指派變數和不存在的篩選器,方法是將 strict_variables 和/或 strict_filters 設定為 true3.8.0

請注意,雖然 error_mode 配置了 Liquid 的剖析器,但 strict_variablesstrict_filters 選項配置了 Liquid 的渲染器,因此是正交的。

以下是在 _config.yml 中設定這些變數的範例

liquid:
  error_mode: strict
  strict_variables: true
  strict_filters: true

如上所述進行配置,將會停止您的建置/服務,並呼叫出有問題的錯誤並暫停。當您希望透過停止建置或服務程序來捕捉與 liquid 相關的問題,並讓您處理任何問題時,這會很有幫助。