Skip to content

Commit

Permalink
i18n(zh-cn): Update configuration.mdx & manual-setup.mdx (#2406)
Browse files Browse the repository at this point in the history
Co-authored-by: HiDeoo <[email protected]>
  • Loading branch information
Nin3lee and HiDeoo authored Sep 25, 2024
1 parent ae95038 commit e3fb116
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/src/content/docs/zh-cn/manual-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,6 @@ import { FileTree } from '@astrojs/starlight/components';

### 结合 SSR 使用 Starlight

你可以通过按照 Astro 文档中的 [“按需渲染适配器”](https://docs.astro.build/zh-cn/guides/server-side-rendering/) 指南,在你的项目中使用 Starlight 与自定义的按需渲染页面一起工作
要启用 SSR,请按照 Astro 文档中的 [“按需渲染适配器”](https://docs.astro.build/zh-cn/guides/server-side-rendering/) 指南将服务器适配器添加到你的 Starlight 项目中

目前,Starlight 生成的文档页面始终是预渲染的,无论你的项目的输出模式如何。我们希望能够尽快支持 Starlight 页面的按需渲染
无论项目的输出模式如何,Starlight 生成的文档页面都默认为预渲染。要选择不对 Starlight 页面进行预渲染,请将 [`prerender` 配置选项](/zh-cn/reference/configuration/#prerender) 设置为 `false`
12 changes: 12 additions & 0 deletions docs/src/content/docs/zh-cn/reference/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -451,6 +451,18 @@ Starlight 默认使用 Sarah Drasner 的 [Night Owl 主题](https://github.com/s

将其设置为 `false` 以禁用使用 Pagefind 索引你的网站。这也将隐藏默认的搜索 UI。

[`prerender`](#prerender) 选项设置为 `false` 时,无法启用 Pagefind。

### `prerender`

**类型:** `boolean`
**默认值:** `true`

定义 Starlight 页面是应预渲染为静态 HTML 还是由 [SSR 适配器](https://docs.astro.build/zh-cn/guides/server-side-rendering/) 按需渲染。

默认情况下,Starlight 页面是预渲染的。
如果你正在使用 SSR 适配器并希望按需渲染 Starlight 页面,请设置为 `prerender: false`

### `head`

**类型:** [`HeadConfig[]`](#headconfig)
Expand Down

0 comments on commit e3fb116

Please sign in to comment.