摘要：如果實(shí)在不會(huì)安裝可以去網(wǎng)上找教程。打開(kāi)，跳轉(zhuǎn)到剛剛創(chuàng)建的文件夾位置，運(yùn)行命令然后會(huì)在你的文件夾中搭建好了環(huán)境配置配置修改一些你的博客名字描述作者等?；谖业膫€(gè)人經(jīng)驗(yàn)，建議都開(kāi)啟開(kāi)啟標(biāo)簽頁(yè)命令，在博客目錄添加元數(shù)據(jù)開(kāi)啟分類頁(yè)命令，在博

Windows環(huán)境下Git安裝、配置SSH key、安裝node.js npm、安裝Hexo及配置、發(fā)布博客

前言

使用github pages服務(wù)搭建博客的好處有：

1. 全是靜態(tài)文件，訪問(wèn)速度快；
2. 免費(fèi)方便，不用花一分錢就可以搭建一個(gè)自由的個(gè)人博客，不需要服務(wù)器不需要后臺(tái)；
3. 可以隨意綁定自己的域名，不仔細(xì)看的話根本看不出來(lái)你的網(wǎng)站是基于github的；
4. 數(shù)據(jù)絕對(duì)安全，基于github的版本管理，想恢復(fù)到哪個(gè)歷史版本都行；
5. 博客內(nèi)容可以輕松打包、轉(zhuǎn)移、發(fā)布到其它平臺(tái)；
   等等；

準(zhǔn)備工作

在開(kāi)始一切之前，你必須已經(jīng)：

• 有一個(gè)github賬號(hào)，沒(méi)有的話去注冊(cè)一個(gè)：https://github.com
• 安裝了git for windows（或者其它git客戶端）：https://git-scm.com/downloads
• 安裝了node.js、npm，并了解相關(guān)基礎(chǔ)知識(shí)：https://nodejs.org/en/

本文所使用的環(huán)境：

Windows 10
node.js@8.11.4 x64
git@2.18.0 x64
hexo@3.2.2

搭建github博客

創(chuàng)建倉(cāng)庫(kù)

新建一個(gè)名為 你的用戶名.github.io 的倉(cāng)庫(kù)，比如說(shuō)，如果你的github用戶名是 test ，那么你就新建 test.github.io 的倉(cāng)庫(kù)（ 必須是你的用戶名 ，其它名稱無(wú)效），將來(lái)你的網(wǎng)站訪問(wèn)地址就是 http://test.github.io 了，是不是很方便？

由此可見(jiàn)，每一個(gè)github賬戶最多只能創(chuàng)建一個(gè)這樣可以直接使用域名訪問(wèn)的倉(cāng)庫(kù)。

幾個(gè)注意的地方：

1. 注冊(cè)的郵箱一定要驗(yàn)證，否則不會(huì)成功；
2. 倉(cāng)庫(kù)名字必須是：username.github.io ，其中username是你的用戶名；
3. 倉(cāng)庫(kù)創(chuàng)建成功不會(huì)立即生效，需要過(guò)一段時(shí)間，大概10-30分鐘，或者更久;

創(chuàng)建成功后，默認(rèn)會(huì)在你這個(gè)倉(cāng)庫(kù)里生成一些示例頁(yè)面，以后你的網(wǎng)站所有代碼都是放在這個(gè)倉(cāng)庫(kù)里啦。

具體步驟截圖如下：

新建倉(cāng)庫(kù)

創(chuàng)建完成

過(guò)了一會(huì)后就可以訪問(wèn)自己的網(wǎng)站啦！

安裝Git

下載安裝

打開(kāi)Git 下載地址 ，我們點(diǎn) windows

這里我推薦使用便攜版，因?yàn)楹芏嗳瞬幌矚g安裝軟件，何況又是一個(gè)不太經(jīng)常使用的軟件，所以便攜版安裝卸載都很方便
如果下載的是安裝版，那么你直接按默認(rèn)值一直點(diǎn)下一步就可以了。如果實(shí)在不會(huì)安裝可以去網(wǎng)上找教程。

便攜版下載完只需要解壓，再配置環(huán)境變量

下載完后解壓的文件如下：

打開(kāi)系統(tǒng)的環(huán)境變量，編輯Path環(huán)境變，新建路徑： git的存放目錄

至此，git算是安裝完成啦，我們可以打開(kāi)控制臺(tái)測(cè)試一下

