i18n.ts
站点支持的语言和默认语言。
config/i18n.ts 配置站点支持的语言和默认语言。语言切换器、页面路径、本地化文案、SEO 多语言链接和 LanguageCode 类型都以这里的配置为准。
languages
站点语言列表至少要有一项,并且 code 不能重复。未注释的对象会加入语言列表;注释中的对象是模板提供的备选语言,取消注释后才会加入列表。
Prop
Type
模板提供以下语言配置,其中只有未注释的对象会加入站点语言列表:
code | name | direction | 文案文件 |
|---|---|---|---|
en | English | ltr | locales/en.json |
es | Español | ltr | locales/es.json |
fr | Français | ltr | locales/fr.json |
de | Deutsch | ltr | locales/de.json |
it | Italiano | ltr | locales/it.json |
pt | Português | ltr | locales/pt.json |
ru | Русский | ltr | locales/ru.json |
ja | 日本語 | ltr | locales/ja.json |
ko | 한국어 | ltr | locales/ko.json |
zh-Hans | 简体中文 | ltr | locales/zh-Hans.json |
zh-Hant | 繁體中文 | ltr | locales/zh-Hant.json |
ar | العربية | rtl | locales/ar.json |
模板已经为表中的语言准备了对应的 JSON 文件,但部分文件仍是空对象占位,存在文件不代表翻译已经完成。启用语言前应补全并检查翻译。添加其他语言时,还要创建 locales/<code>.json。配置文件末尾导出的 LanguageCode 只包含未注释的数组项。按照模板默认配置生成的类型为:
type LanguageCode = 'en' | 'zh-Hans' | 'zh-Hant';defaultLanguage
Prop
Type
defaultLanguage 必须与 languages[].code 中的一项完全一致。默认语言的页面路径不带语言前缀;其他语言会使用对应的 code 作为路径前缀,例如 /zh-Hans/docs。