Hexo 项目说明

目前，zjnull本项目在 GitHub 仓库有两个分支：

main 分支：Hexo 生成的静态网页文件（hexo clean && hexo g && hexo d）

source 分支：在 VS Code 里手动推送的全部 Hexo 源码

更新公告

更新日期 类型 内容概要 仓库
2025-03-21 Docs 更新YOLOv11 环境配置与优化 Brian510000
2025-03-20 Refactor 重构homeworks/index.html并添加新页面 Brian510000
2025-03-19 Feat 新增课程表页面，优化UI布局 Brian510000
2025-03-16 Perf 添加Deepseek-R1的API接口调用 Brian510000
2025-03-15 Bug Fix 修复sendButton宽度及apiKey注释，优化appendMessage函数 Brian510000
2025-03-14 Feat 上线 DeepSeek-R1 大模型及style优化 Brian510000
2025-03-10 Docs 文章配置更新 Brian510000
2025-03-03 Perf zjnull.cn域名备案 Brian510000
2025-03-01 Perf 部署阿里云 SSL 证书 Brian510000
2025-02-22 Bug Fix 修复图片链接引用错误 Brian510000
2025-02-15 Docs Docker 部署 MySQL 服务 Brian510000
2025-02-14 Perf 启用 GitHub Proxy 加速图片加载 Brian510000
2025-02-11 Config 修正菜单项拼写与内容更新 Brian510000
2025-02-09 Docs MySQL/PicList 更新图床 Brian510000
2025-02-07 Config 更新底部文本与文章标签体系 Brian510000
2025-02-06 Refactor 移除子模块并重构主题文件结构 Brian510000
2025-02-06 Config Clash 节点代理配置 Brian510000
2025-02-05 Feat 发布音频跳线设置 Brian510000
2025-02-04 Config 图床服务集成与系统配置优化 Brian510000
2025-01-26 Bug Fix 修正评论模块配置参数 Brian510000
2025-01-25 Feat 上线关于页面与运维状态看板 Brian510000
2025-01-20 Feat 上线评论区板块 Brian510000
2025-01-19 Chore 清理冗余注释与调试代码 Brian510000
2025-01-12 Refactor 重构 Butterfly 主题目录结构 Brian510000
2025-01-11 Test 完成源码兼容性测试 Brian510000
2025-01-09 Chore 归档 ZJNULL.CN 基础源码 Brian510000

关于 Hexo

Hexo 是一个基于 Node.js 高效的web服务器框架，可以快速生成静态网页。

Hexo 使用 Markdown（或其他语言）来写文章，并在渲染时将其转换为 HTML 文件。

Hexo 支持丰富的插件，可以实现各种功能，如评论、搜索、统计、分类、标签、分页等。

Hexo 支持自定义页面，可以搭建个人博客或企业网站。

Hexo 支持本地预览，可以实时看到修改后的效果。

Hexo 支持部署到 GitHub、GitLab、Coding 等平台。

Hexo 部署分支修改

Hexo 的部署分支通常是在 _config.yml 配置文件中的 deploy 部分进行设置。例如：

1
2
3
4
5
# _config.yml
deploy:
  type: git
  repo: https://github.com/Brian510000/zjnull.cn.git
  branch: main

修改部署分支

如果希望 Hexo 部署到 source 分支，而不是 main，可以修改 branch 参数，如下所示：

1
2
3
4
5
# _config.yml
deploy:
  type: git
  repo: https://github.com/Brian510000/zjnull.cn.git
  branch: source

然后运行以下命令，使修改生效并部署到 source 分支：

1
hexo clean && hexo generate && hexo deploy

🚀 注意： 部署后会影响原先的旧文件，这里只是示例

这样 Hexo 生成的静态文件就会推送到 source 分支，而不是 main。

检查当前 Hexo 配置

可以在 Hexo 项目根目录下运行以下命令，查看当前 branch 的设置：

1
cat _config.yml | grep deploy -A 3

默认情况下，Hexo 一般会部署到 main 或 master 分支，用户可根据需求修改。

远程端部署文件位置

Hexo 部署到 main 分支的静态文件默认存放在 public/ 目录。

当运行 hexo generate (hexo g) 时，Hexo 会在 public/ 目录内生成完整的静态网站文件（HTML、CSS、JS、图片等）。如果再执行 hexo deploy (hexo d)，它会把 public/ 目录的内容推送到 GitHub 指定的 main 分支（或者 _config.yml 里设置的分支）。

流程总结

1. Hexo 生成静态文件

1
hexo clean && hexo generate
  • hexo clean 清理 public/ 目录，确保没有旧文件干扰。
  • hexo generate 重新生成完整的静态网站，存放在 public/ 目录。

2. Hexo 部署到 GitHub

1
hexo deploy
  • hexo deploy 会读取 _config.yml 里的 deploy 设置。
  • 它会把 public/ 目录的内容推送到 main 分支（或你指定的分支）。

如何查看 public/ 目录

可以在 Hexo 项目根目录下运行以下命令：

1
ls public/

或者使用 tree 命令（如果已安装）查看目录结构：

1
tree public/

如果手动打开 public/ 目录，你会看到类似以下的文件结构：

1
2
3
4
5
6
7
8
9
public/
├── index.html
├── archives/
├── categories/
├── css/
├── images/
├── js/
├── tags/
└── about/

这些就是最终部署到 GitHub Pages 上的静态网站文件。

如何本地预览 public/ 目录

可以使用 Hexo 提供的 hexo server 命令在本地测试：

1
hexo server

然后在浏览器打开 http://localhost:4000 预览网站。

如果想手动查看 public/ 目录的 HTML 代码，也可以直接用浏览器打开 public/index.html 文件。

总结

  • Hexo 生成的静态网站文件存放在 public/ 目录。
  • hexo g 生成 public/ 目录的内容。
  • hexo d 部署 public/ 目录的内容到 GitHub（通常是 main 分支）。
  • 可以用 hexo server 在本地预览 public/ 目录的内容。

Hexo 快速入门

欢迎来到 Hexo! 这是一篇示例文章，帮助你快速上手 Hexo。查看 官方文档 获取更多信息。如果在使用 Hexo 过程中遇到问题，你可以在 故障排查 页面查找答案，或者在 GitHub 提问。

快速开始

创建新文章

使用以下命令创建一篇新文章：

1
$ hexo new "My New Post"

更多详情： 如何撰写文章

启动本地服务器

运行本地服务器以预览你的博客：

1
$ hexo server

更多详情： 服务器

生成静态文件

Hexo 生成静态网站文件的命令如下：

1
$ hexo generate

更多详情： 生成静态文件

部署到远程站点

你可以使用以下命令将网站部署到远程服务器或 GitHub Pages：

1
$ hexo deploy

更多详情： 一键部署