リダイレクト(Redirect)
ノートの正規permalinkを指す追加のURLで、通常は古いアドレスを生かすために使います。リダイレクトは解決済みの公開先の一部で、permalinkを置き換えません。
リダイレクトが生まれるとき
permalinkプラグイン、名前変更、ロケールの規則がリダイレクトを追加できます。ノートは正規のpermalinkを1つ保ち、リダイレクトはいくつでも持てます。リダイレクトは解決済みの公開先の一部で、permalinkを置き換えません。
リダイレクトの型と構造
リダイレクトは ContentRedirect(packages/core/src/types/content_manifest.ts)として型付けされ、path と status コードを持ちます。マニフェストの redirects マップにリダイレクトパスをキーとして保存され、公開エントリでは publicRedirects にも保存されます。
ContentRedirect の例:
{
path: "/docs/hello/",
status: 301,
}
マニフェストエントリ内のリダイレクトの例:
permalink: "/docs/notes/hello/",
redirects: ["/docs/hello/", "/hello/"],
リダイレクトは、permalinkプラグインが resolveContentLocations フックを通じて生成するほか、コンテンツファイルの名前変更時に自動で生成されます(古いパスから新しいpermalinkへのリダイレクトが付きます)。