使用hexo+github建立個人部落格

前言#

準備開一個博客，記錄一下自己平時碰到的一些問題，也可以供以後進行翻閱，查找定位。
既然是這樣那就需要考慮怎麼建博客了，之前大學的時候 CSDN 和博客園都有帳號，可是只是零零星星寫過一點東西，就放在那了。也自己買域名和 vps 用 wordpress 搭過一個博客，這個運行了接近兩年，直到我工作一年後才停了。前期的目的是寫點技術博客，可是當時學生黨為了盈利，慢慢運營成了電影資源下載網站，收益還可以。期間為了改網站模板也自己學了點 php，也算有點收獲。工作之後就沒怎麼管過了，考慮到版權問題以及對個人成長的沒有多少幫助就給關了。當時關還是有點小不捨的，畢竟自己一手建的站，運營了那麼久。囉裡吧嗦那麼多就是想說其實是對技術博客還是有點情懷的，於是才有了現在想自己開博客，寫點技術文章的想法。
好了廢話不多說，步入正題。
** 本片文章配置是在 Mac 完成的，其他系統版本應該也差不多 **

用 Github pages 創建個人站#

我想作為程序員你應該對 GitHub 不陌生。GitHub 提供了 Github Pages 功能，我們可以用 GitHub pages 創建自己的個人站。

Github Pages 是面向用戶、組織和項目開放的公共靜態頁面搭建托管服務，站點可以被免費托管在 Github 上，你可以選擇使用 Github Pages 默認提供的域名 github.io 或者自定義域名來發布站點。

登錄 GitHub 帳戶，點擊右上角 + 號，選擇 New repository, 創建一個新的倉庫，用於存放你的網站代碼。
按照要求填寫倉庫名，要使用默認的域名 github.io 的話倉庫名就要以你的用戶名命名，命名規則如下username.github.io, 然後選擇公開，點擊 Create Repository, 創建倉庫完成。
至此我們在 GitHub 上有了一個代碼倉庫，等我們在本地寫好代碼就可以部署上去了。

安裝 Git#

最簡單的方法，去Git 官網下載安裝，也可以通過以下途徑安裝

Linux#

Debian 或 Ubuntu Linux，通過一條sudo apt-get install git就可以直接完成 Git 的安裝。

Mac OS 安裝#

安裝 homebrew，然後通過 homebrew 安裝 Git，具體方法請參考 homebrew 的文檔：http://brew.sh/

Windows#

推薦去官網下載，安裝完後在命令行下輸入git version檢查是否安裝成功。

使用 Hexo 搭建博客#

安裝 Node
hexo 是一款基於 Node.js 的靜態博客框架，所以我們先要安裝 node。
- 去 node官網下載安裝包安裝。
- 有個國內牆的原因，可能上不去官網就算上去了也很慢，推薦使用 homebrew 安裝 node
- 在 bash 命令下輸入 node -v 如果顯示版本號說明安裝成功。
安裝 hexo
安裝完 node 就可以用 npm 去安裝 hexo 了，hexo 官網

NPM 是隨同 NodeJS 一起安裝的包管理工具，能解決 NodeJS 代碼部署上的很多問題，由於新版的 nodejs 已經集成了 npm，所以之前 npm 也一並安裝好了。同樣可以通過輸入 "npm -v" 來測試是否成功安裝。

執行以下命令安裝 hexo：
npm install hexo-cli -g #-g表示全局安裝, npm默認為當前項目安裝
然後執行：
hexo version
如果出現版本號說明安裝成功。如果報錯，嘗試用下面的命令安裝
npm install hexo --no-optional
然後使用以下命令：
hexo init blog //執行初始化命令到指定的目錄,這裡的目錄是hexo文件夾
cd blog
npm install
hexo generate //在當前目錄下生成靜態網頁
hexo server // 啟動本地服務
在瀏覽器輸入 http://localhost:4000 就可以看到效果，到此 hexo 生成靜態網站就已經完成。

部署到 Github#

進入你的博客目錄，找到配置文件_config.yml 修改如下信息

deploy:
  type: git
  repo: [email protected]:username/username.github.io.git
  branch: master

這裡的 username 是之前註冊的 github 的用戶名
現在可以執行：hexo d部署到 github 了，不過有時候會出現問題，如果報如下錯誤

fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

說明連接不到遠程倉庫。一般是需要配置你電腦的 SSH Key

為什麼 GitHub 需要 SSH Key 呢？因為 GitHub 需要識別出你推送的提交確實是你推送的，而不是別人冒充的，而 Git 支持 SSH 協議，所以，GitHub 只要知道了你的公鑰，就可以確認只有你自己才能推送。
當然，GitHub 允許你添加多個 Key。假定你有若干電腦，你一會兒在公司提交，一會兒在家裡提交，只要把每台電腦的 Key 都添加到 GitHub，就可以在每台電腦上往 GitHub 推送了。

關於 SSH 的原理可以通過阮一峰老師的一篇文章了解一下：
http://www.ruanyifeng.com/blog/2011/12/ssh_remote_login.html
配置 SSH Key 的方法可以參考 GitHub 官網的教程：
https://help.github.com/articles/generating-an-ssh-key/
按步驟測試好之後就可以使用hexo d部署了。部署完之後在瀏覽器輸入：http://username.github.io/ 就可以看到效果了。