logo
0
0
WeChat Login

Hexo Blog

基于Hexo框架构建的个人博客系统,支持自动化部署到EdgeOne Pages。

📋 项目简介

这是一个使用Hexo静态网站生成器搭建的博客项目,采用anzhiyu主题,集成了CNB平台自动化部署功能,实现代码推送后自动构建和部署。

🚀 快速开始

环境要求

  • Node.js 16.0+
  • npm 或 yarn
  • Git

本地安装

# 克隆项目 git clone <your-repository-url> cd hexo-blog # 安装依赖 npm install # 或 yarn install

本地运行

# 启动本地服务器 hexo server # 访问 http://localhost:4000

📝 常用命令

# 创建新文章 hexo new "文章标题" # 生成静态文件 hexo generate # 或 hexo g # 启动本地服务器 hexo server # 或 hexo s # 部署到远程 hexo deploy # 或 hexo d # 清理缓存 hexo clean

🛠️ 项目结构

hexo-blog/ ├── _config.yml # Hexo主配置文件 ├── _config.anzhiyu.yml # anzhiyu主题配置文件 ├── _config.landscape.yml # landscape主题配置文件 ├── package.json # 项目依赖配置 ├── .cnb.yml # CNB自动化部署配置 ├── source/ # 源文件目录 │ ├── _posts/ # 博客文章目录 │ └── _drafts/ # 草稿目录 ├── themes/ # 主题目录 ├── public/ # 生成的静态文件 ├── scaffolds/ # 文章模板 └── db.json # 数据库文件

🎨 主题配置

本项目使用anzhiyu主题,相关配置在 _config.anzhiyu.yml 文件中:

  • 主题颜色和样式
  • 导航菜单配置
  • 社交媒体链接
  • 评论系统集成
  • 统计分析配置

🚀 自动化部署

项目集成了CNB平台进行自动化部署,配置文件为 .cnb.yml

部署流程

  1. 依赖安装: 使用yarn安装项目依赖
  2. 项目构建: 生成静态文件到dist目录
  3. 自动部署: 部署到EdgeOne Pages

环境变量配置

需要在CNB平台配置以下环境变量:

  • CN_EDGEONE_PAGES_API_TOKEN: EdgeOne Pages API令牌

部署触发

代码推送到main分支后,自动触发构建和部署流程。

✍️ 写作指南

文章格式

--- title: 文章标题 date: 2025-11-25 categories: - 分类名 tags: - 标签1 - 标签2 --- 文章内容...

图片资源

将图片放在 source/images/ 目录下,在文章中引用:

![图片描述](/images/image-name.jpg)

🔧 自定义配置

站点信息

_config.yml 中修改站点基本信息:

# Site title: 你的博客标题 subtitle: 副标题 description: 站点描述 author: 作者名 language: zh-CN timezone: Asia/Shanghai

主题定制

修改 _config.anzhiyu.yml 来自定义主题:

  • 导航菜单
  • 侧边栏配置
  • 颜色方案
  • 功能开关

📚 扩展功能

评论系统

支持集成多种评论系统:

  • Gitalk
  • Valine
  • Twikoo
  • Giscus

统计分析

可集成:

  • Google Analytics
  • 百度统计
  • 腾讯分析

🤝 贡献指南

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

  • Hexo - 强大的静态网站生成器
  • anzhiyu - 美观的主题
  • CNB - 自动化部署平台
  • EdgeOne - 静态网站托管服务

📞 联系方式

如有问题或建议,欢迎通过以下方式联系:

  • 提交 Issue
  • 发送邮件
  • 社交媒体

⭐ 如果这个项目对您有帮助,请给它一个星标!

About

hexo-blog

Language
Stylus32.3%
JavaScript30.6%
CSS18.3%
Others18.8%