win + r 輸入 cmd ，然后 輸入 git --version

配置SSH key

為什么要配置這個(gè)呢？因?yàn)槟闾峤淮a肯定要擁有你的github權(quán)限才可以，但是直接使用用戶名和密碼太不安全了，所以我們使用ssh key來(lái)解決本地和服務(wù)器的連接問(wèn)題。

1、運(yùn)行命令： ssh-keygen -t rsa -C "郵件地址" 。郵件地址可以登錄你的github - Setting - Emails 查看

2、然后連續(xù)3次回車，最終會(huì)生成一個(gè)文件在用戶目錄下

3、打開(kāi)用戶目錄，找到 .sshid_rsa.pub 文件，記事本打開(kāi)并復(fù)制里面的內(nèi)容

4、打開(kāi)你的github主頁(yè)，進(jìn)入 個(gè)人設(shè)置 - SSH and GPG keys - New SSH key

將剛復(fù)制的內(nèi)容粘貼到key那里，title隨便填，保存。

5、測(cè)試連接

運(yùn)行命令： ssh -T git@github.com 。注意這條命令不用修改，直接運(yùn)行

6、全局配置

git config --global user.name "selier"    // 你的github用戶名，非昵稱
git config --global user.email  "郵箱@qq.com"    // 填寫你的github注冊(cè)郵箱

至此，你的Git就配置好了

安裝 node.js

下載安裝 nodeJs ，隨便選一個(gè)即可，下載后安裝時(shí)一路默認(rèn)next (安裝路徑可以自選)。

安裝完成后，測(cè)試是否安裝成功

在 控制臺(tái)中 輸入 node -v ，npm -v

此處說(shuō)明下：新版的Node.js已自帶npm，安裝Node.js時(shí)會(huì)一起安裝，npm的作用就是對(duì)Node.js依賴的包進(jìn)行管理，也可以理解為用來(lái)安裝/卸載Node.js需要裝的東西

使用hexo寫博客

1、簡(jiǎn)介

Hexo 是一個(gè)簡(jiǎn)單、快速、強(qiáng)大的基于 Github Pages 的博客發(fā)布工具，支持Markdown格式，有眾多優(yōu)秀插件和主題。

2、原理

由于github pages存放的都是靜態(tài)文件，博客存放的不只是文章內(nèi)容，還有文章列表、分類、標(biāo)簽、翻頁(yè)等動(dòng)態(tài)內(nèi)容，假如每次寫完一篇文章都要手動(dòng)更新博文目錄和相關(guān)鏈接信息，相信誰(shuí)都會(huì)瘋掉，所以hexo所做的就是將這些md文件都放在本地，每次寫完文章后調(diào)用寫好的命令來(lái)批量完成相關(guān)頁(yè)面的生成，然后再將有改動(dòng)的頁(yè)面提交到github。

3、注意事項(xiàng)

安裝之前先來(lái)說(shuō)幾個(gè)注意事項(xiàng)：

1. 很多命令既可以用Windows的 cmd 來(lái)完成，也可以使用 git bash / git cmd來(lái)完成，但是這里因?yàn)槲矣玫氖潜銛y版 git ，所以我用的是git目錄下的 git-cmd
2. git安裝版會(huì)集成鼠標(biāo)右鍵菜單 git-bash ，所以下面很多步驟中需要通過(guò)git跳轉(zhuǎn)到某個(gè)目錄的，你可以直接打開(kāi)這個(gè)目錄，在空白處右鍵 - git-bash
3. hexo不同版本差別比較大，網(wǎng)上很多文章的配置信息都是基于2.x的，所以注意不要被誤導(dǎo)；
4. hexo有2種 _config.yml 文件，一個(gè)是根目錄下的全局的 _config.yml ，一個(gè)是各個(gè) theme 下的；

4、安裝

1、打開(kāi) git-cmd ，輸入 npm install hexo-cli -g 進(jìn)行安裝。如果顯示報(bào)錯(cuò)“ 沒(méi)有這個(gè)指令 ”，請(qǐng)點(diǎn)擊 這個(gè)網(wǎng)站 看第五點(diǎn)，配置nodeJs全局環(huán)境。

可能你的網(wǎng)絡(luò)無(wú)法訪問(wèn)網(wǎng)站并安裝，那么你可以通過(guò) 淘寶NPM鏡像 來(lái)安裝： npm install -g cnpm --registry=https://registry.npm.taobao.org ，之后下面的所有用到 npm 的命令，可以使用 cnpm 代替 ，如 npm install hexo-cli -g 改成 cnpm install hexo-cli -g

