hugo.IsMultihost
报告每个已配置的语言是否拥有各自独立的 base URL。
这一页解决什么问题
多语言站有两种发布形态:所有语言共用一个域名、按子路径区分(example.org/de/、example.org/en/),或者每种语言一个域名(de.example.org、en.example.org)。后者的产物组织结构完全不同(没有站点根目录下的入口页,而是每种语言各写一套)。hugo.IsMultihost 报告当前配置是否属于后者——每个语言都有各自的 baseURL 时为真。
什么时候用,什么时候别用
该用:
- 主题/布局要兼容两种多语言形态,需要分别处理(例如 multihost 下不要硬编码一个"站点根");
- 排查「为什么产物里没有根目录
index.html」——multihost 下这是正常的(实测)。
别用:
- 只想判断「是否配置了多个语言」 → 用
hugo.IsMultilingual:只有两个及以上语言时它为真,而IsMultihost还额外要求每种语言有独立baseURL(实测:同一份两语言配置,去掉各语言的baseURL后IsMultihost变假,IsMultilingual仍为真); - 想拿当前语言的地址 → 用
site.BaseURL、.Permalink等方法。
项目配置:
toml
defaultContentLanguage = 'de'
defaultContentLanguageInSubdir = true
[languages]
[languages.de]
baseURL = 'https://de.example.org/'
label = 'Deutsch'
locale = 'de-DE'
title = 'Projekt Dokumentation'
weight = 1
[languages.en]
baseURL = 'https://en.example.org/'
label = 'English'
locale = 'en-US'
title = 'Project Documentation'
weight = 2模板:
go-html-template
{{ hugo.IsMultihost }} → true完整示例:按发布形态输出不同的说明
layouts/index.htmlgo-html-template
<p>语言数:{{ len site.Languages }}</p>
<p>多语言:{{ hugo.IsMultilingual }}</p>
<p>多主机:{{ hugo.IsMultihost }}</p>
{{ if hugo.IsMultihost }}
<p>每种语言有独立域名,产物按语言分目录输出。</p>
{{ end }}用上面那份配置,在本机(Hugo 0.167.0 extended,Windows)实测 hugo --source <临时目录> --ignoreCache 后,public/de/index.html 与 public/en/index.html 内容均为:
html
<p>语言数:2</p>
<p>多语言:true</p>
<p>多主机:true</p>
<p>每种语言有独立域名,产物按语言分目录输出。</p>你应当看到什么:不再有站点根目录下的 public/index.html,而是 public/de/index.html、public/en/index.html 各一份(实测)。把各语言的 baseURL 删掉再构建,IsMultihost 就变成 false。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,Windows;配置为上文(两语言 + 各自 baseURL)。
| 情况 | 结果 | 是否报错 |
|---|---|---|
两语言,各有独立 baseURL |
true |
否 |
两语言,共用站点 baseURL(无各语言 baseURL) |
false(同时 IsMultilingual 为 true) |
否 |
| 单语言 | false |
否 |
传入参数 {{ hugo.IsMultihost "x" }} |
—— | 是:wrong number of args for IsMultihost: want 0 got 1 |
返回类型(printf "%T") |
bool |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么改 |
|---|---|---|---|
| 没报错但结果不对 | 部署后根域名返回 404,找不到首页 | multihost 配置下不生成根目录入口页(实测产物只有 public/<lang>/index.html) |
在每个语言的域名上配置首页/重定向,或改用单域名 + 子路径的配置 |
| 没报错但结果不对 | 以为配了两个语言就一定是 multihost | 还需每种语言各写 baseURL |
用 hugo.IsMultilingual 判语言数,用本函数判发布形态 |
| 报错看不懂 | wrong number of args for IsMultihost: want 0 got 1 |
给它传了参数 | 它无参数,直接用在 if 里 |
更多排查入口见故障排查。