i18n(zh-cn): Update frontmatter.mdx (#1362)

Co-authored-by: Chris Swithinbank <[email protected]>

docs/src/content/docs/zh-cn/reference/frontmatter.md

@@ -5,8 +5,9 @@ description: Starlight 支持的默认 frontmatter 字段的概述。
 
 你可以通过设置 frontmatter 中的值来自定义 Starlight 中的单个 Markdown 和 MDX 页面。例如，一个常规页面可能会设置 `title` 和 `description` 字段：
 
-```md
+```md {3-4}
 ---
+# src/content/docs/example.md
 title: 关于此项目
 description: 了解更多关于此项目的信息。
 ---
@@ -28,6 +29,13 @@ description: 了解更多关于此项目的信息。
 
 页面描述用于页面元数据，将被搜索引擎和社交媒体预览捕获。
 
+### `slug`
+
+**类型：** `string`
+
+覆盖页面的slug。有关更多详细信息，请参阅 Astro文档中的 [ "定义自定义slugs"](https://docs.astro.build/zh-cn/guides/content-collections/#定义自定义-slugs) 部分。
+
+
 ### `editUrl`
 
 **类型：** `string | boolean`
@@ -42,6 +50,7 @@ description: 了解更多关于此项目的信息。
 
 ```md
 ---
+# src/content/docs/example.md
 title: 关于我们
 head:
   # 使用自定义 <title> 标签
@@ -58,6 +67,7 @@ head:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 目录中只有 H2 的页面
 tableOfContents:
   minHeadingLevel: 2
@@ -67,6 +77,7 @@ tableOfContents:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 没有目录的页面
 tableOfContents: false
 ---
@@ -91,6 +102,7 @@ tableOfContents: false
 
 ```md
 ---
+# src/content/docs/example.md
 title: 我的主页
 template: splash
 hero:
@@ -114,6 +126,7 @@ hero:
 
 ```md
 ---
+# src/content/docs/example.md
 hero:
   image:
     alt: 一个闪闪发光、色彩鲜艳的 logo
@@ -168,6 +181,7 @@ interface HeroConfig {
 
 ```md
 ---
+# src/content/docs/example.md
 title: 带有横幅的页面
 banner:
   content: |
@@ -184,6 +198,7 @@ banner:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 带有自定义更新日期的页面
 lastUpdated: 2022-08-09
 ---
@@ -197,20 +212,23 @@ lastUpdated: 2022-08-09
 
 ```md
 ---
+# src/content/docs/example.md
 # 隐藏上一页链接
 prev: false
 ---
 ```
 
 ```md
 ---
+# src/content/docs/example.md
 # 将上一页链接更改为“继续教程”
 prev: 继续教程
 ---
 ```
 
 ```md
 ---
+# src/content/docs/example.md
 # 同时覆盖上一页的链接和文本
 prev:
   link: /unrelated-page/
@@ -226,6 +244,7 @@ prev:
 
 ```md
 ---
+# src/content/docs/example.md
 # 隐藏下一页链接
 next: false
 ---
@@ -240,6 +259,7 @@ next: false
 
 ```md
 ---
+# src/content/docs/example.md
 # 在搜索索引中隐藏此页面
 pagefind: false
 ---
@@ -272,6 +292,7 @@ interface SidebarConfig {
 
 ```md
 ---
+# src/content/docs/example.md
 title: 关于此项目
 sidebar:
   label: About
@@ -287,6 +308,7 @@ sidebar:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 要首先显示的页面
 sidebar:
   order: 1
@@ -302,6 +324,7 @@ sidebar:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 从自动生成的侧边栏中隐藏的页面
 sidebar:
   hidden: true
@@ -318,6 +341,7 @@ sidebar:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 带有徽章的页面
 sidebar:
   # 使用与你的网站的强调色相匹配的默认类型
@@ -327,6 +351,7 @@ sidebar:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 带有徽章的页面
 sidebar:
   badge:
@@ -343,10 +368,80 @@ sidebar:
 
 ```md
 ---
+# src/content/docs/example.md
 title: 新标签页中打开页面
 sidebar:
   # 在新标签页中打开页面
   attrs:
     target: _blank
 ---
 ```
+
+## 自定义 frontmatter schema
+
+Starlight 的 `docs` 内容集合的 frontmatter schema 在 `src/content/config.ts` 中使用 `docsSchema()` 辅助函数进行配置：
+
+```ts {3,6}
+// src/content/config.ts
+import { defineCollection } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({ schema: docsSchema() }),
+};
+```
+
+了解更多关于内容集合模式的信息，请参阅 Astro 文档中的 [“定义集合模式”](https://docs.astro.build/zh-cn/guides/content-collections/#定义集合模式) 部分。
+
+`docsSchema()` 采用以下选项：
+
+### `extend`
+
+**类型：** Zod schema 或者返回 Zod schema 的函数  
+**默认值：** `z.object({})`
+
+通过在 `docsSchema()` 选项中设置 `extend` 来使用其他字段扩展 Starlight 的 schema。
+值应该是一个 [Zod schema](https://docs.astro.build/zh-cn/guides/content-collections/#用-zod-定义数据类型)。
+
+
+在下面的示例中，我们为 `description` 提供了一个更严格的类型，使其成为必填项，并添加了一个新的可选的 `category` 字段：
+
+```ts {8-13}
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({
+    schema: docsSchema({
+      extend: z.object({
+        // 将内置字段设置为必填项。
+        description: z.string(),
+        // 将新字段添加到 schema 中。
+        category: z.enum(['tutorial', 'guide', 'reference']).optional(),
+      }),
+    }),
+  }),
+};
+```
+
+要利用 [Astro `image()` 辅助函数](https://docs.astro.build/zh-cn/guides/images/#内容集合中的图像)，请使用返回 schema 扩展的函数：
+
+```ts {8-13}
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({
+    schema: docsSchema({
+      extend: ({ image }) => {
+        return z.object({
+          // 添加一个必须解析为本地图像的字段。
+          cover: image(),
+        });
+      },
+    }),
+  }),
+};
+```