在Github上面搭建一个自己域名的Hexo博客

前言

在一次看到别人的博客主页，觉得设计很漂亮。但是由于自己对于前台这块没什么办法，煞是羡慕。偶然中发现这种样式是在Github上面搭建的，使用的是Next主题。于是便想自己也搭建一个，于是便去就去查询相关资料，在经历不少错误之后，终于搭建成功。

由于当时搭建的时候，没怎么记载，而且当初用的也不太熟。在使用了3个多月之后，趁着国庆这个时间将本博文写出来。如有不妥，欢迎指教！

注:其实搭建一个自己域名的博客，最大的作用就是提升了逼格…

效果图:

一、配置Hexo环境

1.下载并安装git

地址: https://git-scm.com/downloads

至于32位还是64位则看个人电脑情况选择了。

如果不会使用，可以看下我之前的博文:http://blog.csdn.net/qazwsxpcm/article/details/68946736

2. 下载并安装Node.js

http://nodejs.cn/

位数也依旧看个人电脑情况，安装成功之后，输入 node -v 和npm -v 可以查看是否安装成功。

注意:安装成功后需要重启电脑。

3. 配置hexo

1，新建文件夹，然后右键电脑盘符，点击git base。如:E:\Github\hexo

2， 输入: npm install hexo-cli -g 安装hexo

hexo命令简单介绍

$ hexo g #完整命令为hexo generate，用于生成静态文件
$ hexo s #完整命令为hexo server，用于启动服务器，主要用来本地预览
$ hexo d #完整命令为hexo deploy，用于将本地文件发布到github上
$ hexo n #完整命令为hexo new，用于新建一篇文章

3，进入Git Bash，输入hexo init 初始化仓库

4，安装依赖包 输入: npm install ，成功之后输入: hexo g 和 hexo s

5，在浏览器输入:http://localhost:4000/ 可以查看本地预览

注:因为我已经配置好了NexT主题，所以显示的是该主题。正常会显示的Hexo默认的主题，借用了网上的一张贴图作为范例。

二、Hexo的相关配置

1.启用NexT主题

在成功配置完环境之后，hexo的目录结构如下。



在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

为了描述方便，在以下说明中，将前者称为 站点配置文件， 后者称为 主题配置文件。

我们打开站点配置文件， 找到 theme 字段，并将其值更改为 next。



成功配置之后，稍微等一下，然后再次使用 git base 启动hexo，输入hexo g 和 hexo s 便可以看到Next主题以及成功使用。具体可以看我上面的图片，这里还是使用借用的一张图。

2.NexT相关配置

外观设置

打开 主题配置文件，然后解除Scheme中的 # 注释，选择适合自己的主题。

Muse - 默认 Scheme，这是 NexT 最初的版本，黑白主调，大量留白
Mist - Muse 的紧凑版本，整洁有序的单栏外观
Pisces - 双栏 Scheme，小家碧玉似的清新

注意: 设置样式后面需要有一个空格！！！

语言设置

打开站点配置文件 ，找到language，然后设置语音种类。

目前 NexT 支持的语言如以下表格所示：

语言 代码 设定示例

English en  language: en
简体中文    zh-Hans language: zh-Hans
Français    fr-FR   language: fr-FR
Português   pt  language: pt or language: pt-BR
繁體中文    zh-hk 或者 zh-tw  language: zh-hk
Русский язык    ru  language: ru
Deutsch de  language: de
日本語 ja  language: ja
Indonesian  id  language: id
Korean  ko  language: ko

菜单设置

打开主题配置文件，找到menu，然后选择主菜单显示内容。

NexT 默认的菜单项有（标注 的项表示需要手动创建这个页面）：

键值 设定值 显示文本（简体中文）

home    home: / 主页
archives    archives: /archives 归档页
categories  categories: /categories 分类页
tags    tags: /tags 标签页
about   about: /about   关于页面
commonweal  commonweal: /404.html   公益 404 

设置完之后，还需要设置对应菜单的相应的文本，也就是菜单的翻译。

找到languages/{language}.yml ，然后编辑进行相应的说明就行了。

如：设置的是语言是language: zh-Hans ,就打开zh-Hans.yml。

其它设置

头像设置

在主题配置文件 中编辑 avatar 输入头像路径就行了。

images 在hexo/public/images中。

如: avatar: /images/xuwujing.png

至于作者呢称和作者描述在我之前的截图上以及说明了，这里就不再多说了。

百度统计

地址:https://tongji.baidu.com/web/welcome/login

