カスタム 404#

View Markdown

ssg.notFound を有効にすると、SSG ビルドは既定レイアウト（ナビ、検索、その他のサイト chrome）でテーマ付き 404 ページを書き出します。このページは検索インデックスに入りません。sitemap.xml / llms.txt が有効でもそこからも外れます。

機能は自分でオンにするまでオフです。既存サイトはそのままです。

import { oxContent } from "@ox-content/vite-plugin";

export default {
  plugins: [
    oxContent({
      ssg: {
        notFound: true,
      },
    }),
  ],
};

false または省略はファイルを出しません。true は既定でオンです（srcDir の 404.md、出力 404.html）。オブジェクトを渡すと機能はオンになり、設定したフィールドだけ上書きします。

oxContent({
  ssg: {
    notFound: {
      source: "pages/missing.md",
      output: "not-found.html",
    },
  },
});

オプション	型	既定
`ssg.notFound`	`boolean` / `NotFoundOptions`	`false`
`source`	`string`	`"404.md"`
`output`	`string`	`"404.html"`

ソースファイルがなくても、ビルドは「Page not found」というタイトルのテーマ付きページを書き出します。オプションをオンにすると、必ず出力ファイルができます。

404.md のタイトルやその他のメタデータは HTML 文書内でエスケープされるので、<title> や属性の外へは出られません。

カスタム 404#

関連#