快速入門

該 API 或修正可能只在較新的版本中提供。請升級 Fumadocs 後再試一次。

路由由 Next.js 處理。請先移動文件路由 (/docs/* -> /info/*) 。

重新命名路由：

或使用路由群組，將 /docs/* 改為 /*：

最後，請在 source.ts 中更新頁面的基礎 URL：

import { loader } from 'fumadocs-core/source';

export const source = loader({
  baseUrl: '/info', // 改成新的路徑
});

範本在 lib/shared.ts 中將此值定義為 docsRoute，請在該處修改，Markdown 連結便會隨之更新。

建議使用版面配置頁籤。

做法與在 Next.js App Router 中管理版面配置相同：請先從內容目錄 (/content/docs) 中移除原本的 MDX 檔案， 以免重複的頁面造成錯誤。

接著，您可以將該頁面放到另一個路由群組中，且該群組不能位於文件版面配置之下。

例如，若要取代 /docs/test：

若是 /docs，您需要將 catch-all 路由改為非選用：

如果您遇到類似以下的 Turbopack 錯誤：

JSON file not found: FileSystemPath { ... path: "lib/locales/sources/file.json.json" }

這通常是因為不支援 require(esm) (#3312) ，請升級至 Node.js 22 以上版本。

若您在 Node.js 23.1 上進行正式環境建置時遇到以下錯誤：

Could not find a production build in the '.next' directory.

這是已知問題，請參閱 #1021。您可以將 Node.js 升級至 23.6.0 以上版本。

只要設定了 generateStaticParams，Next.js 就會將動態路由轉換為靜態路由。 因此，其速度與靜態頁面一樣快。

您可以啟用靜態匯出，以產生靜態的建置輸出。