Knowledge Garden
技術記事 公開日

Astro で公開ナレッジベースを育てる

ブログ、ノート、用語集、週次ログを同じ content collection で扱う設計メモ。

Astro で公開ナレッジベースを育てる

Astro のデフォルトブログは、記事一覧と個別ページが最初から揃っています。ここに typetagsrelated を足すだけで、単なるブログから公開ナレッジベースへ拡張できます。

設計方針

  • URL は既存の /blog/... を維持する
  • 表示上は「技術記事」「ノート」「用語集」「手順」「ログ」「自作物」に分ける
  • 横断検索は Pagefind に任せる
  • 関連ノートは frontmatter の related で明示する
  • バックリンクは related と本文リンクから自動で拾う

小さく始める理由

最初から専用 CMS や複雑なグラフ構造を入れると、書く前に運用が重くなります。Markdown ファイルを単位にして、必要なメタデータだけを揃えると、あとから分類を変えやすくなります。

このサイトでは 個人知識管理の運用ノート を中心に、関連する用語やトラブルシュートをつなげています。