保姆式Hexo博客搭建教程

注:本教程在Windows下操作
我跟着自己写的教程来了一遍,应该没什么问题φ(゜▽゜*)♪

准备工作

全英文可开启浏览器自带翻译功能

遇到问题可以自行必应 ,或者咨询ChatGPT,不推荐百度

安装vscode

为当前用户安装一路下一步即可

安装node.js

node-v20.17.0-x64 蓝奏云备用链接

安装过程一直选下一步就行

安装Git

  • 进入Git官网:https://git-scm.com/downloads
  • 按照自己的系统选择对应的版本下载,一般选择 64-bit Git for Windows Setup 即可

安装时也是一直下一步就好

Git-2.46.0-64-bit 蓝奏云备用链接

检验是否安装成功

Win + R打开运行窗口,输入cmd,然后输入以下命令

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

那个 npm 是安装 node.js 送的

如果都有相应版本信息即安装成功,若不正确可尝试卸载软件重新安装

版本返回

Git 安装成功后,会在右键鼠标菜单里添加 Git GUI HereGit Bash Here 两个选项,我们要用到的是第二个

安装 Hexo

选择一个合适的位置新建文件夹(建议使用英文名称),这个文件夹之后会被用来存放博客的所有文件,在该文件夹下右键鼠标,点击 Git Bash Here,分别运行以下几条命令安装Hexo。可能会遇到网络问题,多试几次

1
2
3
npm install hexo-cli -g
hexo init
npm install hexo-deployer-git --save

Hexo 安装完成后,将会在文件夹中生成 Hexo 相关的文件

如果你的网络环境无法使用npm,可使用cnpm代替,安装cnpm后请将命令中的npm替换为cnpm

安装cnpm(可选)

1
npm install -g cnpm --registry=https://registry.npmmirror.com

Hexo本地查看

输入以下命令

1
2
hexo g
hexo server

执行完即可访问 http://localhost:4000/ 查看效果,当你看到 Hexo 默认主题即安装成功

Hexo 默认主题

将博客部署到 Github Pages 上

部署前置步骤

注册Github账号

无法打开GitHub的可使用这两个具加速GitHub: fastgithub | 瓦特工具箱(Steam++官网) (选一个就行了)

已有账号请跳过这一步,全英文可开启浏览器自带翻译功能

  • 进入Github官网:https://github.com/

  • 点击右上角的sign up,跟随引导依次填写信息注册 GitHub 账户

配置Github账号

  • 创建项目代码库:修改名称,然后拉到底部点击一个绿色的按钮 new repository 创建仓库

new repository

  • 新建仓库名称 你的用户名.github.io

若不已这个为名称那么之后的地址就是你的用户名.github.io/仓库名称 己有域名的话仓库名称随意

配置SSH密钥

在你的博客文件夹里右键,选择 Git Bash Here,输入以下命令

1
2
ssh-keygen -t rsa -C "your email@example.com"
// 将引号里面的 your email@example.com 改为你的GitHub注册邮箱,不要删除"",粘贴时不要带上这段注释,下同

一路回车

最后输入以下命令将公钥的内容复制到粘贴板上

1
clip < ~/.ssh/id_rsa.pub

在 GitHub 账户中添加你的公钥

第一步:登陆 GitHub,点击右上角头像,进入 settings

setting位置

第二部:点击 SSH and GPG Keys,然后选择 New SSH key

SSH and GPG Keys

第三步:粘贴密钥,完成后点击 Add SSH key

New SSH key

测试

Git Bash,输入以下命令:

1
2
ssh -T git@github.com
//git@github.com不要更改!

然后会提示

输入yes

输入yes设置完成

配置Git个人信息

1
2
3
git config --global user.name "此处填你的用户名"
git config --global user.email "此处填你的邮箱"
// 不要删除文字外的""

到此为止 SSH Key 配置成功,你的计算机已成功连接到Github

将本地文件推送至Github的仓库中

配置Hexo的_config.yml

  • 打开仓库,选择SSH点击按钮复制
    复制SSH
  • 打开你创建的博客文件夹,用 VS Code 打开该文件夹下的 config.yml文件
    修改最下面的 Deployment 为

Deployment

1
2
3
4
deploy:
type: git
repository: 换为你复制的SSH
branch: main

branch: 分支,默认 main 即可,注意缩进!

然后在 Hexo 文件夹下分别执行以下命令

1
2
3
hexo cl
hexo g
hexo d

第一个命令:删除public文件夹下生成的文件

第二个命令:生成文件

第三个命令:上传文件

至此你的博客搭建完成

访问博客:https://你的用户名.github.io

额外

绑定域名

  • 在域名服务商处新增CNAME解析,记录值为你的用户名.github.io

接着在GitHub pages添加你的域名

github pages

在博客 source 文件夹下新建文本文档,将名称改为CNAME

CNAME

保存,然后移除后缀.txt,注意这个文件没有后缀

如果你的电脑不显示.txt后缀请自行搜索如可显示文件扩展名

此操作是为了避免推送时将GitHub生成的CNAME文件删除

在博客上发表文章

新建一个空文章

输入以下命令,会在 [blog]/source/_post 中生成 文章标题.md 文件,文章标题根据需要命名

1
hexo n 文章标题

发表文章

还是执行

1
2
3
hexo cl
hexo g
hexo d

当然在在推送前你可以使用 hexo server 预览一下

注:编写文章使用 Markdown语言,具体语法和教程可自行搜索,这里不过多赘述

安装主题

hexo主题安装
推荐安装Solitude主题,这是他的文档,或者你有其他自己想装的主题,参考其文档即可