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。