fumadocs-i18n

fumadocs-i18n 是一項專業的自動化工具，旨在將標準的 Fumadocs 專案轉換為支援多語言的文檔網站。該技能遵循官方最佳實踐，處理 Next.js App Router 環境下所需的複雜結構調整，確保內容具備良好的可訪問性、SEO 優化及易於維護的架構。

本工具專為需要將文檔擴展至多種語言（如英語、中文、法語或韓語）的開發者設計。它消除了手動調整路由邏輯、目錄模式及 UI 組件的繁瑣工作，讓您能專注於文檔內容的翻譯與維護，而非基礎架構的設定。

• 自動建立 lib/i18n.ts 設定檔，定義支援的語系與目錄解析器。

• 配置 middleware.ts 以管理自動化的語系重新導向與基於路徑的語言偵測。

• 重構 app/ 目錄，將路徑移動至 [lang] 動態分段，以產生如 /en/docs/ 等簡潔的 URL 結構。

• 整合語言切換器組件，直接嵌入至現有的導航欄位中。

• 規範內容組織，自動建立 content/docs/[lang] 資料夾結構並更新 source.ts 以支援多語系頁面樹。

• 啟用側邊欄過濾功能，確保用戶僅能瀏覽與當前語言環境相關的文檔。

• 在執行前，請確保專案已安裝並初始化 fumadocs-core、fumadocs-ui 及 fumadocs-mdx。

• 本工具假設專案採用標準目錄結構（app/, content/, lib/）；若使用自訂結構，請先確認目錄路徑。

• 完全相容於 Next.js App Router，充分利用伺服器組件與動態路由特性。

• 內建針對側邊欄遺漏、路由損毀及解析器錯誤等常見問題的保護措施。

• 建議在乾淨的 Git 分支中執行此技能，以便輕鬆審查檔案變更並確保專案穩定。