用 hexo 搭建个人博客

这篇教程会带着你一步一步搭建属于自己的 blog。

本文环境为 windows11，没有试过其他操作系统。

准备

下载 Node.js，Git。准备一个 github 账号。

配置 SSH

1. 打开 git-bash.exe

2. 运行 ssh-keygen -t rsa -C "Github 注册的邮箱地址"

3. 输入 RET RET y RET(RET 即回车)

4. 出现一个奇怪图案时就成功了。

5. 打开 ~\.ssh\id_rsa.pub 文件，复制里面的所有内容。

6. 登录到 github，点击右上角头像->“Settings”->“SSH and GPG keys”->“New SSH key”。

7. Title 随便写，在 Key 里粘贴你之前复制的内容。

8. 点击 “Add SSH Key”。

9. 终端输入 ssh -T git@github.com，出现 “Hi…” 的信息就大功告成了。

搭建博客环境

首先找一个目录，用来存放博客。此处以 D:\blog 为例。在此处右键，打开 “Git Bash”。

依次执行以下命令

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo s

出现 localhost:4000 就表示成功了。浏览器打开此网址，即可预览自己的博客，默认有一个 Hello World。Ctrl+C 停止本地博客。

部署

创建 github 仓库

1. 进入 github，点击右上角“+”->“New repository”。

2. “Repository name” 写 你的用户名.github.io。

3. “Add README” 选择 “On”。

4. 其他选项不用改，点击 “Create repository”。

部署网站

打开你刚刚创建的仓库，点击右上方绿色的 “<> Code” 按钮，“Clone” 处选择 “SSH”，复制下方的地址。

进入你的博客目录，打开 _config.yml，翻到最底下，把 deploy 一段改成

deploy:
  type: git
  repository: 粘贴你刚刚复制的地址（如 git@github.com:xtttai2/xtttai2.github.io.git）
  branch: main

然后终端定位到博客目录，运行

npm install hexo-deployer-git --save

然后运行

hexo cl && hexo g && hexo d

此时再去仓库看看就会发现除了 README.md 还多出了许多东西。

等待几分钟，访问 你的用户名.github.io，就可以看到你的博客了（默认只有一个 Hello World）。

主题

可以在 Themes | Hexo 浏览主题，我用的是 Fluid。

下面的内容仅适用于 Fluid 主题，若使用其它主题请跳过。

启用 Fluid 主题

1. 下载 最新 release，解压到博客目录下的 themes\ 目录，并将解压的文件夹改名为 fluid。

2. 修改博客目录下的 _config.yml：

theme: fluid

创建“关于”页面

1. 在目录下执行

hexo new page about

2. 编辑目录下的 /source/about/index.md，添加 layout 属性：

---
title: about
layout: about
---

这里写关于页的正文，支持 Markdown, HTML

添加对 Latex 的支持

编辑主题目录下的 _config.yml：

post:
  math:
    enable: true
    specific: false
    engine: katex

然后在博客目录下运行

npm uninstall hexo-renderer-marked --save
npm install   hexo-renderer-markdown-it --save
npm install   @traptitech/markdown-it-katex --save

接着修改博客目录下的 _config.yml，添加如下内容

markdown:
  plugins:
    - "@traptitech/markdown-it-katex"

然后 hexo clean && hexo s 就能看到支持 Latex 了。

新建文章

文章都存放在博客目录下的 source\_posts\ 目录中。

在博客目录下运行

hexo new post "文章标题"

即可新建文章。

上传文章

在博客目录下依次执行

hexo clean
hexo g
hexo d

过几分钟，访问 你的用户名.github.io 就可以看到自己的博客了。

---

EOF