逐步教學

2. Liquid

Liquid 是 Jekyll 開始變得更有趣的地方。它是一種範本語言,有三個主要元件

物件

物件會指示 Liquid 將預先定義的 變數 輸出為頁面上的內容。對物件使用雙大括弧:{{}}

例如,{{ page.title }} 會顯示 page.title 變數。

標籤

標籤會定義範本的邏輯和控制流程。對標籤使用大括弧和百分號:{%%}

例如

{% if page.show_sidebar %}
  <div class="sidebar">
    sidebar content
  </div>
{% endif %}

如果 show_sidebar 頁面變數的值為 true,這會顯示側邊欄。

在此處 深入了解 Jekyll 中可用的標籤

篩選器

篩選器會變更 Liquid 物件的輸出。它們會在輸出中使用,並以 | 分隔。

例如

{{ "hi" | capitalize }}

這會顯示 Hi 而不是 hi

進一步了解可用的濾鏡

使用 Liquid

現在,使用 Liquid 將 設定 中的 Hello World! 文字轉換成小寫

...
<h1>{{ "Hello World!" | downcase }}</h1>
...

若要讓 Jekyll 處理您的變更,請在頁面頂端新增 前端資訊

---
# front matter tells Jekyll to process Liquid
---

您的 HTML 文件應如下所示

---
---

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>Home</title>
  </head>
  <body>
    <h1>{{ "Hello World!" | downcase }}</h1>
  </body>
</html>

重新整理瀏覽器後,您應該會看到 hello world!

Jekyll 的許多功能來自於將 Liquid 與其他功能結合。在頁面中新增前端資訊,讓 Jekyll 處理這些頁面上的 Liquid。

接下來,您將進一步了解前端資訊。

  1. 設定
  2. Liquid
  3. 前端資訊
  4. 版面
  5. 包含
  6. 資料檔案
  7. 資產
  8. 部落格
  9. 彙整
  10. 部署