5分鐘完成HexoBlog部署GitHub設定

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 了,依序輸入以下指令:
1
2
3
4
5
hexo init <folder>  # 創建資料夾初始化 blog 
cd <folder> # 移至該資料夾
npm install # 安裝相關套件
hexo g # 產生 blog 靜態文件
hexo s # 啟動本地瀏覽,用於預覽 blog

安裝 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 帳號名稱
1
2
3
4
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一次,就可以了。

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


常用 Hexo 指令

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

指令簡寫

1
2
3
4
5
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