使用 Hexo + GitHub 搭設 Blog

什麼是HEXO

Hexo 是一款可以不耗費太多心力就可以架設的 Blog 框架，Hexo 可以使用 MarkDown 解析文章，專注於文章撰寫，再利用簡單指令生成靜態網頁。

架設目的

使用 Blog 進行學習紀錄以及熟悉 GitHub 操作方式，在記錄學習過程中，撰寫的文章，可以幫助思緒整理、理清架構，未來如果有忘記細節時，可以當作筆記瀏覽。

目前只有簡單使用預設定，並且使用 NexT theme*

步驟

初始化

使用前需要安裝 git、申請 gitHub 帳號、Node.js、管理工具npm。
檢查是否有 Node.js 版本 node -v、npm -v
將 git 位置使用 cd 移到目的地，我是使用 F 槽

cd /f

並且在 Hexo 官方網站複製安裝code

$ npm install hexo-cli -g
$ hexo init blog
$ cd blog
$ npm install
$ hexo server

npm install hexo-cli -g 這條指令中cli是為了使用hexo的指令工具，而 -g 表示全域安裝
hexo init <folder> 如果沒有資料夾名稱沒有打，會預設blog
npm install 進入 blog 資料夾後安裝 npm 套件
hexo sever 表示本地運行blog，這是一個很重要的指令，可以縮寫成 hexo s
在運行的時候 port 預設是 4000，但如果當你的 port: 4000 被占用的時候，可以輸入

hexo server -p 5000

這樣本地端 port 就變成 5000 了

將 blog 加入 git 版本管理

接著要將資料夾加入 git 版本管理，初始化資料夾

git init
git add .

接著 gitHub 也要開一個新的 repositories 命名為 username.github.io 且要設置為公開，
再來回到 git bash 或是 terminal

git remote add origin git@github.com: username/username.github.io.git 
git push -u origin master

在要使用 git push -u origin master 之前，可以先到，站點配置文件 _config.yml 中找到 deploy
由於是要傳上 github ， 將配置設置如下

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:useraccount/username.github.io.git
  branch: master

繼續設定 hexo

install hexo 自動佈署工具

npm install hexo-deployer-git --save

修改儲存完後可以開始繼續下個指令，先是完成 git push ，然後設置 hexo，

hexo g
hexo d

完成架設

如此便可以創造 public 資料，這就是靜態網頁。
在上方的code g 表示 generater， d 表示 deploy， 之後除非要調整設定，否則最常使用的便是 hexo g、hexo s、hexo d，創造靜態網頁、本地瀏覽、推上 github。