逐步教學

4. 版面

在建立頁面時,Jekyll 除了 HTML 之外,還支援 Markdown。Markdown 非常適合內容結構簡單的頁面(僅包含段落、標題和圖片),因為它比原始 HTML 更簡潔。

在網站的根目錄中,建立一個名為 about.md 的 Markdown 新檔案。

你可以複製 index 的內容,並修改為關於頁面。不過,這會產生重複的程式碼,而你必須為網站中新增的每個頁面自訂這些程式碼。

例如,若要將新的樣式表新增到網站,就必須將樣式表的連結新增到每個頁面的 <head> 中。對於頁面數多的網站來說,這會浪費時間。

建立版面

佈局是可以在網站中的任何頁面使用的範本,並包圍頁面內容。它們儲存在名為 _layouts 的目錄中。

在網站的根目錄中建立 _layouts 目錄,並建立一個新的 default.html 檔案,內容如下

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <title>{{ page.title }}</title>
  </head>
  <body>
    {{ content }}
  </body>
</html>

這個 HTML 幾乎與 index.html 相同,但沒有前置事項,且頁面內容已替換成 content 變數。

content 是特殊變數,會傳回呼叫它的頁面之已呈現內容。

使用佈局

若要讓 index.html 使用新的佈局,請在 front matter 中設定 layout 變數。檔案應如下所示

---
layout: default
title: Home
---
<h1>{{ "Hello World!" | downcase }}</h1>

重新載入網站時,輸出結果保持不變。

由於佈局會包圍頁面上的內容,因此您可以在佈局檔案中呼叫像 page 這樣的 front matter。當您將佈局套用至頁面時,它會使用該頁面的 front matter。

建立關於頁面

將下列內容新增至 about.md,以在關於頁面中使用新的佈局

---
layout: default
title: About
---
# About page

This page tells you a little bit about me.

在瀏覽器中開啟 https://#:4000/about.html,並檢視新的頁面。

恭喜,您現在有一個兩頁的網站!

接下來,您將瞭解如何在網站中從一個頁面導覽至另一個頁面。

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