超链接网址问题

　　问题描述：使用正常的 markdown 超链接格式[]()没问题，然而当直接将一个网址链接放入该文档时，它会将该链接后面的文字也当成是该链接的一部分，直接点击链接时，会将后面的文字也放入浏览器地址栏，从而出现网页 404 错误：404: Page could not be found。

　　解决办法：在网址链接后输入一个空格以隔开网址链接和后面的文字或用<url>将网址括起来。

超链接样式问题

　　问题描述：Shaun 使用的 hexo 主题是基于 spfk 主题稍微修改过的，spfk 主题能自动修改超链接原有的样式，挺好看的 :D，但是当 Shaun 在 markdown 中数字编号列表，即有序列表中添加超链接时，其样式并没有修改，还是普通的超链接样式。

　　解决办法：没有解决。最后只是跳过了这个问题，就用中文的序号表示列表。

文本段落问题

　　问题描述：为了使文本有段落感，一般都会在段落首字前空两格，但是在 markdown 中空两格，用 hexo 发布后并没有空两格，这使得文档没有段落感，阅读体验有点差。

　　解决办法：将中文输入法由半角切换至全角，在段落首字前输入两个空格即可。

显示英文尖括号问题

　　问题描述：由于上篇文档需要在文档中显示<youname>，但由于 Hexo 可能将其当做一个 xml 标签处理了，所以发布之后的文档没有显示该文字。

　　解决办法：首先 Shaun 尝试了转义字符\，谁曾想它只出现了一个转义字符，该文字还是没显示，Shaun 差点又要跳过这个问题，将其用另一种表示法了。后来 Shaun 想到这最后不是会转为 html 吗，Shaun 就直接用 html 中尖括号的表示法不就行啦 :p，于是参考HTML语言中括号(尖括号)的字符编码，用<代替<，用>代替>，最后该文字终于出来了。

给文字添加颜色问题

　　问题描述：Shaun 想给注意事项上的需要注意的问题添加醒目的颜色，但 markdown 本身不支持给文字添加颜色。

　　解决办法：由于 Hexo 最后会将 markdown 文档转换为 html 文档发布，所以直接将 html 标签写进 markdown 文档，最后自然会出现 html 样式，Shaun 这里参考CSDN-markdown编辑器语法——字体、字号与颜色，给想要变色的文字添加<font color=#FA8072></font>标签。

参考资料

[1] HTML语言中括号(尖括号)的字符编码（http://liuxufei.com/weblog/jishu）

[2] CSDN-markdown编辑器语法——字体、字号与颜色（http://blog.csdn.net/testcs_dn）

Shaun 的系统环境：Win10_x64。

前言

　　本来是想在国内某网站上继续写的，毕竟完全不需要自己管理，只需要负责写好文档就可以了，但某一天，该网站由于响应国家的号召，要实名验证，本来实名验证也没什么，就输入手机号，并填写验证码即可，但该网站实名验证的方式给人的感觉特别不爽，于是就决定自己搭建博客，这样虽然有点麻烦，但由于完全是自己管理，自己完全拥有该文档的所有权，也不用担心哪天别的网站突然出现的各种破问题，相比这种完全自由支配、无比爽快的感觉，管理这种麻烦就是小事了。

GitHub + Hexo 个人博客搭建

准备篇

在 GitHub 上搭建博客的要求：

　　1、要有 GitHub 账号。（没有怎么办，没有就去注册啊）

使用 Hexo 框架的要求：

　　1、需要安装 node.js。（电脑上没有安装怎么办，没有安装就去下载（https://nodejs.org/en/download/）安装啊）

　　2、需要安装 git。（没有安装就去下载安装，附 git学习教程）

GitHub 篇

　　满足上文的要求之后，就可以开始搭建了，首先在 GitHub 中新建一个仓库（ New repository ），在 Repository name 下填写 <yourname>.github.io ，其它可默认，点击 Create repository。

　　新建仓库完成后，点击 Create new file 新建一个 README.md 文件，随便写点什么，比如 “It's my blog website”。

　　点击上方横条选项中的 Settings ，查看 GitHub Pages 里的设置，上方应该有绿色框，框中“Your site is published at https://<yourname>.github.io”，该网址即为博客主页，Source 应该是 master branch，自此 GitHub 上的设置可以算是完成了，但为了方便和防止误删，一般把 Hexo 文件也放入 GitHub 中，为方便管理，可以新建另一分支专门放 Hexo 文件。

　　在仓库 code 界面中点击 Branch：master，在出现的框中输入 hexo 新建 hexo 分支，在 branches 中 Change default branch 设置 hexo 为默认分支。

Hexo 篇

　　将刚才新建的仓库克隆到本地：git clone https://github.com/<yourname>/<yourname>.github.io.git当前在 hexo 分支。

在 <yourname>.github.io 文件夹下执行

1
2
3
4
5

npm install hexo-cli -g
hexo init blog
cd blog
npm install
npm install hexo-deployer-git --save

　　按这样一连串执行，如果没出问题的话就会在 <yourname>.github.io 文件夹里生成一个 blog 文件夹，该文件夹有一大堆 Hexo 有关的文件。

配置 Hexo

　　Hexo 的配置文件为 blog 文件夹中的 _config.yml 文件。

