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%