Skip to content

Commit 694a251

Browse files
dsinghviclaude
andcommitted
fix(zh): translate ParamFields in site-level-settings (analytics/integrations/ask-fern/agents/ai-examples/check/experimental)
Final batch covering the remaining sections of the site-level-settings reference: analytics (ga4/gtm/posthog), integrations (context7), ask-fern (datasources, system-prompt), agents (page-directive, description-source, llms-txt, llms-full-txt), ai-examples (enabled/style), check rules (broken-links, example-validation, no-non-component-refs, valid-local-references, no-circular-redirects, valid-docs-endpoints, missing-redirects), experimental (dynamic-snippets), and the trailing canonical-host fallback note. The site-level-settings reference is now fully translated. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent d44c208 commit 694a251

1 file changed

Lines changed: 27 additions & 27 deletions

File tree

fern/translations/zh/products/docs/pages/navigation/site-level-settings.mdx

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1065,8 +1065,8 @@ metadata:
10651065

10661066
<ParamField path="metadata.canonical-host" type="string" required={false}>
10671067
您文档站点的主机名。将用于设置元数据标签和站点地图等文档的规范 URL。
1068-
1069-
Defaults to the URL defined in the `instances` configuration.
1068+
1069+
默认使用 `instances` 配置中定义的 URL。
10701070
</ParamField>
10711071

10721072
## 分析配置
@@ -1084,19 +1084,19 @@ analytics:
10841084
```
10851085

10861086
<ParamField path="analytics.ga4.measurement-id" type="string" required={false} toc={true}>
1087-
Your Google Analytics 4 measurement ID. Must start with "G-".
1087+
您的 Google Analytics 4 measurement ID。必须以 "G-" 开头。
10881088
</ParamField>
10891089

10901090
<ParamField path="analytics.gtm.container-id" type="string" required={false} toc={true}>
1091-
Your Google Tag Manager container ID. Must start with "GTM-".
1091+
您的 Google Tag Manager container ID。必须以 "GTM-" 开头。
10921092
</ParamField>
10931093

10941094
<ParamField path="analytics.posthog" type="object" required={false} toc={true}>
1095-
Configuration for PostHog Analytics integration.
1095+
PostHog Analytics 集成的配置。
10961096
</ParamField>
10971097

10981098
<ParamField path="analytics.posthog.api-key" type="string" required={false} toc={true}>
1099-
Your PostHog project API key. Defaults to the api-host of "https://us.i.posthog.com".
1099+
您的 PostHog 项目 API 密钥。默认使用 api-host "https://us.i.posthog.com"
11001100
</ParamField>
11011101

11021102
## 集成配置
@@ -1109,7 +1109,7 @@ integrations:
11091109
```
11101110

