i18n.ts

站点支持的语言和默认语言。

config/i18n.ts 配置站点支持的语言和默认语言。语言切换器、页面路径、本地化文案、SEO 多语言链接和 LanguageCode 类型都以这里的配置为准。

languages

站点语言列表至少要有一项,并且 code 不能重复。未注释的对象会加入语言列表;注释中的对象是模板提供的备选语言,取消注释后才会加入列表。

Prop

Type

模板提供以下语言配置,其中只有未注释的对象会加入站点语言列表:

codenamedirection文案文件
enEnglishltrlocales/en.json
esEspañolltrlocales/es.json
frFrançaisltrlocales/fr.json
deDeutschltrlocales/de.json
itItalianoltrlocales/it.json
ptPortuguêsltrlocales/pt.json
ruРусскийltrlocales/ru.json
ja日本語ltrlocales/ja.json
ko한국어ltrlocales/ko.json
zh-Hans简体中文ltrlocales/zh-Hans.json
zh-Hant繁體中文ltrlocales/zh-Hant.json
arالعربيةrtllocales/ar.json

模板已经为表中的语言准备了对应的 JSON 文件,但部分文件仍是空对象占位,存在文件不代表翻译已经完成。启用语言前应补全并检查翻译。添加其他语言时,还要创建 locales/<code>.json。配置文件末尾导出的 LanguageCode 只包含未注释的数组项。按照模板默认配置生成的类型为:

type LanguageCode = 'en' | 'zh-Hans' | 'zh-Hant';

defaultLanguage

Prop

Type

defaultLanguage 必须与 languages[].code 中的一项完全一致。默认语言的页面路径不带语言前缀;其他语言会使用对应的 code 作为路径前缀,例如 /zh-Hans/docs。