目录树
hugo-site/ 📁 项目根目录
├── config.toml 📄 主配置文件
├── archetypes/ 📁 内容模板
│ ├── default.md 📄 默认模板
│ └── post.md 📄 文章专用模板 (可预置series等字段)
├── content/ 📁 网站核心内容
│ ├── posts/ 📁 文章分区
│ │ ├── cn/ 📁 中文文章 (新增)
│ │ │ ├── _index.md 📄 中文文章列表页
│ │ │ └── hugo-post.md 📄 您的系列文章 (见下图)
│ │ └── en/ 📁 英文文章 (新增)
│ │ └── _index.md 📄 英文文章列表页
│ ├── about.md 📄 “关于”页面
│ └── archives.md 📄 “归档”页面
├── layouts/ 📁 布局模板 (覆盖主题用)
│ ├── _default/ 📁 默认布局
│ ├── partials/ 📁 可复用组件
│ ├── index.html 📄 首页布局
│ └── section/ 📁 分区布局
├── static/ 📁 静态资源
│ ├── images/ 📁 网站图片
│ └── css/ 📁 自定义样式
├── themes/ 📁 主题目录
└── public/ 📁 最终生成的网站 (运行`hugo`后出现)
核心目录简要说明
| 目录/文件 | 核心用途说明 |
|---|
**content/** | 你的网站内容(文章、页面)都放在这里,使用 Markdown 格式编写。 |
**layouts/** | 如果你想自定义网站的外观(如修改页眉、页脚、文章布局),可以在这里创建模板文件来覆盖主题默认的样式。 |
**static/** | 存放图片、自定义CSS、JavaScript等文件,这些资源会原样复制到最终生成的网站中。 |
**themes/** | 存放你所使用的Hugo主题。通常不建议直接修改主题内的文件,而是通过 layouts目录覆盖。 |
**archetypes/** | 使用 hugo new命令创建新内容时,会依据此处的模板生成Markdown文件,可预设Front Matter字段。 |
**config.toml** | 网站的核心配置文件,可以设置网站标题、基础URL、主题、菜单等全局参数。 |
**public/** | 执行 hugo命令后,生成的最终静态网站文件会输出到此目录,你需要部署的是这个目录里的所有内容。 |