跳至內容
Fumadocs

靜態建置

使用 Fumadocs 輸出靜態網站。

設定

Fumadocs 預設採用伺服器優先的做法,因此需要有執行中的伺服器。 您可以透過設定 Next.js 來輸出靜態建置。

靜態建置沒有伺服器,因此下列功能無法運作:

proxy.ts 也不會執行,因此不會有導向至語系的 i18n 重新導向,頁面也無法依 Accept 標頭提供 Markdown。

  1. 設定搜尋伺服器。
  2. 設定搜尋 UI/用戶端。

完成設定後,您的應用程式會以靜態方式儲存搜尋索引,並改在瀏覽器端執行搜尋運算。

雲端解決方案

由於搜尋功能由遠端伺服器提供,靜態匯出無需額外設定即可運作。

部署

啟用靜態匯出,即可輸出不需 Node.js 伺服器也能執行的靜態 HTML 網站:

next.config.mjs
/**
 * @type {import('next').NextConfig}
 */
const nextConfig = {
  output: 'export',

  // 選用:將連結 `/me` 改為 `/me/`,並將輸出的 `/me.html` 改為 `/me/index.html`
  // trailingSlash: true,

  // 選用:避免自動將 `/me` 導向 `/me/`,改為保留原本的 `href`
  // skipTrailingSlashRedirect: true,
};

限制與詳細資訊請參閱 Next.js 文件。

How is this guide?

最後更新於