使用Github Pages和Hexo搭建本身的独立博客【超级详细的小白教程】

欢迎关注个人CSDN专栏：《我的博客搭建：Hexo+Github Pages》，从搭建到美化一条龙，帮你解决 Hexo 常见问题！

推荐阅读：《Hexo 博客主题个性化》

个人博客地址：https://www.itrhx.com/

前言

这是一篇有关如何使用 Github Pages 和 Hexo 搭建属于本身独立博客的详尽教程，本人是软件工程专业本科生，目前只学习了C和C++编程语言，对网站开发的有关知识几乎为零，这也是我搭建好本身的博客以后写的第一篇博客，刚开始搭建博客的时候本身也是网上各类百度，因为本身属于小白那种，历经了千辛万苦才弄好，因此借这个机会写一篇小白真正能看懂的博客搭建教程，教你一步一步走向成功的彼岸！ 

推荐文章： 《我为何写博客》 （By 知明因此）
　　　　 　《为何你应该（从如今开始就）写博客》 (By 刘未鹏 | Mind Hacks)

入门

Github Pages

Github Pages能够被认为是用户编写的、托管在github上的静态网页。使用Github Pages能够为你提供一个免费的服务器，免去了本身搭建服务器和写数据库的麻烦。此外还能够绑定本身的域名。

Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其余渲染引擎）解析文章，在几秒内，便可利用靓丽的主题生成静态网页。

安装 Node.js

点击此处访问官网，按需下载相应版本，默认安装能够了

注：本人在安装过程当中出现了Warning 1909,没法建立快捷方式，这种状况不多出现，若是在安装过程当中也有这种状况请参考百度文库（win10系统实测可行）：《Win7安装程序警告1909没法建立快捷方式》

安装 Git

点击此处访问官网，按需下载相应版本，默认安装便可
参考资料：《如何在windows下安装GIT》 　（By 俊雨廷休）
　　　　　《Pro Git（中文版）》

检验Git是否安装成功

同时按下 Win 键和 R 键打开运行窗口,输入 cmd ，而后输入如下命令，有相应版本信息显示则安装成功，若不正确能够卸载软件从新安装，此外若安装成功，在桌面右键鼠标，能够看到菜单里多了 Git GUI Here 和 Git Bash Here 两个选项，第一个是图形界面的Git操做，另外一个是命令行

1 $ git --version 
2 $ node -v 
3 $ npm -v

安装Hexo

选择一个磁盘，新建一个文件夹，本身重命名文件夹（如：个人文件夹为：Ｅ\TRHX_Blog），博客相关文件将储存在此文件夹下，在该文件夹下右键鼠标，点击 Git Bash Here，输入如下 npm 命令便可安装，第一个命令表示安装 hexo，第二个命令表示安装 hexo 部署到 git page 的 deployer，如图所示即为安装成功

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

Hexo 初始化配置

在刚才新建的文件夹里面再次新建一个 Hexo 文件夹（如：个人文件夹为：E\TRHX_Blog\Hexo）,进入该 Hexo 文件夹右键鼠标，点击 Git Bash Here，输入如下命令，如图所示则安装成功

$ hexo init

Hexo 安装完成后，将会在指定文件夹中新建所须要的文件，Hexo 文件夹下的目录以下：

本地查看效果

执行如下命令，执行完便可浏览器访问 http://localhost:4000/ 查看效果

$ hexo generate 
$ hexo server

显示如下信息说明操做成功：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

登陆 http://localhost:4000/ 查看效果：

将博客部署到 Github Pages 上

到目前为止，咱们的本地博客就成功搭建了，可是如今咱们只能经过本地链接查看博客，咱们要作的是让其余人也可以访问咱们的博客，这就须要咱们将博客部署到Github Pages上

注册 Github 帐户

点击此处访问 Github 官网，点击 Sign Up 注册帐户

建立项目代码库

