語言切換器檢查清單
✅ 已完成的設定
-
i18n 配置 - 已設定兩個語言:
i18n: {
defaultLocale: 'zh-TW',
locales: ['zh-TW', 'en'],
} -
翻譯檔案 - 已建立:
i18n/en/docusaurus-theme-classic/navbar.jsoni18n/en/docusaurus-theme-classic/footer.jsoni18n/zh-TW/docusaurus-theme-classic/navbar.jsoni18n/zh-TW/docusaurus-theme-classic/footer.json
-
快取已清除 - 已執行
npm run clear
🔍 檢查步驟
1. 重新啟動開發伺服器
npm start
2. 檢查瀏覽器
語言切換器應該會出現在 Navbar 右側,通常在:
- 搜尋框的左邊或右邊
- 或是在 Navbar 的最右側
3. 如果還是看不到
請檢查:
-
瀏覽器控制台(F12)
- 查看是否有錯誤訊息
- 檢查 Console 標籤
-
檢查 HTML 結構
- 按 F12 開啟開發者工具
- 查看 Navbar 的 HTML 結構
- 尋找包含 "locale" 或 "language" 的元素
-
強制重新載入
- 按
Ctrl + Shift + R或Ctrl + F5 - 清除瀏覽器快取
- 按
4. 手動檢查配置
確認 docusaurus.config.js 中的 locales 陣列包含至少兩個語言:
locales: ['zh-TW', 'en'], // 必須有至少兩個語言
💡 注意事項
- 語言切換器是 Docusaurus 自動產生的,不需要手動加入 navbar.items
- 如果只有一個語言,語言切換器不會顯示
- 語言切換器通常是一個下拉選單,顯示當前語言和可切換的語言
🐛 如果仍然沒有出現
請提供以下資訊:
- 瀏覽器控制台的錯誤訊息
- Navbar 的 HTML 結構(從開發者工具複製)
- 是否有任何 CSS 可能隱藏了語言切換器