利用github hexo搭建部落格

---

title: 使用 github + hexo 搭建部落格

1.配置環境

安裝 node.js

這裡我推薦大家使用 v5 的版本，下載傳送門：

https://nodejs.org/dist/v5.12.0/

安裝 git

下載傳送門：

https://git-scm.com/downloads

安裝 hexo

安裝完git之後就可以安裝hexo了，如果某些同學的電腦桌面上沒有git bash,可嘗試在開始選單裡查詢。開啟git bash 之後輸入以下命令回車將hexo安裝到全域性。

$ npm install -g hexo

測試安裝 hexo

$ hexo -v

如果顯示以下內容則安裝成功。版本不同可能會有少許差異，不過無傷大雅

hexo-cli: 1.0.2

os: Windows_NT 10.0.14393 win32 x64

http_parser: 2.7.0

node: 5.12.0

v8: 4.6.85.32

uv: 1.8.0

zlib: 1.2.8

ares: 1.10.1-DEV

icu: 56.1

modules: 47

openssl: 1.0.2h

安裝完所需的軟體之後就要在github上面新建一個庫

點選綠色按鈕新建庫

在Repository name的輸入框內寫入和你的owner名字+github.io(切記一定要一致)

2.本地配置

hexo初始化

前面我們已經安裝完了hexo，但是我們還需要給它初始化，在你的任意一個碟符裡新建一個資料夾，這裡我選擇的是在C盤新建的一個hexo的資料夾。開啟資料夾右鍵git bash,輸入以下命令。

$ hexo init

生成靜態頁面

$ hexo generate

啟動本地預覽

然後在瀏覽器中輸入http://localhost:4000/檢視生成的頁面效果。

$ hexo server

3.關聯github

本地配置

這裡開啟前面自己新建的資料夾下面的_config.yml檔案，用記事本開啟即可。在檔案的最下方，新增如下配置。(注：每一個冒號之後需要空一格，第一個Jun-Dong為Github的使用者名稱,第二個Jun-Dong為之前New的Repository的名字,不要把我的給複製上去了,還有type一定要保持縮排)

deploy:

    type: git

    repository: https://github.com/Jun-Dong/Jun-Dong.github.io

    branch: master

配置SSH

如果你是第一次使用github則需要配置SSH key.

右鍵選擇git bash ,輸入以下命令，your_email@youremail.com換成註冊github的郵箱號。

$ ssh-keygen -t rsa -C "your_email@youremail.com"

之後會要求確認路徑和輸入密碼，我們這使用預設的一路回車就行，成功的話會在C:\Users\Administrator下生成.ssh資料夾，如果你的電腦的使用者名稱是中文，則會在C:\使用者\電腦使用者名稱下生成.ssh資料夾，進入該資料夾，以文字的形式開啟idrsa.pub，複製裡面的key，即複製檔案的全部內容。如果你在這邊只看見2個idrsa檔案，沒看到id_rsa.pub，應該是你把字尾名隱藏了，可以設定顯示字尾，或者直接把兩個檔案都以文字的形式開啟，內容短的並且以ssh-rsa開頭的即為所需的SSH key。回到github，進入Settings，選擇SSH and GPG Keys -> New SSH Key，title隨便填，貼上key。為了驗證是否成功，在git bash下輸入：

$ ssh -T git@github.com

有些童靴如果顯示continue，輸入yes就會看到：You’ve successfully authenticated， but GitHub does not provide shell access ，這就表示已成功連上github。

上傳本地庫到github

$ git config --global user.name "your name"  
$ git config --global user.email "your_email@youremail.com"

繼續部署github

安裝所需外掛

$ npm install hexo --save
$ npm install hexo-deployer-git --save

然後分別執行以下三條指令:

$ hexo clean
$ hexo g
$ hexo d

部署成功後，你在瀏覽器中輸入yourname.github.io，就能看到和本地一樣的效果了

寫文章

在此處新建md檔案即可