hexo搭建github靜態博客總結

具體效果 github不只能免費提供代碼託管，此外還提供了建立github博客的功能，網上有jekyll的方法，以前我試過最終因爲Ubuntu下安裝ruby及其餘組件失敗沒成功，過程也比較繁瑣，但有另外一種方法，操做起來很簡單，並且達到的效果也很好，那就是經過hexo搭建github博客。搭建環境爲window， ###步驟 1.安裝git客戶端，以及github帳號：經過gitBash 生成ssh key，將公鑰加入到github中，具體方法，百度搜索：爲gthub配置ssh key。 2.登錄github建立倉庫，注意倉庫名必須和用戶名相同，好比username/username.github.io 將username換成本身的用戶名，是用戶名不是註冊郵箱。 3.安裝node，去node官網下載安裝包，.msi文件，經過npm安裝hexo，Hexo 是一個基於nodejs 的靜態博客網站生成器，做者是來自臺灣的 Tommy Chen，具體安裝方法參照hexo官網介紹。注意 npm install hexo-cli -g 是在安裝完node後，開始菜單裏會有個node的命令行工具，在這裏面入的。 4.隨便選擇目錄建立要生成博客的文件目錄，進入該目錄：右鍵選擇git bash 輸入

$ hexo init <folder>
$ cd <folder>
$ npm install

folder 爲要建立博客的文件夾名稱。 5.經過以上步驟作完後，繼續輸入 hexo server 啓動服務器，就能夠用瀏覽器訪問localhost:4000/ 查看效果了。 博客文件目錄 ├── _config.yml ├── package.json ├── scaffolds ├── scripts ├── source | ├── _drafts | └── _posts └── themes 根目錄的_config.yml文件是站點設置，可應用於真個站點，在theme目錄下也有個_config.yml該設置僅適用於當前主題，換個主題就不適用了。 根目錄的_config.yml的詳細配置參照此處 目前博客僅限於本地訪問，要部署到github上須要將_config.yml中的deploy改成：

deploy:
  type: git
  repository: https://github.com/username/username.github.io.git
  branch: master

保存在gitbash中輸入：hexo deploy 成功後，github在國外，估計要等上幾分鐘再能訪問username.github.io.git 看到效果，推薦部署到gitcafe上面，很快就能看到效果，若是部署到gitcafe的話須要改成：

deploy:
  type: git
  repository: https://gitcafe.com/username/username.gitcafe.io.git
  branch: gitcafe-pages

###主題的安裝：

$ cd your-hexo-site`
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

next 是主題文件夾的名字，能夠任意取名。若是要設置當前主題爲next只須要在根目錄的_config.yml文件中 theme: next 注配置文件中的冒號後必須有一個空格。 這裏推薦一個主題next,我我的比較喜歡，主題繼承了評論，rss等功能，具體設置見此處，好比要增長多說插件，只須要在該主題文件下的_config.yml的duoshuo_shortname:name 後填寫申請的名稱便可，很是方便。

注意一下幾點： 1.關於hexo的命令輸出都是在git bash下輸入的 2.配置文件中的冒號後必須有空格 3.本地文件的任何改動都須要再hexo generate一下在部署，纔會生效。

我本人在安裝過程當中參照 http://zipperary.com/2013/05/28/hexo-guide-2/ 的文章，但其中部份內容不適合新版本的hexo。若是機子上給github生成過ssh key，再給gitcafe生成ssh key時估計會鏈接不上gitcafe，生成ssh key時須要指定文件名，和給github生成略有不一樣。