术语表

站点根目录(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。它直接影响「构建结果落在哪个子目录」以及相关路径怎么写;不清楚它,把站点部署到二级目录时就容易到处写错链接。

延伸阅读:目录结构、配置总览