md 文档编写示例#
必填项#
示例中 title , published , description 字段根据文件: yukina\src\content.config.ts 规则必须填写，具体规则为:
const posts = defineCollection({
loader: glob({
pattern: "**/*.md",
base: "src/contents/posts",
}),
// 使用 Zod 库来定义 Frontmatter 的 schema (结构)
schema: z.object({
title: z.string(), // 标题必须是字符串
published: z.date(),// 发布日期必须是日期类型
draft: z.boolean().optional(),//可选字段(.optional())，如果存在，必须是布尔值 (true 或 false)
description: z.string().optional(),// 可选的字符串字段
cover: z.string().optional(),
tags: z.array(z.string()).optional(),//可选字段，如果存在，必须是一个字符串数组（如 tags: ["技术", "生活"]）。
category: z.string().optional(),
author: z.string().optional(),
sourceLink: z.string().optional(),
licenseName: z.string().optional(),
licenseUrl: z.string().optional(),
}),
});
const specs = defineCollection({
loader: glob({
pattern: "**/*.md",
base: "src/contents/specs",
}),
});
// 它和 post 相比没有 schema 字段。
// loader 部分告诉 Astro 去 src/contents/specs 文件夹下查找所有 Markdown 文件。
// 缺少 schema 意味着 specs 集合里的 Markdown 文件可以有任意的 Frontmatter，
// 也可以没有任何 Frontmatter。Astro 不会对其进行任何格式或类型检查。
// 这提供了最大的灵活性，但同时也牺牲了类型安全。
// 导出所有集合核心功能总结#
- posts 集合：
- 专门用来管理博客文章。
- 它从 src/contents/posts 文件夹中加载所有 Markdown 文件。
- 它对每篇文章的元数据（Frontmatter）有严格的格式要求。如果文章的元数据不符合规定（例如缺少 title），Astro 在构建时会报错。
- specs 集合：
- 用来管理另一种类型的内容，可能是“说明书”、“规范”或“笔记”。
- 它从 src/contents/specs 文件夹中加载所有 Markdown 文件。
- 它对元数据没有格式要求，可以随意填写。
核心语法#
使用optional()对模型的字段进行限制
注意事项#
头部表单每一个选项填写格式为
字段:[空格]名字
titie: name
中间是有一个空格的，否则报错