根目录 > source

内容管理模块

模块职责

source模块是Nexus博客的内容管理中心，包含所有博客文章、页面内容、静态资源和元数据配置。该模块负责内容的创建、组织和管理，是整个博客系统的核心内容源。

入口与启动

  • 博客文章: _posts/ - 所有Markdown格式的博客文章
  • 独立页面: about/ - 关于页面等独立内容页面
  • 文章索引: posts/ - 文章列表和索引页面
  • 资源配置: robots.txt - 搜索引擎爬虫配置

对外接口

内容结构

source/
├── _posts/                    # 博客文章目录
│   ├── hello-world-hexo-blog-start.md        # Hexo默认欢迎文章
│   ├── understanding-and-solving-cors.md  # 跨域解决方案
│   ├── modern-cpp-programming-complete-guide.md  # C++编程教程
│   ├── cpp-snake-game-tutorial.md  # C++贪吃蛇游戏教程
│   ├── why-rust-is-mandatory-for-future-systems.md  # Rust技术观察
│   ├── life-in-suzhou-as-guilin-native.md  # 苏州生活随笔
│   ├── memories-from-dali-yunnan-trip.md  # 云南旅行笔记
│   └── ling-er-poetry-immortal-mortal-life.md  # 文学创作
├── about/                     # 独立页面
│   └── index.md              # 关于页面内容
├── posts/                     # 文章页面
│   └── index.md              # 文章列表页面
└── robots.txt                 # 搜索引擎配置

文章元数据格式

---
title: 文章标题
date: 2025-11-03 21:35:17  # 必须通过MCP时间服务获取当前时间戳
tags: [标签1, 标签2]
categories:
  - 分类名
author: Chiway Wang
description: 文章描述
keywords: 关键词1, 关键词2
cover: /images/cover.jpg
toc: true
---

文章内容...

时间戳获取规范

强制要求：创建任何Hexo博文时，必须调用MCP时间服务获取当前时间戳。

# 调用MCP时间服务命令
mcp__time__get_current_time(timezone: "Asia/Shanghai")

# 时间戳格式要求
date: YYYY-MM-DD HH:MM:SS  # 使用 Asia/Shanghai 时区

关键依赖与配置

Hexo配置依赖

  • 主配置文件: _config.yml - Hexo全局配置
  • 主题配置: themes/hexo-theme-typing/_config.yml - 主题特定配置
  • 生成器配置: 支持多种生成器插件配置

内容生成器插件

  • hexo-generator-index: 首页生成器
  • hexo-generator-archive: 归档页面生成器
  • hexo-generator-category: 分类页面生成器
  • hexo-generator-tag: 标签页面生成器
  • hexo-generator-feed: RSS订阅生成器
  • hexo-generator-sitemap: 站点地图生成器

数据模型

文章数据结构

文章模型:
  - title: 标题
  - date: 发布日期
  - updated: 更新日期
  - tags: 标签数组
  - categories: 分类层级
  - author: 作者
  - description: 描述
  - keywords: 关键词
  - cover: 封面图片
  - toc: 目录开关
  - content: Markdown内容

分类和标签系统

  • 分类: 支持层级分类结构
  • 标签: 扁平化标签系统
  • 自动归档: 按日期自动归档

测试与质量

内容验证

  • Markdown语法检查: 确保语法正确性
  • 图片链接验证: 检查图片资源可用性
  • 元数据完整性: 确保必要字段完整
  • SEO优化: 自动生成meta标签和结构化数据

发布流程

# 创建新文章
hexo new "文章标题"

# 创建新页面
hexo new page "页面名称"

# 生成静态文件
hexo generate

# 预览效果
hexo server

常见问题 (FAQ)

  1. 如何添加新文章?

    • 使用hexo new "标题"命令创建
    • 或直接在_posts/目录创建Markdown文件

  2. 如何设置文章封面?

    • 在Front Matter中添加cover: /path/to/image.jpg
    • 图片放在source/目录下

  3. 如何创建分类和标签?

    • 在Front Matter中指定categories和tags字段
    • 分类支持多级结构

  4. 如何设置文章摘要?

    • 在文章中插入<!-- more -->分隔符
    • 或在Front Matter中设置excerpt字段

相关文件清单

文章文件

  • _posts/hello-world-hexo-blog-start.md - Hexo默认欢迎文章
  • _posts/understanding-and-solving-cors.md - 跨域解决方案教程
  • _posts/modern-cpp-programming-complete-guide.md - C++编程完全指南
  • _posts/cpp-snake-game-tutorial.md - C++贪吃蛇游戏教程
  • _posts/why-rust-is-mandatory-for-future-systems.md - Rust技术观察
  • _posts/life-in-suzhou-as-guilin-native.md - 苏州生活随笔
  • _posts/memories-from-dali-yunnan-trip.md - 云南旅行笔记
  • _posts/ling-er-poetry-immortal-mortal-life.md - 文学创作

页面文件

  • about/index.md - 关于页面内容
  • posts/index.md - 文章列表页面
  • robots.txt - 搜索引擎爬虫配置

配置文件

  • _config.yml - Hexo主配置文件（项目根目录）

内容创作指南

文章类型

  1. 技术教程: 详细的编程和技术指导
  2. 项目实战: 实际项目开发经验分享
  3. 工具介绍: 开发工具和资源推荐
  4. 行业洞察: 技术趋势和行业分析

写作规范

  • 标题: 简洁明确，包含核心关键词
  • 结构: 清晰的层次结构，使用合适的标题级别
  • 代码: 提供可运行的代码示例，指定语言类型
  • 图片: 使用描述性的alt文本，合理的尺寸
  • 链接: 确保所有链接有效，使用描述性文字

SEO优化

  • 关键词: 在标题、描述和内容中合理分布关键词
  • 元数据: 完善description和keywords字段
  • 结构化数据: 利用Hexo插件自动生成结构化数据
  • 内链: 在文章中添加相关文章的内部链接

变更记录 (Changelog)

  • 2025-11-09 23:26:30 - 添加时间戳获取规范，强制要求使用MCP时间服务
  • 2025-11-03 21:35:17 - 初始化内容管理模块文档
  • 2025-11-02 - 创建C++编程完全指南和贪吃蛇游戏教程
  • 2025-11-02 - 添加跨域问题解决方案文章
  • 初始版本 - 创建hello-world默认文章

本文档由AI辅助生成，遵循模块实际情况。最后更新: 2025-11-09 23:26:30