該系列博客列表請訪問：http://www.cnblogs.com/penglei-it/category/934299.html
摘要
GitHub 是一個開源項目的托管網站，相信很多人都聽過。在上面有很多高質量的項目代碼，我們也可以把自己的項目代碼托管到GitHub，與朋友們共享交流。GitHub Pages 是Github為大家提供的一項服務，不僅能為托管的項目建立主頁，還可以為我們建立個人博客。下面我就介紹個人博客是如何建立的。
在使用GitHub Pages建立個人博客前，我們象征性地了解一下GitHub Pages建立的頁面有哪些優點：
- 極簡的配置，輕量級系統，無需數據庫
- 使用標記語言，如Markdown
- 使用GitHub托管服務，免費300MB空間
- 可以綁定自己的域名
- 新版的GitHub Pages還支持CDN服務，提升訪問速度
總體來說，GitHub Pages搭建的博客使用起來是非常方便的。配置好了之后，只需要使用例如Markdown編寫自己的博文，扔到指定的文件夾里即可發布了。完全不需要管理網站相關的事務，例如數據庫、安全性等問題。
開始正題，下面的操作步驟參考自Github Pages的主頁，再結合我的實際操作介紹各個步驟，並說一下可能遇到的問題和解決辦法。
首先說明下面是以Window 10環境為例的。另外我采用的是Git Bash終端來操作，這在任何環境下都是一樣的。
准備工作
在開始一切之前，你必須已經：
本文所使用的環境：
Windows10
[node.js@6.2.0](http://pan.baidu.com/s/1kU4FPzD)
hexo@3.2.2
安裝node.js
下載node.js 安裝文件，點擊安裝，不用你做任何操作，直接下一步即可安裝完成。
安裝hexo
在電腦的任意一個盤（位置自選）建一個文件夾，比如說的我的文件取名為Hexo.打開此文件夾，按住電腦的shift鍵，右擊鼠標，選擇在此處打開命令窗口(或者打開電腦的dos窗口，直接切換目錄到Hexo文件夾)
在命令窗口中輸入：
$ npm install -g hexo-cli //安裝hexo
然后輸入命令hexo -v輸入hexo的版本號即為安裝成功。
創建一個新倉庫
新建一個名為你的`github用戶名.github.io`的倉庫，比如說，如果你的github用戶名是whitescholars(這個是我的用戶名)，那么你就新建whitescholars.github.io的倉庫（必須是你的用戶名，其它名稱無效），將來你的網站訪問地址就是 https://whitescholars.github.io了，是不是很方便？
由此可見，每一個github賬戶最多只能創建一個這樣可以直接使用域名訪問的倉庫，所以訪問的地址也是唯一的，方便github服務器管理。
設置倉庫的參數
相信大多數人都知道，要想使用git命令來和github進行提交部署等操作，需要進行一些配置，大概就是下面一些命令，如不明白請自行搜索.
- 安裝git for windows
- 右鍵鼠標選擇` git Base here`,輸入如下命令：
git config --global user.email xxx@qq.com git config --global user.name xxx ssh-keygen -t rsa -C xxx@qq.com(郵箱地址) // 生成ssh
注：email和name分別為注冊github時的郵箱和用戶名，生成ssh時會提示讓你選擇存儲地址，可直接按enter下一步存儲為默認地址。
找到.ssh文件夾，找到id_rsa.pub文件打開復制SSH
3.登陸github，settings － Deploy keys － add deploy key（把復制的SSH添加進去即可）
4.測試是否成功
$ ssh -T git@github.com
提示：
Hi whitescholars/whitescholars.github.io! You've successfully authenticated, but GitHub does not provide shell access.
證明校驗成功。
初始化Hexo
進入Hexo文件夾，在Dos命令窗輸入：
$ hexo init
這個過程稍微漫長一點，下載的文件如下圖所示：
接着輸入：
$ hexo g # 生成
$ hexo s # 啟動服務
執行以上命令之后，hexo就會在public文件夾生成相關html文件，這些文件將來都是要提交到github去的：
hexo s是開啟本地預覽服務，打開瀏覽器訪問 http://localhost:4000 即可看到內容：
至此一個簡單的博客框架算是搭建完成。系統會默認生成一個Hello World的文章。
代碼上傳
如果你一切都配置好了，發布上傳很容易，一句hexo d就搞定，當然關鍵還是你要把所有東西配置好。
首先，ssh key肯定要配置好。
其次，配置主配置文件_config.yml中有關deploy的部分：
正確寫法：
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@github.com:whitescholars/whitescholars.github.io.git
branch: master
repository為對應倉庫的地址。注意倉庫地址有兩種形式。一種是https，一種是SSH。此處應該使用SSH形式的地址。
最后輸入如下三條命令：
$ hexo clean # 清理
$ hexo g # 生成文件
$ hexo d # 部署文件
部署完成后輸入自己之前創建的git倉庫地址就可以訪問了，例如我的倉庫名字是whitescholars.github.io則輸入https://whitescholars.github.io即可訪問。
至此一個你已完成了真個博客的搭建。當然你可能或覺得自己不喜歡這個主題，沒關系，我會在后面的博客中接着告訴大家如何安裝和修改主題。
搭建博客的最終效果如下：http://penglei.top
附
常見命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成靜態頁面至public目錄
hexo server #開啟預覽訪問端口（默認端口4000，'ctrl + c'關閉server）
hexo deploy #部署到GitHub
hexo help # 查看幫助
hexo version #查看Hexo的版本
縮寫
hexo n == hexo new hexo g == hexo generate hexo s == hexo server hexo d == hexo deploy
組合命令
hexo s -g #生成並本地預覽
hexo d -g #生成並上傳
結語
如果你還需要了解更多技術文章信息，請繼續關注白衣秀才的博客
個人網站：http://penglei.top/
Github：https://github.com/whitescholars
微博：http://weibo.com/u/3034107691?refer_flag=1001030102_&is_all=1