2、 再輸入 npm install hexo --save ，等待安裝完成。

3、初始化

3.1、在電腦的某個(gè)地方新建一個(gè)文件夾（名字可以隨便?。热缥业氖?D:我的文檔selierlin.github.io ，由于這個(gè)文件夾將來(lái)就作為你存放代碼的地方，所以最好不要隨便放。

3.2、打開(kāi) git-cmd ，跳轉(zhuǎn)到剛剛創(chuàng)建的文件夾位置，運(yùn)行命令 hexo init

然后會(huì)在你的文件夾中搭建好了環(huán)境

5、配置 __config.yml

1、修改一些你的博客名字、描述、作者等。同時(shí)大家可以修改自己的主題，更多主題 點(diǎn)擊這里 。修改主題就修改 _config.yml 里面的 theme 。更多關(guān)于其他配置信息修改請(qǐng)點(diǎn)擊這里訪問(wèn)hexo官方文檔 。

在 _config.yml 文檔修改所有信息都要注意， 冒號(hào)后面一定要有一個(gè)空格

2、hexo與github關(guān)聯(lián)配置

• type改成git
• repo的格式就是：git@github.com:你的用戶名/你的用戶名.github.io.git
• branch為master

6、啟動(dòng)本地服務(wù)

1、使用 git-cmd 跳轉(zhuǎn)到你的博客目錄，依次輸入以下命令

hexo g  # 生成
hexo s  # 啟動(dòng)服務(wù)

2、然后可以通過(guò)瀏覽器訪問(wèn)：http://127.0.0.1:4000 你就看到你的博客樣子啦。停止你的本地服務(wù)器，你可以在Git命令頁(yè)面按住 Ctrl+C 來(lái)停止。

如果瀏覽器一直轉(zhuǎn)圈圈，加載不出來(lái)，一般情況下是因?yàn)槎丝谡加玫木壒?，解決方法

7、上傳到Github

在上傳代碼到github之前，一定要記得先把你以前所有代碼下載下來(lái)（雖然github有版本管理，但備份一下總是好的），因?yàn)閺膆exo提交代碼時(shí)會(huì)把你以前的所有代碼都刪掉。

1、確認(rèn)你的 _config.yml 文件已經(jīng)配置了Deployment

2、git-cmd 跳轉(zhuǎn)到博客目錄，安裝Hexo部署的插件 ： npm install hexo-deployer-git --save

3、使用 git-bash 跳轉(zhuǎn)到博客目錄 ，運(yùn)行命令 hexo d

同時(shí)，在你的github上已經(jīng)上傳了文件

如果出現(xiàn) Deployer not found: git 說(shuō)明Hexo部署的插件沒(méi)有安裝好

4、發(fā)布完成，現(xiàn)在可以通過(guò) 你的用戶名.github.io 訪問(wèn)自己的網(wǎng)站啦

其它

1、保留CNAME、README.md等文件

提交之后網(wǎng)頁(yè)上一看，發(fā)現(xiàn)以前其它代碼都沒(méi)了，此時(shí)不要慌，一些非md文件可以把他們放到source文件夾下，這里的所有文件都會(huì)原樣復(fù)制（除了md文件）到public目錄的

由于hexo默認(rèn)會(huì)把所有md文件都轉(zhuǎn)換成html，包括README.md，所有需要每次生成之后、上傳之前，手動(dòng)將README.md復(fù)制到public目錄，并刪除README.html。

2、常用hexo命令

常見(jiàn)命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建頁(yè)面
hexo generate #生成靜態(tài)頁(yè)面至public目錄
hexo server #開(kāi)啟預(yù)覽訪問(wèn)端口（默認(rèn)端口4000，'ctrl + c'關(guān)閉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 #生成并本地預(yù)覽
hexo d -g #生成并上傳

3、_config.yml

這里面都是一些全局配置，每個(gè)參數(shù)的意思都比較簡(jiǎn)單明了，所以就不作詳細(xì)介紹了。更多關(guān)于其他配置信息修改請(qǐng)點(diǎn)擊這里訪問(wèn)hexo官方文檔

需要特別注意的地方是，冒號(hào)后面必須有 一個(gè)空格 ，否則可能會(huì)出問(wèn)題。

