Blog 视觉与阅读体验追加优化开发文档
项目: Blog-Hexo (Butterfly 主题定制)阶段: 工作区追加优化基准提交: 10e4a3a 之后优化周期: 2026-07-11 至 2026-07-12样式入口: source/css/custom.css模块目录: source/css/modules/主要目标: 提升首页视觉表现、文章阅读体验、长文目录可用性与移动端可读性。 目录 优化目标 文件分类 优化总览 模块详解 首页 Hero 与头图 导航栏 首页文章卡片 侧栏与目录 文章正文排版 代码块与行内代码 移动端适配 主题变量...
Blog 代码主题与目录锚点修复开发文档
项目: Blog-Hexo (Butterfly 主题定制)阶段: 代码阅读与目录跳转修复提交范围: 18d27c5 至 10e4a3a关键文件: code-highlight.css / typography.css / responsive.css / themes/butterfly/source/js/main.js 目录 提交范围 优化目标 代码主题对齐 目录跳转偏移 实时目录锚点映射 影响范围 验证要点 后续建议 提交范围 提交 日期 说明 18d...
Blog 素材性能与全屏头图配置开发文档
项目: Blog-Hexo (Butterfly 主题定制)阶段: 素材性能与头图体验提交范围: 4b68bdb 至 3f39d93关键文件: _config.butterfly.yml / header-text.css / scaffolds/post.md / source/img/ 目录 提交范围 优化目标 视觉素材压缩 首页全屏透明头图 文章自定义头图 脚手架更新 文档同步 验证要点 提交范围 提交 日期 说明 4b68bdb 2026-07-11 ...
Blog 全站视觉系统重构开发文档
项目: Blog-Hexo (Butterfly 主题定制)阶段: 全站视觉系统重构提交范围: 00973e8 至 26adced样式入口: source/css/custom.css模块目录: source/css/modules/ 目录 提交范围 重构目标 文件分类 主题变量与全局基础 首页首屏、导航与页脚 文章列表、侧栏与卡片 文章正文、代码块与目录 移动端与打印样式 主题配置统一 验证要点 提交范围 提交 日期 说明 00973e8 2026-07-11 重构全站视觉基础与主题变量...
Butterfly 主题接入与仓库清理开发文档
项目: Blog-Hexo阶段: Butterfly 主题接入提交范围: 196591f 至 daedcd4核心目录: themes/butterfly/目标: 将 Butterfly 主题纳入主仓库,并清理不应进入业务仓库的主题 Git 缓存。 目录 提交范围 背景目标 主题文件接入 Git 缓存清理 目录结构说明 后续定制策略 风险与注意事项 提交范围 提交 日期 说明 196591f 2026-07-03 添加 Butterfly 主题文件 daedcd4 2026-07-03 ...
source/css 样式文档
项目: Blog-Hexo (Butterfly 主题定制)入口文件: custom.css模块目录: modules/最后更新: 2026-05-10 目录 架构概览 文件分类 模块详解 主题系统 全局样式 布局组件 内容排版 卡片与表面 页面专用 响应式设计 标签索引 架构概览1234567891011121314151617source/css/├── custom.css└── modules/ ├── variables.css ├── backgroun...