11111111
<ParamField path="integrations.context7" type="string" required={false} toc={true}>
1112-
Relative path to a [Context7](https://context7.com/) verification file. When set, Fern hosts the file at `/context7.json` on your docs site. Learn more about the [Context7 integration](/learn/docs/integrations/context7).
1112+
指向 [Context7](https://context7.com/) 验证文件的相对路径。设置后,Fern 会将该文件托管在您文档站点的 `/context7.json` 路径上。了解更多请参阅 [Context7 集成](/learn/docs/integrations/context7)
11131113
</ParamField>
11141114

11151115
## Ask Fern 配置
@@ -1131,21 +1131,21 @@ ai-search:
11311131
```
11321132

11331133
<ParamField path="ai-search.datasources" type="list of objects" required={false} toc={true}>
1134-
Additional content sources that Ask Fern should index and search. For more details, see [Additional content sources](/learn/docs/ai-features/ask-fern/content-sources).
1134+
Ask Fern 应索引和搜索的其他内容源。更多详情请参阅 [其他内容源](/learn/docs/ai-features/ask-fern/content-sources)
11351135
</ParamField>
11361136

11371137
<ParamField path="datasources.url" type="string" required={true} toc={true}>
1138-
The URL of the website to index. Ask Fern will crawl and index the content from this URL.
1138+
要索引的网站 URLAsk Fern 将抓取并索引该 URL 的内容。
11391139
</ParamField>
11401140

11411141
<ParamField path="datasources.title" type="string" toc={true}>
1142-
An optional display name for this datasource. This helps users understand where the information is coming from when Ask Fern cites content from this source.
1142+
此数据源的可选显示名称。当 Ask Fern 引用该数据源的内容时,显示名称可帮助用户了解信息的来源。
11431143
</ParamField>
11441144

11451145
<ParamField path="ai-search.system-prompt" type="string" toc={true}>
1146-
By default, Ask Fern uses system prompts to finetune AI search results. Add a custom prompt to override it.
1147-
1148-
See Anthropic's [prompting guide](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview) for ideas and examples.
1146+
默认情况下,Ask Fern 使用系统提示对 AI 搜索结果进行微调。可添加自定义 prompt 进行覆盖。
1147+
1148+
灵感和示例请参阅 Anthropic 的 [提示工程指南](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview)
11491149
</ParamField>
11501150

11511151
## Agents 配置
@@ -1161,19 +1161,19 @@ agents:
11611161
```
11621162

11631163
<ParamField path="agents.page-directive" type="string" required={false} toc={true}>
1164-
Text prepended to each page's Markdown output when served to AI agents. The directive is injected after the frontmatter metadata section but before the page body. Human-facing documentation is unaffected. When not set, a default directive is used that points agents to your site's `.md` URLs, `llms.txt`, and `llms-full.txt`. Set to an empty string to disable the directive entirely.
1164+
当向 AI 代理提供页面的 Markdown 输出时,添加在每个页面前面的文本。该指令会注入到 frontmatter 元数据段之后、页面正文之前。面向人类的文档不受影响。未设置时使用默认指令,将代理指向您站点的 `.md` URL、`llms.txt` `llms-full.txt`。设为空字符串可完全禁用该指令。
11651165
</ParamField>
11661166

11671167
<ParamField path="agents.page-description-source" type="'description' | 'subtitle'" required={false} default="description" toc={true}>
1168-
Controls which [frontmatter](/learn/docs/configuration/page-level-settings) field is preferred for one-line page descriptions in `llms.txt`. Defaults to `description`. If the preferred field isn't present in a page's frontmatter, Fern falls back to other fields (`description`, `subtitle`, `og:description`, `headline`, `excerpt`).
1168+
控制在 `llms.txt` 中优先使用哪个 [frontmatter](/learn/docs/configuration/page-level-settings) 字段作为页面的一行描述。默认为 `description`。如果首选字段在页面 frontmatter 中不存在,Fern 会回退到其他字段(`description``subtitle``og:description``headline``excerpt`)。
11691169
</ParamField>
11701170

11711171
<ParamField path="agents.llms-txt" type="string" required={false} toc={true}>
1172-
Path to a custom `llms.txt` file, relative to `docs.yml`. When set, this file is served at the root-level `/llms.txt` endpoint instead of the auto-generated version. Nested paths continue to use the auto-generated output.
1172+
自定义 `llms.txt` 文件的路径,相对于 `docs.yml`。设置后,该文件会在站点根级别的 `/llms.txt` 端点提供,替代自动生成的版本。嵌套路径仍使用自动生成的输出。
11731173
</ParamField>
11741174

11751175
<ParamField path="agents.llms-full-txt" type="string" required={false} toc={true}>
1176-
Path to a custom `llms-full.txt` file, relative to `docs.yml`. When set, this file is served at the root-level `/llms-full.txt` endpoint instead of the auto-generated version. Nested paths continue to use the auto-generated output.
1176+
自定义 `llms-full.txt` 文件的路径,相对于 `docs.yml`。设置后,该文件会在站点根级别的 `/llms-full.txt` 端点提供,替代自动生成的版本。嵌套路径仍使用自动生成的输出。
11771177
</ParamField>
11781178

11791179
## AI 示例配置
@@ -1187,11 +1187,11 @@ ai-examples:
11871187
```
11881188

11891189
<ParamField path="ai-examples.enabled" type="boolean" required={false} default="true" toc={true}>
1190-
Controls AI-generated examples for API Reference pages. When enabled, realistic example values are generated instead of placeholder values like `"string"`. Manual examples in `x-fern-examples` or OpenAPI `example` properties always take priority. Set to `false` to disable AI examples entirely.
1190+
控制 API Reference 页面的 AI 生成示例。启用时,会生成贴近实际的示例值,替代 `"string"` 之类的占位值。`x-fern-examples` OpenAPI `example` 属性中的手动示例始终优先。设为 `false` 可完全禁用 AI 示例。
11911191
</ParamField>
11921192

11931193
<ParamField path="ai-examples.style" type="string" required={false} toc={true}>
1194-
Instructions to guide the content and style of AI-generated examples in your API Reference. Use this to align examples with your brand or domain. Limited to 500 characters.
1194+
用于指导 API Reference 中 AI 生成示例的内容和风格的说明。可用此项让示例符合您的品牌或领域风格。最多 500 个字符。
11951195
</ParamField>
11961196

11971197
## Check 配置
@@ -1207,31 +1207,31 @@ check:
12071207
```
12081208

12091209
<ParamField path="check.rules.broken-links" type="'warn' | 'error'" required={false} default="error" toc={true}>
1210-
Severity for broken link detection. Defaults to `error` for broken internal links and `warn` for malformed URLs. Replaces the deprecated `--broken-links` and `--strict-broken-links` CLI flags.
1210+
失效链接检测的严重级别。对失效的内部链接默认为 `error`,对格式错误的 URL 默认为 `warn`。替代已弃用的 `--broken-links` `--strict-broken-links` CLI 标志。
12111211
</ParamField>
12121212

12131213
<ParamField path="check.rules.example-validation" type="'warn' | 'error'" required={false} default="warn" toc={true}>
1214-
Severity for OpenAPI example validation.
1214+
OpenAPI 示例校验的严重级别。
12151215
</ParamField>
12161216

12171217
<ParamField path="check.rules.no-non-component-refs" type="'warn' | 'error'" required={false} default="error" toc={true}>
1218-
Severity for non-component OpenAPI reference validation. Flags `$ref` values that point outside the `#/components` section of an OpenAPI spec.
1218+
非组件 OpenAPI 引用校验的严重级别。会标记指向 OpenAPI 规范 `#/components` 段以外位置的 `$ref` 值。
12191219
</ParamField>
12201220

12211221
<ParamField path="check.rules.valid-local-references" type="'warn' | 'error'" required={false} default="warn" toc={true}>
1222-
Severity for local OpenAPI reference validation. Checks that local `$ref` values resolve to existing definitions.
1222+
本地 OpenAPI 引用校验的严重级别。检查本地 `$ref` 值是否指向已存在的定义。
12231223
</ParamField>
12241224

12251225
<ParamField path="check.rules.no-circular-redirects" type="'warn' | 'error'" required={false} default="error" toc={true}>
1226-
Severity for circular redirect validation. Detects redirect chains that loop back to a previously visited path.
1226+
循环重定向校验的严重级别。检测重定向链路是否回到先前访问过的路径。
12271227
</ParamField>
12281228

12291229
<ParamField path="check.rules.valid-docs-endpoints" type="'warn' | 'error'" required={false} default="warn" toc={true}>
1230-
Severity for docs endpoint URL validation. Checks that endpoint URLs referenced in `docs.yml` are well-formed.
1230+
文档端点 URL 校验的严重级别。检查 `docs.yml` 中引用的端点 URL 是否格式正确。
12311231
</ParamField>
12321232

12331233
<ParamField path="check.rules.missing-redirects" type="'warn' | 'error'" required={false} default="warn" toc={true}>
1234-
Severity for missing redirect detection. Compares the current docs navigation against the previously published state and flags pages that were removed or moved to a new URL without a corresponding [redirect](/learn/docs/configuration/site-level-settings#redirects-configuration) in `docs.yml`. Requires authentication (`fern login` or the `FERN_TOKEN` environment variable). The check is skipped on first publish, when unauthenticated, or when the network is unavailable.
1234+
缺失重定向检测的严重级别。将当前文档导航与之前发布的状态进行对比,标记被删除或移动到新 URL 但未在 `docs.yml` 中配置 [redirect](/learn/docs/configuration/site-level-settings#redirects-configuration) 的页面。需要进行身份验证(`fern login` `FERN_TOKEN` 环境变量)。在首次发布、未登录或网络不可用时会跳过此检查。
12351235
</ParamField>
12361236

12371237
## 实验性功能配置
@@ -1245,6 +1245,6 @@ experimental:
12451245
```
12461246

12471247
<ParamField path="experimental.dynamic-snippets" type="boolean" required={false} default="true" toc={true}>
1248-
Controls dynamic SDK snippets that allow users to modify parameters and see code examples update in real time. Dynamic snippets are enabled by default and supported across all languages. Follow the [SDK snippets setup instructions](/docs/api-references/sdk-snippets) to configure. Set to false to use static SDK snippets instead.
1248+
控制动态 SDK 代码片段——允许用户修改参数并实时查看代码示例的更新。动态代码片段默认启用,并支持所有语言。请按照 [SDK 代码片段配置说明](/docs/api-references/sdk-snippets) 进行配置。设为 false 可改用静态 SDK 代码片段。
12491249
</ParamField>
12501250

0 commit comments

Comments
 (0)