Nuxt Content 集合数据源配置详解

韶婉珊Vivian

于 2025-06-11 09:16:19 发布

阅读量270

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00424/article/details/148578169

版权

Nuxt Content 集合数据源配置详解

content The file-based CMS for your Nuxt application, powered by Markdown and Vue components. 项目地址: https://gitcode.com/gh_mirrors/con/content

前言

在 Nuxt Content 项目中，集合(Collections)是组织和管理内容的核心机制。理解如何配置集合的数据源(Source)对于构建高效的内容管理系统至关重要。本文将全面解析 Nuxt Content 中集合数据源的配置方式，帮助开发者灵活管理本地和远程内容资源。

基础配置

在 content.config.ts 文件中，我们可以通过 defineCollection 方法定义集合，并使用 source 属性指定内容来源：

import { defineCollection, defineContentConfig } from '@nuxt/content'

export default defineContentConfig({
  collections: {
    docs: defineCollection({
      source: '**',  // 包含所有文件
      type: 'page'
    })
  }
})

数据源类型详解

1. 字符串模式（Glob 模式）

最简单的配置方式是使用字符串形式的 Glob 模式：

'**'：包含内容目录及其子目录中的所有文件
'**/*.md'：仅包含所有 Markdown 文件
'docs/**/*.yml'：包含 content/docs 目录下的所有 YAML 文件
'**/*.{json,yml}'：包含所有 JSON 或 YAML 文件
'*.json'：仅包含内容根目录下的 JSON 文件（不包含子目录）

2. 对象模式（高级配置）

对于更复杂的场景，可以使用对象形式的配置：

defineCollection({
  type: "page",
  source: {
    include: "en/**",  // 必须包含的路径模式
    exclude: ["en/index.md"],  // 排除的文件
    prefix: '/'  // 路由前缀
  }
})

关键属性解析

include (必需)
- 指定要包含的文件路径模式
- 支持标准的 Glob 语法
exclude
- 指定要排除的文件或目录
- 可以是字符串或字符串数组
prefix
- 仅适用于 page 类型的集合
- 表示网站上的路径前缀（基础 URL）
- 必须以 / 开头
- 默认情况下，模块会自动从 source 或 source.include 中提取静态前缀

cwd

source: {
  cwd: path.resolve('packages/my-pkg/docs'),
  include: '**/*.md',
}

远程仓库集成

Nuxt Content 支持从远程 Git 仓库拉取内容：

defineCollection({
  type: 'page',
  source: {
    repository: 'https://github.com/nuxt/content',
    include: 'docs/content/**',
  },
})

认证配置

对于私有仓库，需要提供认证信息：

authToken
- 用于 GitHub 等服务的个人访问令牌
- 重要提示：永远不要将认证令牌直接提交到代码库中

authBasic

用于 Bitbucket 等需要基本认证的服务

defineCollection({
  type: 'page',
  source: {
    repository: 'https://bitbucket.org/username/repo',
    authBasic: {
      username: 'username',
      password: 'password',
    },
  },
})