安装与部署

环境要求

项目 要求
Hexo 7.x（推荐）
Node.js >= 18
渲染器 hexo-renderer-ejs（必需）、hexo-renderer-marked（或其它 Markdown 渲染器）
生成器 hexo-generator-index、hexo-generator-archive、hexo-generator-category、hexo-generator-tag
Hexo

上述四个生成器不在 Hexo 7 核心中。如果你是用 hexo init 建站，默认站点已经包含；如果是手动搭的站点，缺首页或归档页时请补装：

Shell
1
npm i hexo-generator-index hexo-generator-archive hexo-generator-category hexo-generator-tag

安装主题

在 Hexo 站点根目录执行：

Shell
1
git clone https://github.com/xfm0797/hexo-theme-xongyi.git themes/hexo-theme-xongyi

好处是可以随时 git pull 获取更新。

从 Releases 或仓库 Code → Download ZIP 下载后，解压到站点的 themes/hexo-theme-xongyi/ 目录。

解压位置

仓库根目录即主题本体，解压后请确认 themes/hexo-theme-xongyi/_config.yml、layout/、source/ 直接位于该目录下（不要多套一层目录）。

适合把站点也托管在 Git 上的场景，主题版本随主仓库一起锁定：

Shell
1
git submodule add https://github.com/xfm0797/hexo-theme-xongyi.git themes/hexo-theme-xongyi

克隆站点时记得带上子模块：

Shell
1
2
3
git clone --recurse-submodules <你的站点仓库>
# 已经克隆过的仓库补拉：
git submodule update --init --recursive

升级主题：

Shell
1
git submodule update --remote themes/hexo-theme-xongyi

启用主题

编辑站点根目录 _config.yml：

YAML
1
theme: hexo-theme-xongyi

然后本地预览：

Shell
1
hexo clean && hexo server

打开 http://localhost:4000，应能看到 Xongyi 的默认企业版首页。

依赖插件（可选）

主题本身不依赖任何额外插件，但下面这些能显著改善官网体验：

插件 作用 建议
hexo-generator-sitemap 生成 sitemap.xml 强烈建议
hexo-generator-feed 生成 RSS（/atom.xml） 新闻动态场景建议
hexo-renderer-marked Markdown 渲染 必装
hexo-server 本地预览服务 必装
Shell
1
npm i hexo-generator-sitemap hexo-generator-feed

推荐做法：站点级覆盖配置

不要在主题目录里直接改 _config.yml。正确姿势是在站点根目录新建 _config.hexo-theme-xongyi.yml，只写你要覆盖的键 —— Hexo 会把它与主题默认配置深度合并：

YAML
1
2
3
4
5
6
7
8
9
10
# 站点根目录 _config.hexo-theme-xongyi.yml
preset: government

brand:
  name: "XX市政务服务网"
  slogan: "为民服务 · 便捷高效"

contact:
  phone: "400-000-0000"
  email: "hello@example.com"
深度合并的好处
  • 只需写与默认值不同的键，未涉及的配置自动沿用主题默认值；
  • git pull 升级主题时，你的自定义内容完全不会丢失；
  • 一份覆盖文件即”站点档案”，迁移与备份都更方便。

配置生效优先级

Text
1
2
3
站点 _config.hexo-theme-xongyi.yml   ← 最高（你写的覆盖）
        ↓ 深合并
主题 themes/hexo-theme-xongyi/_config.yml   ← 默认值（勿直接改）
重新构建

YAML 配置在 hexo generate 时读取。改完配置若页面没变化，先 hexo clean 再 hexo generate，排除缓存干扰。

升级主题

Shell
1
2
3
4
cd themes/hexo-theme-xongyi
git pull
cd ../..
hexo clean && hexo generate
Shell
1
2
git submodule update --remote themes/hexo-theme-xongyi
hexo clean && hexo generate

只要自定义都写在站点根的 _config.hexo-theme-xongyi.yml，升级不会影响你的内容。

懒得配置？直接用演示站

hexo-theme-xongyi-demo 是配好一切的完整站点（主题以 submodule 引入 + 演示内容 + 五大平台部署配置），Fork 后一键部署即可。详见一键部署。

下一步

5 分钟上手
切换预设布局