前段時間萌發自己搭建博客的念頭,沖動之下買了個云服務器,奈何個人對html的東西實在不通,折騰了幾天,blog依然丑的可以。后來無意間看見在github上可以搭建個人blog,就用谷歌折騰該如何在github上搭建blog,奈何網上很多教程都過于古老,或者很多細節都含糊不清,導致爬了好幾天幾天坑,才blog搭建了起來。
成功搭建的hexo網站
如何在github上搭建blog
本文分為三個部分:
- 本地環境搭建
- github 部署
- hexo 與github關聯
需要的的原料
- git
- github 賬號
- node js
- hexo
- 個人域名(可選)
本地環境搭建
- 安裝git
https://www.git-scm.com/download/win
選擇你需要的版本,一路默認安裝便可
- 安裝node js
- 32位下載地址
https://nodejs.org/dist/v4.2.3/node-v4.2.3-x86.msi
- 64位下載地址
https://nodejs.org/dist/v4.2.3/node-v4.2.3-x64.msi
下載完成后雙擊安裝,不做任何操作,一直默認下去便可。
- 安裝完成后win+R調出CMD命令,輸入
node -v
,校驗是否安裝成功,如果出現以下信息,則表示安裝成功</br>
node js安裝成功 - 安裝完成node js后,在任意目錄下打開cmd命令窗口,輸入以下命令來安裝hexo
npm install -g hexo
如果出現以下信息,則表示hexo安裝成功</br>
- 接著輸入以下命令添加git依賴</br>
注意:</br>
- 該命令必須在hexo g 之前完成
- 部署這個命令一定要用git bash,否則會提示Permission denied (publickey).
npm install hexo-deployer-git --save
如果出現以下信息,則表示hexo git依賴安裝成功
- 創建hexo工程
在任意盤符中創建一個文件夾,把它命名為hexo,打開該文件夾,在該目錄下打開cmd,輸入以下命令
hexo init
hexo 便自動創建了一個項目,目錄結構如下:
- 現在在cmd命令下輸入以下命令
hexo server -p 5001
如果出現以下信息,表示你已經生成了hexo工程。
</br>
現在,是時候在瀏覽器中展示你的成果了,在瀏覽器地址欄中,輸入以下地址,如果出現以下頁面,該頁面便是你以后的blog的預覽效果。
http://localhost:5001/
github部署
如果以上的網頁能正常顯示,那么恭喜你,本地環境搭建已經基本完成,現在是時候將hexo部署到github上了,將hexo部署你還需要完成幾個步驟:
創建一個github賬號
-
創建一個新的軟件倉庫,名稱格式必須為:github的用戶名.github.io。</br>
如:我的github用戶名為:AriaLyy,那么該軟件倉庫的名必須為: AriaLyy.github.io</br>
最終軟件倉庫如下:
hexo軟件倉庫 -
現在點擊Settings,往下拉,如果你看見下圖的信息
Your site is published at http://AriaLyy.github.io/
github網站生成
只要出現可以點擊的網絡地址,那么表示github已經成功幫你自動生成一個靜態網站了。 創建github ssk公鑰
在任意目錄打開CMD,輸入以下命令創建git ssh公鑰,一路回車下去便可
ssh-keygen -t rsa -C "key_name"
接著講ssh公鑰添加到github中。</br>
ps:如果你碰到ssh-keygen不是內部命令,那么你需要將git安裝目錄下的Git\usr\bin
路徑設置在環境變量中。
hexo 已github關聯
如果你已經完成了以上的步驟,那么你離成功只剩下一步之遙。</br>
還記得我們的hexo工程,以及*.github.io的軟件倉嗎?</br>
打開該文件,找到_config.yml文件,用文本編輯器打開,找到deploy
字段,添加以下信息
deploy:
type: git
repository: git@github.com:AriaLyy/AriaLyy.github.io.git # 這個配置為你*.github.io軟件倉庫clone地址
branch: master #分支為master分支
這里有幾點需要注意:
- 每個參數,冒號后面,必須要有一個空格!!?。。?!
- repository 參數需要 ssh 的clone地址
- branch 分支需要是master分支
如果你已經配置好以上步驟,接下來在hexo文件夾下打開cmd,輸入以下命令,將hexo工程部署到github上。</br>
hexo d -g
注意:部署這個命令一定要用git bash</br>
如果一切順利,那么將會出現類似于下面的成功提示信息
那么在瀏覽器地址上輸入:你的*.github.io軟件倉庫的名稱,將會打開你的blog。
如果一切順利,請盡情享受你的喜悅吧。