From 5bad00a5019545bc1bcce7894c47544b83ef78ba Mon Sep 17 00:00:00 2001
From: liruifengv <liruifeng1024@gmail.com>
Date: Mon, 19 Feb 2024 05:39:58 +0800
Subject: [PATCH] i18n(zh-cn): Translate pages.mdx (#1523)

---
 docs/src/content/docs/zh-cn/guides/pages.mdx | 152 +++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 docs/src/content/docs/zh-cn/guides/pages.mdx

diff --git a/docs/src/content/docs/zh-cn/guides/pages.mdx b/docs/src/content/docs/zh-cn/guides/pages.mdx
new file mode 100644
index 00000000000..4aa807c2725
--- /dev/null
+++ b/docs/src/content/docs/zh-cn/guides/pages.mdx
@@ -0,0 +1,152 @@
+---
+title: 页面
+description: 了解如何使用 Starlight 创建和管理文档站点页面。
+sidebar:
+  order: 1
+---
+
+Starlight 根据你的内容生成站点的 HTML 页面，并通过 Markdown frontmatter 提供灵活的选项。
+此外，Starlight 项目可以完全使用 [Astro 强大的页面生成工具](https://docs.astro.build/zh-cn/basics/astro-pages/)。
+本指南介绍了 Starlight 中的页面生成工作原理。
+
+## 内容页面
+
+### 文件格式
+
+Starlight 支持使用 Markdown 和 MDX 编写内容，无需任何配置。
+你可以通过安装实验性的 [Astro Markdoc 集成](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/) 来添加对 Markdoc 的支持。
+
+### 添加页面
+通过在 `src/content/docs/` 中创建 `.md` 或 `.mdx` 文件来添加新页面。
+使用子文件夹来组织文件并创建多个路径段。
+
+举个例子，以下文件结构将在 `example.com/hello-world` 和 `example.com/reference/faq` 生成页面：
+
+import FileTree from '~/components/file-tree.astro';
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+      - reference/
+        - faq.md
+
+</FileTree>
+
+### 类型安全的 frontmatter
+
+所有的 Starlight 页面都共享一个可定制的 [通用 frontmatter 属性集](/zh-cn/reference/frontmatter/)，用于控制页面的外观：
+
+```md
+---
+title: Hello, World!
+description: 这是我的 Starlight 网站中的一个页面
+---
+```
+
+如果你忘记了一些重要的东西，Starlight 会提醒你。
+
+## 自定义页面
+
+对于高级用例，你可以通过创建 `src/pages/` 目录来添加自定义页面。
+`src/pages/` 目录使用 [Astro 的基于文件的路由](https://docs.astro.build/zh-cn/basics/astro-pages/#基于文件的路由)， 并支持 `.astro` 文件等其他页面格式。
+
+这对于需要完全自定义布局或从其他数据源生成页面的情况非常有用。
+
+举个例子，以下文件结构将在 `example.com/custom` 和 `example.com/archived` 生成页面：
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+  - pages/
+    - custom.astro
+    - archived.html
+
+</FileTree>
+
+在 [Astro 文档中的“页面”指南](https://docs.astro.build/zh-cn/basics/astro-pages/) 中了解更多。
+
+### 在自定义页面中使用 Starlight 的设计
+
+要在自定义页面中使用 Starlight 布局，请使用 `<StarlightPage />` 组件包装页面内容。
+
+如果你正在动态生成内容但仍想使用 Starlight 的设计，这会很有帮助。
+
+```astro
+---
+// src/pages/custom-page/example.astro
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import CustomComponent from './CustomComponent.astro';
+---
+
+<StarlightPage frontmatter={{ title: '我的自定义页面' }}>
+	<p>这是一个有自定义组件的自定义页面：</p>
+	<CustomComponent />
+</StarlightPage>
+```
+
+#### Props
+
+`<StarlightPage />` 组件接受以下 props。
+
+##### `frontmatter` (必填)
+
+**类型：** `StarlightPageFrontmatter`
+
+为此页面设置 [frontmatter 属性](/zh-cn/reference/frontmatter/)，类似于 Markdown 页面中的 frontmatter。
+[`title`](/zh-cn/reference/frontmatter/#title-必填) 属性是必填的，其他所有属性都是可选的。
+
+以下是与 Markdown frontmatter 不同的属性：
+
+- [`slug`](/zh-cn/reference/frontmatter/#slug) 属性不受支持，并且会根据自定义页面的 URL 自动设置。
+- [`editUrl`](/zh-cn/reference/frontmatter/#editurl) 选项需要一个 URL 来显示编辑链接。
+- [`sidebar`](/zh-cn/reference/frontmatter/#sidebar) 属性不受支持。在 Markdown frontmatter 中，此选项允许自定义[自动生成的链接组](/zh-cn/reference/configuration/#sidebar)，这不适用于使用 `<StarlightPage />` 组件的页面。
+
+{/* ##### `sidebar` */}
+
+{/* **type:** `SidebarEntry[] | undefined` */}
+{/* **default:** the sidebar generated based on the [global `sidebar` config](/reference/configuration/#sidebar) */}
+
+{/* Provide a custom site navigation sidebar for this page. */}
+{/* If not set, the page will use the default global sidebar. */}
+
+##### `hasSidebar`
+
+**类型：** `boolean`  
+**默认值：** 如果 [`frontmatter.template`](/zh-cn/reference/frontmatter/#template) 是 `'splash'`，为`false`，否则为 `true`
+
+控制是否在此页面上显示侧边栏。
+
+##### `headings`
+
+**类型：** `{ depth: number; slug: string; text: string }[]`  
+**默认值：** `[]`
+
+提供此页面上所有标题的数组。
+如果提供了，Starlight 将从这些标题生成页面目录。
+
+##### `dir`
+
+**类型：** `'ltr' | 'rtl'`  
+**默认值：** 当前语言环境的书写方向
+
+设置此页面内容的书写方向。
+
+##### `lang`
+
+**类型：** `string`  
+**默认值：** 当前语言环境的语言
+
+为此页面的内容设置 BCP-47 语言标签，例如 `en`、`zh-CN` 或 `pt-BR`。
+
+##### `isFallback`
+
+**类型：** `boolean`  
+**默认值：** `false`
+
+表示此页面是否使用了[回退内容](/zh-cn/guides/i18n/#回退内容)，因为当前语言没有翻译。