Mac下體驗Hexo與Github Pages搭建

好久以前就知道Github能夠發佈本身的博客，由於僅支持靜態文件，一直懶於動手本身進行編輯。再瞭解到還存在 JekyII 和 Hexo 這樣的內容生成框架後，終於決定體驗一下。

1、本地環境準備。

Github Pages的申請過程就再也不搬磚，Github的頁面上說的很清楚，注意每一個用戶只能建立一個與本身用戶名相同的Pages。

Pages申請好以後，能夠克隆到本地的文件夾，這樣 hexo 運行的文件夾就準備好，能夠開始準備本地的hexo環境。

hexo須要有nodes和nam的支持，我先安裝了6.9.2版本的node，使用的是安裝包，固然也可使用homebrew等工具。安裝hexo很簡單：

$ npm install hexo-cli -g

而後進入到 github Pages 的本地目錄執行：

hexo init blog
cd blog
nam install
hexo server

當看到Hexo is running的提示以後，就能夠按照提示的地址在瀏覽器中預覽博客效果了。

_config.yml 是博客的配置文件，可以定義博客名稱、做者等各類全局的參數。

package.json 應用數據，EJS、Sylus、Markdown三個渲染工具是默認安裝的，若是不須要刻意卸載。可是對於最終要是使用 Markdown 來編輯博客的我來講，那是必不可少的。

source 文件夾，文章原始的 md 文件都放在這個文件夾下面。經過生成器會對該文件夾下的 markdown、html 文件進行解析，其餘的文件只作拷貝，放入 public 文件夾。

themes 主題文件夾，默認的主題爲 landscape。

2、主題更換。

默認的主題美觀性基本上沒有，hexo 支持本身開發博客主題，可是剛開始的時候最好仍是選擇一個比較成熟的主題先上手。hexo 官方有一個提供預覽圖的列表，也有一個更完整的列表，我這裏要使用的是 yilia，後續考慮本身定義一個。

更換theme的步驟包括獲取 theme 文件，修改配置，能夠參考 yilia 的文檔進行。

3、生成與發佈

編輯完本身的文章後，本地預覽以爲效果還能夠的話，就能夠生成等待發布的頁面了。

hexo generate

執行完成後，能夠在 public 文件夾下看到生成的文件。由此能夠看到，hexo 中有原始的文檔文件，也有發佈後生成的網頁文件。

修改 hexo 配置文件中關於部署的部分

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/yourname/yourname.github.io.git
branch: hexo

至此，使用 hexo 搭建環境發佈內容的工做就完成了，你能夠經過 http://yourname.github.io 訪問頁面，查看效果。

爲了讓這兩部分文件都保存下來，咱們利用 git 中的分支功能。在本地環境查看有多少分支 git branch -a，通常只有一個 master。建立一個新的分支 git branch hexo 將分支推送到遠程服務器 git push origin hexo，在 hexo 的配置文件中選擇將內容發佈到 hexo 而本地的源碼提交到 master 中。