Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AutoCorrect fix for translations/zh-CN/content/rest #20828

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions translations/zh-CN/content/rest/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ ms.locfileid: "145129226"

`/content/rest` 目录是 GitHub REST API 文档所在的位置!

* `/content/rest/guides` 和 `/content/rest/overview` 目录包含常规文章。 这些项目可人工编辑。
* `/content/rest/reference` 目录包含 GitHub REST API 中每组终结点的文章。 此目录中的大部分内容都使用 `include` 标记呈现。
* `/content/rest/guides` 和 `/content/rest/overview` 目录包含常规文章。这些项目可人工编辑。
* `/content/rest/reference` 目录包含 GitHub REST API 中每组终结点的文章。此目录中的大部分内容都使用 `include` 标记呈现。

`include` 标记呈现的内容来自 `/lib/rest/static` 目录,由 GitHub 内部的 API 源代码自动生成,不应人工编辑。 有关详细信息,请参阅 [`/lib/rest/README.md`](/lib/rest/README.md)。
`include` 标记呈现的内容来自 `/lib/rest/static` 目录,由 GitHub 内部的 API 源代码自动生成,不应人工编辑。有关详细信息,请参阅 [`/lib/rest/README.md`](/lib/rest/README.md)。

我们无法接受对由 `include` 标记呈现的内容的更改。但你可以打开一个描述你希望看到的更改的问题。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/actions/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,4 @@ ms.contentlocale: zh-CN
ms.lasthandoff: 09/05/2022
ms.locfileid: '147061968'
---
{% data variables.product.prodname_actions %} API 允许您使用 REST API 来管理 {% data variables.product.prodname_actions %}。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} 需要在每个端点中提及的权限。 有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 文档](/actions)”。
{% data variables.product.prodname_actions %} API 允许您使用 REST API 来管理 {% data variables.product.prodname_actions %}。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} 需要在每个端点中提及的权限。有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 文档](/actions)”。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/actions/secrets.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,4 +21,4 @@ ms.locfileid: '147061978'