4、寫博客

寫博客并上傳的過(guò)程如下：

• 在hexo根目錄使用 hexo new 標(biāo)題 創(chuàng)建文章
• 編寫文章后，使用 hexo g 生成靜態(tài)文件到public
• 使用 hexo d 發(fā)布到github

也可以使用組合命令 hexo d -g 生成并上傳

定位到我們的hexo根目錄，執(zhí)行命令： hexo new my-first-blog

hexo會(huì)幫我們?cè)赺posts下生成相關(guān)md文件

我們只需要打開(kāi)這個(gè)文件就可以開(kāi)始寫博客了，默認(rèn)生成如下內(nèi)容

當(dāng)然你也可以直接自己新建md文件，用這個(gè)命令的好處是幫我們自動(dòng)生成了時(shí)間。

一般完整格式如下：

---
title: postName #文章頁(yè)面上的顯示名稱，一般是中文
date: 2013-12-02 15:30:16 #文章生成時(shí)間，一般不改，當(dāng)然也可以任意修改
categories: 默認(rèn)分類 #分類
tags: [tag1,tag2,tag3] #文章標(biāo)簽，可空，多標(biāo)簽請(qǐng)用格式，注意:后面有個(gè)空格
description: 附加一段文章摘要，字?jǐn)?shù)最好在140字以內(nèi)，會(huì)出現(xiàn)在meta的description里面
---

以下是正文

那么 hexo new page postName 命令和 hexo new postName 有什么區(qū)別呢？

hexo new page "my-second-blog" 生成如下：

最終部署時(shí)生成：博客目錄publicmy-second-blogindex.html ，但是它不會(huì)作為文章出現(xiàn)在博文目錄。

5、修改主題

既然默認(rèn)主題很丑，那我們首先來(lái)替換一個(gè)好看點(diǎn)的主題。這是 官方主題

這里我推薦幾款不錯(cuò)的主題：

安裝步驟：

• 打開(kāi) git-cmd ，跳轉(zhuǎn)到你的博客目錄
• 使用 git 拉取主題 git clone 倉(cāng)庫(kù)主題地址.git themes/主題名稱 ，意思是下載主題并將其保存到themes目錄下

如：git clone https://github.com/iissnan/hexo-theme-next.git themes/next

• 修改 主目錄下 _config.yml 中的 theme: landscape 改為 theme: next ，然后重新執(zhí)行 hexo g 來(lái)重新生成。

如果出現(xiàn)一些莫名其妙的問(wèn)題，可以先執(zhí)行 hexo clean 來(lái)清理一下public的內(nèi)容，然后再來(lái)重新生成和發(fā)布 hexo d -g

• 安裝完主題后，建議開(kāi)啟標(biāo)簽頁(yè)、分類頁(yè)

由于某些主題需要用到標(biāo)簽、分類，但是它的安裝方法中又沒(méi)有描述清楚?；谖业膫€(gè)人經(jīng)驗(yàn)，建議都開(kāi)啟

1、開(kāi)啟標(biāo)簽頁(yè)命令 ：hexo new page tags ，在 博客目錄/source/tags/index.md 添加元數(shù)據(jù)：

layout: tags
comments: false

2、開(kāi)啟分類頁(yè)命令 ：hexo new page categories ，在 博客目錄/source/categories/index.md 添加元數(shù)據(jù)：

layout: categories
comments: false

6、如何讓博文列表不顯示全部?jī)?nèi)容

默認(rèn)情況下，生成的博文目錄會(huì)顯示全部的文章內(nèi)容，如何設(shè)置文章摘要的長(zhǎng)度呢？

答案是在合適的位置加上 即可，例如：

# 前言

使用github pages服務(wù)搭建博客的好處有：

1. 全是靜態(tài)文件，訪問(wèn)速度快；
2. 免費(fèi)方便，不用花一分錢就可以搭建一個(gè)自由的個(gè)人博客，不需要服務(wù)器不需要后臺(tái)；
3. 可以隨意綁定自己的域名，不仔細(xì)看的話根本看不出來(lái)你的網(wǎng)站是基于github的；



4. 數(shù)據(jù)絕對(duì)安全，基于github的版本管理，想恢復(fù)到哪個(gè)歷史版本都行；
5. 博客內(nèi)容可以輕松打包、轉(zhuǎn)移、發(fā)布到其它平臺(tái)；
6. 等等；

最終效果：