Esportazione statica

Panoramica

Fumadocs è completamente compatibile con l'esportazione statica di Next.js, consentendoti di esportare l'app come sito HTML statico senza un server Node.js.

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

Cerca

Soluzioni cloud

Poiché la funzionalità di ricerca è alimentata da server remoti, l'esportazione statica funziona senza configurazione.

Ricerca integrata

La configurazione di ricerca predefinita di Orama Search utilizza gestori di route, che non sono supportati dall'esportazione statica.

Puoi invece creare staticamente gli indici di ricerca seguendo la guida Orama Search. E abilita la modalità statica sul client di ricerca dal provider principale:

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>
  );
}

Ciò consente al gestore del percorso di essere memorizzato nella cache staticamente in un singolo file e la ricerca verrà invece calcolata sul browser.