站点根目录(site root)
当前站点相对于 publishDir 的根目录,可包含一个或多个内容维度前缀。
开始之前,你需要
- 在文档里遇到不认识的 Hugo 术语时查阅
读完之后你能
- 能判断当前站点的根目录层级,并预判发布产物会落在哪个子目录
接着读:目录结构
站点根目录(site root)是当前 site 的根目录,相对于 publishDir。_站点根目录_可以包含一个或多个内容 dimension 前缀,例如 language、role 或 version。
| 项目说明 | 站点根目录示例 | |
|---|---|---|
| 单语言 | /、/guest、/guest/v1.2.3 |
|
| 多语言单主机 | /en、/guest/en、/guest/v1.2.3/en |
|
| 多语言多主机 | /en、/en/guest、/en/guest/v1.2.3 |
为什么重要
站点根目录决定发布产物里的路径层级:单语言项目通常是 /,多语言单主机项目则是 /en、/zh。它直接影响「构建结果落在哪个子目录」以及相关路径怎么写;不清楚它,把站点部署到二级目录时就容易到处写错链接。