此方案的教程網(wǎng)上一搜一大把，這篇僅簡單記錄一下我的博客搭建過程、主題設(shè)置吉嚣，以及遇到的一些問題，供參考與對比蹬铺。
demo在這里
一尝哆、準(zhǔn)備工作
- 安裝nodejs
- 安裝Git
- 注冊Github賬號(hào),申請Github博客
二、安裝Hexo
$ npm install hexo-cli -g
1. 初始化
$ hexo init blog
$ cd blog
$ npm install
2. 開啟服務(wù)
$ hexo server
會(huì)看到提示INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop. 代表博客已經(jīng)正常運(yùn)行甜攀，在瀏覽器打開http://0.0.0.0:4000/ 即可預(yù)覽博客的初始狀態(tài)
3. 新建文章
$ hexo new "Hello-Hexo"
會(huì)在根目錄下source/_posts/ 生成Hello-Hexo.md文件渗鬼，使用markdown編輯器非常方便
4. 生成靜態(tài)文件
$ hexo generate
靜態(tài)文件的目錄在public/ 下
三、更換主題
在知乎上有個(gè)話題：有哪些好看的Hexo主題饺蚊？在里面有很多不錯(cuò)的主題衷咽。
我挑選了風(fēng)格簡潔的NexT主題，里面配置教程已經(jīng)非常詳細(xì)了谁撼，以下僅記錄一下過程用到的點(diǎn)歧胁。
下載主題
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
啟動(dòng)主題
克隆完成以后打開站點(diǎn)配置 _config.yml，找到theme字段厉碟，值改為next喊巍。
運(yùn)行hexo server --debug，訪問http://0.0.0.0:4000/ 查看主題是否生效箍鼓。
主題設(shè)置
- 選擇scheme
NexT 通過 Scheme 提供主題中的主題崭参。Mist 是 NexT 的第一款 Scheme。啟用 Mist 僅需在 主題配置文件 中將#scheme: Mist前面的#注釋去掉即可款咖。
設(shè)置語言
編輯站點(diǎn)配置文件何暮，將language設(shè)置成你所需要的語言奄喂。例如選用簡體中文，則配置為：
language: zh-Hans
可用的語言如下列出：
| 語言 | 代碼 | 設(shè)定值 |
|---|---|---|
| English | en | language: en |
| 簡體中文 | zh-Hans | language: zh-Hans |
| 正體中文 | zh-hk/zh-tw | language: zh-hk |
更多的設(shè)置可在 這里 查看海洼。
- 菜單設(shè)置
菜單配置示例：
menu:
home: /
archives: /archives
#about: /about
#categories: /categories
tags: /tags
#commonweal: /404.html
側(cè)欄設(shè)置
默認(rèn)情況下跨新，側(cè)欄僅在文章頁面（擁有目錄列表）時(shí)才顯示》【可以通過修改 主題配置文件 中的sidebar字段來控制側(cè)欄的行為玻蝌。
支持的選項(xiàng)有：post默認(rèn)行為，在文章頁面（擁有目錄列表）時(shí)顯示always在所有頁面中都顯示hide在所有頁面中都隱藏（可以手動(dòng)展開）頭像設(shè)置
編輯 站點(diǎn)配置文件词疼，新增字段avatar俯树， 值設(shè)置成頭像的鏈接地址。
鏈接的地址可以是完整的路徑贰盗，也可以是相對路徑许饿，如：
avatar: https://avatars1.githubusercontent.com/u/32269?v=3&s=460
或者avatar: /images/avatar.jpg作者名稱
編輯 站點(diǎn)配置文件，設(shè)置author為你的昵稱舵盈。站點(diǎn)描述設(shè)置
編輯 站點(diǎn)配置文件陋率，設(shè)置description字段為你的站點(diǎn)描述。站點(diǎn)描述可以是你喜歡的一句簽名:)
第三方服務(wù)
- 多說評(píng)論系統(tǒng)
** 注意 **：duoshuo_shortname不是你的多說登錄的 id
使用多說前需要先在 多說 創(chuàng)建一個(gè)站點(diǎn)秽晚。具體步驟如下：- 登錄后在首頁選擇 “我要安裝”瓦糟。
- 創(chuàng)建站點(diǎn)，填寫站點(diǎn)相關(guān)信息赴蝇。多說域名 這一欄填寫的即是你的
duoshuo_shortname菩浙，如圖：
多說設(shè)置示例：
duoshuo_shortname: iissnan-notes
標(biāo)簽云頁面
Step1:
新建一個(gè)頁面，命名為tags句伶。命令如下：
hexo new page "tags"
Step2:
編輯剛新建的頁面劲蜻，將頁面的類型設(shè)置為tags，主題將自動(dòng)為這個(gè)頁面顯示標(biāo)簽云考余。頁面內(nèi)容如下：
title: Tagcloud
date: 2014-12-22 12:39:04
type: "tags"
---
注意：如果有啟用多說 或者 Disqus 評(píng)論先嬉，默認(rèn)頁面也會(huì)帶有評(píng)論。需要關(guān)閉的話楚堤，請?zhí)砑幼侄?comments 并將值設(shè)置為 false疫蔓，如：
title: Tagcloud
date: 2014-12-22 12:39:04
type: "tags"
comments: false
---
Step3:
在菜單中添加鏈接。編輯 主題配置文件 身冬，添加tags到 menu中鳄袍，如下:
menu:
home: /
archives: /archives
tags: /tags
分類頁面
添加一個(gè) 分類 頁面，并在菜單中顯示頁面鏈接吏恭。
Step1:
新建一個(gè)頁面，命名為categories重罪。命令如下：
hexo new page categories
Step2:
編輯剛新建的頁面樱哼，將頁面的類型設(shè)置為categories哀九，主題將自動(dòng)為這個(gè)頁面顯示所有分類。
title: 分類
date: 2014-12-22 12:39:04
type: "categories"
---
注意：如果有啟用多說 或者 Disqus 評(píng)論搅幅，默認(rèn)頁面也會(huì)帶有評(píng)論阅束。需要關(guān)閉的話，請?zhí)砑幼侄?code>comments并將值設(shè)置為false茄唐，如：
title: 分類
date: 2014-12-22 12:39:04
type: "categories"
comments: false
---
Step3:
在菜單中添加鏈接息裸。編輯 主題配置文件 ，將menu中的categories: /categories注釋去掉沪编，如下:
menu:
home: /
categories: /categories
archives: /archives
tags: /tags
代碼高亮主題
NexT 使用 Tomorrow Theme 作為代碼高亮呼盆，共有5款主題供你選擇。
默認(rèn)使用的是白色的 normal蚁廓。
站點(diǎn)建立時(shí)間
這個(gè)時(shí)間將在站點(diǎn)的底部顯示访圃，例如? 2013 - 2015編輯 站點(diǎn)配置文件，新增字段since相嵌。
since: 2013
數(shù)學(xué)公式顯示
NexT 借助于 MathJax 來顯示數(shù)學(xué)公式腿时，此選項(xiàng)默認(rèn)關(guān)閉。
編輯 主題配置文件饭宾，將mathjax設(shè)定為true即可批糟。
# MathJax Support
mathjax: true
ProTip: 使用七牛 CDN 來加速 MathJax 腳本的加載
側(cè)邊欄社交鏈接
編輯 站點(diǎn)配置文件，新增字段social看铆，然后添加社交站點(diǎn)名稱與地址即可徽鼎。例如：
#Social linkssocial:
github: https://github.com/your-user-name
twitter: https://twitter.com/your-user-name
weibo: http://weibo.com/your-user-name
douban: http://douban.com/people/your-user-name
zhihu: http://www.zhihu.com/people/your-user-name
# 等等
About頁面
新建一個(gè) about頁面：
hexo new page "about"
菜單顯示about鏈接，在 主題配置文件 設(shè)置中將menu中about
前面的注釋去掉即可性湿。
menu:
home: /
archives: /archives
tags: /tags
about: /about
友情鏈接編輯 站點(diǎn)配置文件 添加：
# title, chinese available
links_title: Links
# links
links:
MacTalk: http://macshuo.com/
騰訊公益404頁面
簡體中文增加騰訊公益404頁面纬傲，尋找丟失兒童，讓大家一起關(guān)注此項(xiàng)公益事業(yè)肤频！效果如下http://www.ixirong.com/404.html
使用方法叹括，新建 404.html 頁面，放到主題的source目錄下宵荒，內(nèi)容如下：
<!DOCTYPE HTML><html><head>
<meta http-equiv="content-type" content="text/html;charset=utf-8;"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="robots" content="all" />
<meta name="robots" content="index,follow"/>
</head>
<body>
<script type="text/javascript" src="http://www.qq.com/404/search_children.js" charset="utf-8" homePageUrl="your site url " homePageName="回到我的主頁"></script>
</body>
</html>
四汁雷、常見問題
首頁顯示文章摘錄
NexT 支持三種方式來控制首頁文章的顯示方式。若需要在首頁顯示摘錄报咳，可以通過以下方法：
- 在文章中使用``手動(dòng)進(jìn)行截?cái)?/li>
- 在文章的 front-matter 中添加
description侠讯，并提供文章摘錄 - 自動(dòng)形成摘要，在 主題配置文件 中添加：
auto_excerpt:
enable: true
length: 150
默認(rèn)截取的長度為150字符暑刃，可以根據(jù)需要自行設(shè)定
設(shè)置 favicon
將favicon放置到站點(diǎn)的 source目錄下即可
標(biāo)簽和分類頁面的統(tǒng)計(jì)數(shù)據(jù)不正確
按照以下步驟更新數(shù)據(jù)：
- 刪除站點(diǎn)目錄下的
db.json文件 - 執(zhí)行
hexo clean - 重新生成
hexo g
更詳細(xì)的安裝配置說明：
hexojs/hexo
NexT主題
常用命令：
hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成靜態(tài)頁面至public目錄
hexo server #開啟預(yù)覽訪問端口（默認(rèn)端口4000厢漩，'ctrl + c'關(guān)閉server）
hexo deploy #將.deploy目錄部署到GitHub
常用復(fù)合命令：
hexo deploy -g
hexo server -g
簡寫：
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
部署到git
編輯 站點(diǎn)配置 你在部署時(shí)，要把下面的zippera都換成你的賬號(hào)名岩臣。
deploy:
type: git
repository: http://github.com/Beckjiang/beckjiang.github.com.git
branch: master
此處需要注意hexo在3.0版本以后溜嗜，做如下改動(dòng)：
- 安裝 npm install hexo-deployer-git --save
- 將deploy 的 type由github改為git
