Skip to content

Commit ebc6639

Browse files
Update 101 stale zh translations to match current EN source (#5515)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
1 parent 317941e commit ebc6639

101 files changed

Lines changed: 2737 additions & 3408 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

fern/translations/zh/products/api-def/ferndef/api-yml/environments.mdx

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: 环境配置
3-
description: 列出生产、预发布和开发等环境
4-
sidebar-title: 环境配置
2+
title: 环境
3+
description: 列出生产、暂存和开发等环境
4+
noindex: true
55
---
66

7-
您可以指定服务器部署的环境
7+
您可以指定部署服务器的环境
88

9-
## 单 URL 环境
9+
## 单URL环境
1010

1111
```yaml title="api.yml"
1212
name: api
@@ -17,9 +17,9 @@ environments:
1717
url: https://www.staging.yoursite.com
1818
```
1919
20-
## 每个环境多个 URL
20+
## 每个环境多个URL
2121
22-
您可以为每个环境指定多个 URL。如果您有微服务架构,并且希望单个 SDK 与多个服务器交互,这将很有帮助。
22+
您可以为每个环境指定多个URL。如果您有微服务架构,并希望单个SDK与多个服务器交互,这将很有帮助。
2323
2424
```yaml title="api.yml"
2525
environments:
@@ -33,7 +33,7 @@ environments:
3333
Plants: https://plants.staging.yoursite.com
3434
```
3535
36-
如果您选择使用此功能,必须为您定义的每个服务指定一个 `url`:
36+
如果您选择使用此功能,必须为定义的每个服务指定一个`url`:
3737

3838
```yaml title="auth.yml"
3939
service:
@@ -44,7 +44,7 @@ service:
4444

4545
## 默认环境
4646

47-
您也可以提供默认环境
47+
您还可以提供默认环境
4848

4949
```yaml title="api.yml"
5050
name: api
@@ -56,18 +56,18 @@ environments:
5656
default-environment: Production
5757
```
5858

59-
<Note>通过提供默认环境,生成的 SDK 将设置为开箱即用地访问该 URL。</Note>
59+
<Note>通过提供默认环境,生成的SDK将设置为开箱即用地访问该URL。</Note>
6060

61-
## URL 模板
61+
## URL模板
6262

63-
<Note>URL 模板目前仅支持 Python 和 Java SDK 生成。</Note>
63+
<Note>URL模板目前仅支持Python和Java SDK生成。</Note>
6464

65-
对于跨多个区域或环境部署的 API,您可以定义带有变量占位符的 URL 模板,SDK 用户可以在运行时进行自定义。要设置此功能
65+
对于跨多个区域或环境部署的API,您可以定义带有变量占位符的URL模板,SDK用户可以在运行时自定义。设置方法
6666

67-
1. 在 `urls` 下定义您的静态基础 URL——这些会出现在生成的环境枚举中
68-
2. 为每个服务添加带有 `{variable}` 占位符的 `url-templates`(例如,`https://api.{region}.example.com/v1`)。Fern 将这些作为 SDK 中的可配置参数公开
69-
3. 提供 `default-urls` 作为具体的回退选项,这样 SDK 用户无需提供变量就能获得开箱即用的客户端
70-
4. 为每个服务列出可用的 `variables`,每个变量都有一个 `id`、一个 `default` 值,以及一个可选的 `values` 列表来约束允许的选项。
67+
1. 在`urls`下定义静态基础URL——这些将出现在生成的环境枚举中
68+
2. 为每个服务添加带有`{variable}`占位符的`url-templates`(例如,`https://api.{region}.example.com/v1`)。Fern将这些作为SDK中的可配置参数公开
69+
3. 提供`default-urls`作为具体的后备方案,以便SDK用户无需提供变量即可获得开箱即用的客户端
70+
4. 列出每个服务的可用`variables`,每个变量具有`id`、`default`值和可选的`values`列表来约束允许的选项。
7171

7272
```yaml title="api.yml"
7373
environments:
@@ -106,17 +106,17 @@ default-environment: RegionalApiServer
106106
```
107107

108108
## 基础路径
109-
如果您希望所有端点都添加路径前缀,请使用 `base-path`。
109+
如果您希望所有端点都带有路径前缀,请使用`base-path`。
110110

111-
在下面的示例中,每个端点都添加了 `/v1` 前缀:
111+
在下面的示例中,每个端点都带有`/v1`前缀:
112112
```yaml title="api.yml"
113113
name: api
114114
base-path: /v1
115115
```
116116

117117
## 受众
118118

119-
如果您有列出的环境需要过滤,可以利用受众功能。
119+
如果您有想要筛选的已列出环境,可以利用受众功能。
120120

121121
```yaml title="api.yml"
122122
audiences:
@@ -129,4 +129,4 @@ environments:
129129
url: https://api.buildwithfern.com
130130
audiences:
131131
- external
132-
```
132+
```

fern/translations/zh/products/api-def/ferndef/api-yml/errors.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: 错误处理
33
description: 指定错误类型和模式
4-
sidebar-title: 错误处理
4+
noindex: true
55
---
66

7-
为了以惯用方式生成 SDK,Fern 需要知道在解析端点响应时如何区分不同的错误。
7+
为了生成符合习惯的 SDK,Fern 需要知道在解析端点响应时如何区分不同的错误。
88

9-
### 按状态码区分
9+
### 通过状态码区分
1010

11-
您可以指定 Fern 按状态码区分。这意味着在每个端点上,列出的每个错误都必须具有不同的 HTTP 状态码。
11+
您可以指定 Fern 通过状态码进行区分。这意味着在每个端点上,列出的每个错误都必须具有不同的 HTTP 状态码。
1212

1313
<CodeBlock title="api.yml">
1414
```yaml
@@ -18,9 +18,9 @@ error-discrimination:
1818
```
1919
</CodeBlock>
2020
21-
### 按错误名称区分
21+
### 通过错误名称区分
2222
23-
您可以指定 Fern 按错误名称区分。如果您选择此策略,那么 Fern 将假设每个错误响应都有一个额外的属性来表示错误名称。
23+
您可以指定 Fern 通过错误名称进行区分。如果选择此策略,则 Fern 将假设每个错误响应都有一个额外的属性来表示错误名称。
2424
2525
如果您使用 Fern 生成服务器端代码,那么此选项提供了最大的灵活性。否则,您可能希望使用状态码区分策略。
2626
@@ -35,7 +35,7 @@ error-discrimination:
3535
3636
### 全局错误
3737
38-
您可以导入并列出将由每个端点抛出的错误
38+
您可以导入和列出将由每个端点抛出的错误
3939
4040
<CodeBlock title="api.yml">
4141
```yaml
@@ -46,4 +46,4 @@ errors:
4646
- commons.NotFoundError
4747
- commons.BadRequestError
4848
```
49-
</CodeBlock>
49+
</CodeBlock>

fern/translations/zh/products/api-def/ferndef/api-yml/global-configuration.mdx

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: 全局配置
3-
description: 指定全局请求头、路径参数或查询参数,以包含在每个请求中
4-
sidebar-title: 全局配置
3+
description: 指定全局请求头、路径参数或查询参数,以便在每个请求中包含
4+
noindex: true
55
---
66

77
`api.yml` 配置支持全局配置,如请求头和路径参数。
88

99
## 全局请求头
1010

11-
您可以指定要包含在每个请求中的请求头
11+
您可以指定要在每个请求中包含的请求头
1212

1313
<CodeBlock title="api.yml">
1414
```yaml
@@ -18,11 +18,11 @@ headers:
1818
```
1919
</CodeBlock>
2020
21-
`api.yml` 中定义全局请求头时,您必须[在端点示例中包含它们](/api-definitions/ferndef/examples#examples-with-headers)。
21+
当您在 `api.yml` 中定义全局请求头时,必须[在端点示例中包含它们](/api-definitions/ferndef/examples#examples-with-headers)。
2222

2323
## 全局路径参数
2424

25-
您可以指定要包含在每个请求中的路径参数
25+
您可以指定要在每个请求中包含的路径参数
2626

2727
<CodeBlock title="api.yml">
2828
```yaml
@@ -36,7 +36,7 @@ path-parameters:
3636

3737
### 覆盖基础路径
3838

39-
如果您有某些端点不在配置的 `base-path` 下,您可以在端点级别覆盖 `base-path`。
39+
如果您有某些端点不位于配置的 `base-path` 下,可以在端点级别覆盖 `base-path`。
4040

4141
```yml imdb.yml {5}
4242
service:
@@ -51,12 +51,12 @@ service:
5151

5252
## 全局查询参数
5353

54-
目前还不能指定要包含在每个请求中的查询参数
55-
如果您希望看到这个功能,请为[此问题](https://github.com/fern-api/fern/issues/2930)投票。
54+
您还不能指定要在每个请求中包含的查询参数
55+
如果您希望看到此功能,请为[此问题](https://github.com/fern-api/fern/issues/2930)投票。
5656

5757
## 幂等性请求头
5858

59-
配置幂等性请求头来定义 [SDK 用户](/learn/sdks/deep-dives/idempotency)可以为安全请求重试指定的请求头。您还必须[将每个端点标记为幂等](/learn/api-definitions/ferndef/endpoints/overview#idempotent-endpoints)才能公开这些请求头。当两者都配置时,Fern 生成的 SDK 会将这些请求头作为幂等端点调用的参数公开。
59+
配置幂等性请求头以定义 [SDK 用户](/learn/sdks/deep-dives/idempotency)可以为安全请求重试指定的请求头。您还必须[将每个端点标记为幂等](/learn/api-definitions/ferndef/endpoints/overview#idempotent-endpoints)才能公开这些请求头。当两者都配置时,Fern 生成的 SDK 会将这些请求头作为幂等端点调用的参数公开。
6060

6161
```yaml title="api.yml"
6262
name: api
@@ -66,4 +66,4 @@ idempotency-headers:
6666
Idempotency-Expiration: optional<integer>
6767
```
6868

69-
`idempotency-headers` 中的每个键是 HTTP 请求头名称,值是类型。然后 [SDK 用户](/learn/sdks/deep-dives/idempotency)可以在调用幂等端点时指定这些请求头
69+
`idempotency-headers` 中的每个键都是 HTTP 请求头名称,值是类型。[SDK 用户](/learn/sdks/deep-dives/idempotency)然后可以在调用幂等端点时指定这些请求头

fern/translations/zh/products/api-def/ferndef/api-yml/overview.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: api.yml 配置文件
3-
description: 使用 Fern Definition 格式时,api.yml 文件包含通用 API 配置。
4-
sidebar-title: api.yml 配置文件
3+
description: 在使用 Fern Definition 格式时,api.yml 文件包含通用 API 配置。
4+
noindex: true
55
---
66

7-
`fern/` 文件夹中有一个名为 `api.yml` 的特殊文件,其中包含所有 API 级别的配置
7+
一个 `fern/` 文件夹包含一个名为 `api.yml` 的特殊文件,其中包括所有 API 范围的配置
88

99
```bash {5}
1010
fern/
@@ -19,7 +19,7 @@ fern/
1919

2020
## API 名称
2121

22-
此名称用于在您的组织中唯一标识您的 API。如果您只有一个 API,那么 `api` 是一个合适的名称
22+
此名称用于在您的组织中唯一标识您的 API。如果您只有一个 API,那么 `api` 就是一个足够的名称
2323

2424
<CodeBlock title="api.yml">
2525
```yaml
@@ -42,7 +42,7 @@ docs: |
4242
4343
## API 版本
4444
45-
您可以定义基于请求头的 API 版本控制方案,例如 `X-API-Version`。支持的版本和默认值的指定方式如下
45+
您可以定义基于请求头的 API 版本控制方案,例如 `X-API-Version`。支持的版本和默认值指定如下
4646

4747
<CodeBlock title="api.yml">
4848
```yaml
@@ -54,4 +54,4 @@ version:
5454
- "2.0.0"
5555
- "latest"
5656
```
57-
</CodeBlock>
57+
</CodeBlock>

fern/translations/zh/products/api-def/ferndef/audiences.mdx

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,26 @@
11
---
2-
title: Fern Definition 中的受众
3-
subtitle: 在您的 Fern Definition 中使用受众,为不同的 API 消费者群体进行分组
4-
sidebar-title: Fern Definition 中的受众
2+
title: Fern 定义中的受众
3+
subtitle: Fern 定义中使用受众来为不同的 API 消费者群体进行分段
4+
noindex: true
55
---
66

7-
87
<Markdown src="/snippets/team-or-pro-plan.mdx"/>
98

10-
受众是为不同消费者分组 API 的有用工具。您可以配置 Fern Docs 发布特定于某个`受众`的文档。您也可以在 [OpenAPI 规范中使用受众](/learn/api-definitions/openapi/extensions/audiences)
9+
受众是一个用于为不同消费者分段 API 的有用工具。您可以配置 Fern Docs 来发布特定于某个`受众`的文档。您也可以[OpenAPI 规范中使用受众](/learn/api-definitions/openapi/extensions/audiences)
1110

1211
受众的常见示例包括:
1312

1413
- 内部消费者(例如,使用 API 的前端开发人员)
15-
- Beta 测试人员
14+
- Beta 测试者
1615
- 客户
1716

18-
默认情况下,如果未指定受众,则所有消费者都可以访问
17+
默认情况下,如果没有指定受众,所有消费者都可以访问
1918

2019
## 配置
2120

22-
Fern Definition 具有为不同端点、类型和属性标记不同受众的一级概念。
21+
Fern 定义具有为不同端点、类型和属性标记不同受众的一级概念。
2322

24-
要在 Fern Definition 中使用受众,请将其添加到 `api.yml` 中。
23+
要在 Fern 定义中使用受众,请将其添加到 `api.yml` 中。
2524

2625
在下面的示例中,我们为 `internal``beta``customer` 群体创建了受众:
2726

@@ -33,7 +32,7 @@ audiences:
3332
- customers
3433
```
3534
36-
## 端点的受众
35+
## 端点受众
3736
3837
要为特定消费者标记端点,请添加包含相关群体的 `audience`。
3938

@@ -51,9 +50,9 @@ service:
5150
...
5251
```
5352

54-
## 类型的受众
53+
## 类型受众
5554

56-
类型也可以标记为不同的受众
55+
类型也可以为不同受众进行标记
5756

5857
在此示例中,`Email` 类型对内部和 beta 消费者可用:
5958

@@ -67,9 +66,9 @@ Email:
6766
- beta
6867
```
6968

70-
## 属性的受众
69+
## 属性受众
7170

72-
类型的属性也可以标记为不同的受众
71+
类型的属性也可以为不同受众进行标记
7372

7473
在此示例中,`to` 属性仅对 beta 消费者可用:
7574

@@ -85,7 +84,7 @@ Email:
8584
- beta
8685
```
8786

88-
## SDK 的受众
87+
## SDK 受众
8988

9089
在 `generators.yml` 中,您可以应用受众过滤器,以便只有某些端点传递给生成器。
9190

@@ -100,11 +99,11 @@ groups:
10099
...
101100
```
102101

103-
## 文档的受众
102+
## 文档受众
104103

105104
如果生成 Fern Docs,请更新您的 `docs.yml` 配置以包含您的受众。
106105

107-
以下示例展示了如何配置您的 `docs.yml` `customers` 受众发布文档:
106+
以下示例显示如何配置 `docs.yml` 来为 `customers` 受众发布文档:
108107

109108
<CodeBlock title='docs.yml'>
110109
```yaml {3-4}
@@ -113,4 +112,4 @@ navigation:
113112
audiences:
114113
- customers
115114
```
116-
</CodeBlock>
115+
</CodeBlock>

0 commit comments

Comments
 (0)