点击 New repository 开始建立，步骤及注意事项见下图：

配置 SSH 密钥

只有配置好 SSH 密钥后，咱们才能够经过 git 操做实现本地代码库与 Github 代码库同步，在你第一次新建的文件夹里面（如：个人文件夹为：Ｅ\TRHX_Blog） Git Bash Here 输入如下命令：

$ ssh-keygen -t rsa -C "your email@example.com" 
//引号里面填写你的邮箱地址，好比个人是tanrenhou@126.com

以后会出现：

Generating public/private rsa key pair. 
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): 
//到这里能够直接回车将密钥按默认文件进行存储

而后会出现：

Enter passphrase (empty for no passphrase): 
//这里是要你输入密码，其实不须要输什么密码，直接回车就行 
Enter same passphrase again:

接下来屏幕会显示：

Your identification has been saved in /c/Users/you/.ssh/id_rsa. 
Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub. 
The key fingerprint is: 
这里是各类字母数字组成的字符串，结尾是你的邮箱 
The key's randomart image is: 
这里也是各类字母数字符号组成的字符串

运行如下命令，将公钥的内容复制到系统粘贴板上，也能够用记事本打开 id_rsa.pub 文件（通常在 C:\Users\用户名\.ssh 目录下）

$ clip < ~/.ssh/id_rsa.pub

在 GitHub 帐户中添加你的公钥

① 登录 GitHub，进入 Settings：

② 点击 SSH and GPG Keys：

③ 选择 New SSH key：

④ 粘贴密钥：

测试

输入如下命令：注意：git@github.com不要作任何更改！

$ ssh -T git@github.com

以后会显示：

输入 yes 后会显示：

此时表示设置正确

配置 Git 我的信息

Git 会根据用户的名字和邮箱来记录提交，GitHub 也是用这些信息来作权限的处理，输入如下命令进行我的信息的设置，把名称和邮箱替换成你本身的，名字能够不是 GitHub 的昵称，但为了方便记忆，建议与 GitHub 一致

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

到此为止 SSH Key 配置成功，本机已成功链接到 Github

将本地的 Hexo 文件更新到 Github 的库中

① 登陆 Github 打开本身的项目 your name.github.io

② 鼠标移到 Clone or download 按钮，选择 Use SSH （Use HTTPS 也行，不过容易出现链接不上的问题）

③ 一键复制地址

④ 打开你建立的 Hexo 文件夹（如：E:\TRHX_Blog\Hexo），右键用记事本（Notepad++或者VS Code等均可以，推荐VS Code）打开该文件夹下的 _config.yml 文件

⑤ 按下图修改 _config.yml 文件并保存

⑥ 在 Hexo 文件夹下分别执行如下命令

$ hexo g 
$ hexo d

或者直接执行

$ hexo g -d

执行完以后会让你输入你的 Github 的帐号和密码，若是此时报如下错误，说明你的 deployer 没有安装成功

ERROR Deployer not found: git

须要执行如下命令再安装一次：

npm install hexo-deployer-git --save

再执行 hexo g -d，你的博客就会部署到 Github 上了

⑦ 访问博客

你的博客地址：https://你的用户名.github.io，好比个人是：https://trhx.github.io，如今每一个人均可以经过此连接访问你的博客了

在博客上发表文章

博客已经成功搭建了，可是咱们该怎么写博客呢？

① 新建一个空文章，输入如下命令，会在项目 \Hexo\source\_posts 中生成 文章标题.md 文件，文章标题根据须要命名

$ hexo n "文章标题"

也能够直接在 \Hexo\source\_posts 目录下右键鼠标新建文本文档，改后缀为 .md 便可，这种方法比较方便

② 用编辑器编写文章

md 全称 Markdown， Markdown 是 2004 年由 John Gruberis 设计和开发的纯文本格式的语法，很是的简单实用，经常使用的标记符号屈指可数，几分钟便可学会， .md 文件可使用支持 Markdown 语法的编辑器编辑

