探索 Hexo 框架

简介

Hexo 是一个基于 Node.js 的，快速、简洁且高效的博客框架。它具有丰富的主题和插件，以及超快的速度。支持 Markdown 语法，可以方便快捷地编写博客文章。同时支持 Node 命令，可以一键部署到 GitHub Pages，Vercel 等其他平台。

1.环境

1.1 安装 Git

检测是否安装成功：

# 打开终端，输入：
git -v

1.2 安装 Node.js 和 npm

检测是否安装成功：

# 打开终端，输入：
node -v
npm -v

1.3 安装 Hexo

# 打开终端，输入：
npm install -g hexo-cli

2.Hexo 使用

2.1 基础命令

官方文档：命令 | Hexo

• 初始化 hexo init && npm install
• 生成静态文件 hexo g
• 启动本地服务器 hexo s
• 清理缓存 hexo clean
• 部署到远程服务器 hexo d

Hexo 目录结构：

.
├── _config.yml          # 站点配置文件
├── .gitignore           # Git 忽略文件
├── node_modules         # Node.js 依赖包
├── package.json         # 描述插件
├── package-lock.json    # 插件版本锁定
├── scaffolds            # 模板
├── source               # 资源
│   ├── _posts           # 文章
│   └── _drafts          # 草稿
└── themes               # 主题

2.2 网站配置

网站配置文件：_config.yml ，官方配置文档：配置 | Hexo

2.3 主题配置

安装主题，官方收录主题：主题 | Hexo

# 在网站的根目录下，执行：
git clone git@github.com:xxxx/xxxx theme/xxxx

然后修改 _config.yml 网站配置文件：

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: xxxx

2.4 插件配置

安装插件，官方收录插件：插件 | Hexo

3.Git 推送

3.1 安装插件

# 打开终端，输入
npm install hexo-deployer-git --save

3.2 修改网站配置

修改 _config.yml 网站配置文件：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:xxxx/xxxxx
  branch: main

3.3 命令

一行组合命令，一键推送至 GitHub 仓库。

# 打开终端，输入：
hexo clean && hexo g && hexo d

4.后台

上述推送方法会将 Hexo 生成的 public 静态文件直接推送至代码仓库，因此每次更改网站内容时，都需在本地环境进行。

又因 GitHub 等代码托管平台无法直接处理 Hexo 生成的静态文件，所以需将本地 Hexo 根目录下文件推送至仓库，并参考 GitHub Actions 自动化部署 完成处理。

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/

然后可以通过 GitHub Codespaces / Qexo / HexoPlusPlus / Decap CMS 等其他服务/项目实现对 Hexo 博客的在线管理。

5.部署

• GitHub Pages / Vercel / Cloudflare / Netlify
• And so on…

最后可以通过将 Hexo 生成的静态文件推送至静态仓库，并使用上述或其他部署服务，即可轻松将博客内容发布到线上。但因部署服务分配的子域名也许会被大陆 DNS 污染，无法直接访问，所以建议解析自己的域名以实现正常访问。

结尾

至此，你的 Hexo 博客已经搭建完成，完结撒花🎉！