Hexo 博客项目说明文档

技术/Hexo博客系统
1.8k 词

Hexo 博客项目说明文档## 项目概述

这是一个基于 Hexo 7.3.0 构建的静态博客系统，使用 Vivia 主题，支持中文内容发布和自动化部署。

项目结构

1
2
3
4
5
6
7
8
9
hexo-blog/
├── _config.yml              # 主配置文件
├── _config.vivia.yml        # Vivia 主题配置文件
├── package.json             # 项目依赖和脚本配置
├── scaffolds/               # 文章模板目录
├── source/                  # 源文件目录（md文章存放目录）
├── themes/                  # 主题目录
├── public/                  # 生成的静态文件（构建后）
└── node_modules/            # 依赖包目录

核心配置文件

_config.yml (主配置)

  • 站点信息: 标题、作者、语言(zh-CN)、时区设置
  • URL配置: 永久链接格式、美化URL设置
  • 目录结构: 源文件、公共文件、标签、分类、归档目录配置
  • 写作设置: 新文章命名规则、默认布局、代码高亮配置
  • 分页设置: 首页生成器、每页文章数量
  • 主题配置: 当前使用 Vivia 主题

_config.vivia.yml (主题配置)

  • 头部菜单: 首页、归档、关于页面导航
  • 外观设置: 主题色调(250)、横幅配置
  • 个人信息: 头像、作者名、副标题、社交媒体链接
  • 侧边栏: 个人资料、分类、标签等小部件配置
  • 评论系统: Valine 和 Twikoo 评论插件配置
  • 统计分析: Google Analytics、百度统计配置

目录功能说明

scaffolds/ - 文章模板

  • draft.md: 草稿模板
  • page.md: 页面模板
  • post.md: 文章模板（包含 title、date、tags 字段）

source/ - 源文件目录

  • _drafts/: 草稿文章
  • _posts/: 已发布文章
    • 技术/: 技术分类文章
      • ai/: AI 相关技术文章
  • about/: 关于页面
    • index.md: 关于页面内容

themes/ - 主题目录

  • vivia/: 当前使用的 Vivia 主题
    • languages/: 多语言支持
    • layout/: 布局模板文件
    • scripts/: 主题脚本
    • source/: 主题资源文件（CSS、JS、图片）
  • webmneg-theme/: 备用主题

功能特性

1. 文章管理

  • 支持 Markdown 格式写作
  • 自动分类和标签系统
  • 草稿和发布状态管理

2. 主题功能

  • 响应式设计，支持移动端
  • 侧边栏小部件（个人资料、分类、标签）
  • 社交媒体链接集成
  • 评论系统支持（Valine、Twikoo）

3. 部署能力

  • 本地开发服务器
  • 静态文件生成
  • 自动化部署脚本（支持热铁盒部署）

技术栈

  • 框架: Hexo 7.3.0
  • 主题: Vivia
  • 渲染器:
    • hexo-renderer-ejs
    • hexo-renderer-marked
    • hexo-renderer-stylus
  • 生成器:
    • hexo-generator-archive (归档)
    • hexo-generator-category (分类)
    • hexo-generator-index (首页)
    • hexo-generator-tag (标签)
  • 工具:
    • hexo-server (开发服务器)
    • hexo-symbols-count-time (字数统计)

使用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 清理缓存
npm run clean

# 生成静态文件
npm run build

# 启动开发服务器
npm run server

# 部署到生产环境
npm run deploy

# 使用热铁盒部署
npm run deploy:rth

文章结构

文章存储在 source/_posts/ 目录下，按分类组织：

  • 技术类文章放在 技术/ 子目录
  • 使用 YAML Front Matter 定义元数据：
    1
    2
    3
    4
    5
    ---
    title: 文章标题
    date: 创建时间
    tags: [标签1, 标签2]
    ---

部署配置

项目配置了热铁盒自动化部署：

  • 通过 PowerShell 脚本下载部署工具
  • 自动将 public/ 目录内容部署到指定域名
  • 支持 blog.webmeng.top 域名部署

开发建议

  1. 新文章创建: 使用 hexo new post "文章标题" 命令
  2. 本地测试: 运行 npm run server 查看效果
  3. 主题定制: 修改 _config.vivia.yml 文件
  4. 部署前: 确保运行 npm run build 生成最新静态文件

注意事项

  • 配置文件中的敏感信息（如统计ID）需要实际使用时配置
  • 部署前确保所有依赖已安装（npm install）
  • 主题文件修改后需要重启服务器生效

最后更新: 2025年9月20日