5分鐘完成HexoBlog部署GitHub設定

建置環境node.js+GitHub

安裝node.js

$ node -v —>檢查node版本
$ npm -v —>檢查npm版本

使用 Github

創建放置 Blog 檔案的 Repository
Repository 名稱為 yourname.github.io，yourname是你的帳號名稱

使用 Github Desktop

將剛創的 Repository Clone 到本地端

安裝 Hexo

使用 npm 安裝 hexo

$ npm install -g hexo-cli

$ hexo version —>查看Hexo版本

初始化我們的第一個 Blog 了，依序輸入以下指令：

hexo init <folder>  # 創建資料夾初始化 blog 
cd <folder>  # 移至該資料夾
npm install  # 安裝相關套件
hexo g  # 產生 blog 靜態文件
hexo s  # 啟動本地瀏覽，用於預覽 blog

再來就可以用瀏覽器訪問 http://localhost:4000/ ，預設會有一個 Hello-World 的文章

安裝 Git 和在 Github 建立 SSH Key

在終端機設置user.name和user.email

1 2	git config --global user.name "你的GitHub名字" git config --global user.email "你的GitHub信箱"

生成 SSH Key，使用 SSH Key 可以幫助每次上傳檔案就不用再登入

ssh-keygen -t rsa -C "你的GitHub信箱"

複製KEY

cat ~/.ssh/id_rsa.pub

打開 https://github.com/settings/keys ，將剛剛複製的內容貼到Key裡

在終端機輸入 $ssh git@github.com，成功顯示以下訊息

Hi ::username::! You’ve successfully authenticated, but GitHub does not provide shell access.Connection to github.com closed.

配置 Hexo 到 Github

到 Blog 資料夾下找一個 _config.yml 的檔案，這是 Hexo 的全域配置文件[Note] yourname : 你的 Github 帳號名稱

deploy:
type: git
repository: http://github.com/yourname/yourname.github.io.git
branch: master

然後產生靜態文件後，部署上 Github

$ hexo d -g

如出現以下 Error
ERROR Deployer not found: git

使用 npm 安裝 git 後
$ npm install hexo-deployer-git --save

再次重新hexo d -g一次，就可以了。

再來就可以上https://yourname.github.io/ ，查看是否部署成功

成功之後，就可以開始做一些優化和寫文章啦。

常用 Hexo 指令

1 2	hexo new "postName" # 產生新的文章 hexo new page "pageName" # 產生新的頁面

指令簡寫

hexo n == hexo new  # 產生新的 post/page/draft
hexo s == hexo server  # 啟動伺服器 預設網址為: http://localhost:4000/
hexo clean # 清除快取檔案 (db.json) 和已產生的靜態檔案 (public)
hexo g == hexo generate  # 產生靜態的檔案
hexo d == hexo deploy  # 部署文件至 Github 上

完成後佈署

您可執行下列的其中一個指令，讓 Hexo 在建立完畢後自動佈署網站，兩個指令的作用是相同的。

1 2	hexo generate --deploy hexo deploy --generate

參考資料

基本設定文件 | Hexo