nuxt-content

Nuxt Content v3

コンテンツ主導の Nuxt アプリ向けの段階的なガイダンスです。型付きコレクションと SQL を利用したクエリに対応しています。

使用する場面

次の作業を行う場合：

• コンテンツコレクション（content.config.ts、defineCollection）
• リモートソース（GitHub リポジトリ、defineCollectionSource を介した外部 API）
• コンテンツクエリ（queryCollection、ナビゲーション、検索）
• MDC のレンダリング（<ContentRenderer>、prose コンポーネント）
• データベースの設定（SQLite、PostgreSQL、D1、LibSQL）
• コンテンツフック（content:file:beforeParse、content:file:afterParse）
• i18n による多言語コンテンツ
• NuxtStudio またはプレビューモード
• LLM の統合（nuxt-llms）

ドキュメントを作成する場合： document-writer スキルを使用してください
Nuxt の基本について： nuxt スキルを使用してください
NuxtHub へのデプロイについて： nuxthub スキルを使用してください（NuxtHub v1 互換）

利用可能なガイダンス

現在の作業に応じて、該当するファイルを読んでください。

• references/collections.md - defineCollection、スキーマ、ソース、content.config.ts
• references/querying.md - queryCollection、ナビゲーション、検索、周辺コンテンツ
• references/rendering.md - ContentRenderer、MDC 構文、prose コンポーネント、Shiki
• references/config.md - データベースの設定、Markdown プラグイン、レンダラーのオプション
• references/studio.md - NuxtStudio の統合、プレビューモード、ライブ編集

使用パターン

段階的に読み込む — 必要なものだけを読んでください：

• コレクションを設定する場合 → references/collections.md
• コンテンツをクエリする場合 → references/querying.md
• Markdown/MDC をレンダリングする場合 → references/rendering.md
• データベース/Markdown を設定する場合 → references/config.md
• NuxtStudio を使用する場合 → references/studio.md

すべてのファイルを一度に読まないでください。 コンテキストに応じて読み込んでください。

• content.config.ts を編集する → collections.md を読む
• queryCollection() を使用する → querying.md を読む
• <ContentRenderer> または MDC を扱う → rendering.md を読む
• データベースまたは Markdown を設定する → config.md を読む
• プレビュー/studio を設定する → studio.md を読む

主な概念

概念	目的
コレクション	スキーマを持つ型付きコンテンツグループ
Page と Data	page = ルート + 本文、data = 構造化データのみ
リモートソース	GitHub には source.repository、API には defineCollectionSource
queryCollection	コンテンツ向けの SQL 風の Fluent API
MDC	Markdown 内の Vue コンポーネント
ContentRenderer	解析済みの Markdown 本文をレンダリング

ディレクトリ構成

project/
├── content/                    # Content files
│   ├── blog/                   # Maps to 'blog' collection
│   └── .navigation.yml         # Navigation metadata
├── components/content/         # MDC components
└── content.config.ts           # Collection definitions

公式ドキュメント

• Nuxt Content：https://content.nuxt.com
• MDC 構文：https://content.nuxt.com/docs/files/markdown#mdc-syntax
• コレクション：https://content.nuxt.com/docs/collections/collections

トークン効率

メインスキル：約300トークン。各サブファイル：約800～1200トークンです。現在の作業に関連するファイルだけを読み込んでください。