hexo教學

這是一篇關於如何使用 GitHub 私有倉庫，完整備份 Hexo 部落格原始碼的教學。學會這招，無論更換電腦或系統重灌，都能輕鬆還原你的心血結晶！

身為一位用 Hexo 寫部落格的開發者，我們都知道 hexo deploy 指令只會將產生的靜態檔案（public 資料夾）推送到 GitHub Pages 公開倉庫。但真正重要的其實是包含了所有設定、主題與原始 Markdown 檔案的整個專案。若沒有備份這些原始碼，電腦一出問題，多年的心血可能就付之一炬。

本篇教學將引導你如何建立一個私有的 GitHub 倉庫，專門用來存放與同步你的 Hexo 部落格原始碼，做到萬無一失的備份。

第一步：在 GitHub 建立一個私有倉庫 (Private Repository)

首先，我們需要一個獨立的地方來存放部落格的原始碼。這個倉庫必須是私有的 (Private)，以確保你的設定檔、可能包含的 API 金鑰或草稿文章不會外洩。

  1. 登入你的 GitHub 帳號。
  2. 點擊右上角的「+」號，選擇 “New repository”。
  3. 命名你的倉庫：建議取一個容易辨識的名稱，例如 my-hexo-blog-source 或 blog-backup。
  4. 選擇 “Private”：這是最重要的一步！
  5. 不要勾選 “Add a README file”、“.gitignore” 或 “choose a license”。因為你的本地 Hexo 專案已經包含了這些檔案。
  6. 點擊 “Create repository”。

建立完成後，你會看到一個頁面，上面有你的倉庫 URL，類似 https://github.com/YourUsername/your-repo-name.git。請先將這個網址複製下來，下一步會用到。

第二步：將本地 Hexo 專案連接到遠端倉庫

接下來，我們要讓本地的 Hexo 資料夾認識剛剛建立的 GitHub 倉庫。請打開你的終端機 (Terminal) 或命令提示字元 (Command Prompt)，並切換到你的 Hexo 部落格專案根目錄下。

1
2
3
4
5
6
7
8
9
10
11
# 首先，確認你的專案已經是一個 git 倉庫
# 如果不是，請執行 git init
git init

# 將遠端倉庫的 URL 加入到你的本地 git 設定中
# "origin" 是遠端倉庫的預設代稱，你也可以自訂
# 請將下方的 URL 換成你自己的倉庫 URL
git remote add origin https://github.com/YourUsername/your-repo-name.git

# (可選) 檢查遠端倉庫是否成功加入
git remote -v

執行 git remote -v 後，如果看到你設定的 URL，就代表連接成功了！

第三步：將所有變更加入暫存區 (Stage)

在提交檔案前，我們需要先告訴 Git，哪些檔案的變更需要被記錄。使用 git add 指令可以將檔案加入暫存區。

1
2
3
# 使用 "." 代表將目前資料夾下的所有檔案變更都加入暫存區
# 這會包含你新增的文章、修改的設定檔等
git add .

小提示：Hexo 專案中預設的 .gitignore 檔案會自動幫我們忽略 node_modules、public 等不需要備份的資料夾，所以你可以安心地使用 git add .。

第四步：提交變更並附上描述訊息 (Commit)

將檔案加入暫存區後，就可以正式提交這次的變更，並附上一段簡潔明瞭的訊息，說明這次提交做了什麼。

1
2
# 使用 -m 參數來直接加上提交訊息
git commit -m "feat: Initial backup of my Hexo blog"

一個好的 Commit 訊息能幫助你未來快速了解每次變更的內容。例如：

  • "docs: Add new post about Hexo backup"
  • "fix: Correct a typo in about page"
  • "style: Update theme color scheme"

第五步：將本地變更推送到遠端倉庫 (Push)

最後一步，就是將我們在本地提交的所有變更，推送到 GitHub 上的私有倉庫，完成備份！

1
2
3
4
5
6
7
# -u 參數會設定本地 master 分支的上游 (upstream) 為 origin/master
# 之後你只需要輸入 git push 即可
# 第一次推送時建議使用
git push -u origin master

# 未來再次推送時，可以簡化為
git push

推送過程中，可能需要你輸入 GitHub 的帳號密碼或 Personal Access Token。完成後，回到你的 GitHub 私有倉庫頁面重新整理，就會看到所有 Hexo 專案的原始碼都已經成功上傳了！

未來的備份流程

完成首次設定後，未來你每次在本地寫完文章或修改設定後，只需要重複三到五步即可：

1
2
3
4
5
6
7
8
# 1. 將變更加入暫存區
git add .

# 2. 提交變更
git commit -m "你的更新日誌"

# 3. 推送到 GitHub
git push

就這麼簡單！從此以後，再也不用擔心你的部落格資料會遺失了。

說些什麼吧！

waline