LogoMkSaaS 文件

靜態匯出

使用 Fumadocs 啟用靜態匯出

概覽

Fumadocs 完全相容 Next.js 靜態匯出,允許你將應用程式匯出為不需要 Node.js 伺服器的靜態 HTML 網站。

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

搜尋

雲端解決方案

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

內建搜尋

Orama 搜尋的預設搜尋設定使用路由處理器,靜態匯出不支援這種方式。

相反地,你可以按照 Orama 搜尋 指南靜態建置搜尋索引。 並從 Root Provider 在搜尋客戶端上啟用靜態模式:

app/layout.tsx
import { RootProvider } from 'fumadocs-ui/provider';
import type { ReactNode } from 'react';

export default function RootLayout({ children }: { children: ReactNode }) {
  return (
    <html lang="en" suppressHydrationWarning>
      <body>
        <RootProvider
          search={{
            options: {
              type: 'static', 
            },
          }}
        >
          {children}
        </RootProvider>
      </body>
    </html>
  );
}

這允許路由處理器被靜態快取到單一檔案中,搜尋將在瀏覽器中計算。