之前使用過jekyll+github做過一版自己的部落格網站，有興趣的可以看一下我之前的文章：http://blog.csdn.net/linshuhe1/article/details/51143026，其實也很簡單，但是存在一些問題：目錄、Rss、sitemap無法自動生成。

最近看到了別人使用hexo+github實現的部落格，有更多的靈活性和簡約的風格，所以也試著改一下自己原本的設計。
參考資料：
- EZLippi-浮生志：Jekyll遷移到Hexo搭建個人部落格
- iissnan的Next主題：Next使用文件

什麼是hexo：

hexo是一個基於Node.js的靜態部落格程式，可以方便的生成靜態網頁託管到github或者Heroku上，類似於jekyll、Octopress、Wordpress等，使用markdown來寫文章。hexo的作者是

• 易用性，部署很簡單，常用指令有：hexo new、hexo generate、hexo server、hexo deploy；
• 輕量級，檔案少而小，自定義方便

相關知識：

hexo配置過程中使用到了Github，Git，Markdown，Node.js等相關操作，所以需要很多外掛、widget需要自己安裝配置。

安裝準備：

安裝Github桌面版和配置

1. 雙擊下載好的GitHubSetup.exe檔案，按照預設設定完成安裝；
2. 登入自己的github賬號；
   
3. 在github網頁上建立一個以username.github.io
   命名的repositories,此時username為自己github的賬號名稱；
   
4. 開啟Git Shell，使用配置SSH Key使本地git專案與遠端Github建立聯絡：ssh -T [email protected]；
   

安裝Node.js

直接雙擊下載好的node-v4.5.0-x64.msi選擇指定的安裝路徑，按照預設設定完成安裝操作，安裝完成後不需要對Node.js進行任何配置。為了檢驗是否完成安裝，可以開啟命令列，輸入指令：npm --version進行版本號查詢。

安裝Hexo:

1.安裝:

mkdir hexo #建立一個專案檔案
cd hexo    #進入專案檔案目錄
npm install -g hexo-cli
npm install hexo --save
 

npm是Node.js中的一個工具，所以在安裝Hexo之前應該先安裝Node.js

2.部署Hexo：

在Git shell中輸入：

hexo init

記得輸入之前需要確保當前命令列所處目錄為所要建立工程的根目錄下，因為此操作的結果就是將hexo的一些必要檔案複製到當前目錄下面。

看到上圖結果之後，可以通過以下指令執行部落格：

hexo server

執行正常的話可以通過訪問：http://localhost:4000/檢視執行結果：

假如出現了hexo服務啟動成功，但是瀏覽器訪問localhost:4000一直不響應，那就有可能是因為你的裝置上裝了其他軟體佔用了4000埠，一般有兩種辦法可以解決：

• 在服務管理中將佔用該埠的服務停止掉，通常安裝了福昕閱讀器的就會佔用4000，把其對應的後臺服務關掉即可；
• 切換hexo啟動的預設埠，使用以下指令：

    hexo s -p 5000

此時啟動埠就變成了5000，訪問地址變成了localhost:5000。

3.安裝Hexo外掛：

主要目的是為了讓其自動生成sitemap，Rss，部署到git等，這些是額外的外掛，假如不需要使用到這些功能可以不新增：

npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install [email protected] --save
npm install [email protected] --save
npm install [email protected] --save
npm install [email protected] --save

將當前工程上傳到github

1.修改配置檔案：

在當前專案的根目錄下找到_config.yml配置檔案，用編輯器開啟，並找到Deployment標籤處deploy節點，填寫以下配置資訊，type是指定拖過平臺型別，repository指定了github上建立的repository倉庫地址，branch指定了版本型別。（注：冒號後面需要加一個空格，否則會出現報錯）

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: github
  repository: https://github.com/linshuhe1/linshuhe1.github.io.git
  branch: master

2.將專案deploy到github倉庫：

開啟Git shell進入當前專案的根目錄，依次執行指令：

hexo clean
hexo generate
hexo deploy

一般執行最後一步的時候會出現錯誤如下：

解決錯誤的方法是：將deploy的type改成git，然後在Git shell中執行：

npm install hexo-deployer-git --save

執行結束後再次執行上述三個指令，正確結果應該如下：

如此我們便完成了將本地的hexo工程deploy到github上的操作，訪問地址：https://username.github.io/可以看到頁面效果,這裡以我的github為例：https://linshuhe1.github.io/。