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。