登录之后（没有则注册）,然后新增网站，输入域名就行，然后会出现一串js代码，复制hm.js? 后面那串统计脚本 id , 然后粘贴到 主题配置文件 中的baidu_analytics 就行。

社交链接

编辑主题配置文件 中的 social 然后增加链接以及说明就行。

例如：csdn: http://blog.csdn.net/qazwsxpcm?viewmode=list 。

标签分类

在站点目录下，打开git bash，输入 hexo new page “categories” 创建分类。

输入:hexo new page “tags” hexo new page “about” 创建标签和关于。

创建玩在站点目录下的source文件夹下，会新增一个categories、tags、about的文件夹，里面有一个index.md文件，打开之后更改说明为中文，那么显示的也为中文。

comments可以设置为false，含义是打开分类页面，评论插件不显示。

我的配置，可以从该地址查看：https://github.com/xuwujing/xuwujing.github.io

三、Hexo关联github以及将本地博客上传

1. 在github上面创建仓库

1，成功登录github后(未创建先行创建)，创建一个仓库，仓库名称格式为 youname.github.io youname 为用户名 。例如:xuwujing.github.io

2，创建成功之后，点击该仓库，选择setting，然后拖到GitHub Pages界面来, 然后选择Choose a theme，随便选择一个主题之后。再次点击setting来到GitHub Pages来，可以发现出现了一个路径，访问该路径，便可以访问所设置的仓库的界面了。

注: 因为我已经成功设置了。所以使用一个test测试仓库，用于截图和说明。实际仓库名称不要使用这种！！！

2.Hexo关联Github

这个就和之前关联仓库的步骤差不多。

设置git身份信息

在hexo目录右键git base 输入:

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

在站点配置文件 中加上仓库地址，注意要加上.git

例如: git@github.com:xuwujing/xuwujing.github.io.git

3.发布博客

首先新建一篇博文。

如:hexo new post “Hello GitHub”

就会在\source\ _posts 将会看到 Hello GitHub.md 文件。

要发布的博客放在在\source_posts路径下。博客推荐使用markdown编辑，后缀名为.md。



在发布之前，先编辑该博客，写点描述。

---
title: Hello GitHub
date: 2017-10-05 14:50:33
categories: hello
tags: [hello,haha]
---

然后输入:

hexo g 生成静态文件
hexo s  本地预览

成功之后如下图:

然后输入:hexo d 发布到github上。

成功之后输入youname.github.io路径便可以看到该博文了。

四、注册域名以及绑定到Github上

首先登录阿里云，搜索域名或者在控制台找到域名。进入之后，首先查询你要申请的域名，如果查不到就表示可以注册。域名注册有很多后缀名，如果可以，推荐.com的。

成功申请域名之后，将域名和Github绑定，Github的IP地址是192.30.252.153或192.30.252.154。所以我们在填写解析的时候，就解析这个地址。至于Github是怎么找到我们的仓库的，这个在CNAME设置。

以下来自百度经验

进入域名解析之后

点击【新增解析】；依次填写相应内容。

“记录类型”选择A；”主机记录”填写www；”解析线路”选择默认；

“记录值”填写github提供的IP地址，192.30.252.153或192.30.252.154；

“TTL”默认10分钟，自己可以另行设置也可；

最后点击【保存】。

域名成功解析之后，在你Github上面的仓库中创建CNAME，然后输入你申请域名的地址。然后你再输入你的域名就可以访问Github博客了。

五、错误问题解决方案

1. FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 10, column 1:

检查_config.yml内容，特别注意:后面需要有一个空格。

2.若出现这个错误:ERROR Deployer not found : github

则安装hexo git插件

输入:npm install hexo-deployer-git –save

3.如果使用CNAME绑定域名之后，上传博客的时候，会将CNAME中的地址替换为日志，导致无法通过域名访问。

解决办法:重新设置CNAME 中的域名地址。

如果有更好的解决办法，请私信我。谢谢！

六、参考网址:

Hexo网站搭建: http://opiece.me/2015/04/09/hexo-guide/

https://xuanwo.org/2015/03/26/hexo-intor/

NextT主题使用: http://theme-next.iissnan.com/getting-started.html

NextT后续配置: http://www.jeyzhang.com/next-theme-personal-settings.html

域名绑定博客: https://jingyan.baidu.com/article/dca1fa6fa1e403f1a5405262.html

Hexo问题解决: http://xuanwo.org/2014/08/14/hexo-usual-problem/