　　修改配置文件不要使用 windows 自带的记事本，Shaun 使用的 VS Code，或者 Notepad++ 和 Sublime Text 2 等编辑器都可以，以防文件编码改变，具体修改如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Site
title:  <你的blog名>
author: <作者名称>
language: zh-CN<网站所用语言，中国大陆选择zh-CN即可>

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://<yourname>.github.io

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/<yourname>/<yourname>.github.io.git
  branch: master

其它的默认即可，具体参数信息详见 Hexo官方文档。

配置 git 用户信息

1
2

git config --global user.name "<yourname>"
git config --global user.email "<yourname>@xxxxxx.com"

　　如果是个人电脑的话推荐加上 --global 全局参数，因为这样更加方便，如果不加的话，还要在 \<yourname>.github.io\.deploy_git\.git 中 config 里加入 git 用户信息，不然可能提交会出问题，稍显麻烦。

部署 Hexo

在 blog 文件夹下执行：

1
2
3

hexo g         #generate 生成静态文件
hexo d         #deploy 部署网站.部署网站前,需要预先生成静态文件
hexo s         #server 启动服务器

或者执行：

1

hexo g -d

快速部署个人 blog。

　　在浏览器中输入http://localhost:4000/，将会出现 Hexo 的 Hello World 界面，更多 Hexo 命令详见 Hexo官方文档。

最后将 Hexo 文件提交到 GitHub 远程仓库，具体提交命令为：

1
2
3

git add .
git commit
git push origin hexo

　　在浏览器中输入https://<yourname>.github.io同样会出现 Hexo 的 Hello World 界面，自此整个个人 blog 的框架已经完全搭好了。

其它篇

主题选择

　　主题可以去官网上的主题界面去找，目前比较受欢迎主题有 next 和 yilia，去别人 GitHub 上的主题仓库上去下载或 clone 均可，Shaun 目前用的主题为black-blue，这个主题 Shaun 在用的时候还有些问题，或许会换，或许会自己魔改。最后由于术业有专攻，实在不知道该改哪里，所以决定换 black-blue 的原版主题 SPFK ，对照着 black-blue 对 spfk 进行修改。具体换主题的方法为：

　　先将下载好的主题整个放在 \blog\themes 文件夹中，再修改 blog 文件夹中的配置文件 _config.yml：

1
2

# theme: landscape
theme: black-blue

　　black-blue 为打包主题文件并放入 \blog\themes 文件夹中的文件夹名，并不是原主题名，只是 Shaun 恰好将其重命名为主题名。

文章发布

发布文章需要在 blog 文件夹中执行：

1

hexo new "test"

　　将会在 _posts 文件夹中生成 test.md 文件，随后编辑 test.md 文件即可，Shaun 使用的 Markdown 编辑器为 Typora。

至于给文章打标签和分类什么的，请参考 Hexo官方文档。

写完文章之后推送到 GitHub 中，需要执行：

1
2
3

git add .
git commit -m "add test.md"
git push origin hexo

Hexo 文件配置同样需要同步一下：

1
2
3

hexo g
hexo clean
hexo d

插件添加

以 RSS 订阅插件为例。首先安装 hexo-generator-feed，在 blog 文件夹下执行：

1
2

## rss插件
npm install hexo-generator-feed --save

安装成功后，修改 blog 文件夹中的配置文件 _config.yml：

1
2
3
4

# Extensions
## Plugins: https://hexo.io/plugins/
plugin:
- hexo-generator-feed #RSS订阅

最后，修改当前主题文件夹中的配置文件 _config.yml，添加 RSS 订阅链接即可：

1
2

subnav:
  rss: "/atom.xml"

修改完成后，执行

1
2
3

hexo clean
hexo g
hexo d

将会在页面中看到 RSS 图标。

注意事项

1、提交至远程仓库时可能会出现错误。

　　原因可能是因为没有将 SSH Key 添加到 GitHub 中。

　　查看当前用户主目录下的 .ssh 文件夹中（ windows 是 C:\Users\<username>\.ssh）是否有id_rsa（私钥）和id_rsa.pub（公钥）这两个文件，若没有，则执行

1

ssh-keygen -t rsa -C "youremail@example.com"

　　在 GitHub 中添加 SSH Key 的具体方法为：点击 GitHub 用户头像下的 Settings，选中 SSH and GPG keys，点击 New SSH key，将id_rsa.pub中的内容复制粘贴到 Key文本框中。

2、Hexo 生成和部署命令都执行失败。

　　原因可能是修改配置文件 _config.yml 出错。

　　将修改的配置文件 _config.yml 复原试试。

3、Hexo 部署之后网页没变化。

可能需要执行

1

hexo clean

　　清除缓存文件 ( db.json ) 和已生成的静态文件 ( public )。在某些情况（尤其是更换主题后），如果发现对站点的更改无论如何也不生效，可能需要运行该命令。

后记

　　以后就在这上面写 blog 了，顺便把以前写的一些文档也放上来。

参考资料

[1] 利用github+hexo搭建自己的博客（http://blog.csdn.net/u012150360/article/category/6765461）

[2] Hexo官方文档（https://hexo.io/zh-cn/）

[3] GITHUB+HEXO博客轻松更换主题外观（http://www.jianshu.com/nb/10649566）

[4] Hexo—正确添加RSS订阅（http://hanhailong.com/tags/Hexo%E4%B8%BB%E9%A2%98/）