这是 hexo-theme-xongyi 的开发过程系列:一套面向机构官网(企业 / 政务 / 教育)的 Hexo 通用主题,从需求拆解到真实客户站落地的完整路径。
一句话
三套预设 + 12 个可编排首页板块 + 60+ 项配置,客户改文案不用碰代码,推到 GitHub 就上线。
全系列篇目
| # | 篇目 | 你会拿到什么 |
|---|---|---|
| 一 | 机构官网到底需要什么 | 与个人博客的四个本质差异、三类客户诉求、仓库形态的两次取舍 |
| 二 | 三套预设布局 | body.preset-* 只覆盖变量、预设的边界、政务红对比度、新增第四套预设 |
| 三 | 首页板块系统 | 7 行模板 + 一个数组驱动 12 个板块、合并板块静默跳过的坑 |
| 四 | 配置即产品 | 按页面区域分组、_config.<主题名>.yml 覆盖升级不丢、配置项取舍 |
| 五 | 内容建模 | 新闻 / 页面 / 结构化数据三层模型、front-matter 与目录约定 |
| 六 | 零依赖前端 | 防闪烁暗色、内联 SVG 图标 helper、无后端表单、两个 IntersectionObserver |
| 七 | 部署工程化 | 五平台配置对照、三个「本地能跑平台 404」的坑 |
| 八 | 从主题到产品 | 仓库形态改造、演示站、真实客户站、两套主题的方法论差异 |
建议的阅读顺序
先理解需求
机构官网的客户不是开发者——这个约束决定了后面所有取舍。读完这两篇就能判断这套思路适不适合你的场景。
再看两个核心机制
预设(换气质)与板块数组(换结构)是这套主题的两根支柱,各自独立,可挑着读。
然后是实现细节
内容怎么存、前端怎么做。写过 Hexo 主题的人可以跳过第五篇的前半部分。
最后是交付
部署与产品化。如果你的主题要给客户用,这两篇的取舍判断比代码更有参考价值。
适合谁
- 要给机构 / 客户做官网:第一、四、八篇讲的是需求、配置组织与交付方式;
- 想做可换肤的主题:第二篇的预设机制可直接照搬;
- 想让首页可编排:第三篇的数组驱动 + 命名约定;
- 关心零依赖前端:第六篇的暗色、图标、表单、动效实现。
相关资源
姐妹系列
本系列面向「机构官网」,另一系列 从零造一个 Hexo 主题 面向「博客 / 笔记 / 文档」三模式主题。两者是同一套作者、不同的产品定位,第八篇末尾有对比。