軽量な実用メモを管理する Snippets コレクション導入方針
Decision
- 背景説明が短い実用メモ(コマンド断片、最小手順、短い設定例)は
snippetsに配置する。 - 時系列で読む記事は
blog、定義・知識整理はglossary、実用断片はsnippetsとして3分類で運用する。 snippetsコレクションを追加し、/snippetsと/{lang}/snippetsに一覧と詳細ページを実装する。- テンプレートは
_template.ja.mdを配置し、_始まり除外ルールで公開対象から外す。
Context
既存運用では、次のような短い実用メモの置き場が曖昧だった。
- ブログとしては分量が薄い
- 用語集としては定義ページではない
この種のメモを blog に混在させると、記事一覧の意図と検索意図がぶれやすい。
一方 glossary は概念整理向けであり、コマンド断片中心の内容とは性質が異なる。
Options
- Option A: 短い実用メモも
blogに統一する。 - Option B:
glossaryに含める。 - Option C:
snippetsを新設して分離する(採用)。
Rationale
- 読者の期待値に合わせて、入口を「記事」「知識」「実用断片」で分けられる。
- 短いメモを独立させることで、
blogの記事品質基準を維持しやすい。 - URL を分離することで、検索エンジンにもページ意図を伝えやすい。
Consequences
src/content.config.tsにsnippetsコレクション定義を追加する。src/features/snippets/*とsrc/pages/snippets/*、src/pages/[lang]/snippets*を追加する。- ヘッダーナビと i18n 辞書に
snippets文言を追加する。 - 初回コンテンツとして
avifencの一括変換メモをcontent/snippets/に移行する。
hsb.horse