hexo-blog/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个基于 Hexo 静态站点生成器的个人技术博客，使用 Next 主题。博客主要包含 Java、前端开发（React）、架构设计等技术文章。

常用命令

开发与预览

# 启动本地开发服务器
npm run server
# 或
hexo server

# 清理生成的文件
npm run clean
# 或
hexo clean

构建与部署

# 生成静态文件
npm run build
# 或
hexo generate

# 部署到远程服务器
npm run deploy
# 或
hexo deploy

创建新文章

# 创建新文章（使用 scaffolds/post.md 模板）
hexo new post "文章标题"

# 创建草稿
hexo new draft "草稿标题"

目录结构

hexo-blog/
├── _config.yml           # Hexo 主配置文件
├── _config.landscape.yml # Landscape 主题配置（未使用）
├── source/               # 源文件目录
│   ├── _posts/          # 博客文章（Markdown 格式）
│   ├── _drafts/         # 草稿文章
│   ├── _discarded/      # 已废弃文章
│   ├── _data/           # 自定义数据文件
│   ├── images/          # 图片资源
│   ├── about/           # 关于页面
│   ├── categories/      # 分类页面
│   ├── tags/            # 标签页面
│   └── guestbook/       # 留言板页面
├── themes/
│   ├── next/            # Next 主题（当前使用）
│   └── landscape/       # Landscape 主题（备用）
├── scaffolds/           # 文章模板
│   └── post.md          # 默认文章模板
└── db.json              # hexo-admin 数据库文件

配置架构

主配置文件 (_config.yml)

• 设置站点标题、作者、语言等基本信息
• 配置 URL 和永久链接格式
• 启用插件：mermaid 图表、搜索、分享功能等
• 部署配置：部署到 VPS 服务器

Next 主题配置 (themes/next/_config.yml)

• 使用 Mist scheme
• 自定义样式文件：source/_data/styles.styl
• 菜单配置：首页、关于、标签、分类等
• 启用百度推送、评论系统（Waline）、分享功能等

自定义样式 (source/_data/styles.styl)

• 文章块样式：圆角、阴影、透明效果
• 代码块样式：自定义颜色和边框
• 自定义文字样式类：highlight-text、wavy-underline、gradient-text 等
• 自定义分隔线样式：渐变、波浪、科技感等
• AI 标签样式：带闪光动画效果

文章格式

Front Matter

每篇文章应包含以下元数据：

---
title: 文章标题
author: Gamehu
tags:
  - 标签1
  - 标签2
categories:
  - 分类名
date: YYYY-MM-DD HH:mm:ss
---

文章资源

• 启用了 post_asset_folder: true，每篇文章可以有自己的资源文件夹
• 图片引用使用 {% asset_img filename.png 描述 %} 标签

主题定制

自定义文件路径

主题支持在 source/_data/ 目录下创建自定义文件来覆盖主题默认设置：

• styles.styl - 自定义样式（已使用）
• head.njk - 自定义 head 标签内容
• body-end.njk - 自定义 body 结束标签前的内容
• 等等...

样式类

博客定义了多个自定义样式类，可在文章中使用：

• .highlight-text - 黄色背景标注
• .wavy-underline - 波浪下划线
• .gradient-text - 渐变色文字
• .ai-tag - AI 标签（带闪光效果）
• .article-quote - 引言样式
• .divider-* - 各种分隔线样式

部署

• 部署方式：Git deployer
• 部署目标：VPS 服务器（ssh://root@104.128.95.214:28915/home/git/blog.git, master 分支）
• SEO 配置：启用了 sitemap、baidu sitemap、RSS 订阅