【Hexo】建置與部署

目錄

建置 Hexo

環境要求
安裝 Hexo 與建立專案

部署網站到 GitHub

新增 GitHub Repository
修改 config 設定
使用 hexo-deployer-git 部署專案

參考資料


本文目標

簡單快速架設
以 Hexo 建置的 GitHub Page

預期操作時間:
約 10 分鐘(無報錯或其他問題)


建置 Hexo

本文示範版本為 hexo 5.4.0

環境要求

  • Node.js (官網建議使用 10+ 以上版本)
  • Git

安裝 Hexo 與建立專案

安裝 Hexo

1
npm install -g hexo-cli

建立專案,並指定專案名稱

1
hexo init 你的專案名稱

以上跑完後執行 hexo s(等於hexo serve)
跑完後 Terminal 應會出現以下訊息
INFO Hexo is running at http://localhost:4000
接著用瀏覽器開啟 http://localhost:4000
就可以看到 hexo 建成的部落格囉


部署網站到 GitHub

新增 GitHub Repository

在 GitHub 上新增 Repository
專案可見設 public
專案名稱如下(名稱就包含「.github.io」)
GitHub帳號名稱.github.io


修改 config 設定

hexo 專案的根目錄中
有個 _config.yml 的設定
將 url 從 http://example.com 修改如下

1
url: https://xxxxx.github.io.git`

deploy 屬性內容修改如下

1
2
3
4
deploy:  
type: git
repo: https://github.com/xxxxx/xxxxx.github.io.git
branch: master # 指定要生成、部署哪個分支的專案內容

※ 請注意 xxxxx 都要代換成 Github的帳號名稱


使用 hexo-deployer-git 部署專案

新增 hexo-deployer-git 套件

1
npm install hexo-deployer-git --save

接下來執行指令

1
hexo d -g

以上意思同 hexo deployhexo generate


按照以上步驟執行
就會依照 _config.yml 內的設定
將部落格部署到 xxxxx.github.io 這個專案上
完成以 Hexo 建置的 GitHub Page 了



參考資料

Hexo 官網文件
架設 Hexo+GitHub
Hexo live-reload 플러그인(hexo-browsersync)