使用 Vercel 免費部署 Hexo 靜態部落格
安裝 Hexo#
- 參考官方文件 文件 | Hexo
- 理論上只要完成「概述」和「建站」兩個步驟即可
- 安裝主題：見後文
建立 GitHub 遠端儲存庫#
- 在 GitHub 中新建一個 repo，名字隨意，其他設定保持預設，可以設為私有
- 在帳戶設定中生成一個 Personal access token，妥善保管。
建立本地 git 儲存庫，並推送到 GitHub#
- 進入 Hexo 根目錄
# 新建 git 儲存庫
git init
git add .
git commit -m "first commit"
git branch -M main
# 連接到 GitHub，例子：https://github.com/<使用者名稱>/<儲存庫名稱>.git
git remote add origin <你的遠端儲存庫地址>
# 設定儲存帳號密碼，去掉 --global 參數可以只對當前參數保存
git config --global credential.helper store
git push -u origin main
# 會要求輸入帳號密碼，注意密碼是之前生成的 Personal access token，而不是 GitHub 帳戶的密碼
使用 Vercel 部署#
- 使用 GitHub 帳戶登入 vercel.com
- 選擇從 GitHub 新增專案，選擇剛建立的 repo
- 會自動識別為 Hexo 專案，設定不需更改，直接確定即可
- 然後就可以使用 vercel 提供的域名訪問了，也可以使用自己的域名
- 若本地專案有更改，
git add .、git commit、git push後 vercel 會自動更新
注意事項#
關於主題#
- 直接
git clone和git submodule add各有優劣，可以了解後自行選擇
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# 或者
git submodule add https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
關於檔案名稱#
- 如果是從其他地方貼上的 md 檔案，記得把檔案名稱中的特殊字元去掉，否則雖然本地可以運行，在 vercel 上會出現 404 錯誤
- 如果是
hexo new的檔案，會發現即使有特殊字元，也會在檔案名稱中被自動去掉（Front-matter 中不受影響），所以可以大膽使用特殊字元