2025-08-20 建立新Hexo 專案完整步驟

發表於 2026-01-12 閱讀次數：

現在的狀態（確認）

你已經完成：

✅ 1. Node.js、Git（環境 OK）
✅ 2. GitHub repo 已建立
👉 https://github.com/lilyLovesJeans/sourdough-notes.git
✅ 3. Hexo 已安裝（全域）

你現在還沒有做的，是「本機的 Hexo 專案」。

關鍵觀念（先講清楚）

Hexo 專案 = 本機的一個資料夾

它可以在任何地方，只要你記得它在哪。

你前面說過：

你用 USB
USB 還有 45GB
你已經決定：

1	/Volumes/Lily_Data/hexo-sourdough

👉 這個選擇是完全正確的
👉 而且「跟 apple.lily.github.io 那個資料夾沒有衝突」

接下來：本機端要做的事（照順序）

🟢 STEP 4：在 USB 建立 Hexo 專案目錄

1️⃣ 進到 USB

1	cd /Volumes/Lily_Data

確認一下：

ls

看到 Lily_Data 裡面你熟悉的資料就 OK。

2️⃣ 建立 Hexo 專案

1	hexo init hexo-sourdough

這一行會：

建立資料夾 hexo-sourdough
裡面自動產生：
- _config.yml
- source/
- themes/
- package.json

3️⃣ 進入專案目錄

1	cd hexo-sourdough

4️⃣ 安裝專案需要的套件

1	npm install

📌 這一步一定要做
📌 會產生 node_modules/

🟢 STEP 5：測試本機是否正常

hexo s

終端機看到：

1	http://localhost:4000

用瀏覽器打開看，有看到 Hexo 預設首頁就代表 本機 OK。

🟢 STEP 6：安裝 NexT 主題（你要的版面）

1️⃣ 進到 themes

cd themes

2️⃣ 下載 NexT

（建議方式）

1	git clone https://github.com/next-theme/hexo-theme-next.git next

3️⃣ 回到專案根目錄

cd ..

4️⃣ 啟用 NexT

打開 _config.yml，找到：

1	theme: landscape

改成：

1	theme: next

5️⃣ 重跑本機

1 2	hexo clean hexo s

看到 NexT 樣式就成功了 🎉

🟢 STEP 7：設定 GitHub Pages 自動部署

1️⃣ 安裝 deployer（你剛剛問的）

1	npm install hexo-deployer-git --save

2️⃣ 設定 `_config.yml`（很重要）

在檔案最下面加：

deploy:
  type: git
  repo: https://github.com/lilyLovesJeans/sourdough-notes.git
  branch: main

3️⃣ 第一次部署

1
2
3

hexo clean
hexo g
hexo d

第一次會稍慢，正常。

🟢 STEP 8：GitHub Pages 設定（只要一次）

到 GitHub repo → Settings → Pages

Source：Deploy from a branch
Branch：gh-pages
Folder：/ (root)

儲存。

等 1–3 分鐘，你的網站就會出現在：

1	https://lilylovesjeans.github.io/sourdough-notes/

📌 結構對照（讓你安心）

USB:
└── /Volumes/Lily_Data/
    └── hexo-sourdough/        ← 酸種筆記 Hexo 專案
        ├── _config.yml
        ├── source/
        │   └── _posts/        ← 你的酸種文章
        ├── themes/
        │   └── next/
        └── public/            ← hexo g 產生（不用動）

你的工程師筆記 lily_posts 完全不會被影響。

接下來我建議你做什麼（下一步）

👉 先做到這一行成功為止：

hexo s

只要你看到 NexT 首頁，我們再一起慢慢：

設定 NexT 外觀
建立「酸種養成」分類
寫第一篇 starter 筆記