Hexo 博客使用指南

项目使用 Hexo（基于 Node.js）生成博客内容，配合自定义主题展示。

📁 目录结构

目录	用途	说明
`myblogs/`	最终网站	上传到 GitHub Pages 的目录
`myblogs/blog/`	生成的内容	Hexo 自动生成，无需手动管理
`myblogs/assets/images/`	图片资源	存放头像等图片
`blog_manage/`	博客管理	Hexo 源文件和工作区
`blog_manage/source/_posts/`	文章源文件	存放 Markdown 文章
`blog_manage/source/images/`	文章封面图	定义在yaml当中

🎨 个性化设置

1. 主页信息修改

打开 myblogs/index.html，修改以下内容：

位置	修改内容
Line 6	`<title>Cat's Blog</title>` - 网站标题
`"highlight">你的名字<`	你的名字
`<h3>科研论文</h3>`	论文列表内容
`<h3>个人项目</h3>`	项目列表内容
`<h4>邮箱</h4>`	联系邮箱

2. 头像设置

1	myblogs\assets\images\avatar.jpg

将你的头像图片移动到上述路径，命名为 avatar.jpg

3. 博客标题配置

打开 blog_manage\themes\my_theme\_config.yml

1	title: Cat's Blog # 修改为你的博客标题

✍️ 撰写文章

创建新文章

在 blog_manage\source\_posts 目录下创建 Markdown 文件

文章 Front Matter（YAML 配置）

每个 Markdown 文件开头必须包含 YAML 配置，用于定义文章属性。

技术分享类

---
title: 标题
date: 2026-02-05 10:00:00
categories: 技术分享
tags:
  - 环境变量
  - Path
  - CMD
cover: /images/unnamed.jpg
---

项目展示类

---
title: 在线教育平台
date: 2025-09-15 10:00:00
categories: 项目展示
project_type: 全栈项目
tags:
  - React
  - Spring Boot
  - MySQL
  - WebRTC
cover: /images/unnamed.jpg
description: 基于微服务架构的在线教育平台
demo_url: https://edu-demo.example.com
github_url: https://github.com/username/online-education
---

常用字段说明

字段	说明	适用场景
`title`	文章标题	必填
`date`	发布日期	必填
`categories`	文章分类	用于路由分组
`tags`	标签列表	多个标签分类
`cover`	封面图片	显示在列表页
`description`	项目描述	项目展示
`demo_url`	演示链接	项目展示
`github_url`	GitHub 链接	项目展示

🚀 生成与部署

生成博客

在 blog_manage 目录下运行：

1	npx hexo g

该命令会：

读取 source/_posts 下的 Markdown 文件
根据 _config.yml 配置生成静态文件
输出到 myblogs/blog 目录

本地预览测试

⚠️ 每次生成后建议进行本地测试

在 blog_manage 目录下运行：

1	npx hexo s

该命令会启动本地服务器，默认地址为 http://localhost:4000，你可以在浏览器中预览博客效果。测试完了之后再git到仓库。

部署到 GitHub Pages

⚠️ 重要：只提交 myblogs 目录，不要提交 blog_manage

# 1. 提交生成的文件（仅提交 myblogs）
git add myblogs/
git commit -m "更新博客"
git push

# 2. GitHub Pages 自动更新

入口文件：myblogs/index.html

说明：

myblogs/ - 最终网站文件，需要提交

blog_manage/ - Hexo 源文件，无需提交（本地管理即可）

📝 日常更新流程

graph LR
    A[编辑/新增 Markdown 文件] --> B[blog_manage/source/_posts]
    B --> C[运行 npx hexo g]
    C --> D[生成到 myblogs/blog]
    D --> E[git 提交推送]
    E --> F[GitHub Pages 自动更新]

步骤	操作	命令/位置
1️⃣	编辑文章	`blog_manage/source/_posts/`
2️⃣	生成博客	`npx hexo g`
3️⃣	提交更改	`git add myblogs/`
4️⃣	推送更新	`git push`

💡 注意事项

myblogs/blog 目录由 Hexo 自动生成，不要手动编辑
图片资源放在 myblogs/assets/images/ 目录
确保 Node.js 已安装（Hexo 基于 Node.js）
每次更新文章后都需要运行 npx hexo g 重新生成