ルーティング

Methanol は、pages/ ディレクトリの構造に基づき、ファイルベースで自動的にルーティングを構築します。

MDX / Markdown ページ

• pages/about.mdx → /about
• pages/guide/index.mdx → /guide/（ディレクトリのインデックス）

HTML ページ

pages/ ディレクトリには通常の HTML ファイルを配置することも可能です。これらのファイルはビルド時に Vite によって処理され、dist/ ディレクトリに出力されます。

• pages/custom.html → dist/custom.html（/custom.html でアクセス可能）

デモ:

• カスタム HTML ページ

404 ページ

Not Found ページをカスタマイズするには、pages/404.mdx を作成してください。このページはデフォルトでナビゲーションから除外されます。

オフライン用ページ

pages/offline.mdx を作成することで、内蔵 PWA が使用するオフライン用のフォールバックページをカスタマイズできます。このページもデフォルトでナビゲーションから除外されます。

hidden と exclude の違い

• hidden: true: ナビゲーションメニューからは非表示になりますが、ルート自体は有効です。直接 URL を指定することでアクセス可能です。
• exclude: true: 開発サーバー（dev）およびビルド（build）のプロセスから完全に除外されます。ディレクトリの index.mdx に設定した場合、その配下すべてが除外対象となります。
• _ または . で始まるファイルやディレクトリは、システムによって自動的に無視されます。