用 Hexo + Github 搭建本身的博客

扯在前面

在好久好久之前，一直就想搭建屬於本身的一個博客，但因爲各類緣由，最終都不了了之，剛好最近忽然有了興趣，因而就本身參照網上的教程，搭建了屬於本身的博客。

至於爲何要搭建本身的博客了？哈哈，大概是爲了裝逼吧。

以前有選擇其它平臺，記點本身的學習筆記，作技術這行，要不斷學習新知識，俗話說的好，好記性不如爛筆頭，若是不記筆記，三天學習，兩天忘記。本身搭建博客的話，樣式的選擇也比較自由，能夠本身選擇，不須要受限於各大平臺。

網上搜 hexo 關鍵字，這樣的教程一大堆，爲何我還要寫這篇文章呢？由於我沒能根據某篇文章能從頭至尾一步步很順利地走下來，要麼由於軟件版本問題，要麼由於本身的水平問題，踩了不少坑啊，幸運地是，通過本身不斷努力，慢慢把坑填平了。

這篇文章只准備說下建立博客的重點步驟了，詳細步驟能夠參考：零基礎免費搭建我的博客-hexo+github（參考了別人的文章，也就幫忙宣傳下）,下面主要說說我我的的一些理解，以及遇到的坑。

進入正題

利用 hexo + github 搭建博客大概以下幾步：
-node.js 的安裝和準備（本地配置）
-Git 的安裝和準備（遠程空間配置）
-github 帳戶配置（部署和發佈）

那麼個人第一步是安裝 node.js 咯？不！我第一步是花錢買了個域名。相信我，當你花完錢以後，在接下來的步驟中遇到問題，你解決問題的信念會更強，而且花錢越多，離成功會越近。因此買個.com/.net 的域名，你就成功了一半。

不買域名行不行？固然能夠。買域名是爲了更好的裝逼。

nodo.js 下載與安裝

下載地址：
官網
中文站
安裝就不用多說了，跟安裝普通軟件沒有區別，能夠一路按提示Next。完成以後，打開命令行窗口 WIN + R，輸入以下命令：

node -v    
npm -v

出現以下結果說明安裝成功：

安裝 Hexo

在命令行輸入以下命令:
$ npm install -g hexo-cli
因爲衆所周知的緣由,可能你執行這條命令會報錯，若是你不會調整姿式上網，可使用淘寶 npm 鏡像，執行以下命令便可：
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
以後不少 npm 命令可使用 cnpm 代替。執行下面命令便可安裝 Hexo :
$ cnpm install -g hexo-cli
可能出現一些 WARN ,能夠不用理會，而後執行：
$ cnpm install hexo --save
輸入 $ hexo -v 命令，出現下面所示的版本信息，則說明安裝成功

本地搭建博客

-初始化 hexo
新建一個文件夾，這個文件夾即爲之後博客的文件存放路徑。打開命令行，cd 到該文件夾，執行
hexo init
-生成靜態文件，執行：
hexo g
OK,本地的博客搭建好了，下面能夠執行 hexo s 進行本地調試，執行完以後，打開瀏覽器，輸入 http://localhost:4000 ,能夠看到以下頁面

那麼恭喜你，本地博客搭建已經完成了。下一步就是部署到遠程服務器上。

將本地博客部署到遠程服務器端

本地博客搭建好了，咱們還須要將它部署到遠程服務器上。由於博客主要都是一些靜態的頁面，不涉及與後臺的數據傳送，因此咱們能夠利用 Github 上提供的一個免費空間，那麼，首先須要有一個 Github 帳號，相信同行都有，非猿類請登陸官網註冊。作法是創建一個倉庫，將文件上傳到該倉庫便可，這個倉庫的起名要注意，爲 yourname.github.io，yourname與你的註冊用戶名一致,好比的github用戶名是 zhangsan，那麼起名就爲 zhangsan.github.io ,這個就是你博客的域名了。

下面還須要作相應的配置，在你項目的文件夾下，找到 _config.yml 文件，注意是修改整個項目的配置文件，不是主題文件夾下的配置文件。打開文件修改配置以下：

deploy:    
  type: git     
  repo: <repository url>      
  branch: [branch]      
  message: [message]

參數描述：
repo： 庫（Repository）地址
branch： 分支名稱。若是您使用的是 GitHub 或 GitCafe 的話，程序會嘗試自動檢測。
message: 自定義提交信息 (默認爲 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}

最後經過生成靜態文件：
hexo g
部署到github:
hexo d
以上兩句能夠合併成一句 hexo g -d 或者 hexo d -g

下面是知識點：

1.若是你跟我同樣用的是 Node.js 是最新的版本，這裏 type ,要寫 git，網上一些文章上寫的 github ,親測，不可行。後來上 hexo 官網查看，證明爲 git。 github 多是之前比較老的版本中的推薦的配置。
2.若是沒有配置好 github 的 SSH Key, 每次提交代碼的時時候都是要求輸入github 用戶名和密碼。假設你已經將 SSH Key 添加到 github 上了（具體操做網上一大把），你仍然有可能每次提交代碼都須要輸入用戶名和密碼。緣由是， repo 地址，你寫的是
https://github.com/username/username.github.io.git
能夠將其替換爲
git@github.com:yourname/yourname.github.io.git

爲博客更改域名

爲了更好的裝逼，決不能知足於別人經過 yourname.github.io 去訪問你的博客，因此下面簡單介紹如何更改本身的博客域名。開頭提到，域名是要花錢買的，以我本身的爲例，在萬網買的，國內域名還須要實名認證，登陸萬網，進入控制檯，而後一步步按流程來就OK了。最後進行域名解析：

點擊解析，進入以下頁面進行點擊 添加解析 ：

記錄值，你須要 ping 一下你的 github 地址，輸入對應的值。

最後還有一步，在你的本地博客 source 目錄下，新建一個文件，命名爲 CNAME ，注意該文件沒有後綴，內容爲你購買的域名。而後執行 hexo d -g。

到此，就所有結束了,你也能夠出去裝逼了。

附，遇到的兩個坑：Hexo 使用中搭建博客過程當中遇到的坑