🌐 多语言建站
最后更新:2026-11-04
在后台「站点管理 → 一键启用语言站点」勾选语言,系统会为每个语言自动创建独立站点、独立模板目录与栏目/导航骨架,前台自动生成语言切换按钮,所有内容按 site_id 隔离。后台路径:后台 → 站点管理(/admin/sites)
⚠️ 版本要求(务必先看)
多语言功能需 专业版及以上授权。基础版客户即使按本章步骤添加了多语言站点,前台也不会输出语言切换按钮与 hreflang 标签(系统自动降级为单语言)。
判定依据是「是否购买过专业版 / 企业版」,与服务是否在有效期内无关——客户买了专业版后即使未续费,多语言站点依然正常。详见 🔑 授权与邮件服务。
📋 多语言相关字段
- {{.LangSwitcher}}多语言切换器数据(数组)NEW数组
- {{.SiteCode}}当前站点代码(如 zh、en)文本
- {{.SiteLanguage}}站点语言(如 zh-CN、en)文本
- {{.SiteID}}当前站点ID数字
每条 LangSwitcher 对象含 Code(站点代码)、Name(显示名称)、URL(跳转地址)、IsCurrent(是否当前)。
🔗 hreflang 互链标签(SEO 用)
{{.LangSwitcher}} 是给访客看的「语言切换按钮」数据;{{.HrefLangs}} 则是专门给搜索引擎看的 `互链数据,两者用途不同,但常配合使用。系统会为**每个启用的站点**自动生成对应语言版本的绝对 URL,并附带一条x-default`(指向默认站点同路径)。
- {{.HrefLangs}}hreflang 互链数组(仅多站点时非空;单站点为 nil)NEW数组
每件 HrefLangs 元素含两个字段:Lang(语言代码,如 zh-CN / en / x-default)与 Href(该语言版本的绝对 URL)。
<!-- 放在 <head> 的 canonical 之后 -->
{{range .HrefLangs}}<link rel="alternate" hreflang="{{.Lang}}" href="{{.Href}}">
{{end}}
只有多于一个启用站点时 {{.HrefLangs}} 才非空,单语言站点无需输出(搜索引擎只看 canonical 即可)。输出顺序不影响 SEO 效果。
💻 使用示例
<!-- 语言切换按钮 -->
{{if .LangSwitcher}}
<div class="lang-switch">
{{range .LangSwitcher}}
<a href="{{.URL}}" class="lang-item{{if .IsCurrent}} active{{end}}">{{if .Name}}{{.Name}}{{else}}{{.Code}}{{end}}</a>
{{end}}
</div>
{{end}}
<!-- 判断当前语言 -->
{{if eq .SiteCode "en"}}
<span>当前为英文站</span>
{{else}}
<span>当前为中文站</span>
{{end}}
<!-- 多语言头部(导航 + 切换) -->
<nav>
{{range .Navigations}}
{{if eq .Location "header"}}
<!-- 导航高亮见 05-navigation.html:用 CurrentNav 映射首段路径加 is-current -->
<a href="{{.Link}}" target="{{.Target}}" class="nav-link {{if eq .CurrentNav "news"}}is-current{{end}}">{{.Name}}</a>
{{end}}
{{end}}
</nav>
{{if .LangSwitcher}}
<div class="lang-switch">
{{range .LangSwitcher}}<a href="{{.URL}}" class="lang-item{{if .IsCurrent}} active{{end}}">{{.Name}}</a>{{end}}
</div>
{{end}}
⚙️ 多语言建站步骤(一键启用)
- 后台「站点管理」→「一键启用语言站点」,勾选需要的语言(en / ja / ko / fr / de / es / ru / pt / it / vi / th / id),点「启用所选语言」。
- 系统对每种语言自动完成:
- 新建一条
sites记录:site_code、language、tpl_path均为语言码(如en),domain留空,前台走/en/二级目录; - 复制默认中文站的公司信息、SEO、页脚设置,以及栏目与导航骨架(不含内容数据);
- 从中文站当前使用的模板目录整目录复制出一套独立模板:多租户落在
<租户目录>/templates/en/,单机落在templates/en/;目录已存在则不覆盖,保护你改过的文件; - 重建模板缓存,前台
/en/立即可访问。
- 新建一条
- 切换到该语言站后台,录入该语言内容;或用「复制为翻译 / AI 全站翻译」生成初稿后人工润色。
- 把复制出来的模板里的中文固定文案(导航、按钮、页脚)改成对应语言。各语言模板互相独立,改英文站不会影响中文站或日文站。
- 头部加入
{{range .LangSwitcher}}显示切换按钮;{{.HrefLangs}}由系统自动生成 hreflang,无需手写。 - 已启用的语言在勾选区显示「已启用」并禁用;重复提交不会重复建站,也不会覆盖已存在的模板目录。
手工方式仍可用:「添加站点」逐个填写名称 / 站点代码 / 语言,模板目录保持默认「自动创建(按站点代码,从中文模板复制)」即可;也可在下拉里直接选一个已有的共享模板目录。
云建站 SaaS