通过 {% data variables.product.prodname_actions %} 机密 API,可以创建、更新、删除和检索有关可在 {% data variables.product.prodname_actions %} 工作流中使用的加密机密的信息。 {% data reusables.actions.about-secrets %} 有关详细信息,请参阅“[创建和使用加密机密](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。

{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有 `secrets` 权限才可使用此 API。 经过身份验证的用户必须对仓库具有协作者权限才可创建、更新或读取密码。
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有 `secrets` 权限才可使用此 API。经过身份验证的用户必须对仓库具有协作者权限才可创建、更新或读取密码。
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,6 @@ ms.locfileid: '147064368'
---
## 关于自托管运行器组 API

自托管运行器组 API 允许你管理自托管运行器组。 有关详细信息,请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。
自托管运行器组 API 允许你管理自托管运行器组。有关详细信息,请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。

{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有对存储库的 `administration` 权限,或具有对组织的 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有对存储库的 `administration` 权限,或具有对组织的 `organization_self_hosted_runners` 权限。经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,4 @@ ms.locfileid: '147064376'

自托管运行器 API 支持注册、查看和删除自托管的运行器。 {% data reusables.actions.about-self-hosted-runners %} 有关详细信息,请参阅“[托管自己的运行器](/actions/hosting-your-own-runners)”。

{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有对存储库的 `administration` 权限,或具有对组织的 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}必须具有对存储库的 `administration` 权限,或具有对组织的 `organization_self_hosted_runners` 权限。经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。
6 changes: 3 additions & 3 deletions translations/zh-CN/content/rest/activity/events.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ ms.locfileid: '147064304'
---
这些事件推动站点上的各种活动流。

事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。 有关可从事件 API 接收的特定事件的详细信息,请参阅“[{% data variables.product.prodname_dotcom %} 事件类型](/developers/webhooks-and-events/github-event-types)”。 存储库问题的事件 API 也可用。 有关详细信息,请参阅“[议题事件 API](/rest/reference/issues#events)”。
事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。有关可从事件 API 接收的特定事件的详细信息,请参阅“[{% data variables.product.prodname_dotcom %} 事件类型](/developers/webhooks-and-events/github-event-types)”。存储库问题的事件 API 也可用。有关详细信息,请参阅“[议题事件 API](/rest/reference/issues#events)”。

事件针对使用 "ETag" 标头的轮询进行了优化。 如果未触发任何新事件,您将会看到一个 "304 Not Modified" 响应,并且您的当前速率限制不受影响。 还有一个 "X-Poll-Interval" 标头,用于指定允许您轮询的间隔时间(以秒为单位)。 在服务器负载较高时,该时间可能会增加。 请遵循标头指示。
事件针对使用 "ETag" 标头的轮询进行了优化。如果未触发任何新事件,您将会看到一个 "304 Not Modified" 响应,并且您的当前速率限制不受影响。还有一个 "X-Poll-Interval" 标头,用于指定允许您轮询的间隔时间(以秒为单位)。在服务器负载较高时,该时间可能会增加。请遵循标头指示。

``` shell
$ curl -I {% data variables.product.api_url_pre %}/users/tater/events
Expand All @@ -35,4 +35,4 @@ $ -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"'
> X-Poll-Interval: 60
```

时间表中只包含过去 90 天内创建的事件。 超过 90 天的活动将不包括在内(即使时间表中的活动总数不到 300 个)。
时间表中只包含过去 90 天内创建的事件。超过 90 天的活动将不包括在内(即使时间表中的活动总数不到 300 个)。
4 changes: 2 additions & 2 deletions translations/zh-CN/content/rest/activity/feeds.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,11 @@ ms.locfileid: '147064296'
---
## 关于源 API

若要查看可用的源,请使用[“获取源”](#get-feeds)操作。 然后,可以通过向其中一个源 URL 发送请求来获取源。
若要查看可用的源,请使用[“获取源”](#get-feeds)操作。然后,可以通过向其中一个源 URL 发送请求来获取源。

### 获取 Atom 馈送的示例

若要获取 Atom 格式的馈送,必须在 `Accept` 标头中指定 `application/atom+xml` 类型。 例如,要获取 GitHub 安全通告的 Atom 馈送:
若要获取 Atom 格式的馈送,必须在 `Accept` 标头中指定 `application/atom+xml` 类型。例如,要获取 GitHub 安全通告的 Atom 馈送:

curl -H "Accept: application/atom+xml" https://github.com/security-advisories

Expand Down
12 changes: 6 additions & 6 deletions translations/zh-CN/content/rest/activity/notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,13 @@ ms.locfileid: '147064272'
---
## 关于通知 API

使用通知 API 可以管理 {% data variables.product.product_name %} 通知。 有关通知的详细信息,请参阅“[关于通知](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)”。
使用通知 API 可以管理 {% data variables.product.product_name %} 通知。有关通知的详细信息,请参阅“[关于通知](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)”。

所有通知 API 调用都需要 `notifications` 或 `repo` API 作用域。 这将赋予对某些议题和提交内容的只读权限。 你仍需要 `repo` 作用域才能从相应的端点访问议题和提交。
所有通知 API 调用都需要 `notifications` 或 `repo` API 作用域。这将赋予对某些议题和提交内容的只读权限。你仍需要 `repo` 作用域才能从相应的端点访问议题和提交。

通知以“帖子”的形式返回。 帖子包含当前对议题、拉取请求或提交的讨论信息。
通知以“帖子”的形式返回。帖子包含当前对议题、拉取请求或提交的讨论信息。

通知针对使用 `Last-Modified` 标头的轮询进行了优化。 如果没有新的通知,你将看到 `304 Not Modified` 响应,你的当前速率限制不受影响。 还有一个 `X-Poll-Interval` 标头,用于指定允许你轮询的间隔时间(以秒为单位)。 在服务器负载较高时,该时间可能会增加。 请遵循标头指示。
通知针对使用 `Last-Modified` 标头的轮询进行了优化。如果没有新的通知,你将看到 `304 Not Modified` 响应,你的当前速率限制不受影响。还有一个 `X-Poll-Interval` 标头,用于指定允许你轮询的间隔时间(以秒为单位)。在服务器负载较高时,该时间可能会增加。请遵循标头指示。

``` shell
# Add authentication to your requests
Expand All @@ -42,7 +42,7 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT"

### 关于通知原因

从通知 API 检索响应时,每个有效负载都有一个名为 `reason` 的键。 这些键对应于触发通知的事件。
从通知 API 检索响应时,每个有效负载都有一个名为 `reason` 的键。这些键对应于触发通知的事件。

以下是接收通知的可能 `reason`:

Expand All @@ -63,4 +63,4 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT"

请注意,`reason` 根据每个帖子而修改,如果在以后的通知中,`reason` 不同,其值可能会变更。

例如,如果你是某个议题的作者,则有关该议题的后续通知中,其 `reason` 值为 `author`。 如果后来你在这个议题上被 **@mentioned** ,则你此后收到的通知中,其 `reason` 值为 `mention`。 无论你此后是否被再次提及,`reason` 值将保持 `mention` 不变。
例如,如果你是某个议题的作者,则有关该议题的后续通知中,其 `reason` 值为 `author`。如果后来你在这个议题上被 **@mentioned** ,则你此后收到的通知中,其 `reason` 值为 `mention`。无论你此后是否被再次提及,`reason` 值将保持 `mention` 不变。
6 changes: 3 additions & 3 deletions translations/zh-CN/content/rest/activity/starring.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ ms.locfileid: '147064248'
---
## 关于星标 API

星标 API 允许为存储库添加书签。 显示在仓库旁边的星标表示大致的兴趣程度。 星标对通知或活动馈送没有影响。 有关详细信息,请参阅“[使用星标保存存储库](/get-started/exploring-projects-on-github/saving-repositories-with-stars)”。
星标 API 允许为存储库添加书签。显示在仓库旁边的星标表示大致的兴趣程度。星标对通知或活动馈送没有影响。有关详细信息,请参阅“[使用星标保存存储库](/get-started/exploring-projects-on-github/saving-repositories-with-stars)”。

### 标星与 关注

2012 年 8 月,我们在 {% data variables.product.prodname_dotcom %} 上[更改了关注工作的方式](https://github.com/blog/1204-notifications-stars)。 许多 API 客户端应用程序可能在使用原始的“观察程序”端点来访问此数据。 现在,可以开始使用“星标”端点了(如下所述)。 有关详细信息,请参阅[观察程序 API 更改帖子](https://developer.github.com/changes/2012-09-05-watcher-api/)和“[存储库观察 API](/rest/reference/activity#watching)”。
2012 年 8 月,我们在 {% data variables.product.prodname_dotcom %} 上[更改了关注工作的方式](https://github.com/blog/1204-notifications-stars)。许多 API 客户端应用程序可能在使用原始的“观察程序”端点来访问此数据。现在,可以开始使用“星标”端点了(如下所述)。有关详细信息,请参阅[观察程序 API 更改帖子](https://developer.github.com/changes/2012-09-05-watcher-api/)和“[存储库观察 API](/rest/reference/activity#watching)”。

### 标星的自定义媒体类型

标星 REST API 有一个支持的自定义媒体类型。 使用此自定义媒体类型时,你将收到带有 `starred_at` 时间戳属性的响应,该属性指示星标创建的时间。 该响应还有第二个属性,该属性包括在不使用自定义媒体类型时返回的资源。 包含资源的属性将为 `user` 或 `repo`。
标星 REST API 有一个支持的自定义媒体类型。使用此自定义媒体类型时,你将收到带有 `starred_at` 时间戳属性的响应,该属性指示星标创建的时间。该响应还有第二个属性,该属性包括在不使用自定义媒体类型时返回的资源。包含资源的属性将为 `user` 或 `repo`。

application/vnd.github.star+json

Expand Down
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/activity/watching.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@ ms.locfileid: '147883479'
---
## 关于监视 API

监视 API 允许用户订阅存储库中活动的通知。 若要改为为存储库添加书签,请参阅“[标星](/rest/reference/activity#starring)”。
监视 API 允许用户订阅存储库中活动的通知。若要改为为存储库添加书签,请参阅“[标星](/rest/reference/activity#starring)”。
6 changes: 3 additions & 3 deletions translations/zh-CN/content/rest/apps/apps.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,10 @@ ms.locfileid: '146769187'

{% data reusables.apps.general-apps-restrictions %}

本页列出了验证为 GitHub 应用程序后可访问的端点。 有关详细信息,请参阅“[验证为 GitHub 应用](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)”。
本页列出了验证为 GitHub 应用程序后可访问的端点。有关详细信息,请参阅“[验证为 GitHub 应用](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)”。

验证为 GitHub 应用程序后,GitHub 应用程序 API 使您能够获取有关 GitHub 应用程序的高层次信息以及有关应用程序安装的特定信息。

验证为 GitHub 应用后,你可以访问 REST API 终结点。 这些终结点包含指示“使用 GitHub 应用”的文本。 验证为用户后也可以访问这些端点。
验证为 GitHub 应用后,你可以访问 REST API 终结点。这些终结点包含指示“使用 GitHub 应用”的文本。验证为用户后也可以访问这些端点。

某些 REST API 终结点需要验证为 GitHub 应用安装设施。 有关这些终结点的列表,请参阅“[安装](/rest/reference/apps#installations)”。
某些 REST API 终结点需要验证为 GitHub 应用安装设施。有关这些终结点的列表,请参阅“[安装](/rest/reference/apps#installations)”。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/apps/installations.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,6 @@ ms.locfileid: '147711668'
---
## 关于 {% data variables.product.prodname_github_app %} 安装 API

“安装”是指已安装该应用的任何用户或组织帐户。 有关如何验证为安装并限制对特定存储库的访问的信息,请参阅“[验证为安装](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。
“安装”是指已安装该应用的任何用户或组织帐户。有关如何验证为安装并限制对特定存储库的访问的信息,请参阅“[验证为安装](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。

若要列出组织的所有 GitHub 应用安装,请参阅“[列出组织的应用安装](/rest/orgs/orgs#list-app-installations-for-an-organization)”。
4 changes: 2 additions & 2 deletions translations/zh-CN/content/rest/apps/marketplace.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,8 @@ ms.locfileid: '145129186'

### 使用存根端点进行测试

此 API 包含的终结点允许使用“存根数据”[测试 {% data variables.product.prodname_github_app %}](/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/)。 存根数据是硬编码的假数据,不会根据实际订阅而更改。
此 API 包含的终结点允许使用“存根数据”[测试 {% data variables.product.prodname_github_app %}](/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/)。存根数据是硬编码的假数据,不会根据实际订阅而更改。

要使用存根数据进行测试,请使用存根端点代替其对应的生产端点。 这允许您在 {% data variables.product.prodname_marketplace %} 上列出 {% data variables.product.prodname_github_apps %} 之前测试 API 逻辑是否成功。
要使用存根数据进行测试,请使用存根端点代替其对应的生产端点。这允许您在 {% data variables.product.prodname_marketplace %} 上列出 {% data variables.product.prodname_github_apps %} 之前测试 API 逻辑是否成功。

在部署您的 {% data variables.product.prodname_github_app %} 之前,请务必将存根端点替换为生产端点。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,4 @@ ms.locfileid: '147062503'
---
## 关于计费 API

您可以获取企业的帐单信息。 有关详细信息,请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#billing)”REST API。
您可以获取企业的帐单信息。有关详细信息,请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#billing)”REST API。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/checks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ ms.contentlocale: zh-CN
ms.lasthandoff: 09/11/2022
ms.locfileid: '147065840'
---
您可以创建应用程序以执行持续集成 、代码分析或代码扫描服务,并提供有关提交的详细反馈。 有关详细信息,请参阅“[检查 API 入门](/rest/guides/getting-started-with-the-checks-api)”和“[使用检查 API 创建 CI 测试](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)”。
您可以创建应用程序以执行持续集成、代码分析或代码扫描服务,并提供有关提交的详细反馈。有关详细信息,请参阅“[检查 API 入门](/rest/guides/getting-started-with-the-checks-api)”和“[使用检查 API 创建 CI 测试](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)”。
2 changes: 1 addition & 1 deletion translations/zh-CN/content/rest/checks/suites.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,6 @@ ms.locfileid: '147063192'
---
{% note %}

注意:GitHub 应用在每个提交 SHA 中仅接收一个 [`check_suite`](/webhooks/event-payloads/#check_suite) 事件,即使将提交 SHA 推送到多个分支也是如此。 要了解何时将提交 SHA 推送到分支,可以订阅分支 [`create`](/webhooks/event-payloads/#create) 事件。
注意:GitHub 应用在每个提交 SHA 中仅接收一个 [`check_suite`](/webhooks/event-payloads/#check_suite) 事件,即使将提交 SHA 推送到多个分支也是如此。要了解何时将提交 SHA 推送到分支,可以订阅分支 [`create`](/webhooks/event-payloads/#create) 事件。

{% endnote %}
Loading