Hexo+GitHub Pages架設個人blog

Hexo

Hexo 是一個基於 Node.js 開發的網誌框架，具有下列幾項特點：

• 使用Markdown語法
• 一鍵部署，只需一個指令就能部署到GitHub Pages或Heroku等支援靜態網頁的空間
• 豐富的外掛套件，可安裝外掛支援Jade, CoffeeScript
• 輕量級，編輯速度快
• 支援多樣Theme

1. 前置作業

安裝Node.js

Node.js官網下載安裝，安裝後用CMD檢查是否安裝成功

node -v

npm -v

安裝hexo-deployer-git

npm install hexo-deployer-git --save

安裝Hexo

npm install hexo-cli -g

2. Hexo環境建置

初始化Hexo

hexo init [folder]

安裝所需套件

切換到初始化完的Hexo資料夾，執行下列指令，安裝所需npm套件：

npm install

npm會根據 package.json 中設定，載入所有專案中所需套件模組

初始化與安裝完成後，進入資料夾會看到以下檔案和資料夾

.
+-- _config.yml
+-- package.json
+-- scaffolds
+-- source
|   +-- _drafts
|   +-- _posts
+-- themes

3. Hexo指令

清除靜態檔案及快取(clean)

清除db.json及public資料夾中已產生的靜態檔案

hexo clean
hexo cl #簡寫

產生靜態檔案(generate)

產生靜態檔案。此指令會建立public資料夾，所有靜態檔案都在此資料夾中

hexo generate
hexo g #簡寫

啟動伺服器(server)

啟動Hexo伺服器

hexo server
hexo s #簡寫

4. 將網站部署到GitHub

新增Repository

將repository命名為username.github.io (username請改為自己的帳號名稱)，下方設定都預設不需更動，最後按下Create repository按鈕。

修改_config.yml中的deploy設定

此處 _config.yml 是hexo根目錄的檔案，不是themes下的。

_config.yml 拉到最下方，可看到 deploy 區塊，修改內容如下：

deploy:
  type: git
  repo: https://github.com/username/username.github.io.git
  branch: master

deploy到GitHub

使用下面指令將檔案deploy到GitHub：

hexo deploy
hexo d #簡寫

或是先清除快取

hexo cl && hexo d -g

5. 參考資料

【學習筆記】如何使用 Hexo + GitHub Pages 架設個人網誌