技術記事 公開日
Astro で公開ナレッジベースを育てる
ブログ、ノート、用語集、週次ログを同じ content collection で扱う設計メモ。
Astro のデフォルトブログは、記事一覧と個別ページが最初から揃っています。ここに type、tags、related を足すだけで、単なるブログから公開ナレッジベースへ拡張できます。
設計方針
- URL は既存の
/blog/...を維持する - 表示上は「技術記事」「ノート」「用語集」「手順」「ログ」「自作物」に分ける
- 横断検索は Pagefind に任せる
- 関連ノートは frontmatter の
relatedで明示する - バックリンクは
relatedと本文リンクから自動で拾う
小さく始める理由
最初から専用 CMS や複雑なグラフ構造を入れると、書く前に運用が重くなります。Markdown ファイルを単位にして、必要なメタデータだけを揃えると、あとから分類を変えやすくなります。
このサイトでは 個人知識管理の運用ノート を中心に、関連する用語やトラブルシュートをつなげています。