hexo搭建与使用

本文最后更新于 2024年6月13日 晚上

环境搭建(必选)

总体来说，环境搭建首先是安装 git 等相关软件，以及拥有 github 帐号。然后设置 git 和 github 以及创建仓库，最后本地创建 hexo 的构建网页的环境，然后将其链接到 github 仓库上即可，下面分别介绍如何操作。

准备工具

首先安装 git 和 nodejs 软件，全部点击下一步，保持默认安装即可。然后在终端中(cmd 或 powershell)输入以下命令检测安装是否成功：

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

git 与 github 账户设置

首先创建 github 账户，这里不介绍如何创建，然后安装 git 软件。
打开Git Bash，输入以下命令进行账户和邮件的配置。

1
2
git config --global user.name "用户名"
git config --global user.email "注册github的邮箱"

然后创建 ssh 密钥，用来给 hexo 程序进行上传和连接使用。

在Git Bash中输入：

1
ssh-keygen -t rsa -C "邮箱"

然后一直点击下一步知直到创建完成，打开C:\Users\用户名\.ssh目录下找到id_rsa.pub(如果没有，请打开隐藏文件显示)，然后使用记事本打开该文件并全选复制下来。

打开 github 网页，在Settings中选择SSH and GPG keys，点击New SSH key。名称自己定义一个，然后把刚刚复制的内容粘贴到Key中，保存即可。

切换到Git Bash中，输入ssh -T git@github.com检测是否连接成功。
出现以下信息表示成功：

1
You've successfully authenticated, but GitHub does not provide shell access.

创建仓库

打开 github 网页，在自己的主页上，点击repositories然后点击New，出现创建仓库的页面。

然后在Repository name*中输入用户名加上 github.io 的后缀，例如用户名为qwer，则实际仓库名填写qwer.github.io，填好后点击Create repository即可创建完成。

然后测试是否正确，在浏览器中输入网址并访问：https://qwer.github.io,注意这里的qwer需要替换为你的用户名。
如果一切正常，将会显示用户名以及该网址和该仓库的描述信息。

hexo 本地构建网页

在你想存放的位置创建一个文件夹用来保存 hexo 构建网页的环境，例如D:/hexo文件夹，然后打开Git Bash在此目录下。
然后安装顺序执行以下命令：

1
2
# 初始化hexo
hexo init

如果一切正常，将输出以下信息：

1
2
3
INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
INFO  Install dependencies
INFO  Start blogging with Hexo!

接下来执行：

1
2
# 安装组件
npm install

如果一切正常，将输出以下信息：

1
2
3
4
5
6
added 1 package, and audited 227 packages in 1s

23 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

然后输入hexo g生成页面，log 如下所示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
INFO  Validating config
INFO  Start processing
INFO  Files loaded in 277 ms
INFO  Generated: archives/2024/06/index.html
INFO  Generated: archives/index.html
INFO  Generated: archives/2024/index.html
INFO  Generated: index.html
INFO  Generated: fancybox/jquery.fancybox.min.js
INFO  Generated: js/script.js
INFO  Generated: css/style.css
INFO  Generated: fancybox/jquery.fancybox.min.css
INFO  Generated: js/jquery-3.6.4.min.js
INFO  Generated: css/images/banner.jpg
INFO  Generated: 2024/06/10/hello-world/index.html
INFO  11 files generated in 310 ms

然后执行hexo s命令，打开浏览器输入http://localhost:4000进行预览。

链接 hexo 本地环境与 github 仓库

上面只是在浏览器中预览本地的内容，别人无法通过网络进行访问。所以还需要将 hexo 与 github 链接到一起。
首先需要安装hexo-deployer-git插件，在上面打开的Git Bash中输入命令：

1
npm install -g hexo-cli

然后修改D:\hexo\_config.yml（注意路径需要修改到你自己创建的目录），将该文件末尾的以下内容:

1
2
deploy:
  type: ""

改为如下：

1
2
3
4
deploy:
  type: git
  repo: git@github.com:qwer/qwer.github.io.git
  branch: gh-pages

然后在Git Bash中依次输入：

1
2
3
4
# 1. clean： 清除非必要文件
hexo c
# 2. deploy：先生成博客，然后将代码上传到github仓库中
hexo d -g

上传完毕后，打开浏览器，进入 github 网页，在该仓库的Settings中，点击Pages，将Branch改为gh-pages（来自上面修改的_config.yml文件）。

稍等片刻后，在浏览器中访问：https://qwer.github.io就可以访问到默认的内容。到这里就搭建好了。

但是目前只有一篇默认的文章，所以还需要说明一下如何进行创建新的文章。

发布文章(必选)

参考官方文档

更改域名(可选)

以阿里云为例

首先打开阿里云的控制台，选择云解析 DNS-域名解析-解析设置，然后选择添加记录，记录类型选择CNAME，主机记录输入自己想要定义的域名前缀。然后点击确认即可保存该记录。官方参考

这个前缀结合后面的域名共同组成了一个完整地址，hexo 中会使用该地址。

hexo 部分设置

在本地的目录下D:\hex\source,新建一个文件叫CNAME,注意没有后缀名称。
然后输入域名(从上一小节中，添加的CNAME中的内容)。

github 部分的设置

然后打开 github，参考以下内容修改 DNS 域名解析的相关设置。github 官方文档

到这里，域名更改就彻底结束，后面可以通过方位自己的域名，访问博客。

主题美化(可选)

fluid主题仓库

#blog搭建 #学习记录
hexo搭建与使用
https://blog.zimablue.fun/2024/06/10/hexo搭建与使用/
作者
zimablue1996
发布于
2024年6月10日
许可协议