项目(project)
用于生成一个或多个站点的组件集合。
开始之前,你需要
- 在文档里遇到不认识的 Hugo 术语时查阅
读完之后你能
- 找到项目根目录下决定构建的文件与目录,并理解为什么同一套内容能生成多个站点
接着读:目录结构
项目(project)是用于生成一个或多个 sites 的 components 集合。虽然一个项目可能只包含单个站点,但 Hugo 允许单个项目基于 language、role 和 version 生成站点矩阵。项目是构建中所有站点共用的资源与逻辑的父容器。
为什么重要
命令行的 hugo 总是以项目根为基准:hugo.toml、content/、layouts/、assets/、static/ 都相对它定位,hugo config 输出的也是这一层的生效配置——模板没生效时,先确认文件确实在项目里,而不是只存在于主题目录中。
一个项目可以产出多个站点(多语言、多版本、多角色),模板里 site 与 Sites 的区别、资源路径为何按项目定位,答案都在这里;也正因如此,改一处项目级配置会影响该项目下的所有站点。