推荐 Windows 上使用 Typora 或者 小书匠 编辑器，macOS 上使用 Mou 编辑器，Linux 上使用 Remarkable 编辑器，Web 端上使用 CSDN ，其余编辑器推荐能够参考个人另外一篇文章：《最新主流 Markdown 编辑器推荐》

文章标题，标签，分类，封面图片，摘要等，能够在 Front-matter 里面配置（Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量，官方文档：https://hexo.io/zh-cn/docs/front-matter ），举个例子：

---
layout: 页面布局（配合主题文档使用）
title: 文章名称
date: 文章日期
comments: 文章是否开启评论
photos: 文章封面图（仅部分主题支持）
tags: 
- 文章标签一
- 文章标签二
categories: 文章分类
description: 文章描述，即要在首页显示的摘要（仅部分主题支持）
---

这里是摘要

<!-- more -->

这里是正文

注意：description 和 <!-- more --> 方式显示摘要二选一便可，部分主题不支持description，每一个配置英文冒号后面要空一格，不一样主题配置有所差别，具体要参考主题文档

当咱们用编辑器写好文章后，可使用如下命令将其推送到服务器上

$ hexo g 
$ hexo d

或者将两个命令合二为一输入如下命令：

$ hexo d -g

如今访问你的博客就能够看见写好的文章啦！

参考资料：《10款流行的Markdown编辑器》 （By xiaoxiao_engineer）
　　　　　《献给写做者的 Markdown 新手指南》 （By 简书）
　　　　　《认识与入门 Markdown》 （By Te_Lee）
　　　　　《markdown简明语法》 （By 不如）
　　　　　《markdown基本语法》 （By 高鸿祥）
　　　　　《Markdown 公式指导手册》 （By Harries）

为博客更换本身喜欢的主题

博客也搭建好了，文章也会写了，可是！！！默认的主题并不喜欢怎么办？如今，咱们就来为本身的博客更换本身喜欢的主题

点击此处进入 Hexo 官网的主题专栏，咱们能够看见有许多的主题供咱们选择

咱们要作的就是把主题克隆过来，在此咱们以主题 Aero-Dual 为例，点进去咱们就能够看见该主题做者的博客，鼠标滑到底，咱们能够看见 Theme By Levblanc 的字样（其余主题相似），点击做者 Levblanc ，页面就会跳转到该主题全部的相关文件在 Github 上的地址，复制该地址

再打开 Hexo 文件夹下的 themes 目录（如：E:\TRHX_Blog\Hexo\themes），右键 Git Bash Here，输入如下命令：

$ git clone 此处填写你刚才复制的主题地址

好比要安装 Aero-Dual 主题，则输入命令：

$ git clone https://github.com/levblanc/hexo-theme-aero-dual

等待下载完成后便可在 themes 目录下生成 hexo-theme-aero-dual 文件夹，而后打开 Hexo 文件夹下的配置文件 _config.yml ，找到关键字 theme，修改参数为：theme：hexo-theme-aero-dual （其余主题修改为相应名称便可），再次注意冒号后面有一个空格！

返回 Hexo 目录，右键 Git Bash Here ，输入如下命令开始部署主题：

$ hexo g 
$ hexo s

此时打开浏览器，访问 http://localhost:4000/ 就可看见咱们的主题已经更换了，若是感受效果满意，咱们就能够把它部署到Github上了

打开 Hexo 文件夹，右键 Git Bash Here ，输入如下命令：

$ hexo clean 
//该命令的做用是清除缓存，若不输入此命令，服务器有可能更新不了主题
$ hexo g -d

