這篇文章記錄我自己建立 Zola 部落格《Debug My Life》的完整過程。這是一個靜態網站生成器,用 Rust 開發,速度快、結構清楚,非常適合喜歡手寫 Markdown 並掌握內容結構的人。


為什麼選擇 Zola?

我原本考慮過 Next.js + Markdown,但後來意識到如果只是要做內容型部落格、不需要互動機制,Zola 更輕巧、更單純,而且可以直接部署在 Vercel 或 GitLab Pages 上,部署體驗不輸給 VuePress、Hugo 等靜態架站工具。


步驟一:安裝 Zola

在 macOS 上可以直接使用 Homebrew 安裝:

brew install zola

確認是否成功:

zola --version

步驟二:初始化專案

進入你想放部落格的資料夾,執行:

zola init debug-my-life

依照提示輸入網站標題、網址、是否開啟 Sass、是否為部落格,然後會自動產生以下結構:

debug-my-life/
├── content/
├── static/
├── templates/
├── sass/
├── config.toml

步驟三:套用主題(以 Anemone 為例)

cd debug-my-life
git submodule add https://github.com/Speyll/anemone.git themes/anemone

然後編輯 config.toml

theme = "anemone"

[extra]
author = "Kat"
description = "一位努力 debug 自己人生的工程師"
header_nav = [
  { name = "Notes", url = "/notes" },
  { name = "Projects", url = "/projects" },
  { name = "Writings", url = "/writings" },
]

再建立你的內容資料夾與 _index.md

mkdir -p content/notes content/projects content/writings
touch content/notes/_index.md content/projects/_index.md content/writings/_index.md

步驟四:建立首頁 _index.md

首頁內容建議加入 banner 圖與自我介紹:

![Debug My Life Banner](/images/banner.png)

歡迎來到我的部落格!這裡是我記錄學習、信仰與創作歷程的空間。

步驟五:啟動本地開發伺服器

zola serve

打開瀏覽器前往 http://127.0.0.1:1111,就可以看到網站囉!


小結

Zola 對我來說是一個剛剛好的選擇:不需要 JS bundler,也不強迫你用特定語法,只要你喜歡 Markdown、想要有系統地記錄自己的內容,它是一個非常舒服的部落格起點。

下一步我會記錄如何部署到 Vercel,以及如何撰寫有結構的技術與信仰內容。

願這個部落格成為我 debug my life 的地方,也能鼓勵每一位在成長路上的朋友。