跳至主要内容

語言切換器檢查清單

✅ 已完成的設定

  1. i18n 配置 - 已設定兩個語言:

    i18n: {
    defaultLocale: 'zh-TW',
    locales: ['zh-TW', 'en'],
    }
  2. 翻譯檔案 - 已建立:

    • i18n/en/docusaurus-theme-classic/navbar.json
    • i18n/en/docusaurus-theme-classic/footer.json
    • i18n/zh-TW/docusaurus-theme-classic/navbar.json
    • i18n/zh-TW/docusaurus-theme-classic/footer.json
  3. 快取已清除 - 已執行 npm run clear

🔍 檢查步驟

1. 重新啟動開發伺服器

npm start

2. 檢查瀏覽器

語言切換器應該會出現在 Navbar 右側,通常在:

  • 搜尋框的左邊或右邊
  • 或是在 Navbar 的最右側

3. 如果還是看不到

請檢查:

  1. 瀏覽器控制台(F12)

    • 查看是否有錯誤訊息
    • 檢查 Console 標籤
  2. 檢查 HTML 結構

    • 按 F12 開啟開發者工具
    • 查看 Navbar 的 HTML 結構
    • 尋找包含 "locale" 或 "language" 的元素
  3. 強制重新載入

    • Ctrl + Shift + RCtrl + F5
    • 清除瀏覽器快取

4. 手動檢查配置

確認 docusaurus.config.js 中的 locales 陣列包含至少兩個語言:

locales: ['zh-TW', 'en'],  // 必須有至少兩個語言

💡 注意事項

  • 語言切換器是 Docusaurus 自動產生的,不需要手動加入 navbar.items
  • 如果只有一個語言,語言切換器不會顯示
  • 語言切換器通常是一個下拉選單,顯示當前語言和可切換的語言

🐛 如果仍然沒有出現

請提供以下資訊:

  1. 瀏覽器控制台的錯誤訊息
  2. Navbar 的 HTML 結構(從開發者工具複製)
  3. 是否有任何 CSS 可能隱藏了語言切換器