此时访问本身的博客便可看见更换后的主题，但咱们仍然须要对主题的相关配置进行修改，好比网站标题，图标等等，Hexo 中有两份主要的配置文件，名称都是  _config.yml ，它们均是用于站点配置使用的。其中，一份位于站点根目录下（好比个人：E:\TRHX_Blog\Hexo\_config.yml），主要包含 Hexo 自己整站的配置；另外一份位于主题目录下（好比个人：E:\TRHX_Blog\Hexo\themes\hexo-theme-aero-dual\_config.yml），这份配置由主题做者提供，主要用于配置主题相关的选项，通常 _config.yml 文件里都有相关注释，主题也有相关文档，按需修改便可

参考资料：《有哪些好看的 Hexo 主题？》 （知乎）
　　　　　《Hexo | 配置》（Hexo官方文档）
　　　　　《hexo经常使用命令笔记》 （By 小弟调调）

为你的 Hexo 博客配置个性域名

本人在配置域名的时候问题百出，百度的各类方法都无论用，打开网站老是 404，多是我太笨了 　o(╥﹏╥)o　，不过好在后来终于解决了这个问题

首先咱们要购买域名，阿里云，腾讯云均可以，也不贵，一年几十块钱，最便宜几块钱也能买到，以阿里云为例，我购买的域名是 itrhx.com，（最开始买的是trhx.top），购买过程就不赘述了，选择阿里云的解析平台，来到阿里云的管理控制台，点击进入域名解析列表或者直接点击域名后面的解析

方法一：点击添加记录，须要添加两个记录，两个记录类型都是 CNAME ，第一个主机记录为 @ ，第二个主机记录为 www，记录值都是填你本身的博客地址（好比个人是：trhx.github.io），保存以后域名解析就完成了！（主机记录有 @ 和 www 能保证URL加不加 www 都能访问）

方法二：两个记录类型为 A ，第一个主机记录为 @ ，第二个主机记录为 www，记录值都为博客的 IP地址，IP地址能够 cmd 中输入 ping 你的博客地址 得到（好比个人：ping trhx.github.io），保存以后域名解析就完成了！

有关解析记录类型的区别能够参考《域名解析中A记录、CNAME、MX记录、NS记录的区别和联系》

为了使 GitHub 接收咱们的域名，还须要在博客的根目录下添加一个名为 CNAME 的文件（注意不要加.txt，没有任何后缀名！），这个文件放到 Hexo\source 里面，（好比个人是：E:\TRHX_Blog\Hexo\source），文件里面填写你的域名（加不加www都行），好比要填写个人域名，文件里面就写：www.itrhx.com 或者 itrhx.com，通过以上操做，别人就能够经过 www.itrhx.com 、itrhx.com 、trhx.github.io 三个当中任意一个访问个人博客了！你的也同样！

有关加不加www的问题有如下区别：

若是你填写的是没有www的，好比 itrhx.com，那么不管是访问 https://www.itrhx.com 仍是 https://itrhx.com ，都会自动跳转到 https://itrhx.com

若是你填写的是带www的，好比 www.itrhx.com ，那么不管是访问 https://www.itrhx.com 仍是 https://itrhx.com ，都会自动跳转到 https://www.itrhx.com

若是你在其余平台购买域名，或者选择 DNSPod 等其余域名解析，操做方法大同小异，遇到问题可自行百度解决！

参考资料：《推荐几家域名注册服务商》 （By Jelly Bool）
　　　　　《盘点十大免费DNS域名解析服务：稳定、可靠》

博客美化和实用功能的添加

有关博客后期的美化、实用功能的添加，能够参考个人另外两篇文章：
《Hexo 博客优化之博客美化》
《Hexo 博客优化之实用功能添加》

结语

一顿操做下来虽然有点儿累，但看见拥有了本身的博客仍是很是有成就感的，人生就是须要折腾，那么如今就开始你的创做之旅吧！文章的不断积累，你会从中受益不少的！另外，这是一篇小白写的适用于小白的博客搭建教程，比较详细，有这方面基础的能够百度有简略一点儿的教程，文中若有错误还请大佬指出改正！文中涉及参考资料若有侵权请联系我删除！