0 写在前面

历时1周，在翻阅了大大小小无数的教程之后，总算是完成了个人博客的搭建。现将个人经验总结分享如下，亦做为个人存档留底。因本人才疏学浅，如有错误，欢迎在评论区指正。

本教程使用的Hexo版本为3.8.0，不同版本差别比较大，请留意使用的版本。

本教程默认读者已学会使用git并且拥有一个GitHub账号，如果还不会请点击TODO

Hexo依赖于node.js，请先安装，如需详细教程请点击TODO

1 安装Hexo

1.1 什么是Hexo?

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

引自Hexo官网

1.2 安装Hexo

必须先安装Git与node.js(建议版本≥12)

在命令行窗口中输入:

1
npm install -g hexo-cli

稍等片刻Hexo即可安装完成，安装之后在命令行输入hexo -v，如果可以正常显示版本信息，即为安装成功。

2 配置Hexo

2.1 初始化博客目录

首先新建一个文件夹myblog(名称随意,以下统称博客目录为myblog)，然后在当前目录下打开命令行(Windows按住Shift右键)，输入：

1
2
hexo init
npm install

等两步安装完成后，可以看到myblog文件夹下包含下列文件(其他文件基本不会去修改)：

1
2
3
4
5
6
_config.yml    #博客配置文件
package.json   #项目配置文件
scaffolds/     #模板目录
source/        #文章目录
themes/        #主题目录
node_modules/  #插件目录

现在，你已经拥有了一个简单的博客站点。接下来，在命令行中输入：

1
2
hexo generate
hexo server

稍等片刻等网站渲染完成，目录下生成的public文件夹就是静态站点目录。在浏览器中输入localhost:4000，即可查看到博客页面啦(虽然Hexo自带的主题真的很丑)。

2.2 简单配置Hexo

然而，现在的博客实际上还是空空如也，我们需要加入个性化的内容。

打开myblog下的_config.yml文件,修改最前面的部分:

1
2
3
4
5
6
7
8
9
10
11
12
# Site
title: #网站名称
subtitle: #网站副标题
description: #网站描述
keywords: #关键词
author: #作者
language: zh-CN #语言
timezone: 'Asia/Shanghai' #时区

# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: #你的网站的域名

_config.yml更多参数修改请参照官方文档，但一般没有必要修改。

如果你想要使用别的主题，可以在网上寻找Hexo的主题自行更换。本博客使用的主题为butterfly主题，TODO

2.3 为博客添加文章

在博客目录，输入：

1
hexo new [post] name

其中，[post]为默认文章模板，可在scaffolds/文件夹中修改。

然后就可以在source/_post中找到新生成的文章开始愉快的写作啦！

3 将博客同步到GitHub并开启gh-pages

请确认已配置GitHub上的ssh key，如果没有请点击TODO

众所周知，GitHub是最流行的代码托管平台(虽然访问速度是真的慢)，而其中的gh-pages为每个人提供了一个免费的静态网站托管服务，非常适合用来搭建个人博客。

3.1 将博客同步到GitHub

下面提供两种管理代码的方案。

首先新建一个名为username.github.io的空仓库，其中username为你的github用户名。

在本地博客目录打开.gitignore(没有先创建一个)文件，写入：

1
2
public/
node_modules/

打开目录themes/<你的主题名称>/,找到.git文件夹将其删除，避免git将其认定为子项目不同步的情况。

然后，在本地博客目录运行以下命令：

1
2
3
4
git init
git add .
git commit -m 'new'
git remote add github git@github.com:username/username.github.io.git

记得将username修改成你自己的名称！

测试是否配置成功，运行：

1
git push github main

如果成功的话，即可在GitHub上看到你的仓库代码了。

首先，在GitHub新建一个空仓库，将类型选择为私有(名称随意)。

然后新建一个名为username.github.io的空仓库，其中username为你的github用户名。

在本地博客目录打开.gitignore(没有先创建一个)文件，写入：

1
2
public/
node_modules/

打开目录themes/<你的主题名称>/,找到.git文件夹将其删除，避免git将其认定为子项目不同步的情况。

然后，在本地博客目录运行以下命令：

1
2
3
4
git init
git add .
git commit -m 'new'
git remote add github <你的私有仓库的地址>

测试是否配置成功，运行：

1
git push github main

如果成功的话，即可在GitHub上看到你的私有仓库代码了。

3.2 开启博客一键部署

仍然提供两种方案。

todo

todo

3.3 开启博客gh-pages服务

todo

好了，Hexo博客搭建的教程就到这里了，如果你想要为自己的博客更换主题的话，可以选择我使用的主题todo