Permalink

コンテンツの恒久的な公開先を制御するための Plugin です。

導入

npm install @riebeckite/plugin-permalink

Plugin の export 名や設定項目は、実装と package README を一次情報として確認してください。Riebeckite の Plugin は riebeckite.config.ts の plugins に登録して利用します。

ファイル配置とは独立した安定URLを記事に持たせたい場合に利用します。ファイルを整理・移動しても公開URLを維持したいサイトで便利です。

frontmatter の id などを手掛かりに正規 URL（canonical）が決まり、redirects に指定した旧 URL からは 308 リダイレクトが返されます。

この Plugin が必要な場合だけ追加してください。Preset に含まれている場合は、同じ Plugin を重複して登録する必要はありません。

設定項目、公開 API、制約、追加の使用例は package README を参照してください。Plugin 全体の仕組みは Plugin System、Plugin を作る場合は Writing a Plugin を参照してください。

1 changesCollapseExpand

From To

	1	`+ # Permalink`
	2	`+`
	3	`+ コンテンツの恒久的な公開先を制御するための Plugin です。`
	4	`+`
	5	`+ ## 導入`
	6	`+`
	7	+ ```bash
	8	`+ npm install @riebeckite/plugin-permalink`
	9	+ ```
	10	`+`
	11	+ Plugin の export 名や設定項目は、実装と package README を一次情報として確認してください。Riebeckite の Plugin は `riebeckite.config.ts` の `plugins` に登録して利用します。
	12	`+`
	13	`+ ## 使用例`
	14	`+`
	15	`+ ファイル配置とは独立した安定URLを記事に持たせたい場合に利用します。ファイルを整理・移動しても公開URLを維持したいサイトで便利です。`
	16	`+`
	17	+ frontmatter の `id` などを手掛かりに正規 URL（canonical）が決まり、`redirects` に指定した旧 URL からは 308 リダイレクトが返されます。
	18	`+`
	19	`+ ## 使いどころ`
	20	`+`
	21	`+ この Plugin が必要な場合だけ追加してください。Preset に含まれている場合は、同じ Plugin を重複して登録する必要はありません。`
	22	`+`
	23	`+ ## 詳細仕様`
	24	`+`
	25	`+ 設定項目、公開 API、制約、追加の使用例は package README を参照してください。Plugin 全体の仕組みは [Plugin System](../framework/plugin-system.ja.md)、Plugin を作る場合は [Writing a Plugin](./writing-a-plugin.ja.md) を参照してください。`
	26	`+`
	27	`+`