コンテンツへスキップ
Fumadocs

静的ビルド

Fumadocs で静的サイトを出力します。

セットアップ

Fumadocs はデフォルトでサーバーファーストのアプローチを採用しているため、稼働中のサーバーが必要です。 Next.js を設定すれば、静的ビルドを出力できます。

静的ビルドにはサーバーが存在しないため、次の機能は動作しません。

  • 検索サーバー。代わりに静的検索を使用してください。
  • AIに質問。チャットルートから AI モデルを呼び出す必要があるためです。
  • MCP サーバー。

また、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?

最終更新日