名称: nuxt-content 描述: 用于处理Nuxt Content v3 - 提供集合（本地/远程/API源）、queryCollection API、MDC渲染、数据库配置、NuxtStudio集成、钩子、i18n模式以及LLMs集成 许可证: MIT
Nuxt Content v3
用于内容驱动的Nuxt应用的渐进式指南，支持类型化集合和SQL支持的查询。
何时使用
处理以下内容时使用：
- 内容集合（
content.config.ts,defineCollection） - 远程源（GitHub仓库，通过
defineCollectionSource的外部API） - 内容查询（
queryCollection, 导航, 搜索） - MDC渲染（
<ContentRenderer>, 文本组件） - 数据库配置（SQLite, PostgreSQL, D1, LibSQL）
- 内容钩子（
content:file:beforeParse,content:file:afterParse） - i18n多语言内容
- NuxtStudio或预览模式
- LLMs集成（
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语法, 文本组件, Shiki
- references/config.md - 数据库设置, Markdown插件, 渲染器选项
- references/studio.md - NuxtStudio集成, 预览模式, 实时编辑
加载文件
根据任务考虑加载这些参考文件：
- [ ] references/collections.md - 如果设置集合、模式或content.config.ts
- [ ] references/querying.md - 如果使用queryCollection、导航或搜索
- [ ] references/rendering.md - 如果渲染Markdown/MDC或处理ContentRenderer
- [ ] references/config.md - 如果配置数据库、Markdown插件或渲染器选项
- [ ] references/studio.md - 如果集成NuxtStudio或预览模式
不要一次性加载所有文件。 只加载与当前任务相关的文件。
关键概念
| 概念 | 目的 |
|---|---|
| 集合 | 带有模式的类型化内容组 |
| 页面 vs 数据 | page = 路由 + 正文, data = 仅结构化数据 |
| 远程源 | 用于GitHub的source.repository，用于API的defineCollectionSource |
| queryCollection | 类似SQL的流畅API用于内容 |
| MDC | Markdown中的Vue组件 |
| ContentRenderer | 渲染解析后的Markdown正文 |
目录结构
project/
├── content/ # 内容文件
│ ├── blog/ # 映射到'blog'集合
│ └── .navigation.yml # 导航元数据
├── components/content/ # MDC组件
└── content.config.ts # 集合定义
官方文档
- 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个令牌。只加载与当前任务相关的文件。