Hexo文档库使用指南

本文档库基于Hexo静态网站生成器，使用prontera主题，并配置了自动GitHub同步。

📚 基本信息

📝 添加新文档

1. 创建文档文件

在 /root/website/hexo/source/_posts/ 目录下创建新的Markdown文件，必须包含Front Matter：

1
2
3
4
5
6
7
8
9
10
11
---
title: 文档标题
date: 2026-02-06 08:00:00
categories:
  - 分类名称
tags:
  - 标签1
  - 标签2
---

# 文档内容开始...

2. 生成静态网站

1
2
cd /root/website/hexo
npx hexo generate

3. 自动推送到GitHub

  • 自动方式: Cron任务每10分钟自动检查并推送
  • 手动方式: 运行 /root/website/hexo/auto-push.sh

🎨 支持的功能

Mermaid图表

支持Mermaid语法绘制流程图、序列图等（需安装插件）：

1
2
3
graph LR
    A[开始] --> B[处理]
    B --> C[结束]

分类和标签

  • 分类: 适用于大的主题分组（如：架构、金融分析、开发）
  • 标签: 适用于细粒度的主题标记（如：Git、NASDAQ、技术栈）

访问：

🔧 常用命令

新建文章

1
2
cd /root/website/hexo
npx hexo new "文章标题"

生成静态文件

1
2
3
4
cd /root/website/hexo
npx hexo generate
# 或简写
npx hexo g

清理缓存

1
2
cd /root/website/hexo
npx hexo clean

本地预览

1
2
3
cd /root/website/hexo
npx hexo server -p 4000
# 访问 http://localhost:4000

🚀 自动化机制

自动推送GitHub

脚本位置: /root/website/hexo/auto-push.sh

Cron配置:

1
*/10 * * * * /root/website/hexo/auto-push.sh >> /root/website/hexo/auto-push.log 2>&1

查看推送日志:

1
tail -f /root/website/hexo/auto-push.log

Nginx静态文件服务

配置文件: /etc/nginx/sites-available/md.zeelool.asia

文档根目录: /root/website/hexo/public

SSL证书: Let’s Encrypt（自动续期）

重载Nginx:

1
systemctl reload nginx

📂 目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/root/website/hexo/
├── _config.yml              # 主配置文件
├── source/
│   ├── _posts/              # 文章目录
│   ├── categories/          # 分类页面
│   ├── tags/                # 标签页面
│   └── pages/               # 独立页面
├── themes/
│   ├── prontera/            # 当前主题
│   └── landscape/           # 默认主题
├── public/                  # 生成的静态文件（Nginx服务目录）
├── auto-push.sh             # 自动推送脚本
├── auto-push.log            # 推送日志
└── package.json             # 项目依赖

🎯 最佳实践

Front Matter模板

1
2
3
4
5
6
7
8
9
10
11
---
title: 标题（必填）
date: YYYY-MM-DD HH:mm:ss（必填）
categories:
  - 主分类
  - 子分类（可选）
tags:
  - 标签1
  - 标签2
  - 标签3
---

分类建议

  • 架构: 系统设计、技术架构相关
  • 金融分析: 投资、市场分析相关
  • 开发: 代码、技术实现相关
  • 指南: 使用说明、教程相关
  • notes: 工作记录、会议纪要等

标签建议

使用具体的、可搜索的关键词，例如：

  • 技术类：Git, Mermaid, Docker, K8s, Nginx
  • 金融类：NASDAQ, S&P500, 红利策略
  • 项目类：项目名称、模块名称

🔗 相关链接

🆘 故障排除

网站无法访问

1
2
3
4
5
6
7
8
# 检查Nginx状态
systemctl status nginx

# 重启Nginx
systemctl restart nginx

# 检查静态文件是否生成
ls -la /root/website/hexo/public/

GitHub推送失败

1
2
3
4
5
6
7
# 查看推送日志
tail -50 /root/website/hexo/auto-push.log

# 手动测试推送
cd /root/website/hexo
git status
git push origin main

主题渲染失败

如果生成的HTML是模板源代码，检查是否安装了对应的渲染器：

1
2
3
4
5
6
7
# prontera使用Jade模板
cd /root/website/hexo
npm install hexo-renderer-jade --save

# 重新生成
npx hexo clean
npx hexo generate

Mermaid图表不显示

安装Mermaid插件：

1
2
cd /root/website/hexo
npm install hexo-filter-mermaid-diagrams --save

然后在 _config.yml 中添加：

1
2
mermaid:
  enable: true

🔑 关键依赖

1
2
3
4
5
6
{
  "hexo": "^8.1.1",
  "hexo-renderer-jade": "^0.5.0",
  "hexo-renderer-ejs": "^2.0.0",
  "hexo-renderer-marked": "^7.0.1"
}

📊 网站统计

  • 文章数量：动态更新
  • 分类数量：5+
  • 标签数量：20+
  • 月均访问：待统计
  • GitHub星标：待积累

文档库维护者: Vincent Zhang (贾维斯)
最后更新: 2026-02-06 08:16 UTC
项目状态: ✅ 正式上线