从空目录到上线：hugo-theme-imx 全量配置手册

Wed, 15 Jul 2026 11:00:00 +0800

这篇手册按一个真实站点的顺序来写：先把环境和模块装好，再整理 hugo.toml、内容与图片，最后部署。文中的配置以 IMX 当前模板实际读取的参数为准，不把 Hugo 的数百项通用设置全部塞进来凑数。

如果只想先看效果，下载主题 Release 源码后，在主题目录运行：

hugo server --source exampleSite

但正式建站不要复制 exampleSite/go.mod。其中的 replace github.com/c-x-x/hugo-theme-imx => ../ 只为主题仓库本地开发服务，离开这个目录结构就会失效。

1. 环境与目录

IMX 通过 Hugo Module 安装，最低要求是 Hugo Extended 0.112.0 和 Go 1.20。先确认本机工具：

hugo version
go version
git --version

hugo version 的输出应包含 extended。普通建站不需要 Node.js，也不需要执行主题仓库里的 npm install；Node.js 和 Playwright 只是主题维护者跑回归测试时使用。

新站点可以这样开始：

hugo new site my-blog
cd my-blog
git init
hugo mod init github.com/your-name/my-blog

一个够用的目录大致如下：

my-blog/
├── archetypes/
├── assets/ # 覆盖主题 CSS 等资源时才需要
├── content/
│ ├── _index.md
│ ├── about.md
│ ├── categories/_index.md
│ ├── posts/_index.md
│ └── tags/_index.md
├── static/
│ └── images/
├── go.mod
├── go.sum
└── hugo.toml

public/ 和 resources/_gen/ 都是构建产物，不应当手工维护。建议加入 .gitignore：

配置 on IMX 示例站

从空目录到上线：hugo-theme-imx 全量配置手册

1. 环境与目录