术语表

服务器相对路径(server-relative)

生成站点中从 Web 服务器根目录算起的最终路径,含 baseURL 与内容维度前缀。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 能分清服务器相对路径与站点相对路径,并在多语言或子目录部署下选对写法

接着读:URL 管理

服务器相对路径(server-relative)是生成站点中使用的、从 Web 服务器根目录算起的最终路径。这类路径总是以斜杠开头,并且计入了 baseURL 以及语言、role 或版本等 content dimension 前缀。例如,/en/examples/old-name/ 就是一条服务器相对路径。

另请参见:page-relative、site-relative。

为什么重要

服务器相对路径是「部署后浏览器实际请求的最终路径」,已经计入 baseURL 与语言、角色、版本前缀。调试「本地正常、上线 404」时先分清手的路径属于哪一种:多语言或部署在子目录时,手写的 /about/(站点相对路径)会漏掉 /en/ 之类前缀,而 .RelPermalink 生成的正是正确的服务器相对路径。

延伸阅读:URL 管理、永久链接配置