From 61522c069c08b7b5e869c6e4f8aebe7bb3f41839 Mon Sep 17 00:00:00 2001 From: Jason Lee Date: Sun, 25 Sep 2022 00:09:16 +0800 Subject: [PATCH] AutoCorrect fix for translations/zh-CN/content/p* --- translations/zh-CN/content/packages/index.md | 2 +- .../connecting-a-repository-to-a-package.md | 4 +- .../installing-a-package.md | 4 +- .../publishing-a-package.md | 10 ++-- .../zh-CN/content/packages/quickstart.md | 16 +++--- ...ainer-registry-from-the-docker-registry.md | 4 +- .../working-with-the-apache-maven-registry.md | 8 +-- .../working-with-the-docker-registry.md | 8 +-- .../working-with-the-gradle-registry.md | 10 ++-- .../working-with-the-nuget-registry.md | 12 ++--- .../working-with-the-rubygems-registry.md | 36 ++++++------- .../about-custom-domains-and-github-pages.md | 24 ++++----- ...ustom-domain-for-your-github-pages-site.md | 20 +++---- ...hooting-custom-domains-and-github-pages.md | 32 ++++++------ ...ing-your-custom-domain-for-github-pages.md | 10 ++-- .../about-github-pages.md | 34 ++++++------ ...he-visibility-of-your-github-pages-site.md | 14 ++--- ...shing-source-for-your-github-pages-site.md | 24 ++++----- ...uring-your-github-pages-site-with-https.md | 12 ++--- .../unpublishing-a-github-pages-site.md | 6 +-- .../using-submodules-with-github-pages.md | 2 +- translations/zh-CN/content/pages/index.md | 2 +- .../zh-CN/content/pages/quickstart.md | 16 +++--- .../about-github-pages-and-jekyll.md | 28 +++++----- ...yll-build-errors-for-github-pages-sites.md | 26 +++++----- ...-to-your-github-pages-site-using-jekyll.md | 4 +- ...-to-your-github-pages-site-using-jekyll.md | 18 +++---- ...reating-a-github-pages-site-with-jekyll.md | 12 ++--- ...for-your-github-pages-site-using-jekyll.md | 2 +- ...r-github-pages-site-locally-with-jekyll.md | 4 +- ...yll-build-errors-for-github-pages-sites.md | 52 +++++++++---------- translations/zh-CN/data/glossaries/README.md | 4 +- .../zh-CN/data/learning-tracks/README.md | 12 ++--- .../zh-CN/data/product-examples/README.md | 6 +-- 34 files changed, 239 insertions(+), 239 deletions(-) diff --git a/translations/zh-CN/content/packages/index.md b/translations/zh-CN/content/packages/index.md index cb3aed05edf6..bcd9db09d4e1 100644 --- a/translations/zh-CN/content/packages/index.md +++ b/translations/zh-CN/content/packages/index.md @@ -1,7 +1,7 @@ --- title: GitHub 包文档 shortTitle: GitHub Packages -intro: '了解如何安全地发布和使用包，将包与代码存储在一起，以及与您的团队私下分享或与开源社区公开分享您的包。 还可以使用 {% data variables.product.prodname_actions %} 自动执行您的包。' +intro: '了解如何安全地发布和使用包，将包与代码存储在一起，以及与您的团队私下分享或与开源社区公开分享您的包。还可以使用 {% data variables.product.prodname_actions %} 自动执行您的包。' introLinks: quickstart: /packages/quickstart reference: /packages/manage-packages diff --git a/translations/zh-CN/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md b/translations/zh-CN/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md index 0549b49958d1..fc2e69c881c7 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md +++ b/translations/zh-CN/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md @@ -47,7 +47,7 @@ ms.locfileid: '147882333' ``` 有关详细信息，请参阅 Docker 官方文档中的“[标签](https://docs.docker.com/engine/reference/builder/#label)”和 `opencontainers/image-spec` 存储库中的“[预定义的注释键](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)”。 -2. 构建容器映像。 此示例从当前目录中的 Dockerfile 生成映像，并分配映像名称 `hello_docker`。 +2. 构建容器映像。此示例从当前目录中的 Dockerfile 生成映像，并分配映像名称 `hello_docker`。 ```shell $ docker build -t hello_docker . @@ -70,7 +70,7 @@ ms.locfileid: '147882333' $ docker tag 38f737a91f39 {% data reusables.package_registry.container-registry-example-hostname %}/monalisa/hello_docker:latest ``` -5. 如果尚未向 {% data variables.product.prodname_container_registry %} 验证，请验证。 有关详细信息，请参阅“[对 {% data variables.product.prodname_container_registry %} 进行身份验证](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-the-container-registry)”。 +5. 如果尚未向 {% data variables.product.prodname_container_registry %} 验证，请验证。有关详细信息，请参阅“[对 {% data variables.product.prodname_container_registry %} 进行身份验证](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-the-container-registry)”。 {% raw %} ```shell $ echo $CR_PAT | docker login {% endraw %}{% data reusables.package_registry.container-registry-hostname %}{% raw %} -u USERNAME --password-stdin diff --git a/translations/zh-CN/content/packages/learn-github-packages/installing-a-package.md b/translations/zh-CN/content/packages/learn-github-packages/installing-a-package.md index da305e87ef90..1e71eb9e4882 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/installing-a-package.md +++ b/translations/zh-CN/content/packages/learn-github-packages/installing-a-package.md @@ -23,7 +23,7 @@ ms.locfileid: '145130322' ## 关于包的安装 -您可以在 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上搜索，以查找 {% data variables.product.prodname_registry %} 中可以在自己项目中安装的包。 有关详细信息，请参阅“[在 {% data variables.product.prodname_registry %} 中搜索包](/search-github/searching-on-github/searching-for-packages)”。 +您可以在 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上搜索，以查找 {% data variables.product.prodname_registry %} 中可以在自己项目中安装的包。有关详细信息，请参阅“[在 {% data variables.product.prodname_registry %} 中搜索包](/search-github/searching-on-github/searching-for-packages)”。 找到包后，您可以在包页面上阅读包的说明以及安装和使用说明。 @@ -31,7 +31,7 @@ ms.locfileid: '145130322' 你可以按照相同的一般准则，使用任何为实例启用的{% ifversion fpt or ghae or ghec %}支持的包客户端{% else %}包类型{% endif %}从 {% data variables.product.prodname_registry %} 安装包。 -1. 按照包客户端的说明，向 {% data variables.product.prodname_registry %} 验证。 有关详细信息，请参阅“[对 GitHub 包进行身份验证](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)”。 +1. 按照包客户端的说明，向 {% data variables.product.prodname_registry %} 验证。有关详细信息，请参阅“[对 GitHub 包进行身份验证](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)”。 2. 按照包客户端的说明安装包。 有关特定于包客户端的说明，请参阅“[使用 {% data variables.product.prodname_registry %} 注册表](/packages/working-with-a-github-packages-registry)”。 diff --git a/translations/zh-CN/content/packages/learn-github-packages/publishing-a-package.md b/translations/zh-CN/content/packages/learn-github-packages/publishing-a-package.md index 0c5ff90454e3..6c1428ebf393 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/publishing-a-package.md +++ b/translations/zh-CN/content/packages/learn-github-packages/publishing-a-package.md @@ -22,21 +22,21 @@ ms.locfileid: '145130320' ## 关于发布的包 -您可以在包页面上提供说明和其他详细信息，例如安装和使用说明，以帮助他人了解和使用您的包。 {% data variables.product.product_name %} 提供每个版本的元数据，例如发布日期、下载活动和最新版本。 有关示例包页面，请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。 +您可以在包页面上提供说明和其他详细信息，例如安装和使用说明，以帮助他人了解和使用您的包。 {% data variables.product.product_name %} 提供每个版本的元数据，例如发布日期、下载活动和最新版本。有关示例包页面，请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。 -{% data reusables.package_registry.public-or-private-packages %} 一个仓库可连接到多个包。 为避免混淆，请确保使用自述文件和说明清楚地阐明每个包的相关信息。 +{% data reusables.package_registry.public-or-private-packages %} 一个仓库可连接到多个包。为避免混淆，请确保使用自述文件和说明清楚地阐明每个包的相关信息。 -{% ifversion fpt or ghec %} 如果包的新版本修复了安全漏洞，则应在存储库中发布安全公告。 {% data variables.product.prodname_dotcom %} 审查每个发布的安全通告，并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_alerts %}。 有关详细信息，请参阅“[关于 GitHub 安全公告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 +{% ifversion fpt or ghec %} 如果包的新版本修复了安全漏洞，则应在存储库中发布安全公告。 {% data variables.product.prodname_dotcom %} 审查每个发布的安全通告，并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_alerts %}。有关详细信息，请参阅“[关于 GitHub 安全公告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 {% endif %} ## 发布包 您可以按照一般准则，使用任何{% ifversion fpt or ghae or ghec %}支持的包客户端{% else %}为您的实例启用的包类型{% endif %}将包发布到 {% data variables.product.prodname_registry %}。 -1. 针对要完成的任务，创建具有适当作用域的访问令牌或使用现有的此类令牌。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_registry %} 的权限](/packages/learn-github-packages/about-permissions-for-github-packages)”。 +1. 针对要完成的任务，创建具有适当作用域的访问令牌或使用现有的此类令牌。有关详细信息，请参阅“[关于 {% data variables.product.prodname_registry %} 的权限](/packages/learn-github-packages/about-permissions-for-github-packages)”。 2. 按照包客户端的说明，使用访问令牌向 {% data variables.product.prodname_registry %} 验证。 3. 按照包客户端的说明发布包。 有关包客户端的特定说明，请参阅“[使用 GitHub Packages 注册表](/packages/working-with-a-github-packages-registry)”。 -在发布包后，您可以在 {% data variables.product.prodname_dotcom %} 上查看该包。 有关详细信息，请参阅“[查看包](/packages/learn-github-packages/viewing-packages)”。 +在发布包后，您可以在 {% data variables.product.prodname_dotcom %} 上查看该包。有关详细信息，请参阅“[查看包](/packages/learn-github-packages/viewing-packages)”。 diff --git a/translations/zh-CN/content/packages/quickstart.md b/translations/zh-CN/content/packages/quickstart.md index 58abe0642b84..405fc5cedf5b 100644 --- a/translations/zh-CN/content/packages/quickstart.md +++ b/translations/zh-CN/content/packages/quickstart.md @@ -23,7 +23,7 @@ ms.locfileid: '147876154' ## 发布包 -1. 在 {% data variables.product.prodname_dotcom %} 上创建新存储库，为节点添加 `.gitignore`。 有关详细信息，请参阅“[创建新存储库](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)”。 +1. 在 {% data variables.product.prodname_dotcom %} 上创建新存储库，为节点添加 `.gitignore`。有关详细信息，请参阅“[创建新存储库](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)”。 2. 将存储库克隆到本地计算机。 ```shell $ git clone https://{% ifversion ghes or ghae %}YOUR-HOSTNAME{% else %}github.com{% endif %}/YOUR-USERNAME/YOUR-REPOSITORY.git @@ -35,7 +35,7 @@ ms.locfileid: '147876154' console.log("Hello, World!"); ``` {% endraw %} -4. 使用 `npm init` 初始化 npm 包。 在包初始化向导中，输入名称为 _`@YOUR-USERNAME/YOUR-REPOSITORY`_ 的包，并将测试脚本设置为 `exit 0`。 这将生成一个 `package.json` 文件，其中包含有关包的信息。 +4. 使用 `npm init` 初始化 npm 包。在包初始化向导中，输入名称为 _`@YOUR-USERNAME/YOUR-REPOSITORY`_ 的包，并将测试脚本设置为 `exit 0`。这将生成一个 `package.json` 文件，其中包含有关包的信息。 {% raw %} ```shell $ npm init @@ -53,7 +53,7 @@ ms.locfileid: '147876154' $ git commit -m "initialize npm package" $ git push ``` -6. 创建 `.github/workflows` 目录。 在此目录中，创建名为 `release-package.yml` 的文件。 +6. 创建 `.github/workflows` 目录。在此目录中，创建名为 `release-package.yml` 的文件。 7. 将以下 YAML 内容复制到 `release-package.yml` 文件{% ifversion ghes or ghae %} 中，将 `YOUR-HOSTNAME` 替换为企业名称{% endif %}。 ```yaml{:copy} name: Node.js Package @@ -111,9 +111,9 @@ ms.locfileid: '147876154' $ git commit -m "workflow to publish package" $ git push ``` -10. 只要您的仓库中创建新版本，您创建的工作流程就会运行。 如果测试通过，则包将发布到 {% data variables.product.prodname_registry %}。 +10. 只要您的仓库中创建新版本，您创建的工作流程就会运行。如果测试通过，则包将发布到 {% data variables.product.prodname_registry %}。 - 要测试这一点，请导航到存储库中的“代码”选项卡，并创建新版本。 有关详细信息，请参阅“[管理存储库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)”。 + 要测试这一点，请导航到存储库中的“代码”选项卡，并创建新版本。有关详细信息，请参阅“[管理存储库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)”。 ## 查看已发布的包 @@ -123,13 +123,13 @@ ms.locfileid: '147876154' ## 安装已发布的包 -现在，您已发布包，您需要使用它作为项目之间的依赖项。 有关详细信息，请参阅“[使用 npm 注册表](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)”。 +现在，您已发布包，您需要使用它作为项目之间的依赖项。有关详细信息，请参阅“[使用 npm 注册表](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)”。 ## 后续步骤 -您刚刚添加的基本工作流程在仓库中创建新版本时运行。 但是，这只是您可以对 {% data variables.product.prodname_registry %} 执行操作的开始。 您可以使用单个工作流和将包发布到多个注册表，触发工作流程以在发生不同事件（如合并拉取请求、管理容器等）时运行。 +您刚刚添加的基本工作流程在仓库中创建新版本时运行。但是，这只是您可以对 {% data variables.product.prodname_registry %} 执行操作的开始。您可以使用单个工作流和将包发布到多个注册表，触发工作流程以在发生不同事件（如合并拉取请求、管理容器等）时运行。 -合并 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 可以帮助您实现应用程序开发过程几乎每个方面的自动化。 准备好开始了吗？ 以下是一些有用的资源，可用于执行 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 的后续步骤： +合并 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 可以帮助您实现应用程序开发过程几乎每个方面的自动化。准备好开始了吗？以下是一些有用的资源，可用于执行 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 的后续步骤： - 有关 GitHub 包的深入教程，请“[了解 {% data variables.product.prodname_registry %}](/packages/learn-github-packages)”。 - 有关 GitHub Actions 的深入教程，请“[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)” diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md index ca2de2dfc817..17c0c36f22a4 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md @@ -30,7 +30,7 @@ ms.locfileid: '147409489' ## 关于从 Docker 注册表迁移 -{% data reusables.package_registry.container-registry-replaces-docker-registry %}如果已将 Docker 映像存储在 Docker 注册表中，则{% ifversion docker-ghcr-enterprise-migration %}企业所有者{% else %}{% data variables.product.company_short %}{% endif %}会逐步将映像迁移到 {% data variables.product.prodname_container_registry %}。 你无需执行任何操作。 +{% data reusables.package_registry.container-registry-replaces-docker-registry %}如果已将 Docker 映像存储在 Docker 注册表中，则{% ifversion docker-ghcr-enterprise-migration %}企业所有者{% else %}{% data variables.product.company_short %}{% endif %}会逐步将映像迁移到 {% data variables.product.prodname_container_registry %}。你无需执行任何操作。 {% ifversion docker-ghcr-enterprise-migration %} @@ -57,7 +57,7 @@ ms.locfileid: '147409489' {% ifversion fpt or ghec %} -迁移后，便无法再使用 GraphQL API 来查询 `PackageType` 为“DOCKER”的包。 可以改为使用 REST API 查询 `package_type` 为“容器”的包。 有关详细信息，请参阅 REST API 文档中的“[包](/rest/reference/packages)”。 +迁移后，便无法再使用 GraphQL API 来查询 `PackageType` 为“DOCKER”的包。可以改为使用 REST API 查询 `package_type` 为“容器”的包。有关详细信息，请参阅 REST API 文档中的“[包](/rest/reference/packages)”。 ## 关于 {% data variables.product.prodname_container_registry %} 的计费 diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md index 85a94d6146a7..3abdad5bc41c 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md @@ -35,11 +35,11 @@ ms.locfileid: '147061704' {% data reusables.package_registry.required-scopes %} -通过编辑 ~/.m2/settings.xml 文件以包含个人访问令牌，可以使用 Apache Maven 向 {% data variables.product.prodname_registry %} 进行身份验证。 如果 ~/.m2/settings.xml 文件不存在，请新建该文件。 +通过编辑 ~/.m2/settings.xml 文件以包含个人访问令牌，可以使用 Apache Maven 向 {% data variables.product.prodname_registry %} 进行身份验证。如果 ~/.m2/settings.xml 文件不存在，请新建该文件。 在 `servers` 标记中，添加一个带有 `id` 的子 `server` 标记，将“USERNAME”替换为 {% data variables.product.prodname_dotcom %} 用户名，并将“TOKEN”替换为个人访问令牌。 -在 `repositories` 标记中，通过将存储库的 `id` 映射到在包含凭据的 `server` 标记中添加的 `id` 来对该存储库进行配置。 将 {% ifversion ghes or ghae %}HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，并将{% endif %} OWNER 替换为拥有该存储库的用户或组织帐户的名称。 由于不支持大写字母，因此，即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母，也必须对仓库所有者使用小写字母。 +在 `repositories` 标记中，通过将存储库的 `id` 映射到在包含凭据的 `server` 标记中添加的 `id` 来对该存储库进行配置。将 {% ifversion ghes or ghae %}HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，并将{% endif %} OWNER 替换为拥有该存储库的用户或组织帐户的名称。由于不支持大写字母，因此，即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母，也必须对仓库所有者使用小写字母。 如果要与多个存储库交互，可以将每个存储库添加到 `repositories` 标记中独立的子 `repository`，将每个存储库的 `id` 映射到 `servers` 标记中的凭据。 @@ -135,7 +135,7 @@ ms.locfileid: '147061704' `com.example:test` 的包发布到名为 `OWNER/test` 的存储库中。 -如果要将多个包发布到同一存储库，可以在 pom.xml 文件的 `` 元素中包含该存储库的 URL。 {% data variables.product.prodname_dotcom %} 将根据该字段匹配仓库。 由于存储库名称也是 `distributionManagement` 元素的一部分，因此将多个包发布到同一存储库无需额外步骤。 +如果要将多个包发布到同一存储库，可以在 pom.xml 文件的 `` 元素中包含该存储库的 URL。 {% data variables.product.prodname_dotcom %} 将根据该字段匹配仓库。由于存储库名称也是 `distributionManagement` 元素的一部分，因此将多个包发布到同一存储库无需额外步骤。 有关创建包的详细信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 @@ -171,7 +171,7 @@ ms.locfileid: '147061704' ## 安装包 -要从 {% data variables.product.prodname_registry %} 安装 Apache Maven 包，请编辑 pom.xml 文件以包含该包作为依赖项。 如果要从多个存储库安装包，请为每个存储库添加 `repository` 标记。 有关在项目中使用 pom.xml 文件的详细信息，请参阅 Apache Maven 文档中的“[POM 简介](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)”。 +要从 {% data variables.product.prodname_registry %} 安装 Apache Maven 包，请编辑 pom.xml 文件以包含该包作为依赖项。如果要从多个存储库安装包，请为每个存储库添加 `repository` 标记。有关在项目中使用 pom.xml 文件的详细信息，请参阅 Apache Maven 文档中的“[POM 简介](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)”。 {% data reusables.package_registry.authenticate-step %} 2. 将包依赖项添加到项目 pom.xml 文件的 `dependencies` 元素，将 `com.example:test` 替换为包。 diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md index 0ea713b72d2e..9cdc024594cc 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md @@ -27,7 +27,7 @@ ms.locfileid: '147888450' {% data variables.product.prodname_dotcom %} 的 Docker 注册表（使用命名空间 `docker.pkg.github.com`）已被 {% data variables.product.prodname_container_registry %} 替换（使用命名空间 `https://ghcr.io`）。 {% data variables.product.prodname_container_registry %} 为 Docker 映像提供粒度权限和存储优化等优点。 -先前存储在 Docker 注册表中的 Docker 映像将自动迁移到 {% data variables.product.prodname_container_registry %}。 有关详细信息，请参阅“[从 Docker 注册表迁移到 {% data variables.product.prodname_container_registry %}](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)”和“[使用 {% data variables.product.prodname_container_registry %}](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)。” +先前存储在 Docker 注册表中的 Docker 映像将自动迁移到 {% data variables.product.prodname_container_registry %}。有关详细信息，请参阅“[从 Docker 注册表迁移到 {% data variables.product.prodname_container_registry %}](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)”和“[使用 {% data variables.product.prodname_container_registry %}](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)。” {% else %} @@ -88,7 +88,7 @@ ms.locfileid: '147888450' {% endnote %} -{% data variables.product.prodname_registry %} 支持每个仓库的多个顶层 Docker 镜像。 仓库可以拥有任意数量的映像标记。 在发布或安装大于 10GB 的 Docker 映像（每个图层上限为 5GB）时，可能会遇到服务降级的情况。 有关详细信息，请参阅 Docker 文档中的“[Docker 标记](https://docs.docker.com/engine/reference/commandline/tag/)”。 +{% data variables.product.prodname_registry %} 支持每个仓库的多个顶层 Docker 镜像。仓库可以拥有任意数量的映像标记。在发布或安装大于 10GB 的 Docker 映像（每个图层上限为 5GB）时，可能会遇到服务降级的情况。有关详细信息，请参阅 Docker 文档中的“[Docker 标记](https://docs.docker.com/engine/reference/commandline/tag/)”。 {% data reusables.package_registry.viewing-packages %} @@ -99,7 +99,7 @@ ms.locfileid: '147888450' > REPOSITORY TAG IMAGE ID CREATED SIZE > IMAGE_NAME VERSION IMAGE_ID 4 weeks ago 1.11MB ``` -2. 使用 Docker 映像 ID、标记和 Docker 映像，将 OWNER 替换为拥有存储库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的存储库的名称，将 IMAGE_NAME 替换为包或映像的名称，{% ifversion ghes or ghae %}将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，{% endif %}并将 VERSION 替换为生成时的包版本 。 +2. 使用 Docker 映像 ID、标记和 Docker 映像，将 OWNER 替换为拥有存储库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的存储库的名称，将 IMAGE_NAME 替换为包或映像的名称，{% ifversion ghes or ghae %}将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，{% endif %}并将 VERSION 替换为生成时的包版本。 {% ifversion fpt or ghec %} ```shell $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -211,7 +211,7 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 {% data reusables.package_registry.docker_registry_deprecation_status %} -可以使用 `docker pull` 命令从 {% data variables.product.prodname_registry %} 安装 Docker 映像，将 OWNER 替换为拥有存储库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的存储库的名称，将 IMAGE_NAME 替换为包或映像的名称，{% ifversion ghes or ghae %}将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，{% endif %} 并将 TAG_NAME 替换为要安装的映像的标记 。 +可以使用 `docker pull` 命令从 {% data variables.product.prodname_registry %} 安装 Docker 映像，将 OWNER 替换为拥有存储库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的存储库的名称，将 IMAGE_NAME 替换为包或映像的名称，{% ifversion ghes or ghae %}将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名，{% endif %} 并将 TAG_NAME 替换为要安装的映像的标记。 {% ifversion fpt or ghec %} ```shell diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md index 3cbe4eab4f39..88808fb62204 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md @@ -35,13 +35,13 @@ ms.locfileid: '147061657' {% data reusables.package_registry.required-scopes %} -你可以使用 Gradle Groovy 或 Kotlin DSL 通过 Gradle 向 {% data variables.product.prodname_registry %} 进行验证，方法是编辑你的 build.gradle 文件 (Gradle Groovy) 或 build.gradle.kts 文件 (Kotlin DSL)，将你的个人访问令牌包含在其中 。 您还可以配置 Gradle Groovy 和 Kotlin DSL 以识别仓库中的一个或多个包。 +你可以使用 Gradle Groovy 或 Kotlin DSL 通过 Gradle 向 {% data variables.product.prodname_registry %} 进行验证，方法是编辑你的 build.gradle 文件 (Gradle Groovy) 或 build.gradle.kts 文件 (Kotlin DSL)，将你的个人访问令牌包含在其中。您还可以配置 Gradle Groovy 和 Kotlin DSL 以识别仓库中的一个或多个包。 -{% ifversion ghes %} 将 REGISTRY-URL 替换为你实例的 Maven 注册表的 URL。 如果你的实例启用了子域隔离功能，请使用 `maven.HOSTNAME`。 如果你的实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/maven`。 在任一情况下，都将 HOSTNAME 替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。 -{% elsif ghae %} 将 REGISTRY-URL 替换为企业 Maven 注册表 `maven.HOSTNAME` 的 URL。 将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。 +{% ifversion ghes %} 将 REGISTRY-URL 替换为你实例的 Maven 注册表的 URL。如果你的实例启用了子域隔离功能，请使用 `maven.HOSTNAME`。如果你的实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/maven`。在任一情况下，都将 HOSTNAME 替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。 +{% elsif ghae %} 将 REGISTRY-URL 替换为企业 Maven 注册表 `maven.HOSTNAME` 的 URL。将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。 {% endif %} -将 USERNAME 替换为你的 {% data variables.product.prodname_dotcom %} 用户名，将 TOKEN 替换为你的个人访问令牌，将 REPOSITORY 替换为包含要发布的包的存储库的名称，将 OWNER 替换为 {% data variables.product.prodname_dotcom %} 上拥有该存储库的用户或组织帐户的名称 。 由于不支持大写字母，因此，即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母，也必须对仓库所有者使用小写字母。 +将 USERNAME 替换为你的 {% data variables.product.prodname_dotcom %} 用户名，将 TOKEN 替换为你的个人访问令牌，将 REPOSITORY 替换为包含要发布的包的存储库的名称，将 OWNER 替换为 {% data variables.product.prodname_dotcom %} 上拥有该存储库的用户或组织帐户的名称。由于不支持大写字母，因此，即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母，也必须对仓库所有者使用小写字母。 {% note %} @@ -170,7 +170,7 @@ subprojects { ## 使用已发布的包 -要使用 {% data variables.product.prodname_registry %} 发布的软件包，请将包添加为依赖项，并将仓库添加到项目。 有关详细信息，请参阅 Gradle 文档中的“[声明依赖项](https://docs.gradle.org/current/userguide/declaring_dependencies.html)”。 +要使用 {% data variables.product.prodname_registry %} 发布的软件包，请将包添加为依赖项，并将仓库添加到项目。有关详细信息，请参阅 Gradle 文档中的“[声明依赖项](https://docs.gradle.org/current/userguide/declaring_dependencies.html)”。 {% data reusables.package_registry.authenticate-step %} 2. 将包依赖项添加到你的 build.gradle 文件 (Gradle Groovy) 或 build.gradle.kts 文件 (Kotlin DSL) 。 diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md index 074da2f85ce4..7003d6f91d91 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md @@ -115,14 +115,14 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB ### 使用 nuget.config 文件发布包 -发布时，需要将 csproj 文件中的 `OWNER` 值用于 nuget.config 身份验证文件 。 在 .csproj 文件中指定或递增版本号，然后使用 `dotnet pack` 命令创建该版本的 .nuspec 文件 。 有关创建包的详细信息，请参阅 Microsoft 文档中的“[创建和发布包](https://docs.microsoft.com/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)”。 +发布时，需要将 csproj 文件中的 `OWNER` 值用于 nuget.config 身份验证文件。在 .csproj 文件中指定或递增版本号，然后使用 `dotnet pack` 命令创建该版本的 .nuspec 文件。有关创建包的详细信息，请参阅 Microsoft 文档中的“[创建和发布包](https://docs.microsoft.com/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)”。 {% data reusables.package_registry.authenticate-step %} 2. 创建新项目。 ```shell dotnet new console --name OctocatApp ``` -3. 将项目的特定信息添加到以 .csproj 结尾的项目文件中。 必须： +3. 将项目的特定信息添加到以 .csproj 结尾的项目文件中。必须： - 将 `OWNER` 替换为拥有项目所在存储库的用户或组织帐户的名称。 - 将 `REPOSITORY` 替换为要发布的包所在存储库的名称。 - 将 `1.0.0` 替换为包的版本号。{% ifversion ghes or ghae %} @@ -159,7 +159,7 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB 要将多个包发布到同一个存储库，可以在所有 .csproj 项目文件的 `RepositoryURL` 字段中包含相同的 {% data variables.product.prodname_dotcom %} 存储库 URL。 {% data variables.product.prodname_dotcom %} 根据该字段匹配仓库。 -例如，OctodogApp 和 OctocatApp 项目将发布到同一个存储库 ： +例如，OctodogApp 和 OctocatApp 项目将发布到同一个存储库： ``` xml @@ -197,11 +197,11 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB ## 安装包 -在项目中使用来自 {% data variables.product.prodname_dotcom %} 的包类似于使用来自 nuget.org 的包。将包依赖项添加到 .csproj 文件，并指定包名称和版本 。 有关在项目中使用 .csproj 文件的详细信息，请参阅 Microsoft 文档中的“[使用 NuGet 包](https://docs.microsoft.com/nuget/consume-packages/overview-and-workflow)”。 +在项目中使用来自 {% data variables.product.prodname_dotcom %} 的包类似于使用来自 nuget.org 的包。将包依赖项添加到 .csproj 文件，并指定包名称和版本。有关在项目中使用 .csproj 文件的详细信息，请参阅 Microsoft 文档中的“[使用 NuGet 包](https://docs.microsoft.com/nuget/consume-packages/overview-and-workflow)”。 {% data reusables.package_registry.authenticate-step %} -2. 要使用包，请在 .csproj 项目文件中添加 `ItemGroup` 并配置 `PackageReference` 字段。 将 `Include="OctokittenApp"` 中的 `OctokittenApp` 值替换为包依赖项，并将 `Version="12.0.2"` 中的 `12.0.2` 值替换为要使用的版本： +2. 要使用包，请在 .csproj 项目文件中添加 `ItemGroup` 并配置 `PackageReference` 字段。将 `Include="OctokittenApp"` 中的 `OctokittenApp` 值替换为包依赖项，并将 `Version="12.0.2"` 中的 `12.0.2` 值替换为要使用的版本： ``` xml @@ -234,7 +234,7 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB 如果使用的是 nuspec 文件，请确保它具有包含必要的 `type` 和 `url` 属性的 `repository` 元素。 -如果使用 `GITHUB_TOKEN` 对 {% data variables.product.prodname_actions %} 工作流内的 {% data variables.product.prodname_registry %} 注册表进行身份验证，则令牌无法在工作流运行范围以外的其他存储库中访问基于专用存储库的包。 若要访问与其他存储库关联的包，请改为生成具有 `read:packages` 范围的 PAT，并将此令牌作为机密传入。 +如果使用 `GITHUB_TOKEN` 对 {% data variables.product.prodname_actions %} 工作流内的 {% data variables.product.prodname_registry %} 注册表进行身份验证，则令牌无法在工作流运行范围以外的其他存储库中访问基于专用存储库的包。若要访问与其他存储库关联的包，请改为生成具有 `read:packages` 范围的 PAT，并将此令牌作为机密传入。 ## 延伸阅读 diff --git a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md index 101689060dc8..9c55749974a4 100644 --- a/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md +++ b/translations/zh-CN/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md @@ -27,20 +27,20 @@ ms.locfileid: '147882325' ## 先决条件 -- 您必须具有 RubyGems 2.4.1 或更高版本。 要查找您的 RubyGems 版本： +- 您必须具有 RubyGems 2.4.1 或更高版本。要查找您的 RubyGems 版本： ```shell $ gem --version ``` -- 必须拥有 bundler 1.6.4 或更高版本。 要查找您的 Bundler 版本： +- 必须拥有 bundler 1.6.4 或更高版本。要查找您的 Bundler 版本： ```shell $ bundle --version Bundler version 1.13.7 ``` -- 安装 keycutter 以管理多个凭据。 要安装 keycutter： +- 安装 keycutter 以管理多个凭据。要安装 keycutter： ```shell $ gem install keycutter @@ -56,27 +56,27 @@ ms.locfileid: '147882325' {% data reusables.package_registry.required-scopes %} -通过编辑用于发布 gem 的 ~/.gem/credentials 文件、编辑用于安装单个 gem 的 ~/.gemrc 文件或使用用于跟踪和安装一个或多个 gem 的 Bundler，可使用 RubyGems 向 {% data variables.product.prodname_registry %} 进行身份验证 。 +通过编辑用于发布 gem 的 ~/.gem/credentials 文件、编辑用于安装单个 gem 的 ~/.gemrc 文件或使用用于跟踪和安装一个或多个 gem 的 Bundler，可使用 RubyGems 向 {% data variables.product.prodname_registry %} 进行身份验证。 -要发布新的 gem，需要通过编辑 ~/.gem/credentials 文件以包含你的个人访问令牌，使用 RubyGems 向 {% data variables.product.prodname_registry %} 进行身份验证。 如果此文件不存在，请创建新的 ~/.gem/credentials 文件。 +要发布新的 gem，需要通过编辑 ~/.gem/credentials 文件以包含你的个人访问令牌，使用 RubyGems 向 {% data variables.product.prodname_registry %} 进行身份验证。如果此文件不存在，请创建新的 ~/.gem/credentials 文件。 -例如，创建或编辑 ~/.gem/credentials 以包含以下内容，将“令牌”替换为个人访问令牌 。 +例如，创建或编辑 ~/.gem/credentials 以包含以下内容，将“令牌”替换为个人访问令牌。 ```shell --- :github: Bearer TOKEN ``` -要安装 gem，需要通过编辑项目的 ~/.gemrc 文件以包含 `https://USERNAME:TOKEN@{% ifversion fpt or ghec %}rubygems.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/`，来对 {% data variables.product.prodname_registry %} 进行身份验证。 必须： +要安装 gem，需要通过编辑项目的 ~/.gemrc 文件以包含 `https://USERNAME:TOKEN@{% ifversion fpt or ghec %}rubygems.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/`，来对 {% data variables.product.prodname_registry %} 进行身份验证。必须： - 将 `USERNAME` 替换为 {% data variables.product.prodname_dotcom %} 用户名。 - 将 `TOKEN` 替换为个人访问令牌。 - 将 `OWNER` 替换为拥有项目所在存储库的用户或组织帐户的名称。{% ifversion ghes %} - - 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL。 如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。 如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。 在任一情况下，都将 HOSTNAME 替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。 + - 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL。如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。在任一情况下，都将 HOSTNAME 替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。 {% elsif ghae %} - - 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。 将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。 + - 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。 {% endif %} -如果没有 ~/.gemrc 文件，请使用此示例创建新的 ~/.gemrc 文件 。 +如果没有 ~/.gemrc 文件，请使用此示例创建新的 ~/.gemrc 文件。 ```shell --- @@ -90,7 +90,7 @@ ms.locfileid: '147882325' ``` -若要使用 Bundler 进行身份验证，请将 Bundler 配置为使用个人访问令牌，将“用户名”替换为 {% data variables.product.prodname_dotcom %} 用户名，将“令牌”替换为个人访问令牌，并将“所有者”替换为拥有包含项目的存储库的用户或组织帐户的名称。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 RubyGems 注册表的 URL 。 如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。 如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。 在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %}将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。 将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} +若要使用 Bundler 进行身份验证，请将 Bundler 配置为使用个人访问令牌，将“用户名”替换为 {% data variables.product.prodname_dotcom %} 用户名，将“令牌”替换为个人访问令牌，并将“所有者”替换为拥有包含项目的存储库的用户或组织帐户的名称。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 RubyGems 注册表的 URL。如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %}将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} ```shell $ bundle config https://{% ifversion fpt or ghec %}rubygems.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER USERNAME:TOKEN @@ -98,16 +98,16 @@ $ bundle config https://{% ifversion fpt or ghec %}rubygems.pkg.github.com{% els ## 发布包 -{% data reusables.package_registry.default-name %} 例如，将 `octo-gem` 发布到 `octo-org` 组织时，{% data variables.product.prodname_registry %} 会将 gem 发布到 `octo-org/octo-gem` 存储库。 有关创建 gem 的详细信息，请参阅 RubyGems 文档中的“[创建自己的 gem](http://guides.rubygems.org/make-your-own-gem/)”。 +{% data reusables.package_registry.default-name %} 例如，将 `octo-gem` 发布到 `octo-org` 组织时，{% data variables.product.prodname_registry %} 会将 gem 发布到 `octo-org/octo-gem` 存储库。有关创建 gem 的详细信息，请参阅 RubyGems 文档中的“[创建自己的 gem](http://guides.rubygems.org/make-your-own-gem/)”。 {% data reusables.package_registry.viewing-packages %} {% data reusables.package_registry.authenticate-step %} -2. 从 gemspec 生成包以创建 .gem 包 。 +2. 从 gemspec 生成包以创建 .gem 包。 ```shell gem build OCTO-GEM.gemspec ``` -3. 将包发布到 {% data variables.product.prodname_registry %}，将 `OWNER` 替换为拥有包含项目的存储库的用户或组织帐户的名称，并将 `OCTO-GEM` 替换为 gem 包的名称。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL。 如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。 如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。 在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。 将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} +3. 将包发布到 {% data variables.product.prodname_registry %}，将 `OWNER` 替换为拥有包含项目的存储库的用户或组织帐户的名称，并将 `OCTO-GEM` 替换为 gem 包的名称。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL。如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} ```shell $ gem push --key github \ @@ -117,7 +117,7 @@ $ bundle config https://{% ifversion fpt or ghec %}rubygems.pkg.github.com{% els ## 将多个包发布到同一个仓库 -要将多个 gem 发布到同一存储库，可在 `gem.metadata` 的 `github_repo` 字段中包含指向 {% data variables.product.prodname_dotcom %} 存储库的 URL。 如果包含此字段，则 {% data variables.product.prodname_dotcom %} 将基于此值匹配存储库，而不是使用 gem 名称。{% ifversion ghes or ghae %} 将“主机名”替换为 {% data variables.product.product_location %} 的主机名。{% endif %} +要将多个 gem 发布到同一存储库，可在 `gem.metadata` 的 `github_repo` 字段中包含指向 {% data variables.product.prodname_dotcom %} 存储库的 URL。如果包含此字段，则 {% data variables.product.prodname_dotcom %} 将基于此值匹配存储库，而不是使用 gem 名称。{% ifversion ghes or ghae %} 将“主机名”替换为 {% data variables.product.product_location %} 的主机名。{% endif %} ```ruby gem.metadata = { "github_repo" => "ssh://{% ifversion fpt or ghec %}github.com{% else %}HOSTNAME{% endif %}/OWNER/REPOSITORY" } @@ -125,10 +125,10 @@ gem.metadata = { "github_repo" => "ssh://{% ifversion fpt or ghec %}github.com{% ## 安装包 -可使用来自 {% data variables.product.prodname_registry %} 的 gem，就像使用来自 rubygems.org 的 gem 一样。需要通过在 ~/.gemrc 文件中将 {% data variables.product.prodname_dotcom %} 用户或组织添加为源，或者通过使用 Bundler 并编辑 Gemfile，对 {% data variables.product.prodname_registry %} 进行身份验证 。 +可使用来自 {% data variables.product.prodname_registry %} 的 gem，就像使用来自 rubygems.org 的 gem 一样。需要通过在 ~/.gemrc 文件中将 {% data variables.product.prodname_dotcom %} 用户或组织添加为源，或者通过使用 Bundler 并编辑 Gemfile，对 {% data variables.product.prodname_registry %} 进行身份验证。 {% data reusables.package_registry.authenticate-step %} -1. 对于 Bundler，请将 {% data variables.product.prodname_dotcom %} 用户或组织添加为 Gemfile 中的源，以便从这个新源获取 gem。 例如，可以将一个新的 `source` 块添加到 Gemfile，其仅对指定的包使用 {% data variables.product.prodname_registry %}，将 GEM NAME 替换为要从 {% data variables.product.prodname_registry %} 安装的包，并将“所有者”替换为拥有包含要安装的 gem 的存储库的用户或组织。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL 。 如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。 如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。 在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。 将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} +1. 对于 Bundler，请将 {% data variables.product.prodname_dotcom %} 用户或组织添加为 Gemfile 中的源，以便从这个新源获取 gem。例如，可以将一个新的 `source` 块添加到 Gemfile，其仅对指定的包使用 {% data variables.product.prodname_registry %}，将 GEM NAME 替换为要从 {% data variables.product.prodname_registry %} 安装的包，并将“所有者”替换为拥有包含要安装的 gem 的存储库的用户或组织。{% ifversion ghes %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表的 URL。如果实例启用了子域隔离功能，请使用 `rubygems.HOSTNAME`。如果实例禁用了子域隔离功能，请使用 `HOSTNAME/_registry/rubygems`。在任一情况下，请将“主机名”替换为 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% elsif ghae %} 将 `REGISTRY-URL` 替换为实例的 Rubygems 注册表 `rubygems.HOSTNAME` 的 URL。将 HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名。{% endif %} ```ruby source "https://rubygems.org" @@ -140,7 +140,7 @@ gem.metadata = { "github_repo" => "ssh://{% ifversion fpt or ghec %}github.com{% end ``` -3. 对于低于 1.7.0 的 Bundler 版本，需要添加新的全局 `source`。 有关使用 Bundler 的详细信息，请参阅 [bundler.io 文档](https://bundler.io/gemfile.html)。 +3. 对于低于 1.7.0 的 Bundler 版本，需要添加新的全局 `source`。有关使用 Bundler 的详细信息，请参阅 [bundler.io 文档](https://bundler.io/gemfile.html)。 ```ruby source "https://{% ifversion fpt or ghec %}rubygems.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER" diff --git a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md index 5e77f1bfa3a8..de92e022585e 100644 --- a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md +++ b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md @@ -23,7 +23,7 @@ ms.locfileid: '145130285' --- ## 支持的自定义域 -{% data variables.product.prodname_pages %} 可使用两种类型的域名：子域名和 apex 域名。 有关不支持的自定义域列表，请参阅“[自定义域和 {% data variables.product.prodname_pages %} 故障排除](/articles/troubleshooting-custom-domains-and-github-pages/#custom-domain-names-that-are-unsupported)”。 +{% data variables.product.prodname_pages %} 可使用两种类型的域名：子域名和 apex 域名。有关不支持的自定义域列表，请参阅“[自定义域和 {% data variables.product.prodname_pages %} 故障排除](/articles/troubleshooting-custom-domains-and-github-pages/#custom-domain-names-that-are-unsupported)”。 | 支持的自定义域类型 | 示例 | |---|---| @@ -31,33 +31,33 @@ ms.locfileid: '145130285' | 自定义子域 | `blog.example.com` | | Apex 域 | `example.com` | -可以为站点设置顶点和/或 `www` 子域配置。 有关 apex 域的详细信息，请参阅“[对 {% data variables.product.prodname_pages %} 站点使用顶点域](#using-an-apex-domain-for-your-github-pages-site)”。 +可以为站点设置顶点和/或 `www` 子域配置。有关 apex 域的详细信息，请参阅“[对 {% data variables.product.prodname_pages %} 站点使用顶点域](#using-an-apex-domain-for-your-github-pages-site)”。 -建议始终使用 `www` 子域，即使同时使用顶点域也是如此。 当你使用顶点域创建新网站时，我们会自动尝试保护 `www` 子域，以便在提供你的站点内容时使用，但你需要进行 DNS 更改才能使用 `www` 子域。 如果你配置 `www` 子域，我们会自动尝试保护相关的顶点域。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 +建议始终使用 `www` 子域，即使同时使用顶点域也是如此。当你使用顶点域创建新网站时，我们会自动尝试保护 `www` 子域，以便在提供你的站点内容时使用，但你需要进行 DNS 更改才能使用 `www` 子域。如果你配置 `www` 子域，我们会自动尝试保护相关的顶点域。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 -在配置用户或组织站点的自定义域后，自定义域将替换未配置自定义域的帐户所拥有的任何项目站点 URL 的 `.github.io` 或 `.github.io` 部分。 例如，如果你的用户站点的自定义域为 `www.octocat.com`，并且你拥有一个未配置自定义域且从名为 `octo-project` 的存储库发布的项目站点，则该存储库的 {% data variables.product.prodname_pages %} 站点将在 `www.octocat.com/octo-project` 上提供。 +在配置用户或组织站点的自定义域后，自定义域将替换未配置自定义域的帐户所拥有的任何项目站点 URL 的 `.github.io` 或 `.github.io` 部分。例如，如果你的用户站点的自定义域为 `www.octocat.com`，并且你拥有一个未配置自定义域且从名为 `octo-project` 的存储库发布的项目站点，则该存储库的 {% data variables.product.prodname_pages %} 站点将在 `www.octocat.com/octo-project` 上提供。 ## 对您的 {% data variables.product.prodname_pages %} 网站使用子域名 -子域名是根域前 URL 的一部分。 你可以将子域配置为 `www` 或站点的独特部分，如 `blog.example.com`。 +子域名是根域前 URL 的一部分。你可以将子域配置为 `www` 或站点的独特部分，如 `blog.example.com`。 -DNS 提供商为子域配置 `CNAME` 记录。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”。 +DNS 提供商为子域配置 `CNAME` 记录。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”。 ### `www` 子域 -`www` 子域是最常用的子域类型。 例如，`www.example.com` 包括 `www` 子域。 +`www` 子域是最常用的子域类型。例如，`www.example.com` 包括 `www` 子域。 `www` 子域是最稳定的自定义域类型，因为 `www` 子域不受 {% data variables.product.product_name %} 服务器的 IP 地址变动的影响。 ### 自定义子域 -自定义子域是一种不使用标准 `www` 变体的子域。 自定义子域主要在您需要将网站分为两个不同的部分时使用。 例如，可以创建一个名为 `blog.example.com` 的站点并独立于 `www.example.com` 自定义该部分。 +自定义子域是一种不使用标准 `www` 变体的子域。自定义子域主要在您需要将网站分为两个不同的部分时使用。例如，可以创建一个名为 `blog.example.com` 的站点并独立于 `www.example.com` 自定义该部分。 ## 对您的 {% data variables.product.prodname_pages %} 网站使用 apex 域 -顶点域是不包含子域的自定义域，如 `example.com`。 Apex 域也称为基础域、裸域、根 apex 域或区域 apex 域。 +顶点域是不包含子域的自定义域，如 `example.com`。Apex 域也称为基础域、裸域、根 apex 域或区域 apex 域。 -DNS 提供商为顶点域配置 `A`、`ALIAS` 或 `ANAME` 记录。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site#configuring-an-apex-domain)”。 +DNS 提供商为顶点域配置 `A`、`ALIAS` 或 `ANAME` 记录。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site#configuring-an-apex-domain)”。 {% data reusables.pages.www-and-apex-domain-recommendation %} 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site/#configuring-a-subdomain)”。 @@ -67,8 +67,8 @@ DNS 提供商为顶点域配置 `A`、`ALIAS` 或 `ANAME` 记录。 有关详细 有许多原因会导致您的网站被自动禁用。 -- 如果您从 {% data variables.product.prodname_pro %} 降级到 {% data variables.product.prodname_free_user %}，则目前发布自您的帐户中私有仓库的任何 {% data variables.product.prodname_pages %} 站点都会取消发布。 有关详细信息，请参阅“[将 {% data variables.product.prodname_dotcom %} 计费计划降级](/articles/downgrading-your-github-billing-plan)”。 -- 如果将私人仓库转让给使用 {% data variables.product.prodname_free_user %} 的个人帐户，仓库将失去对 {% data variables.product.prodname_pages %} 功能的访问，当前发布的 {% data variables.product.prodname_pages %} 站点将取消发布。 有关详细信息，请参阅“[转让存储库](/articles/transferring-a-repository)”。 +- 如果您从 {% data variables.product.prodname_pro %} 降级到 {% data variables.product.prodname_free_user %}，则目前发布自您的帐户中私有仓库的任何 {% data variables.product.prodname_pages %} 站点都会取消发布。有关详细信息，请参阅“[将 {% data variables.product.prodname_dotcom %} 计费计划降级](/articles/downgrading-your-github-billing-plan)”。 +- 如果将私人仓库转让给使用 {% data variables.product.prodname_free_user %} 的个人帐户，仓库将失去对 {% data variables.product.prodname_pages %} 功能的访问，当前发布的 {% data variables.product.prodname_pages %} 站点将取消发布。有关详细信息，请参阅“[转让存储库](/articles/transferring-a-repository)”。 ## 延伸阅读 diff --git a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md index ce3f3612d991..dee4cd7d5219 100644 --- a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md @@ -29,11 +29,11 @@ ms.locfileid: '147710321' ## 关于自定义域配置 -使用 DNS 提供程序配置自定义域之前，请确保将自定义域添加到您的 {% data variables.product.prodname_pages %} 站点。 使用 DNS 提供程序配置自定义域而不将其添加到 {% data variables.product.product_name %}，可能导致其他人能够在您的某个子域上托管站点。 +使用 DNS 提供程序配置自定义域之前，请确保将自定义域添加到您的 {% data variables.product.prodname_pages %} 站点。使用 DNS 提供程序配置自定义域而不将其添加到 {% data variables.product.product_name %}，可能导致其他人能够在您的某个子域上托管站点。 {% windows %} -`dig` 命令可用于验证 DNS 记录的配置是否正确，它未包含在 Windows 中。 必须安装 [BIND](https://www.isc.org/bind/) 才能验证 DNS 记录是否配置正确。 +`dig` 命令可用于验证 DNS 记录的配置是否正确，它未包含在 Windows 中。必须安装 [BIND](https://www.isc.org/bind/) 才能验证 DNS 记录是否配置正确。 {% endwindows %} @@ -45,12 +45,12 @@ ms.locfileid: '147710321' ## 配置子域 -要设置 `www` 或自定义子域（例如 `www.example.com` 或 `blog.example.com`），必须在存储库设置中添加你的域。 然后，通过 DNS 提供商配置 CNAME 记录。 +要设置 `www` 或自定义子域（例如 `www.example.com` 或 `blog.example.com`），必须在存储库设置中添加你的域。然后，通过 DNS 提供商配置 CNAME 记录。 {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} -4. 在“自定义域”下，键入自定义域，然后单击“保存”。 如果从分支发布站点，将会创建一个提交，将 `CNAME` 文件添加到源分支的根目录。 如果使用自定义 {% data variables.product.prodname_actions %} 工作流发布站点，则不会创建 `CNAME` 文件。 有关发布源的详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 +4. 在“自定义域”下，键入自定义域，然后单击“保存”。如果从分支发布站点，将会创建一个提交，将 `CNAME` 文件添加到源分支的根目录。如果使用自定义 {% data variables.product.prodname_actions %} 工作流发布站点，则不会创建 `CNAME` 文件。有关发布源的详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 ![“保存自定义域”按钮](/assets/images/help/pages/save-custom-subdomain.png) -5. 导航到 DNS 提供程序并创建 `CNAME` 记录，使子域指向站点的默认域。 例如，如果要使用子域 `www.example.com` 作为你的用户站点，请创建将 `www.example.com` 指向 `.github.io` 的 `CNAME` 记录。 如果要使用子域 `another.example.com` 作为你的组织站点，请创建将 `another.example.com` 指向 `.github.io` 的 `CNAME` 记录。 `CNAME` 记录应始终指向 `.github.io` 或 `.github.io`，排除存储库名称。 {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %} +5. 导航到 DNS 提供程序并创建 `CNAME` 记录，使子域指向站点的默认域。例如，如果要使用子域 `www.example.com` 作为你的用户站点，请创建将 `www.example.com` 指向 `.github.io` 的 `CNAME` 记录。如果要使用子域 `another.example.com` 作为你的组织站点，请创建将 `another.example.com` 指向 `.github.io` 的 `CNAME` 记录。 `CNAME` 记录应始终指向 `.github.io` 或 `.github.io`，排除存储库名称。 {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %} {% indented_data_reference reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. 要确认 DNS 记录配置正确，请使用 `dig` 命令，将 WWW.EXAMPLE.COM 替换为子域。 @@ -70,9 +70,9 @@ ms.locfileid: '147710321' {% data reusables.pages.www-and-apex-domain-recommendation %} 有关详细信息，请参阅“[配置子域](#configuring-a-subdomain)”。 {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} -4. 在“自定义域”下，键入自定义域，然后单击“保存”。 如果从分支发布站点，将会创建一个提交，将 `CNAME` 文件添加到源分支的根目录。 如果使用自定义 {% data variables.product.prodname_actions %} 工作流发布站点，则不会创建 `CNAME` 文件。 有关发布源的详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 +4. 在“自定义域”下，键入自定义域，然后单击“保存”。如果从分支发布站点，将会创建一个提交，将 `CNAME` 文件添加到源分支的根目录。如果使用自定义 {% data variables.product.prodname_actions %} 工作流发布站点，则不会创建 `CNAME` 文件。有关发布源的详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 ![“保存自定义域”按钮](/assets/images/help/pages/save-custom-apex-domain.png) -5. 导航到 DNS 提供程序并创建一条 `ALIAS`、`ANAME` 或 `A` 记录。 还可以为 IPv6 支持创建 `AAAA` 记录。 {% data reusables.pages.contact-dns-provider %} +5. 导航到 DNS 提供程序并创建一条 `ALIAS`、`ANAME` 或 `A` 记录。还可以为 IPv6 支持创建 `AAAA` 记录。 {% data reusables.pages.contact-dns-provider %} - 要创建 `ALIAS` 或 `ANAME` 记录，请将顶点域指向站点的默认域。 {% data reusables.pages.default-domain-information %} - 要创建 `A` 记录，请将顶点域指向 {% data variables.product.prodname_pages %} 的 IP 地址。 ```shell @@ -90,7 +90,7 @@ ms.locfileid: '147710321' ``` {% indented_data_reference reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} -6. 要确认 DNS 记录配置正确，请使用 `dig` 命令，将 EXAMPLE.COM 替换为顶点域。 确认结果与上面 {% data variables.product.prodname_pages %} 的 IP 地址相匹配。 +6. 要确认 DNS 记录配置正确，请使用 `dig` 命令，将 EXAMPLE.COM 替换为顶点域。确认结果与上面 {% data variables.product.prodname_pages %} 的 IP 地址相匹配。 - 适用于 `A` 记录。 ```shell $ dig EXAMPLE.COM +noall +answer -t A @@ -113,11 +113,11 @@ ms.locfileid: '147710321' 使用顶点域时，建议配置 {% data variables.product.prodname_pages %} 站点，以便在顶点域和该域的 `www` 子域变体中托管内容。 -要与顶点域一起设置 `www` 子域，必须先使用 DNS 提供程序创建 `ALIAS`、`ANAME` 或 `A` 记录来配置顶点域。 有关详细信息，请参阅[配置顶点域](#configuring-an-apex-domain)。 +要与顶点域一起设置 `www` 子域，必须先使用 DNS 提供程序创建 `ALIAS`、`ANAME` 或 `A` 记录来配置顶点域。有关详细信息，请参阅[配置顶点域](#configuring-an-apex-domain)。 配置 apex 域后，您必须通过 DNS 提供商配置 CNAME 记录。 -1. 导航到 DNS 提供程序并创建 `CNAME` 记录，使其将 `www.example.com` 指向站点 `.github.io` 或 `.github.io` 的默认域。 不要包括仓库名称。 {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %} +1. 导航到 DNS 提供程序并创建 `CNAME` 记录，使其将 `www.example.com` 指向站点 `.github.io` 或 `.github.io` 的默认域。不要包括仓库名称。 {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %} 2. 要确认 DNS 记录配置正确，请使用 `dig` 命令，将 `www` 替换为子域变体。 ```shell $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd diff --git a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md index 2adc67e74c8f..2858c958d54a 100644 --- a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md @@ -25,16 +25,16 @@ ms.locfileid: '147428386' {% ifversion pages-custom-workflow %}如果从自定义 {% data variables.product.prodname_actions %} 工作流进行发布，则忽略且无需任何 CNAME 文件。{% endif %} -如果从分支进行发布，自定义域存储在发布源根目录下的 CNAME 文件中。 您可以通过仓库设置或手动添加或更新此文件。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 +如果从分支进行发布，自定义域存储在发布源根目录下的 CNAME 文件中。您可以通过仓库设置或手动添加或更新此文件。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 -要让站点呈现在正确的域中，请确保 CNAME 文件仍存在于存储库中。 例如，许多静态站点生成器会强制推送到存储库，这可能会覆盖在配置自定义域时添加到存储库的 CNAME 文件。 如果在本地构建站点并将生成的文件推送到 {% data variables.product.product_name %}，请确保先将添加 CNAME 文件的提交拉取到本地存储库，使该文件包含在构建中。 +要让站点呈现在正确的域中，请确保 CNAME 文件仍存在于存储库中。例如，许多静态站点生成器会强制推送到存储库，这可能会覆盖在配置自定义域时添加到存储库的 CNAME 文件。如果在本地构建站点并将生成的文件推送到 {% data variables.product.product_name %}，请确保先将添加 CNAME 文件的提交拉取到本地存储库，使该文件包含在构建中。 然后，请确保 CNAME 文件的格式正确。 - CNAME 文件名必须全部大写。 -- CNAME 文件只能包含一个域。 要将多个域指向您的站点，必须通过 DNS 提供程序设置重定向。 -- CNAME 文件必须仅包含域名。 例如，`www.example.com`、`blog.example.com` 或 `example.com`。 -- 域名在所有 {% data variables.product.prodname_pages %} 站点中必须是唯一的。 例如，如果另一个存储库的 CNAME 文件包含 `example.com`，则不能在存储库的 CNAME 文件中使用 `example.com` 。 +- CNAME 文件只能包含一个域。要将多个域指向您的站点，必须通过 DNS 提供程序设置重定向。 +- CNAME 文件必须仅包含域名。例如，`www.example.com`、`blog.example.com` 或 `example.com`。 +- 域名在所有 {% data variables.product.prodname_pages %} 站点中必须是唯一的。例如，如果另一个存储库的 CNAME 文件包含 `example.com`，则不能在存储库的 CNAME 文件中使用 `example.com` 。 ## DNS 配置错误 @@ -42,19 +42,19 @@ ms.locfileid: '147428386' 您还可以使用以下方法之一来测试自定义域的 DNS 记录是否正确配置： -- CLI 工具，例如 `dig`。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 +- CLI 工具，例如 `dig`。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 - 在线 DNS 查找工具。 ## 自定义域名不受支持 -如果您的自定义域不受支持，则可能需要将您的域更改为受支持的域。 也可以联系您的 DNS 提供商，看他们是否提供域名转发服务。 +如果您的自定义域不受支持，则可能需要将您的域更改为受支持的域。也可以联系您的 DNS 提供商，看他们是否提供域名转发服务。 确保您的站点没有： -- 使用多个 apex 域。 例如，`example.com` 和 `anotherexample.com`。 -- 使用多个 `www` 子域。 例如，`www.example.com` 和 `www.anotherexample.com`。 -- 同时使用 apex 域和自定义子域。 例如，`example.com` 和 `docs.example.com`。 +- 使用多个 apex 域。例如，`example.com` 和 `anotherexample.com`。 +- 使用多个 `www` 子域。例如，`www.example.com` 和 `www.anotherexample.com`。 +- 同时使用 apex 域和自定义子域。例如，`example.com` 和 `docs.example.com`。 - 一个例外是 `www` 子域。 如果配置正确， `www` 子域将自动重定向到 apex 域。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site#configuring-an-apex-domain)”。 + 一个例外是 `www` 子域。如果配置正确， `www` 子域将自动重定向到 apex 域。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site#configuring-an-apex-domain)”。 {% data reusables.pages.wildcard-dns-warning %} @@ -62,16 +62,16 @@ ms.locfileid: '147428386' ## HTTPS 错误 -可以通过 HTTPS 访问使用正确配置了 `CNAME`、`ALIAS`、`ANAME` 或 `A` DNS 记录的自定义域的 {% data variables.product.prodname_pages %} 站点。 有关详细信息，请参阅“[使用 HTTPS 保护 {% data variables.product.prodname_pages %} 站点](/articles/securing-your-github-pages-site-with-https)”。 +可以通过 HTTPS 访问使用正确配置了 `CNAME`、`ALIAS`、`ANAME` 或 `A` DNS 记录的自定义域的 {% data variables.product.prodname_pages %} 站点。有关详细信息，请参阅“[使用 HTTPS 保护 {% data variables.product.prodname_pages %} 站点](/articles/securing-your-github-pages-site-with-https)”。 -配置自定义域后，您的站点可能需要最多一个小时才能通过 HTTPS 访问。 更新现有 DNS 设置后，您可能需要删除自定义域并将其重新添加到站点仓库，以触发启用 HTTPS 的进程。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 +配置自定义域后，您的站点可能需要最多一个小时才能通过 HTTPS 访问。更新现有 DNS 设置后，您可能需要删除自定义域并将其重新添加到站点仓库，以触发启用 HTTPS 的进程。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 站点管理自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。 -如果使用的是证书颁发机构授权 (CAA) 记录，则必须存在至少一个值为 `letsencrypt.org` 的 CAA 记录，才能通过 HTTPS 访问站点。 有关详细信息，请参阅 Let's Encrypt 文档中的“[证书颁发机构授权 (CAA)](https://letsencrypt.org/docs/caa/)”。 +如果使用的是证书颁发机构授权 (CAA) 记录，则必须存在至少一个值为 `letsencrypt.org` 的 CAA 记录，才能通过 HTTPS 访问站点。有关详细信息，请参阅 Let's Encrypt 文档中的“[证书颁发机构授权 (CAA)](https://letsencrypt.org/docs/caa/)”。 ## Linux 上的 URL 格式 -如果您站点的 URL 包含以破折号开头或结尾的用户名或组织名称，或者包含连续破折号，则使用 Linux 浏览的用户在尝试访问您的站点时会收到服务器错误。 要解决此问题，请更改您的 {% data variables.product.product_name %} 用户名以删除非字母数字字符。 有关详细信息，请参阅“[更改 {% data variables.product.prodname_dotcom %} 用户名](/articles/changing-your-github-username/)。” +如果您站点的 URL 包含以破折号开头或结尾的用户名或组织名称，或者包含连续破折号，则使用 Linux 浏览的用户在尝试访问您的站点时会收到服务器错误。要解决此问题，请更改您的 {% data variables.product.product_name %} 用户名以删除非字母数字字符。有关详细信息，请参阅“[更改 {% data variables.product.prodname_dotcom %} 用户名](/articles/changing-your-github-username/)。” ## 浏览器缓存 -如果您最近更改或删除了自定义域，但无法在浏览器中访问新 URL，则可能需要清除浏览器的缓存才能访问新 URL。 有关清除缓存的更多信息，请参阅浏览器的文档。 +如果您最近更改或删除了自定义域，但无法在浏览器中访问新 URL，则可能需要清除浏览器的缓存才能访问新 URL。有关清除缓存的更多信息，请参阅浏览器的文档。 diff --git a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md index d384ba0bdb68..fbf210892047 100644 --- a/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md +++ b/translations/zh-CN/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md @@ -19,20 +19,20 @@ ms.locfileid: '147529669' 验证个人帐户或组织的自定义域时，只能使用个人帐户或组织拥有的存储库将 {% data variables.product.prodname_pages %} 站点发布到已验证的自定义域或域的直接子域。 -验证您的域会阻止其他 GitHub 用户接管您的自定义域并使用它来发布他们自己的 {% data variables.product.prodname_pages %} 站点。 当您删除存储库、降低计费计划级别时，或者在取消链接自定义域或禁用 {% data variables.product.prodname_pages %} 而域仍配置为 {% data variables.product.prodname_pages %} 且未进行验证的任何其他更改之后，可能会发生域接管。 +验证您的域会阻止其他 GitHub 用户接管您的自定义域并使用它来发布他们自己的 {% data variables.product.prodname_pages %} 站点。当您删除存储库、降低计费计划级别时，或者在取消链接自定义域或禁用 {% data variables.product.prodname_pages %} 而域仍配置为 {% data variables.product.prodname_pages %} 且未进行验证的任何其他更改之后，可能会发生域接管。 -验证域时，验证中还会包含任何直接子域。 例如，如果已验证 `github.com` 自定义域，`docs.github.com`、`support.github.com` 和任何其他直接子域也将受到保护，以防止被接管。 +验证域时，验证中还会包含任何直接子域。例如，如果已验证 `github.com` 自定义域，`docs.github.com`、`support.github.com` 和任何其他直接子域也将受到保护，以防止被接管。 {% data reusables.pages.wildcard-dns-warning %} -还可以验证组织{% ifversion ghec %} 或企业{% endif %}的域，这会在组织 {% ifversion ghec %}或企业{% endif %} 配置文件{% ifversion ghec %} 以及 {% data variables.product.prodname_ghe_cloud %} 上显示“已验证”徽章，允许您使用已验证的域将通知限于电子邮件地址{% endif %}。 有关详细信息，请参阅“[验证或批准组织的域](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization){% ifversion ghec %}”和“[验证或批准企业的域](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)”{% endif %}。 +还可以验证组织{% ifversion ghec %} 或企业{% endif %}的域，这会在组织 {% ifversion ghec %}或企业{% endif %} 配置文件{% ifversion ghec %} 以及 {% data variables.product.prodname_ghe_cloud %} 上显示“已验证”徽章，允许您使用已验证的域将通知限于电子邮件地址{% endif %}。有关详细信息，请参阅“[验证或批准组织的域](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization){% ifversion ghec %}”和“[验证或批准企业的域](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)”{% endif %}。 ## 验证用户站点的域 {% data reusables.user-settings.access_settings %} 1. 在边栏的“代码、规划和自动化”部分中，单击 {% octicon "browser" aria-label="The pages icon" %} 页。 {% data reusables.pages.settings-verify-domain-setup %} -1. 等待您的 DNS 配置更改，这可能是立即更改或最多需要 24 小时。 可以通过在命令行上运行 `dig` 命令来确认对 DNS 配置的更改。 在以下命令中，将 `USERNAME` 替换为你的用户名，将 `example.com` 替换为要验证的域。 如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。 +1. 等待您的 DNS 配置更改，这可能是立即更改或最多需要 24 小时。可以通过在命令行上运行 `dig` 命令来确认对 DNS 配置的更改。在以下命令中，将 `USERNAME` 替换为你的用户名，将 `example.com` 替换为要验证的域。如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。 ``` dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT ``` @@ -45,7 +45,7 @@ ms.locfileid: '147529669' {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} 1. 在边栏的“代码、规划和自动化”部分中，单击 {% octicon "browser" aria-label="The browser icon" %} 页。 {% data reusables.pages.settings-verify-domain-setup %} -1. 等待您的 DNS 配置更改，这可能是立即更改或最多需要 24 小时。 可以通过在命令行上运行 `dig` 命令来确认对 DNS 配置的更改。 在以下命令中，将 `ORGANIZATION` 替换为组织的名称，将 `example.com` 替换为要验证的域。 如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。 +1. 等待您的 DNS 配置更改，这可能是立即更改或最多需要 24 小时。可以通过在命令行上运行 `dig` 命令来确认对 DNS 配置的更改。在以下命令中，将 `ORGANIZATION` 替换为组织的名称，将 `example.com` 替换为要验证的域。如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。 ``` dig _github-pages-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/about-github-pages.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/about-github-pages.md index e8d1ec4e9973..9c9505f9a6a0 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/about-github-pages.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/about-github-pages.md @@ -27,33 +27,33 @@ ms.locfileid: '147507987' --- ## 关于 {% data variables.product.prodname_pages %} -{% data variables.product.prodname_pages %} 是一项静态站点托管服务，它直接从 {% data variables.product.product_name %} 上的仓库获取 HTML、CSS 和 JavaScript 文件，（可选）通过构建过程运行文件，然后发布网站。 可以在 [{% data variables.product.prodname_pages %} 示例集合](https://github.com/collections/github-pages-examples)中看到 {% data variables.product.prodname_pages %} 站点的示例。 +{% data variables.product.prodname_pages %} 是一项静态站点托管服务，它直接从 {% data variables.product.product_name %} 上的仓库获取 HTML、CSS 和 JavaScript 文件，（可选）通过构建过程运行文件，然后发布网站。可以在 [{% data variables.product.prodname_pages %} 示例集合](https://github.com/collections/github-pages-examples)中看到 {% data variables.product.prodname_pages %} 站点的示例。 -{% ifversion fpt or ghec %} 你可以在 {% data variables.product.prodname_dotcom %} 的 `github.io` 域或自己的自定义域上托管站点。 有关详细信息，请参阅“[将自定义域与 {% data variables.product.prodname_pages %} 配合使用](/articles/using-a-custom-domain-with-github-pages)”。 +{% ifversion fpt or ghec %} 你可以在 {% data variables.product.prodname_dotcom %} 的 `github.io` 域或自己的自定义域上托管站点。有关详细信息，请参阅“[将自定义域与 {% data variables.product.prodname_pages %} 配合使用](/articles/using-a-custom-domain-with-github-pages)”。 {% endif %} {% ifversion fpt or ghec %} {% data reusables.pages.about-private-publishing %} 有关详细信息，请参阅 {% data variables.product.prodname_ghe_cloud %} 文档中的“[更改 {% data variables.product.prodname_pages %} 站点的可见性]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site){% ifversion fpt %}”。{% else %}."{% endif %} {% endif %} 若要开始，请参阅“[创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site)”。 -{% ifversion fpt or ghes or ghec %} 组织所有者可禁止从组织的存储库发布 {% data variables.product.prodname_pages %} 站点。 有关详细信息，请参阅“[为组织管理 {% data variables.product.prodname_pages %} 站点的发布](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)”。 +{% ifversion fpt or ghes or ghec %} 组织所有者可禁止从组织的存储库发布 {% data variables.product.prodname_pages %} 站点。有关详细信息，请参阅“[为组织管理 {% data variables.product.prodname_pages %} 站点的发布](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)”。 {% endif %} ## {% data variables.product.prodname_pages %} 站点的类型 -有三种类型的 {% data variables.product.prodname_pages %} 站点：项目、用户和组织。 项目站点连接到 {% data variables.product.product_name %} 上托管的特定项目，例如 JavaScript 库或配方集合。 用户和组织站点连接到 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的特定帐户。 +有三种类型的 {% data variables.product.prodname_pages %} 站点：项目、用户和组织。项目站点连接到 {% data variables.product.product_name %} 上托管的特定项目，例如 JavaScript 库或配方集合。用户和组织站点连接到 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的特定帐户。 -若要发布用户站点，必须创建名为 {% ifversion fpt or ghec %}`.github.io`{% else %}`.`{% endif %} 的个人帐户拥有的存储库。 若要发布组织站点，必须创建名为 {% ifversion fpt or ghec %}`.github.io`{% else %}`.`{% endif %} 的组织帐户拥有的存储库。 {% ifversion fpt or ghec %}除非使用的是自定义域，否则用户和组织站点在 `http(s)://.github.io` 或 `http(s)://.github.io` 中可用。{% elsif ghae %}用户和组织站点在 `http(s)://pages./` 或 `http(s)://pages./` 上可用。{% endif %} +若要发布用户站点，必须创建名为 {% ifversion fpt or ghec %}`.github.io`{% else %}`.`{% endif %} 的个人帐户拥有的存储库。若要发布组织站点，必须创建名为 {% ifversion fpt or ghec %}`.github.io`{% else %}`.`{% endif %} 的组织帐户拥有的存储库。 {% ifversion fpt or ghec %}除非使用的是自定义域，否则用户和组织站点在 `http(s)://.github.io` 或 `http(s)://.github.io` 中可用。{% elsif ghae %}用户和组织站点在 `http(s)://pages./` 或 `http(s)://pages./` 上可用。{% endif %} 项目站点的源文件与其项目存储在同一个仓库中。 {% ifversion fpt or ghec %}除非使用的是自定义域，否则项目站点在 `http(s)://.github.io/` 或 `http(s)://.github.io/` 中可用。{% elsif ghae %}项目站点在 `http(s)://pages.///` 或 `http(s)://pages.///` 上可用。{% endif %} -{% ifversion ghec %} 如果私下发布站点，则站点的 URL 将有所不同。 有关详细信息，请参阅“[更改 {% data variables.product.prodname_pages %} 站点的可见性](/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site)”。 +{% ifversion ghec %} 如果私下发布站点，则站点的 URL 将有所不同。有关详细信息，请参阅“[更改 {% data variables.product.prodname_pages %} 站点的可见性](/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site)”。 {% endif %} {% ifversion fpt or ghec %} 有关自定义域如何影响站点的 URL 的详细信息，请参阅“[关于自定义域和 {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)”。 {% endif %} -您只能为 {% data variables.product.product_name %} 上的每个帐户创建一个用户或组织站点。 项目站点（无论是组织还是个人帐户拥有）没有限制。 +您只能为 {% data variables.product.product_name %} 上的每个帐户创建一个用户或组织站点。项目站点（无论是组织还是个人帐户拥有）没有限制。 {% ifversion ghes %} 你的站点可用的 URL 取决于是否为 {% data variables.product.product_location %} 启用了子域隔离。 @@ -87,19 +87,19 @@ ms.locfileid: '147507987' ## 静态站点生成器 -{% data variables.product.prodname_pages %} 会发布您推送到仓库的任何静态文件。 您可以创建自己的静态文件或使用静态站点生成器为您构建站点。 您还可以在本地或其他服务器上自定义自己的构建过程。 +{% data variables.product.prodname_pages %} 会发布您推送到仓库的任何静态文件。您可以创建自己的静态文件或使用静态站点生成器为您构建站点。您还可以在本地或其他服务器上自定义自己的构建过程。 {% ifversion pages-custom-workflow %} -如果使用自定义生成过程或 Jekyll 以外的静态站点生成器，可以编写 {% data variables.product.prodname_actions %} 来生成和发布站点。 {% data variables.product.product_name %} 为多个静态站点生成器提供入门工作流。 有关详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 +如果使用自定义生成过程或 Jekyll 以外的静态站点生成器，可以编写 {% data variables.product.prodname_actions %} 来生成和发布站点。 {% data variables.product.product_name %} 为多个静态站点生成器提供入门工作流。有关详细信息，请参阅“[为 GitHub Pages 站点配置发布源](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。 -如果从源分支发布站点，{% data variables.product.prodname_pages %} 将默认使用 Jekyll 生成站点。 如果想使用 Jekyll 以外的静态站点生成器，则建议编写 {% data variables.product.prodname_actions %} 来生成和发布站点。 否则，通过在发布源的根目录中创建一个名为 `.nojekyll` 的空文件来禁用 Jekyll 生成过程，然后按照静态站点生成器的说明在本地生成站点。 +如果从源分支发布站点，{% data variables.product.prodname_pages %} 将默认使用 Jekyll 生成站点。如果想使用 Jekyll 以外的静态站点生成器，则建议编写 {% data variables.product.prodname_actions %} 来生成和发布站点。否则，通过在发布源的根目录中创建一个名为 `.nojekyll` 的空文件来禁用 Jekyll 生成过程，然后按照静态站点生成器的说明在本地生成站点。 {% else %} -我们建议使用 Jekyll，它是一个静态站点生成器，内置 {% data variables.product.prodname_pages %} 支持和简化的构建流程。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll)”。 +我们建议使用 Jekyll，它是一个静态站点生成器，内置 {% data variables.product.prodname_pages %} 支持和简化的构建流程。有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll)”。 -默认情况下，{% data variables.product.prodname_pages %} 将使用 Jekyll 来构建您的站点。 如果你想使用除 Jekyll 以外的静态站点生成器，通过在发布来源的根目录中创建一个名为 `.nojekyll` 的空文件来禁用 Jekyll 构建过程，然后按照静态站点生成器的说明在本地构建站点。 +默认情况下，{% data variables.product.prodname_pages %} 将使用 Jekyll 来构建您的站点。如果你想使用除 Jekyll 以外的静态站点生成器，通过在发布来源的根目录中创建一个名为 `.nojekyll` 的空文件来禁用 Jekyll 构建过程，然后按照静态站点生成器的说明在本地构建站点。 {% endif %} @@ -107,7 +107,7 @@ ms.locfileid: '147507987' ## {% data variables.product.prodname_pages %} 使用限制 -{% ifversion fpt or ghec %} 2016 年 6 月 15 日后创建并使用 `github.io` 域的 {% data variables.product.prodname_pages %} 站点通过 HTTPS 提供服务。 如果您在 2016 年 6 月 15 日之前创建站点，您可以为站点的流量启用 HTTPS 支持。 有关详细信息，请参阅“[使用 HTTPS 保护 {% data variables.product.prodname_pages %}](/articles/securing-your-github-pages-site-with-https)”。 +{% ifversion fpt or ghec %} 2016 年 6 月 15 日后创建并使用 `github.io` 域的 {% data variables.product.prodname_pages %} 站点通过 HTTPS 提供服务。如果您在 2016 年 6 月 15 日之前创建站点，您可以为站点的流量启用 HTTPS 支持。有关详细信息，请参阅“[使用 HTTPS 保护 {% data variables.product.prodname_pages %}](/articles/securing-your-github-pages-site-with-https)”。 ### 禁止使用 {% endif %} {% data variables.product.prodname_pages %} 并非旨在用于或允许用作免费的 Web 托管服务来运行你的在线业务、电子商务站点或主要针对促进商业交易或提供商业软件即服务 (SaaS) 的任何其他网站。 {% data reusables.pages.no_sensitive_data_pages %} @@ -122,7 +122,7 @@ ms.locfileid: '147507987' {% ifversion fpt or ghec %} - {% data variables.product.prodname_pages %} 站点的软带宽限制为每月 100 GB。 - {% data variables.product.prodname_pages %} 站点的软限制为每小时 10 次生成。{% ifversion pages-custom-workflow %} 如果使用自定义 {% data variables.product.prodname_actions %} 工作流生成和发布站点，则此限制不适用 {% endif %} - - 为了为所有 {% data variables.product.prodname_pages %} 站点提供一致的服务质量，可能会实施速率限制。 这些速率限制无意干扰 {% data variables.product.prodname_pages %} 的合法使用。 如果你的请求触发了速率限制，你将收到相应响应，其中包含 HTTP 状态代码 `429` 以及信息性 HTML 正文。 + - 为了为所有 {% data variables.product.prodname_pages %} 站点提供一致的服务质量，可能会实施速率限制。这些速率限制无意干扰 {% data variables.product.prodname_pages %} 的合法使用。如果你的请求触发了速率限制，你将收到相应响应，其中包含 HTTP 状态代码 `429` 以及信息性 HTML 正文。 如果您的站点超出这些使用配额，我们可能无法为您的站点提供服务；或者您可能收到来自 {% data variables.contact.contact_support %} 的礼貌电子邮件，建议降低站点对服务器影响的策略，包括将第三方内容分发网络 (CDN) 置于您的站点前，利用其他 {% data variables.product.prodname_dotcom %} 功能（如发行版）或转用可能更符合您需求的其他托管服务。 @@ -130,14 +130,14 @@ ms.locfileid: '147507987' ## {% data variables.product.prodname_pages %} 上的 MIME 类型 -MIME 类型是服务器发送到浏览器的标头，提供有关浏览器所请求文件性质和格式的信息。 {% data variables.product.prodname_pages %} 支持数千种文件扩展名中 750 多种 MIME 类型。 支持的 MIME 类型列表是从 [mime-db 项目](https://github.com/jshttp/mime-db)生成的。 +MIME 类型是服务器发送到浏览器的标头，提供有关浏览器所请求文件性质和格式的信息。 {% data variables.product.prodname_pages %} 支持数千种文件扩展名中 750 多种 MIME 类型。支持的 MIME 类型列表是从 [mime-db 项目](https://github.com/jshttp/mime-db)生成的。 -虽然无法基于每个文件或每个仓库指定自定义 MIME 类型，但您可以添加或修改 MIME 类型以在 {% data variables.product.prodname_pages %} 上使用。 有关详细信息，请参阅 [mime-db 贡献指南](https://github.com/jshttp/mime-db#adding-custom-media-types)。 +虽然无法基于每个文件或每个仓库指定自定义 MIME 类型，但您可以添加或修改 MIME 类型以在 {% data variables.product.prodname_pages %} 上使用。有关详细信息，请参阅 [mime-db 贡献指南](https://github.com/jshttp/mime-db#adding-custom-media-types)。 {% ifversion fpt %} ## 数据收集 -访问 {% data variables.product.prodname_pages %} 站点时，出于安全目的，无论访问者是否已登录 {% data variables.product.prodname_dotcom %} ，都会记录并存储访问者的 IP 地址。 有关 {% data variables.product.prodname_dotcom %} 的安全做法的详细信息，请参阅 {% data variables.product.prodname_dotcom %} 隐私声明。 +访问 {% data variables.product.prodname_pages %} 站点时，出于安全目的，无论访问者是否已登录 {% data variables.product.prodname_dotcom %} ，都会记录并存储访问者的 IP 地址。有关 {% data variables.product.prodname_dotcom %} 的安全做法的详细信息，请参阅 {% data variables.product.prodname_dotcom %} 隐私声明。 {% endif %} ## 延伸阅读 diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md index 6c43327f5672..710a75bf0fb4 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md @@ -16,26 +16,26 @@ ms.locfileid: '145282855' --- ## 关于 {% data variables.product.prodname_pages %} 站点的访问控制 -如果对 {% data variables.product.prodname_pages %} 具有访问控制权限，便可以通过私密发布站点来限制访问项目站点。 只有对发布站点的仓库具有读取权限的人才可访问私密发布的站点。 您可以使用私密发布的站点与企业成员分享您的内部文档或知识库。 +如果对 {% data variables.product.prodname_pages %} 具有访问控制权限，便可以通过私密发布站点来限制访问项目站点。只有对发布站点的仓库具有读取权限的人才可访问私密发布的站点。您可以使用私密发布的站点与企业成员分享您的内部文档或知识库。 {% data reusables.pages.privately-publish-ghec-only %} -如果企业使用 {% data variables.product.prodname_emus %}，则访问控制不可用，且所有 {% data variables.product.prodname_pages %} 站点都只可供其他企业成员访问。 有关 {% data variables.product.prodname_emus %} 的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)”。 +如果企业使用 {% data variables.product.prodname_emus %}，则访问控制不可用，且所有 {% data variables.product.prodname_pages %} 站点都只可供其他企业成员访问。有关 {% data variables.product.prodname_emus %} 的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)”。 如果组织使用 {% data variables.product.prodname_ghe_cloud %} 而没有 {% data variables.product.prodname_emus %}，可以选择在 Internet 上私下或公开地向任何人发布项目站点。 -从组织拥有的私人或内部仓库发布的项目站点可使用访问控制。 您无法管理组织站点的访问控制。 有关 {% data variables.product.prodname_pages %} 类型的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites)”。 +从组织拥有的私人或内部仓库发布的项目站点可使用访问控制。您无法管理组织站点的访问控制。有关 {% data variables.product.prodname_pages %} 类型的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites)”。 ## 关于以私密方式发布的站点的子域 -私下发布的站点与公开发布的站点位于不同的子域中。 这可确保您的 {% data variables.product.prodname_pages %} 站点从发布之日起是安全的： +私下发布的站点与公开发布的站点位于不同的子域中。这可确保您的 {% data variables.product.prodname_pages %} 站点从发布之日起是安全的： - 我们使用 TLS 证书自动保护 `*.pages.github.io` 的每个子域，并强制执行 HSTS 以确保浏览器始终通过 HTTPS 提供页面。 -- 我们对以私密方式发布的站点使用独特的子域，从而确保组织中其他存储库不能在与该站点相同的来源发布内容。 这样可以保护这些站点免受“[cookie 抛掷](https://github.blog/2013-04-09-yummy-cookies-across-domains/)”攻击。 这也是为什么我们不在 `github.com` 域上托管 {% data variables.product.prodname_pages %} 网站的原因。 +- 我们对以私密方式发布的站点使用独特的子域，从而确保组织中其他存储库不能在与该站点相同的来源发布内容。这样可以保护这些站点免受“[cookie 抛掷](https://github.blog/2013-04-09-yummy-cookies-across-domains/)”攻击。这也是为什么我们不在 `github.com` 域上托管 {% data variables.product.prodname_pages %} 网站的原因。 -可在存储库设置的“页面”选项卡中看到站点独特的子域。 如果您使用配置为以仓库名称为路径来构建站点的静态站点生成器，则在将站点更改为私有站点时可能需要更新静态站点生成器的设置。 有关详细信息，请参阅“[在 {% data variables.product.prodname_pages %} 网站中配置 Jekyll](/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”或静态网站生成器的文档。 +可在存储库设置的“页面”选项卡中看到站点独特的子域。如果您使用配置为以仓库名称为路径来构建站点的静态站点生成器，则在将站点更改为私有站点时可能需要更新静态站点生成器的设置。有关详细信息，请参阅“[在 {% data variables.product.prodname_pages %} 网站中配置 Jekyll](/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”或静态网站生成器的文档。 -若要为以私密方式发布的站点使用较短且更令人难忘的域，可配置自定义域。 有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 网站配置自定义域](/pages/configuring-a-custom-domain-for-your-github-pages-site)”。 +若要为以私密方式发布的站点使用较短且更令人难忘的域，可配置自定义域。有关详细信息，请参阅“[为你的 {% data variables.product.prodname_pages %} 网站配置自定义域](/pages/configuring-a-custom-domain-for-your-github-pages-site)”。 ## 更改 {% data variables.product.prodname_pages %} 站点的可见性 diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index cda9710fcc87..a1c64705a4ee 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: 配置 GitHub Pages 站点的发布源 -intro: '{% ifversion pages-custom-workflow %}可以将 {% data variables.product.prodname_pages %} 站点配置为在将更改推送到特定分支时进行发布，也可以编写 {% data variables.product.prodname_actions %} 工作流来发布站点。{% else%}如果使用 {% data variables.product.prodname_pages %} 站点的默认发布源，会自动发布你的站点。 你也可以选择从不同的分支或文件夹发布你的站点。{% endif %}' +intro: '{% ifversion pages-custom-workflow %}可以将 {% data variables.product.prodname_pages %} 站点配置为在将更改推送到特定分支时进行发布，也可以编写 {% data variables.product.prodname_actions %} 工作流来发布站点。{% else%}如果使用 {% data variables.product.prodname_pages %} 站点的默认发布源，会自动发布你的站点。你也可以选择从不同的分支或文件夹发布你的站点。{% endif %}' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages - /articles/configuring-a-publishing-source-for-your-github-pages-site @@ -33,10 +33,10 @@ ms.locfileid: '147529637' 1. 确保你要用作发布源的分支已经存在于你的存储库中。 {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} {% ifversion pages-custom-workflow %} 1. 在“生成和部署”的“源”下，选择“从分支进行部署”。 -1. 在“生成和部署”的“分支”下，使用“无”或“分支”下拉菜单并选择发布源 。 +1. 在“生成和部署”的“分支”下，使用“无”或“分支”下拉菜单并选择发布源。 ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) {% else %} -3. 在“{% data variables.product.prodname_pages %}”下，使用“无”或“分支”下拉菜单，选择发布源 。 +3. 在“{% data variables.product.prodname_pages %}”下，使用“无”或“分支”下拉菜单，选择发布源。 ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} 4. （可选）使用下拉菜单选择发布源的文件夹。 ![用于选择发布源文件夹的下拉菜单](/assets/images/help/pages/publishing-source-folder-drop-down.png) @@ -47,13 +47,13 @@ ms.locfileid: '147529637' {% data reusables.pages.admin-must-push %} -如果选择任意分支上的 `docs` 文件夹作为发布源，稍后从存储库中的该分支中删除 `/docs` 文件夹，则站点不会生成，并且你将收到缺失 `/docs` 文件夹的页面生成错误消息。 有关详细信息，请参阅“[对 {% data variables.product.prodname_pages %} 站点的 Jekyll 生成错误进行故障排除](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)”。 +如果选择任意分支上的 `docs` 文件夹作为发布源，稍后从存储库中的该分支中删除 `/docs` 文件夹，则站点不会生成，并且你将收到缺失 `/docs` 文件夹的页面生成错误消息。有关详细信息，请参阅“[对 {% data variables.product.prodname_pages %} 站点的 Jekyll 生成错误进行故障排除](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)”。 {% ifversion build-pages-with-actions %} -{% data variables.product.prodname_pages %} 站点将始终使用 {% data variables.product.prodname_actions %} 工作流程运行进行部署，即使您已将 {% data variables.product.prodname_pages %} 站点配置为使用其他 CI 工具构建也是如此。 大多数外部 CI 工作流通过将生成输出提交到存储库的 `gh-pages` 分支来“部署”到 GitHub Pages，且通常包含 `.nojekyll` 文件。 发生这种情况时， {% data variables.product.prodname_actions %} 工作流程将检测分支不需要构建步骤的状态，并且仅执行将站点部署到 {% data variables.product.prodname_pages %} 服务器所需的步骤。 +{% data variables.product.prodname_pages %} 站点将始终使用 {% data variables.product.prodname_actions %} 工作流程运行进行部署，即使您已将 {% data variables.product.prodname_pages %} 站点配置为使用其他 CI 工具构建也是如此。大多数外部 CI 工作流通过将生成输出提交到存储库的 `gh-pages` 分支来“部署”到 GitHub Pages，且通常包含 `.nojekyll` 文件。发生这种情况时， {% data variables.product.prodname_actions %} 工作流程将检测分支不需要构建步骤的状态，并且仅执行将站点部署到 {% data variables.product.prodname_pages %} 服务器所需的步骤。 -若要查找构建或部署的潜在错误，可以通过查看仓库的工作流程运行来检查 {% data variables.product.prodname_pages %} 站点的工作流程运行情况。 有关详细信息，请参阅“[查看工作流运行历史记录](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。 有关如何在出现错误时重新运行工作流的详细信息，请参阅“[重新运行工作流和作业](/actions/managing-workflow-runs/re-running-workflows-and-jobs)”。 +若要查找构建或部署的潜在错误，可以通过查看仓库的工作流程运行来检查 {% data variables.product.prodname_pages %} 站点的工作流程运行情况。有关详细信息，请参阅“[查看工作流运行历史记录](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。有关如何在出现错误时重新运行工作流的详细信息，请参阅“[重新运行工作流和作业](/actions/managing-workflow-runs/re-running-workflows-and-jobs)”。 {% endif %} @@ -67,27 +67,27 @@ ms.locfileid: '147529637' {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} 1. 在“生成和部署”的“源”下，选择“GitHub Actions”。 -1. {% data variables.product.product_name %} 将推荐多个入门工作流。 如果已有用于发布站点的工作流，可跳过此步骤。 否则，请选择其中一个选项来创建 {% data variables.product.prodname_actions %} 工作流。 有关创建自定义工作流的详细信息，请参阅“[创建自定义 {% data variables.product.prodname_actions %} 工作流以发布站点](#creating-a-custom-github-actions-workflow-to-publish-your-site)”。 +1. {% data variables.product.product_name %} 将推荐多个入门工作流。如果已有用于发布站点的工作流，可跳过此步骤。否则，请选择其中一个选项来创建 {% data variables.product.prodname_actions %} 工作流。有关创建自定义工作流的详细信息，请参阅“[创建自定义 {% data variables.product.prodname_actions %} 工作流以发布站点](#creating-a-custom-github-actions-workflow-to-publish-your-site)”。 - {% data variables.product.prodname_pages %} 不会将特定工作流与 {% data variables.product.prodname_pages %} 设置相关联。 但 {% data variables.product.prodname_pages %} 设置将链接到最近部署你的站点的工作流运行。 + {% data variables.product.prodname_pages %} 不会将特定工作流与 {% data variables.product.prodname_pages %} 设置相关联。但 {% data variables.product.prodname_pages %} 设置将链接到最近部署你的站点的工作流运行。 ### 创建自定义 {% data variables.product.prodname_actions %} 工作流以发布站点 有关 {% data variables.product.prodname_actions %} 的详细信息，请参阅“[Actions](/actions)”。 -将站点配置为使用 {% data variables.product.prodname_actions %} 进行发布时，{% data variables.product.product_name %} 将针对常见发布方案推荐入门工作流。 工作流的一般流程如下： +将站点配置为使用 {% data variables.product.prodname_actions %} 进行发布时，{% data variables.product.product_name %} 将针对常见发布方案推荐入门工作流。工作流的一般流程如下： 1. 在推送到存储库的默认分支时，或者在已打开、已重新打开或已更新针对默认分支的拉取请求时触发。 1. 使用 [`actions/checkout`](https://github.com/actions/checkout) 操作签出存储库内容。 1. 如果站点需要，请生成任何静态站点文件。 1. 使用 [`actions/upload-pages-artifact`](https://github.com/actions/upload-pages-artifact) 操作将静态文件作为项目上传。 -1. 如果推送到默认分支触发了工作流，请使用 [`actions/deploy-pages`](https://github.com/actions/deploy-pages) 操作来部署项目。 如果拉取请求触发了工作流，则跳过此步骤。 +1. 如果推送到默认分支触发了工作流，请使用 [`actions/deploy-pages`](https://github.com/actions/deploy-pages) 操作来部署项目。如果拉取请求触发了工作流，则跳过此步骤。 -入门工作流使用名为 `github-pages` 的部署环境。 如果存储库尚未包含名为 `github-pages` 的环境，则自动创建该环境。 建议添加环境保护规则，确保仅默认分支可部署到该环境。 有关详细信息，请参阅“[使用环境进行部署](/actions/deployment/targeting-different-environments/using-environments-for-deployment)”。 +入门工作流使用名为 `github-pages` 的部署环境。如果存储库尚未包含名为 `github-pages` 的环境，则自动创建该环境。建议添加环境保护规则，确保仅默认分支可部署到该环境。有关详细信息，请参阅“[使用环境进行部署](/actions/deployment/targeting-different-environments/using-environments-for-deployment)”。 {% note %} -**注意**：存储库文件中的 `CNAME` 文件不会自动添加或删除自定义域。 必须通过存储库设置或 API 配置自定义域。 有关详细信息，请参阅“[管理 GitHub Pages 站点的自定义域](/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”和 [Pages API 参考文档](/rest/pages#update-information-about-a-github-pages-site)。 +**注意**：存储库文件中的 `CNAME` 文件不会自动添加或删除自定义域。必须通过存储库设置或 API 配置自定义域。有关详细信息，请参阅“[管理 GitHub Pages 站点的自定义域](/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)”和 [Pages API 参考文档](/rest/pages#update-information-about-a-github-pages-site)。 {% endnote %} diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md index 6f005fc1dcfa..d5145dd38518 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md @@ -1,6 +1,6 @@ --- title: 使用 HTTPS 保护 GitHub Pages 站点 -intro: 'HTTPS 增加一层加密，用于防止其他人窥探或篡改您的站点的流量。 您可对 {% data variables.product.prodname_pages %} 站点强制实施 HTTPS，从而将所有 HTTP 请求透明地重定向到 HTTPS。' +intro: 'HTTPS 增加一层加密，用于防止其他人窥探或篡改您的站点的流量。您可对 {% data variables.product.prodname_pages %} 站点强制实施 HTTPS，从而将所有 HTTP 请求透明地重定向到 HTTPS。' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/securing-your-github-pages-site-with-https @@ -22,7 +22,7 @@ ms.locfileid: '146273064' ## 关于 HTTPS 和 {% data variables.product.prodname_pages %} -所有 {% data variables.product.prodname_pages %} 站点（包括使用自定义域正确配置的站点）均支持 HTTPS 和 HTTPS 强制实施。 有关自定义域的详细信息，请参阅“[关于自定义域和 {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)”和“[自定义域和 {% data variables.product.prodname_pages %} 故障排除](/articles/troubleshooting-custom-domains-and-github-pages#https-errors)”。 +所有 {% data variables.product.prodname_pages %} 站点（包括使用自定义域正确配置的站点）均支持 HTTPS 和 HTTPS 强制实施。有关自定义域的详细信息，请参阅“[关于自定义域和 {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)”和“[自定义域和 {% data variables.product.prodname_pages %} 故障排除](/articles/troubleshooting-custom-domains-and-github-pages#https-errors)”。 {% data reusables.pages.no_sensitive_data_pages %} @@ -30,7 +30,7 @@ ms.locfileid: '146273064' {% note %} -**注意：** RFC3280 表示通用名称的最大长度应为 64 个字符。 因此，{% data variables.product.prodname_pages %} 网站的整个域名必须小于 64 个字符，才能成功创建证书。 +**注意：** RFC3280 表示通用名称的最大长度应为 64 个字符。因此，{% data variables.product.prodname_pages %} 网站的整个域名必须小于 64 个字符，才能成功创建证书。 {% endnote %} @@ -42,13 +42,13 @@ ms.locfileid: '146273064' ## 证书预配疑难解答（”证书尚未创建“错误） -当您在 Pages 设置中设置或更改自定义域名时，系统会开始自动进行 DNS 检查。 此检查确定您的 DNS 设置是否配置为允许 {% data variables.product.prodname_dotcom %} 自动获取证书。 如果检查成功，{% data variables.product.prodname_dotcom %} 会将作业排队以从 [Let's Encrypt](https://letsencrypt.org/) 请求 TLS 证书。 收到有效证书后，{% data variables.product.prodname_dotcom %} 会自动将其上传到处理 Pages 的 TLS 终止的服务器。 成功完成此过程后，您的自定义域名旁边将显示一个复选标记。 +当您在 Pages 设置中设置或更改自定义域名时，系统会开始自动进行 DNS 检查。此检查确定您的 DNS 设置是否配置为允许 {% data variables.product.prodname_dotcom %} 自动获取证书。如果检查成功，{% data variables.product.prodname_dotcom %} 会将作业排队以从 [Let's Encrypt](https://letsencrypt.org/) 请求 TLS 证书。收到有效证书后，{% data variables.product.prodname_dotcom %} 会自动将其上传到处理 Pages 的 TLS 终止的服务器。成功完成此过程后，您的自定义域名旁边将显示一个复选标记。 -该过程可能需要一些时间。 如果在单击“保存”后几分钟未完成此过程，请尝试单击自定义域名旁边的“删除” 。 重新键入域名，然后单击“保存”。 这将取消并重新启动预配过程。 +该过程可能需要一些时间。如果在单击“保存”后几分钟未完成此过程，请尝试单击自定义域名旁边的“删除” 。重新键入域名，然后单击“保存”。这将取消并重新启动预配过程。 ## 解决具有混合内容的问题 -如果对 {% data variables.product.prodname_pages %} 站点启用了 HTTPS，但站点的 HTML 仍通过 HTTP 引用图像、CSS 或 JavaScript，则站点将提供“混合内容”。 提供混合内容可能会降低站点的安全性，并导致在加载资产时出现问题。 +如果对 {% data variables.product.prodname_pages %} 站点启用了 HTTPS，但站点的 HTML 仍通过 HTTP 引用图像、CSS 或 JavaScript，则站点将提供“混合内容”。提供混合内容可能会降低站点的安全性，并导致在加载资产时出现问题。 要删除站点的混合内容，请在站点的 HTML 中将 `http://` 更改为 `https://`，确保所有资产都通过 HTTPS 提供。 diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md index 34301031d0b3..2c634604c85b 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md @@ -27,7 +27,7 @@ ms.locfileid: '147428346' --- {% ifversion pages-custom-workflow %} -取消发布站点时，该站点将不再可用。 所有现有存储库设置或内容都不受影响。 +取消发布站点时，该站点将不再可用。所有现有存储库设置或内容都不受影响。 {% data reusables.repositories.navigate-to-repo %} 1. 在 {% data variables.product.prodname_pages %} 下的“站点所在位置”消息旁，单击 {% octicon "kebab-horizontal" aria-label="the horizontal kebab icon" %} 。 @@ -40,7 +40,7 @@ ms.locfileid: '147428346' ## 取消发布项目站点 {% data reusables.repositories.navigate-to-repo %} -2. 如果存储库中存在 `gh-pages` 分支，请删除 `gh-pages` 分支。 有关详细信息，请参阅“[创建和删除存储库中的分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”。 +2. 如果存储库中存在 `gh-pages` 分支，请删除 `gh-pages` 分支。有关详细信息，请参阅“[创建和删除存储库中的分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”。 3. 如果 `gh-pages` 分支是发布源，{% ifversion fpt or ghec %}请跳到步骤 6{% else %}你的网站现在已取消发布，你可以跳过其余步骤{% endif %}。 {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} 5. 在“{% data variables.product.prodname_pages %}”下，使用“源”下拉菜单，然后选择“无”。 @@ -49,7 +49,7 @@ ms.locfileid: '147428346' ## 取消发布用户或组织站点 {% data reusables.repositories.navigate-to-repo %} -2. 删除用作发布源的分支，或删除整个仓库。 有关详细信息，请参阅“[创建和删除存储库中的分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”和“[删除存储库](/articles/deleting-a-repository)”。 +2. 删除用作发布源的分支，或删除整个仓库。有关详细信息，请参阅“[创建和删除存储库中的分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”和“[删除存储库](/articles/deleting-a-repository)”。 {% data reusables.pages.update_your_dns_settings %} {% endif %} diff --git a/translations/zh-CN/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md b/translations/zh-CN/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md index 6e73ec60c4e5..c99f9595eb4c 100644 --- a/translations/zh-CN/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md +++ b/translations/zh-CN/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md @@ -23,7 +23,7 @@ ms.locfileid: '147880796' 只能使用指向公共仓库的子模块，因为 {% data variables.product.prodname_pages %} 服务器无法访问私有仓库。 -对子模块（包括嵌套子模块）使用 `https://` 只读 URL。 你可以在 .gitmodules 文件中进行此更改。 +对子模块（包括嵌套子模块）使用 `https://` 只读 URL。你可以在 .gitmodules 文件中进行此更改。 ## 延伸阅读 diff --git a/translations/zh-CN/content/pages/index.md b/translations/zh-CN/content/pages/index.md index 597ed0814e7b..0362849e8526 100644 --- a/translations/zh-CN/content/pages/index.md +++ b/translations/zh-CN/content/pages/index.md @@ -1,7 +1,7 @@ --- title: GitHub Pages 文档 shortTitle: GitHub Pages -intro: '了解如何直接从 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的存储库创建网站。 浏览 Jekyll 等网站生成工具并解决 {% data variables.product.prodname_pages %} 站点的问题。' +intro: '了解如何直接从 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的存储库创建网站。浏览 Jekyll 等网站生成工具并解决 {% data variables.product.prodname_pages %} 站点的问题。' introLinks: quickstart: /pages/quickstart overview: /pages/getting-started-with-github-pages/about-github-pages diff --git a/translations/zh-CN/content/pages/quickstart.md b/translations/zh-CN/content/pages/quickstart.md index d61248db2e74..31505bce491a 100644 --- a/translations/zh-CN/content/pages/quickstart.md +++ b/translations/zh-CN/content/pages/quickstart.md @@ -1,6 +1,6 @@ --- title: GitHub Pages 快速入门 -intro: '您可以使用 {% data variables.product.prodname_pages %} 来展示一些开源项目、主持博客甚或分享您的简历。 本指南将帮助您开始创建下一个网站。' +intro: '您可以使用 {% data variables.product.prodname_pages %} 来展示一些开源项目、主持博客甚或分享您的简历。本指南将帮助您开始创建下一个网站。' allowTitleToDifferFromFilename: true versions: fpt: '*' @@ -21,31 +21,31 @@ ms.locfileid: '145130258' --- ## 简介 -{% data variables.product.prodname_pages %} 是通过 {% data variables.product.product_name %} 托管和发布的公共网页。 启动和运行的最快方法是使用 Jekyll 主题选择器加载预置主题。 然后，您可以修改 {% data variables.product.prodname_pages %} 的内容和样式。 +{% data variables.product.prodname_pages %} 是通过 {% data variables.product.product_name %} 托管和发布的公共网页。启动和运行的最快方法是使用 Jekyll 主题选择器加载预置主题。然后，您可以修改 {% data variables.product.prodname_pages %} 的内容和样式。 本指南将引导你在 `username.github.io` 创建用户站点。 ## 创建网站 {% data reusables.repositories.create_new %} -1. 输入 `username.github.io` 作为存储库名称。 将 `username` 替换为你的 {% data variables.product.prodname_dotcom %} 用户名。 例如，如果用户名为 `octocat`，则存储库名称应为 `octocat.github.io`。 +1. 输入 `username.github.io` 作为存储库名称。将 `username` 替换为你的 {% data variables.product.prodname_dotcom %} 用户名。例如，如果用户名为 `octocat`，则存储库名称应为 `octocat.github.io`。 ![存储库名称字段](/assets/images/help/pages/create-repository-name-pages.png) {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} 1. 单击“选择主题”。 ![“选择主题”按钮](/assets/images/help/pages/choose-theme.png) -2. 主题选择器将打开。 浏览可用主题，然后单击“选择主题”以选择主题。 以后更改主题很容易，因此，如果您不确定，请暂时选择一个。 +2. 主题选择器将打开。浏览可用主题，然后单击“选择主题”以选择主题。以后更改主题很容易，因此，如果您不确定，请暂时选择一个。 ![“主题”选项和“选择主题”按钮](/assets/images/help/pages/select-theme.png) -3. 选择主题后，存储库的 `README.md` 文件将在文件编辑器中打开。 `README.md` 文件是你将为站点编写内容的位置。 您可以编辑文件或暂时保留默认内容。 +3. 选择主题后，存储库的 `README.md` 文件将在文件编辑器中打开。 `README.md` 文件是你将为站点编写内容的位置。您可以编辑文件或暂时保留默认内容。 4. 编辑完文件后，单击“提交更改”。 -5. 访问 `username.github.io` 以查看新网站。 注意：对站点的更改在推送到 {% data variables.product.product_name %} 后，最长可能需要 20 分钟才会发布。 +5. 访问 `username.github.io` 以查看新网站。注意：对站点的更改在推送到 {% data variables.product.product_name %} 后，最长可能需要 20 分钟才会发布。 ## 更改标题和说明 -默认情况下，站点的标题为 `username.github.io`。 可通过编辑存储库中的 `_config.yml` 文件来更改标题。 您还可以为您的网站添加说明。 +默认情况下，站点的标题为 `username.github.io`。可通过编辑存储库中的 `_config.yml` 文件来更改标题。您还可以为您的网站添加说明。 1. 单击存储库的“代码”选项卡。 1. 在文件列表中，单击 `_config.yml` 以打开该文件。 1. 单击 {% octicon "pencil" aria-label="The edit icon" %} 编辑文件。 -1. `_config.yml` 文件已包含指定站点主题的行。 添加一个新行，其中 `title:` 后跟所需的标题。 添加一个新行，其中 `description:` 后跟所需的描述。 例如： +1. `_config.yml` 文件已包含指定站点主题的行。添加一个新行，其中 `title:` 后跟所需的标题。添加一个新行，其中 `description:` 后跟所需的描述。例如： ```yaml theme: jekyll-theme-minimal diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md index f806dc4ccb00..3a3ea51a3bb9 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md @@ -36,15 +36,15 @@ ms.locfileid: '145130256' --- ## 关于 Jekyll -Jekyll 是一个静态站点生成器，内置 {% data variables.product.prodname_pages %} 支持和简化的构建过程。 Jekyll 使用 Markdown 和 HTML 文件，并根据您选择的布局创建完整静态网站。 Jekyll 支持 Markdown 和 Lick，这是一种可在网站上加载动态内容的模板语言。 有关详细信息，请参阅 [Jekyll](https://jekyllrb.com/)。 +Jekyll 是一个静态站点生成器，内置 {% data variables.product.prodname_pages %} 支持和简化的构建过程。Jekyll 使用 Markdown 和 HTML 文件，并根据您选择的布局创建完整静态网站。Jekyll 支持 Markdown 和 Lick，这是一种可在网站上加载动态内容的模板语言。有关详细信息，请参阅 [Jekyll](https://jekyllrb.com/)。 -Windows 并未正式支持 Jekyll。 有关详细信息，请参阅 Jekyll 文档中的“[Windows 上的 Jekyll](http://jekyllrb.com/docs/windows/#installation)”。 +Windows 并未正式支持 Jekyll。有关详细信息，请参阅 Jekyll 文档中的“[Windows 上的 Jekyll](http://jekyllrb.com/docs/windows/#installation)”。 -我们建议将 Jekyll 用于 {% data variables.product.prodname_pages %}。 如果您喜欢，可以使用其他静态站点生成器或者在本地或其他服务器上自定义构建过程。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/articles/about-github-pages#static-site-generators)”。 +我们建议将 Jekyll 用于 {% data variables.product.prodname_pages %}。如果您喜欢，可以使用其他静态站点生成器或者在本地或其他服务器上自定义构建过程。有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/articles/about-github-pages#static-site-generators)”。 ## 在 {% data variables.product.prodname_pages %} 网站中配置 Jekyll -可以通过编辑 _config.yml 文件来配置大多数 Jekyll 设置，例如站点的主题和插件。 有关详细信息，请参阅 Jekyll 文档中的“[配置](https://jekyllrb.com/docs/configuration/)”。 +可以通过编辑 _config.yml 文件来配置大多数 Jekyll 设置，例如站点的主题和插件。有关详细信息，请参阅 Jekyll 文档中的“[配置](https://jekyllrb.com/docs/configuration/)”。 对于 {% data variables.product.prodname_pages %} 站点，有些配置设置不能更改。 @@ -73,21 +73,21 @@ kramdown: {% data reusables.pages.about-front-matter %} -可以添加 `site.github` 到帖子或页面，以将任何存储库引用元数据添加到站点。 有关详细信息，请参阅 Jekyll 元数据文档中的“[使用 `site.github`](https://jekyll.github.io/github-metadata/site.github/)”。 +可以添加 `site.github` 到帖子或页面，以将任何存储库引用元数据添加到站点。有关详细信息，请参阅 Jekyll 元数据文档中的“[使用 `site.github`](https://jekyll.github.io/github-metadata/site.github/)”。 ## 主题 {% data reusables.pages.add-jekyll-theme %} 有关详细信息，请参阅 Jekyll 文档中的“[主题](https://jekyllrb.com/docs/themes/)”。 -{% ifversion fpt or ghec %} 可以在 {% data variables.product.prodname_dotcom %} 上添加支持的主题到站点。 有关详细信息，请参阅 {% data variables.product.prodname_pages %} 站点中的“[支持的主题](https://pages.github.com/themes/)”，以及“[使用主题选择器向 {% data variables.product.prodname_pages %} 站点添加主题](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)”。 +{% ifversion fpt or ghec %} 可以在 {% data variables.product.prodname_dotcom %} 上添加支持的主题到站点。有关详细信息，请参阅 {% data variables.product.prodname_pages %} 站点中的“[支持的主题](https://pages.github.com/themes/)”，以及“[使用主题选择器向 {% data variables.product.prodname_pages %} 站点添加主题](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)”。 要使用 {% data variables.product.prodname_dotcom %} 上托管的任何其他开源 Jekyll 主题，可以手动添加主题。{% else %} 可以手动添加主题到站点。{% endif %} 有关详细信息，请参阅{% ifversion fpt or ghec %} [{% data variables.product.prodname_dotcom %} 上托管的主题](https://github.com/topics/jekyll-theme)，{% else %} {% data variables.product.prodname_pages %} 站点上的“[支持的主题](https://pages.github.com/themes/)”，以及{% endif %}“[使用 Jekyll 添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)”。 -您可以通过编辑主题文件来覆盖任何主题的默认值。 有关详细信息，请参阅主题文档和 Jekyll 文档中的“[替代主题的默认值](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)”。 +您可以通过编辑主题文件来覆盖任何主题的默认值。有关详细信息，请参阅主题文档和 Jekyll 文档中的“[替代主题的默认值](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)”。 ## 插件 -您可以下载或创建 Jekyll 插件，以便为您的网站扩展 Jekyll 的功能。 例如，通过 [jemoji](https://github.com/jekyll/jemoji) 插件，可在站点的任何页面上使用 {% data variables.product.prodname_dotcom %} 风格的表情符号，就像在 {% data variables.product.prodname_dotcom %} 上使用一样。 有关详细信息，请参阅 Jekyll 文档中的“[插件](https://jekyllrb.com/docs/plugins/)”。 +您可以下载或创建 Jekyll 插件，以便为您的网站扩展 Jekyll 的功能。例如，通过 [jemoji](https://github.com/jekyll/jemoji) 插件，可在站点的任何页面上使用 {% data variables.product.prodname_dotcom %} 风格的表情符号，就像在 {% data variables.product.prodname_dotcom %} 上使用一样。有关详细信息，请参阅 Jekyll 文档中的“[插件](https://jekyllrb.com/docs/plugins/)”。 {% data variables.product.prodname_pages %} 使用默认启用且不能禁用的插件： - [`jekyll-coffeescript`](https://github.com/jekyll/jekyll-coffeescript) @@ -100,23 +100,23 @@ kramdown: - [`jekyll-titles-from-headings`](https://github.com/benbalter/jekyll-titles-from-headings) - [`jekyll-relative-links`](https://github.com/benbalter/jekyll-relative-links) -可以通过将插件的 gem 添加到 _config.yml 文件中的 `plugins` 设置来启用其他插件。 有关详细信息，请参阅 Jekyll 文档中的“[配置](https://jekyllrb.com/docs/configuration/)”。 +可以通过将插件的 gem 添加到 _config.yml 文件中的 `plugins` 设置来启用其他插件。有关详细信息，请参阅 Jekyll 文档中的“[配置](https://jekyllrb.com/docs/configuration/)”。 -有关受支持的插件列表，请参阅 {% data variables.product.prodname_pages %} 站点上的“[依赖项版本](https://pages.github.com/versions/)”。 有关特定插件的使用信息，请参阅插件的文档。 +有关受支持的插件列表，请参阅 {% data variables.product.prodname_pages %} 站点上的“[依赖项版本](https://pages.github.com/versions/)”。有关特定插件的使用信息，请参阅插件的文档。 {% tip %} -提示：可以保持更新 {% data variables.product.prodname_pages %} gem，确保使用所有插件的最新版本。 有关详细信息，请参阅 {% data variables.product.prodname_pages %} 站点上的“[使用 Jekyll 在本地测试 GitHub Pages 站点](/articles/testing-your-github-pages-site-locally-with-jekyll#updating-the-github-pages-gem)”和“[依赖项版本”](https://pages.github.com/versions/)。 +提示：可以保持更新 {% data variables.product.prodname_pages %} gem，确保使用所有插件的最新版本。有关详细信息，请参阅 {% data variables.product.prodname_pages %} 站点上的“[使用 Jekyll 在本地测试 GitHub Pages 站点](/articles/testing-your-github-pages-site-locally-with-jekyll#updating-the-github-pages-gem)”和“[依赖项版本”](https://pages.github.com/versions/)。 {% endtip %} -{% data variables.product.prodname_pages %} 无法使用不支持的插件构建网站。 如果想使用不支持的插件，请在本地生成网站，然后将网站的静态文件推送到 {% data variables.product.product_name %}。 +{% data variables.product.prodname_pages %} 无法使用不支持的插件构建网站。如果想使用不支持的插件，请在本地生成网站，然后将网站的静态文件推送到 {% data variables.product.product_name %}。 ## 语法突出显示 -为了使网站更容易读取，代码片段在 {% data variables.product.prodname_pages %} 上突显，就像在 {% data variables.product.product_name %} 上突显一样。 有关 {% data variables.product.product_name %} 上的语法突出显示的详细信息，请参阅“[创建和突出显示代码块](/articles/creating-and-highlighting-code-blocks)”。 +为了使网站更容易读取，代码片段在 {% data variables.product.prodname_pages %} 上突显，就像在 {% data variables.product.product_name %} 上突显一样。有关 {% data variables.product.product_name %} 上的语法突出显示的详细信息，请参阅“[创建和突出显示代码块](/articles/creating-and-highlighting-code-blocks)”。 -默认情况下，网站上的代码块将被 Jekyll 突出显示。 Jekyll 使用与 [Pygments](https://github.com/jneen/rouge) 兼容的 [Rouge](http://pygments.org/) 突显工具。 Pygments 已被弃用，在 Jekyll 4 中不受支持。 如果在 _config.yml 文件中指定 Pygments，则 Rouge 将用作后备。 Jekyll 不能使用任何其他语法突显工具，如果你在 _config.yml 文件中指定其他语法突显工具，你将收到页面生成警告。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 生成错误](/articles/about-jekyll-build-errors-for-github-pages-sites)”。 +默认情况下，网站上的代码块将被 Jekyll 突出显示。Jekyll 使用与 [Pygments](https://github.com/jneen/rouge) 兼容的 [Rouge](http://pygments.org/) 突显工具。Pygments 已被弃用，在 Jekyll 4 中不受支持。如果在 _config.yml 文件中指定 Pygments，则 Rouge 将用作后备。Jekyll 不能使用任何其他语法突显工具，如果你在 _config.yml 文件中指定其他语法突显工具，你将收到页面生成警告。有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 生成错误](/articles/about-jekyll-build-errors-for-github-pages-sites)”。 如果想使用其他突显工具，如 `highlight.js`，则必须更新项目的 _config.yml 文件来禁用 Jekyll 的语法突出显示。 diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md index 675f159e0397..b38a6e994f46 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md @@ -25,9 +25,9 @@ ms.locfileid: '147648237' ## 关于 Jekyll 构建错误 {% ifversion pages-custom-workflow %}如果从分支发布，则将更改推送到站点的发布源后，有时，{% else %}Sometimes,{% endif %} {% data variables.product.prodname_pages %} 不会尝试生成站点。{% ifversion fpt or ghec %} -- 推送更改的人尚未验证他们的电子邮件地址。 有关详细信息，请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。{% endif %} -- 您使用部署密钥推送。 如果要自动推送到站点的仓库，您可以改为设置计算机用户。 有关详细信息，请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys#machine-users)”。 -- 您使用的是未配置为构建发布源的 CI 服务。 例如，Travis CI 不会生成 `gh-pages` 分支，除非将分支添加到安全列表。 有关详细信息，请参阅 Travis CI 上的“[自定义生成](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)”或 CI 服务的文档。 +- 推送更改的人尚未验证他们的电子邮件地址。有关详细信息，请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。{% endif %} +- 您使用部署密钥推送。如果要自动推送到站点的仓库，您可以改为设置计算机用户。有关详细信息，请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys#machine-users)”。 +- 您使用的是未配置为构建发布源的 CI 服务。例如，Travis CI 不会生成 `gh-pages` 分支，除非将分支添加到安全列表。有关详细信息，请参阅 Travis CI 上的“[自定义生成](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)”或 CI 服务的文档。 {% note %} @@ -36,9 +36,9 @@ ms.locfileid: '147648237' {% endnote %} {% ifversion build-pages-with-actions %} 如果 Jekyll 尝试构建站点但遇到错误，你将收到一条构建错误消息。 -{% else %} 如果 Jekyll 尝试构建站点但遇到错误，你将收到一条构建错误消息。 Jekyll 构建错误消息有两种主要类型。 +{% else %} 如果 Jekyll 尝试构建站点但遇到错误，你将收到一条构建错误消息。Jekyll 构建错误消息有两种主要类型。 - “Page build warning（页面构建警告）”消息表示构建已成功完成，但您可能需要进行更改以防止将来出现问题。 -- “Page build failed（页面构建失败）”消息表示构建未能完成。 如果 Jekyll 能够检测到失败的原因，您将看到描述性错误消息。 +- “Page build failed（页面构建失败）”消息表示构建未能完成。如果 Jekyll 能够检测到失败的原因，您将看到描述性错误消息。 {% endif %} 有关排查生成错误的详细信息，请参阅“[排查 {% data variables.product.prodname_pages %} 站点的 Jekyll 生成错误](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites)”。 @@ -46,7 +46,7 @@ ms.locfileid: '147648237' {% ifversion build-pages-with-actions %} ## 查看 {% data variables.product.prodname_actions %} 的 Jekyll 构建错误消息 -默认情况下，除非已将 {% data variables.product.prodname_pages %} 网站配置为使用其他 CI 工具，否则 {% data variables.product.prodname_pages %} 网站使用 {% data variables.product.prodname_actions %} 工作流程运行构建和部署。 要查找潜在的构建错误，您可以通过查看仓库的工作流程运行来检查 {% data variables.product.prodname_pages %} 站点的工作流程运行情况。 有关详细信息，请参阅“[查看工作流运行历史记录](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。 有关如何在出现错误时重新运行工作流的详细信息，请参阅“[重新运行工作流和作业](/actions/managing-workflow-runs/re-running-workflows-and-jobs)”。 +默认情况下，除非已将 {% data variables.product.prodname_pages %} 网站配置为使用其他 CI 工具，否则 {% data variables.product.prodname_pages %} 网站使用 {% data variables.product.prodname_actions %} 工作流程运行构建和部署。要查找潜在的构建错误，您可以通过查看仓库的工作流程运行来检查 {% data variables.product.prodname_pages %} 站点的工作流程运行情况。有关详细信息，请参阅“[查看工作流运行历史记录](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。有关如何在出现错误时重新运行工作流的详细信息，请参阅“[重新运行工作流和作业](/actions/managing-workflow-runs/re-running-workflows-and-jobs)”。 {% endif %} {% ifversion build-pages-with-actions %}{% else %} @@ -57,19 +57,19 @@ ms.locfileid: '147648237' ## 在本地查看 Jekyll 构建错误消息 -我们建议在本地测试您的站点，这样您可以在命令行上看到构建错误消息，并在更改推送到 {% data variables.product.product_name %} 之前解决任何构建失败。 有关详细信息，请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 +我们建议在本地测试您的站点，这样您可以在命令行上看到构建错误消息，并在更改推送到 {% data variables.product.product_name %} 之前解决任何构建失败。有关详细信息，请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 ## 在拉取请求中查看 Jekyll 构建错误消息 -{% ifversion pages-custom-workflow %}如果从分支发布，当{% else %}When{% endif %}创建拉取请求来更新 {% data variables.product.product_name %} 上的发布源时，拉取请求的“检查”选项卡上会显示生成错误消息。 有关详细信息，请参阅“[关于状态检查](/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)”。 +{% ifversion pages-custom-workflow %}如果从分支发布，当{% else %}When{% endif %}创建拉取请求来更新 {% data variables.product.product_name %} 上的发布源时，拉取请求的“检查”选项卡上会显示生成错误消息。有关详细信息，请参阅“[关于状态检查](/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)”。 -{% ifversion pages-custom-workflow %}如果使用自定义 {% data variables.product.prodname_actions %} 工作流进行发布，以在拉取请求中查看生成错误消息，则必须将工作流配置为在 `pull_request` 触发器上运行。 执行此操作时，如果工作流已由 `pull_request` 事件触发，则建议跳过所有部署步骤。 这样，无需将拉取请求中的更改部署到站点即可查看所有生成错误。 有关详细信息，请参阅“[触发工作流的事件](/actions/using-workflows/events-that-trigger-workflows#pull_request)”和“[表达式](/actions/learn-github-actions/expressions)”。{% endif %} +{% ifversion pages-custom-workflow %}如果使用自定义 {% data variables.product.prodname_actions %} 工作流进行发布，以在拉取请求中查看生成错误消息，则必须将工作流配置为在 `pull_request` 触发器上运行。执行此操作时，如果工作流已由 `pull_request` 事件触发，则建议跳过所有部署步骤。这样，无需将拉取请求中的更改部署到站点即可查看所有生成错误。有关详细信息，请参阅“[触发工作流的事件](/actions/using-workflows/events-that-trigger-workflows#pull_request)”和“[表达式](/actions/learn-github-actions/expressions)”。{% endif %} ## 通过电子邮件查看 Jekyll 构建错误 -{% ifversion pages-custom-workflow %}如果从分支发布，当{% else %}When{% endif %}将更改推送到 {% data variables.product.product_name %} 上的发布源时，{% data variables.product.prodname_pages %} 将尝试生成站点。 如果构建失败，您将在您的主要电子邮件地址收到一封电子邮件。 {% data reusables.pages.build-failure-email-server %} +{% ifversion pages-custom-workflow %}如果从分支发布，当{% else %}When{% endif %}将更改推送到 {% data variables.product.product_name %} 上的发布源时，{% data variables.product.prodname_pages %} 将尝试生成站点。如果构建失败，您将在您的主要电子邮件地址收到一封电子邮件。 {% data reusables.pages.build-failure-email-server %} -{% ifversion pages-custom-workflow %}如果使用自定义 {% data variables.product.prodname_actions %} 工作流进行发布，以在拉取请求中接收有关生成错误的电子邮件，则必须将工作流配置为在 `pull_request` 触发器上运行。 执行此操作时，如果工作流已由 `pull_request` 事件触发，则建议跳过所有部署步骤。 这样，无需将拉取请求中的更改部署到站点即可查看所有生成错误。 有关详细信息，请参阅“[触发工作流的事件](/actions/using-workflows/events-that-trigger-workflows#pull_request)”和“[表达式](/actions/learn-github-actions/expressions)”。{% endif %} +{% ifversion pages-custom-workflow %}如果使用自定义 {% data variables.product.prodname_actions %} 工作流进行发布，以在拉取请求中接收有关生成错误的电子邮件，则必须将工作流配置为在 `pull_request` 触发器上运行。执行此操作时，如果工作流已由 `pull_request` 事件触发，则建议跳过所有部署步骤。这样，无需将拉取请求中的更改部署到站点即可查看所有生成错误。有关详细信息，请参阅“[触发工作流的事件](/actions/using-workflows/events-that-trigger-workflows#pull_request)”和“[表达式](/actions/learn-github-actions/expressions)”。{% endif %} ## 使用第三方 CI 服务查看拉取请求中的 Jekyll 构建错误消息 @@ -81,11 +81,11 @@ ms.locfileid: '147648237' gem `github-pages` ``` -2. 为您选择的测试服务配置站点仓库。 例如，使用 [Travis CI](https://travis-ci.org/) 在发布源的根目录中添加名为 _.travis.yml_ 的文件并包含以下内容： +2. 为您选择的测试服务配置站点仓库。例如，使用 [Travis CI](https://travis-ci.org/) 在发布源的根目录中添加名为 _.travis.yml_ 的文件并包含以下内容： ```yaml language: ruby rvm: - 2.3 script: "bundle exec jekyll build" ``` -3. 您可能需要使用第三方测试服务激活仓库。 更多信息请参阅测试服务的文档。 +3. 您可能需要使用第三方测试服务激活仓库。更多信息请参阅测试服务的文档。 diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md index d515097673f5..562e4c06881e 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -33,7 +33,7 @@ ms.locfileid: '147644793' 2. 导航到“_config.yml”。 {% data reusables.repositories.edit-file %} 4. 为主题名称添加新行。 - - 若要使用支持的主题，请键入 `theme: THEME-NAME`，将 THEME-NAME 替换为主题存储库的 README 中显示的主题名称。 有关支持主题的列表，请参阅 {% data variables.product.prodname_pages %} 站点上的“[支持主题](https://pages.github.com/themes/)”。 + - 若要使用支持的主题，请键入 `theme: THEME-NAME`，将 THEME-NAME 替换为主题存储库的 README 中显示的主题名称。有关支持主题的列表，请参阅 {% data variables.product.prodname_pages %} 站点上的“[支持主题](https://pages.github.com/themes/)”。 ![配置文件中支持的主题](/assets/images/help/pages/add-theme-to-config-file.png) - 若要使用在 {% data variables.product.prodname_dotcom %} 上托管的任何其他 Jekyll 主题，请键入 `remote_theme: THEME-NAME`，将 THEME-NAME 替换为主题存储库的 README 中显示的主题名称。 ![配置文件中不支持的主题](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} {% data reusables.files.propose_file_change %} @@ -61,7 +61,7 @@ ms.locfileid: '147644793' {% data reusables.pages.theme-customization-help %} -1. 在 {% data variables.product.prodname_dotcom %} 上，导航到主题的源仓库。 例如，Minima 的源存储库为 https://github.com/jekyll/minima 。 +1. 在 {% data variables.product.prodname_dotcom %} 上，导航到主题的源仓库。例如，Minima 的源存储库为 https://github.com/jekyll/minima。 2. 在 _layouts 文件夹中，导航到主题的 default.html 文件。 3. 复制该文件的内容。 {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md index 94fd4dfb0f5c..53658c4b46a5 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md @@ -24,13 +24,13 @@ ms.locfileid: '145130245' ## 关于 Jekyll 站点中的内容 -必须先创建一个 Jekyll 站点，然后才可将内容添加到 {% data variables.product.prodname_pages %} 上的 Jekyll 站点。 有关详细信息，请参阅“[使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site-with-jekyll)”。 +必须先创建一个 Jekyll 站点，然后才可将内容添加到 {% data variables.product.prodname_pages %} 上的 Jekyll 站点。有关详细信息，请参阅“[使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site-with-jekyll)”。 -Jekyll 站点中内容的主要类型是页面和帖子。 页面是指与某个特定日期没有关联的独立内容，例如“关于”页面。 默认的 Jekyll 站点包含一个名为 `about.md` 的文件，该文件在 `YOUR-SITE-URL/about` 呈现为站点上的一个页面。 您可以编辑该文件的内容以个性化“关于”页面，也可以使用“关于”页作为模板创建新页面。 有关详细信息，请参阅 Jekyll 文档中的“[页面](https://jekyllrb.com/docs/pages/)”。 +Jekyll 站点中内容的主要类型是页面和帖子。页面是指与某个特定日期没有关联的独立内容，例如“关于”页面。默认的 Jekyll 站点包含一个名为 `about.md` 的文件，该文件在 `YOUR-SITE-URL/about` 呈现为站点上的一个页面。您可以编辑该文件的内容以个性化“关于”页面，也可以使用“关于”页作为模板创建新页面。有关详细信息，请参阅 Jekyll 文档中的“[页面](https://jekyllrb.com/docs/pages/)”。 -帖子是博客文章。 默认 Jekyll 站点包含名为 `_posts` 的目录，其中包含默认帖子文件。 您可以编辑该帖子的内容，也可以将默认帖子用作模板来创建新帖子。 有关详细信息，请参阅 Jekyll 文档中的“[帖子](https://jekyllrb.com/docs/posts/)”。 +帖子是博客文章。默认 Jekyll 站点包含名为 `_posts` 的目录，其中包含默认帖子文件。您可以编辑该帖子的内容，也可以将默认帖子用作模板来创建新帖子。有关详细信息，请参阅 Jekyll 文档中的“[帖子](https://jekyllrb.com/docs/posts/)”。 -主题包括默认布局、包含和样式表，它们将自动应用到站点上的新页面和帖子，但您可以覆盖其中任何默认值。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#themes)”。 +主题包括默认布局、包含和样式表，它们将自动应用到站点上的新页面和帖子，但您可以覆盖其中任何默认值。有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#themes)”。 {% data reusables.pages.about-front-matter %} @@ -39,8 +39,8 @@ Jekyll 站点中内容的主要类型是页面和帖子。 页面是指与某个 ## 向站点添加新页面 {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} -3. 在发布源的根目录中，为名为 PAGE-NAME.md 的页面创建新文件，将 PAGE-NAME 替换为对该页面有意义的文件名 。 -4. 在文件顶部添加以下 YAML 前页，将 PAGE TITLE 替换为页面的标题，将 URL-PATH 替换为想要的页面 URL 的路径 。 例如，如果站点的基 URL 为 `https://octocat.github.io`，并且 URL-PATH 为 `/about/contact/`，则页面将位于 `https://octocat.github.io/about/contact`。 +3. 在发布源的根目录中，为名为 PAGE-NAME.md 的页面创建新文件，将 PAGE-NAME 替换为对该页面有意义的文件名。 +4. 在文件顶部添加以下 YAML 前页，将 PAGE TITLE 替换为页面的标题，将 URL-PATH 替换为想要的页面 URL 的路径。例如，如果站点的基 URL 为 `https://octocat.github.io`，并且 URL-PATH 为 `/about/contact/`，则页面将位于 `https://octocat.github.io/about/contact`。 ```shell layout: page title: "PAGE TITLE" @@ -53,8 +53,8 @@ Jekyll 站点中内容的主要类型是页面和帖子。 页面是指与某个 {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} 3. 导航到 `_posts` 目录。 -4. 创建名为 YYYY-MM-DD-NAME-OF-POST.md 的新文件，将 YYYY-MM-DD 替换为帖子的日期，将 NAME-OF-POST 替换为帖子的名称 。 -4. 在文件顶部添加以下 YAML 前页，将 POST TITLE 替换为帖子标题，将 YYYY-MM-DD hh:mm:ss -0000 替换为帖子的日期和时间，将 CATEGORY-1 和 CATEGORY-2 替换为要为帖子选择的多个类别 。 +4. 创建名为 YYYY-MM-DD-NAME-OF-POST.md 的新文件，将 YYYY-MM-DD 替换为帖子的日期，将 NAME-OF-POST 替换为帖子的名称。 +4. 在文件顶部添加以下 YAML 前页，将 POST TITLE 替换为帖子标题，将 YYYY-MM-DD hh:mm:ss -0000 替换为帖子的日期和时间，将 CATEGORY-1 和 CATEGORY-2 替换为要为帖子选择的多个类别。 ```shell layout: post title: "POST TITLE" @@ -64,7 +64,7 @@ Jekyll 站点中内容的主要类型是页面和帖子。 页面是指与某个 5. 在前页下方，为帖子添加内容。 {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} {% data reusables.files.propose_file_change %} {% data reusables.files.choose_pull_request %} {% data reusables.files.merge_pull_request %} {% data reusables.files.write_commit_message_pull_request %} {% data reusables.files.confirm_merge %} {% data reusables.files.delete_branch %} -您的帖子现在应该显示在您的站点上！ 如果站点的基 URL 为 `https://octocat.github.io`，则新帖子将位于 `https://octocat.github.io/YYYY/MM/DD/TITLE.html`。 +您的帖子现在应该显示在您的站点上！如果站点的基 URL 为 `https://octocat.github.io`，则新帖子将位于 `https://octocat.github.io/YYYY/MM/DD/TITLE.html`。 ## 后续步骤 diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md index 275a21ebe63f..1701e23eee0a 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md @@ -25,7 +25,7 @@ ms.locfileid: '145129667' ## 先决条件 -必须安装 Jekyll 和 Git 后才可使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点。 有关详细信息，请参阅 Jekyll 文档中的[安装](https://jekyllrb.com/docs/installation/)和“[设置 Git](/articles/set-up-git)”。 +必须安装 Jekyll 和 Git 后才可使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点。有关详细信息，请参阅 Jekyll 文档中的[安装](https://jekyllrb.com/docs/installation/)和“[设置 Git](/articles/set-up-git)”。 {% data reusables.pages.recommend-bundler %} @@ -79,30 +79,30 @@ ms.locfileid: '145129667' ``` 1. 打开 Jekyll 创建的 Gemfile 文件。 1. 将“#”添加到以 `gem "jekyll"` 开头的行首，以注释禁止此行。 -1. 编辑以 `# gem "github-pages"` 开头的行，以添加 `github-pages` gem。 将此行更改为： +1. 编辑以 `# gem "github-pages"` 开头的行，以添加 `github-pages` gem。将此行更改为： ```shell gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins ``` - 将 GITHUB-PAGES-VERSION 替换为 `github-pages` gem 的最新支持版本。 可以在以下位置找到这个版本：“[依赖项版本](https://pages.github.com/versions/)”。 + 将 GITHUB-PAGES-VERSION 替换为 `github-pages` gem 的最新支持版本。可以在以下位置找到这个版本：“[依赖项版本](https://pages.github.com/versions/)”。 正确版本的 Jekyll 将安装为 `github-pages` gem 的依赖项。 1. 保存并关闭 Gemfile。 1. 从命令行中，运行 `bundle install`。 -1. （可选）对 `_config.yml` 文件进行任何必要的编辑。 当仓库托管在子目录时相对路径需要此设置。 有关详细信息，请参阅“[将子文件夹拆分到新存储库中](/github/getting-started-with-github/using-git/splitting-a-subfolder-out-into-a-new-repository)”。 +1. （可选）对 `_config.yml` 文件进行任何必要的编辑。当仓库托管在子目录时相对路径需要此设置。有关详细信息，请参阅“[将子文件夹拆分到新存储库中](/github/getting-started-with-github/using-git/splitting-a-subfolder-out-into-a-new-repository)”。 ```yml domain: my-site.github.io # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com url: https://my-site.github.io # the base hostname and protocol for your site, e.g. http://example.com baseurl: /REPOSITORY-NAME/ # place folder name if the site is served in a subfolder ``` -1. （可选）在本地测试您的站点。 有关详细信息，请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 +1. （可选）在本地测试您的站点。有关详细信息，请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 1. 添加并提交您的工作。 ```shell git add . git commit -m 'Initial GitHub pages site with Jekyll' ``` -1. 将 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的存储库添加为远程存储库，将 {% ifversion ghes or ghae %}HOSTNAME 替换为企业的主机名，{% endif %} 将 USER 替换为拥有该存储库的帐户{% ifversion ghes or ghae %}，{% endif %}并将 REPOSITORY 替换为存储库名称 。 +1. 将 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上的存储库添加为远程存储库，将 {% ifversion ghes or ghae %}HOSTNAME 替换为企业的主机名，{% endif %} 将 USER 替换为拥有该存储库的帐户{% ifversion ghes or ghae %}，{% endif %}并将 REPOSITORY 替换为存储库名称。 ```shell {% ifversion fpt or ghec %} $ git remote add origin https://github.com/USER/REPOSITORY.git diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md index 999ed64fd0b9..bdfb2ade2ddd 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md @@ -24,7 +24,7 @@ ms.locfileid: '145129656' --- 拥有仓库写入权限的人可为 {% data variables.product.prodname_pages %} 站点设置 Markdown 处理器。 -{% data variables.product.prodname_pages %} 支持两种 Markdown 处理器：[kramdown](http://kramdown.gettalong.org/) 和 {% data variables.product.prodname_dotcom %} 自己的 Markdown 处理器，后者用于在整个 {% data variables.product.product_name %} 中呈现 [{% data variables.product.prodname_dotcom %} 风格的 Markdown (GFM)](https://github.github.com/gfm/)。 有关详细信息，请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上编写和设置格式](/articles/about-writing-and-formatting-on-github)”。 +{% data variables.product.prodname_pages %} 支持两种 Markdown 处理器：[kramdown](http://kramdown.gettalong.org/) 和 {% data variables.product.prodname_dotcom %} 自己的 Markdown 处理器，后者用于在整个 {% data variables.product.product_name %} 中呈现 [{% data variables.product.prodname_dotcom %} 风格的 Markdown (GFM)](https://github.github.com/gfm/)。有关详细信息，请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上编写和设置格式](/articles/about-writing-and-formatting-on-github)”。 您可以在任一处理器上使用 {% data variables.product.prodname_dotcom %} 风格的 Markdown，但只有我们的 GFM 处理器始终与您在 {% data variables.product.product_name %} 上看到的结果相匹配。 diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md index 05896a14f32b..51ec570835c4 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md @@ -28,7 +28,7 @@ ms.locfileid: '147876038' 在使用 Jekyll 测试站点之前，您必须： - 安装 [Jekyll](https://jekyllrb.com/docs/installation/) - - 创建一个 Jekyll 站点。 有关详细信息，请参阅“[使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site-with-jekyll)”。 + - 创建一个 Jekyll 站点。有关详细信息，请参阅“[使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site-with-jekyll)”。 {% data reusables.pages.recommend-bundler %} @@ -62,7 +62,7 @@ ms.locfileid: '147876038' ## 更新 {% data variables.product.prodname_pages %} gem -Jekyll 是一个活跃的开源项目，经常更新。 如果计算机上的 `github-pages` gem 与 {% data variables.product.prodname_pages %} 服务器上的 `github-pages` gem 已过期，则站点外观在本地构建时可能与在 {% data variables.product.product_name %} 上发布时不同。 为避免这种情况，请定期更新计算机上的 `github-pages` gem。 +Jekyll 是一个活跃的开源项目，经常更新。如果计算机上的 `github-pages` gem 与 {% data variables.product.prodname_pages %} 服务器上的 `github-pages` gem 已过期，则站点外观在本地构建时可能与在 {% data variables.product.product_name %} 上发布时不同。为避免这种情况，请定期更新计算机上的 `github-pages` gem。 {% data reusables.command_line.open_the_multi_os_terminal %} 2. 更新 `github-pages` gem。 diff --git a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index 1246fd4df969..3411e3c8ffe8 100644 --- a/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/zh-CN/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -43,11 +43,11 @@ ms.locfileid: '147883463' --- ## 排查构建错误 -如果在本地或 {% data variables.product.product_name %} 上构建 {% data variables.product.prodname_pages %} 站点时发生 Jekyll 错误，您可以使用错误消息排查故障。 有关错误消息以及如何查看它们的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误](/articles/about-jekyll-build-errors-for-github-pages-sites)”。 +如果在本地或 {% data variables.product.product_name %} 上构建 {% data variables.product.prodname_pages %} 站点时发生 Jekyll 错误，您可以使用错误消息排查故障。有关错误消息以及如何查看它们的详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误](/articles/about-jekyll-build-errors-for-github-pages-sites)”。 如果您收到一般错误消息，请检查常见问题。 -- 您使用的插件不受支持。 有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)。”{% ifversion fpt or ghec %} -- 您的仓库已超过我们的仓库大小限制。 有关详细信息，请参阅“[我的磁盘配额是多少？](/articles/what-is-my-disk-quota)”{% endif %} +- 您使用的插件不受支持。有关详细信息，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)。”{% ifversion fpt or ghec %} +- 您的仓库已超过我们的仓库大小限制。有关详细信息，请参阅“[我的磁盘配额是多少？](/articles/what-is-my-disk-quota)”{% endif %} - 你更改了 _config.yml 文件中的 `source` 设置。 {% ifversion pages-custom-workflow %}如果从分支发布站点，{% endif %}{% data variables.product.prodname_pages %} 在生成过程中会覆盖此设置。 - 已发布文件中的文件名包含不支持的冒号 (`:`)。 @@ -69,13 +69,13 @@ ms.locfileid: '147883463' 此错误意味着站点上的某个页面包含无效的日期时间。 -要排除故障，请搜索错误消息中的文件和文件布局，以调用任何与日期相关的 Liquid 过滤器。 确保传递给与日期相关的 Liquid 筛选器的任何变量在所有情况下都具有值，并且永远不会传递 `nil` 或 `""`。 有关详细信息，请参阅 Liquid 文档中的“[Liquid 筛选器](https://help.shopify.com/en/themes/liquid/filters)”。 +要排除故障，请搜索错误消息中的文件和文件布局，以调用任何与日期相关的 Liquid 过滤器。确保传递给与日期相关的 Liquid 筛选器的任何变量在所有情况下都具有值，并且永远不会传递 `nil` 或 `""`。有关详细信息，请参阅 Liquid 文档中的“[Liquid 筛选器](https://help.shopify.com/en/themes/liquid/filters)”。 ## 文件在包含目录中不存在 此错误意味着代码引用了 _includes 目录中不存在的文件。 -{% data reusables.pages.search-for-includes %} 如果你引用的任何文件不在 _includes 目录中，请将这些文件复制或移动到 _includes 目录 。 +{% data reusables.pages.search-for-includes %} 如果你引用的任何文件不在 _includes 目录中，请将这些文件复制或移动到 _includes 目录。 ## 文件是符号链接 @@ -96,13 +96,13 @@ encoding: UTF-8 此错误意味着你在配置文件中指定了除 [Rouge](https://github.com/jneen/rouge) 或 [Pygments](http://pygments.org/) 之外的任何语法高亮插件。 -若要排除故障，请更新 _config.yml 文件以指定 [Rouge](https://github.com/jneen/rouge) 或 [Pygments](http://pygments.org/)。 有关详细信息，请参阅“[关于 {% data variables.product.product_name %} 和 Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)”。 +若要排除故障，请更新 _config.yml 文件以指定 [Rouge](https://github.com/jneen/rouge) 或 [Pygments](http://pygments.org/)。有关详细信息，请参阅“[关于 {% data variables.product.product_name %} 和 Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)”。 ## 帖子日期无效 此错误意味着站点上的帖子在文件名或 YAML 前页中包含无效的日期。 -要排除故障，请确保所有日期的 UTC 格式均为 YYYY-MM-DD HH:MM:SS， 并且都是实际日历日期。 若要指定与 UTC 偏移的时区，请使用格式 YYYY-MM-DD HH:MM:SS +/-TTTT，例如 `2014-04-18 11:30:00 +0800`。 +要排除故障，请确保所有日期的 UTC 格式均为 YYYY-MM-DD HH:MM:SS，并且都是实际日历日期。若要指定与 UTC 偏移的时区，请使用格式 YYYY-MM-DD HH:MM:SS +/-TTTT，例如 `2014-04-18 11:30:00 +0800`。 如果你在 _config.yml 文件中指定日期格式，请确保格式正确。 @@ -110,7 +110,7 @@ encoding: UTF-8 此错误意味着您的仓库包含内容无效的 Sass 或 SCSS 文件。 -要排除故障，请查看指示 Sass 或 SCSS 无效的错误消息中包含的行号。 为防止以后出错，请在您的常用文本编辑器中安装 Sass 或 SCSS 语法检查插件。 +要排除故障，请查看指示 Sass 或 SCSS 无效的错误消息中包含的行号。为防止以后出错，请在您的常用文本编辑器中安装 Sass 或 SCSS 语法检查插件。 ## 子模块无效 @@ -136,18 +136,18 @@ encoding: UTF-8 此错误意味着您的仓库包含 Markdown 错误。 -要排除故障，请确保使用受支持的 Markdown 处理器。 有关详细信息，请参阅“[使用 Jekyll 为 {% data variables.product.prodname_pages %} 站点设置 Markdown 处理器](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)”。 +要排除故障，请确保使用受支持的 Markdown 处理器。有关详细信息，请参阅“[使用 Jekyll 为 {% data variables.product.prodname_pages %} 站点设置 Markdown 处理器](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)”。 -然后，确认错误消息中的文件使用有效的 Markdown 语法。 有关详细信息，请参阅 Daring Fireball 上的“[Markdown：语法](https://daringfireball.net/projects/markdown/syntax)”。 +然后，确认错误消息中的文件使用有效的 Markdown 语法。有关详细信息，请参阅 Daring Fireball 上的“[Markdown：语法](https://daringfireball.net/projects/markdown/syntax)”。 ## 缺少 docs 文件夹 此错误意味着你已选择分支上的 `docs` 文件夹作为发布源，但该分支上存储库的根目录中没有 `docs` 文件夹。 -若要排除故障，如果 `docs` 文件夹被意外移动，请尝试将 `docs` 文件夹移回你为发布源选择的分支上的存储库根目录。 如果 `docs` 文件夹被意外删除，你可以执行以下任一操作： -- 使用 Git 还原或撤消删除。 有关详细信息，请参阅 Git 文档中的“[git-revert](https://git-scm.com/docs/git-revert.html)”。 -- 在为发布源选择的分支上的存储库根目录中创建一个新的 `docs` 文件夹，并将站点的源文件添加到该文件夹中。 有关详细信息，请参阅“[创建新文件](/articles/creating-new-files)”。 -- 更改发布源。 有关详细信息，请参阅“[为 {% data variables.product.prodname_pages %} 配置发布源](/articles/configuring-a-publishing-source-for-github-pages)”。 +若要排除故障，如果 `docs` 文件夹被意外移动，请尝试将 `docs` 文件夹移回你为发布源选择的分支上的存储库根目录。如果 `docs` 文件夹被意外删除，你可以执行以下任一操作： +- 使用 Git 还原或撤消删除。有关详细信息，请参阅 Git 文档中的“[git-revert](https://git-scm.com/docs/git-revert.html)”。 +- 在为发布源选择的分支上的存储库根目录中创建一个新的 `docs` 文件夹，并将站点的源文件添加到该文件夹中。有关详细信息，请参阅“[创建新文件](/articles/creating-new-files)”。 +- 更改发布源。有关详细信息，请参阅“[为 {% data variables.product.prodname_pages %} 配置发布源](/articles/configuring-a-publishing-source-for-github-pages)”。 ## 缺少子模块 @@ -155,44 +155,44 @@ encoding: UTF-8 {% data reusables.pages.remove-submodule %} -如果要使用子模块，请初始化子模块。 有关详细信息，请参阅 _Pro Git_ 书中的“[Git 工具 - 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)”。 +如果要使用子模块，请初始化子模块。有关详细信息，请参阅 _Pro Git_ 书中的“[Git 工具 - 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)”。 ## 配置了相对永久链接 此错误意味着 _config.yml 文件中存在 {% data variables.product.prodname_pages %} 不支持的相对永久链接。 -永久链接是引用站点上特定页面的永久 URL。 绝对永久链接以站点的根目录开头，而相对永久链接以包含引用页面的文件夹开头。 {% data variables.product.prodname_pages %} 和 Jekyll 不再支持相对永久链接。 有关永久链接的详细信息，请参阅 Jekyll 文档中的“[永久链接](https://jekyllrb.com/docs/permalinks/)”。 +永久链接是引用站点上特定页面的永久 URL。绝对永久链接以站点的根目录开头，而相对永久链接以包含引用页面的文件夹开头。 {% data variables.product.prodname_pages %} 和 Jekyll 不再支持相对永久链接。有关永久链接的详细信息，请参阅 Jekyll 文档中的“[永久链接](https://jekyllrb.com/docs/permalinks/)”。 -若要排除故障，请从 _config.yml 文件中删除 `relative_permalinks` 行，并将站点中的任何相对永久链接重新格式化为绝对永久链接。 有关详细信息，请参阅“[编辑文件](/repositories/working-with-files/managing-files/editing-files)”。 +若要排除故障，请从 _config.yml 文件中删除 `relative_permalinks` 行，并将站点中的任何相对永久链接重新格式化为绝对永久链接。有关详细信息，请参阅“[编辑文件](/repositories/working-with-files/managing-files/editing-files)”。 ## 符号链接不存在于站点的仓库中 -此错误意味着你的站点包含站点已发布文件中不存在的符号链接。 有关符号链接的详细信息，请参阅 Wikipedia 上的“[符号链接](https://en.wikipedia.org/wiki/Symbolic_link)”。 +此错误意味着你的站点包含站点已发布文件中不存在的符号链接。有关符号链接的详细信息，请参阅 Wikipedia 上的“[符号链接](https://en.wikipedia.org/wiki/Symbolic_link)”。 -要排除故障，请确定错误消息中的文件是否用于构建站点。 如果否，或者您不希望文件成为符号链接，请删除该文件。 如果符号链接文件是生成站点的必需项，请确保符号链接引用的文件或目录存在于站点已发布文件中。 若要包含外部资产，请考虑使用 {% ifversion fpt or ghec %}`git submodule` 或{% endif %}第三方包管理器，例如 [Bower](https://bower.io/)。{% ifversion fpt or ghec %} 有关详细信息，请参阅“[将子模块用于 {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)”。{% endif %} +要排除故障，请确定错误消息中的文件是否用于构建站点。如果否，或者您不希望文件成为符号链接，请删除该文件。如果符号链接文件是生成站点的必需项，请确保符号链接引用的文件或目录存在于站点已发布文件中。若要包含外部资产，请考虑使用 {% ifversion fpt or ghec %}`git submodule` 或{% endif %}第三方包管理器，例如 [Bower](https://bower.io/)。{% ifversion fpt or ghec %} 有关详细信息，请参阅“[将子模块用于 {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)”。{% endif %} ## 'for' 循环中的语法错误 此错误意味着代码在 Liquid `for` 循环声明中包含无效语法。 -若要排除故障，请确保错误消息所指文件中的所有 `for` 循环都具有正确的语法。 有关 `for` 循环的正确语法的详细信息，请参阅 Liquid 文档中的“[迭代标记](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)”。 +若要排除故障，请确保错误消息所指文件中的所有 `for` 循环都具有正确的语法。有关 `for` 循环的正确语法的详细信息，请参阅 Liquid 文档中的“[迭代标记](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)”。 ## 标记未正确关闭 -此错误消息意味着您的代码包含未正确关闭的逻辑标记。 例如，{% raw %}`{% capture example_variable %}` 必须由 `{% endcapture %}`{% endraw %} 关闭。 +此错误消息意味着您的代码包含未正确关闭的逻辑标记。例如，{% raw %}`{% capture example_variable %}` 必须由 `{% endcapture %}`{% endraw %} 关闭。 -要排除故障，请确保错误消息所指文件中的所有逻辑标记都正确关闭。 有关详细信息，请参阅 Liquid 文档中的“[Liquid 标记](https://help.shopify.com/en/themes/liquid/tags)”。 +要排除故障，请确保错误消息所指文件中的所有逻辑标记都正确关闭。有关详细信息，请参阅 Liquid 文档中的“[Liquid 标记](https://help.shopify.com/en/themes/liquid/tags)”。 ## 标记未正确终止 -此错误意味着您的代码包含未正确终止的输出标记。 例如，是 {% raw %}`{{ page.title }` 而不是 `{{ page.title }}`{% endraw %}。 +此错误意味着您的代码包含未正确终止的输出标记。例如，是 {% raw %}`{{ page.title }` 而不是 `{{ page.title }}`{% endraw %}。 -若要排除故障，请确保错误消息所指文件中的所有输出标记都以 `}}` 终止。 有关详细信息，请参阅 Liquid 文档中的“[Liquid 对象](https://help.shopify.com/en/themes/liquid/objects)”。 +若要排除故障，请确保错误消息所指文件中的所有输出标记都以 `}}` 终止。有关详细信息，请参阅 Liquid 文档中的“[Liquid 对象](https://help.shopify.com/en/themes/liquid/objects)”。 ## 未知标记错误 此错误意味着您的代码包含无法识别的 Liquid 标记。 -要排除故障，请确保错误消息所指文件中的所有 Liquid 标记都与 Jekyll 的默认变量相匹配，并且标记名称没有拼写错误。 有关默认变量的列表，请参阅 Jekyll 文档中的“[变量](https://jekyllrb.com/docs/variables/)”。 +要排除故障，请确保错误消息所指文件中的所有 Liquid 标记都与 Jekyll 的默认变量相匹配，并且标记名称没有拼写错误。有关默认变量的列表，请参阅 Jekyll 文档中的“[变量](https://jekyllrb.com/docs/variables/)”。 -不受支持的插件是无法识别标记的常见来源。 如果您通过在本地生成站点并将静态文件推送到 {% data variables.product.product_name %} 的方法在站点中使用不受支持的插件，请确保该插件未引入 Jekyll 默认变量中没有的标记。 有关受支持插件的列表，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)”。 +不受支持的插件是无法识别标记的常见来源。如果您通过在本地生成站点并将静态文件推送到 {% data variables.product.product_name %} 的方法在站点中使用不受支持的插件，请确保该插件未引入 Jekyll 默认变量中没有的标记。有关受支持插件的列表，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)”。 diff --git a/translations/zh-CN/data/glossaries/README.md b/translations/zh-CN/data/glossaries/README.md index 53ec58a736f6..1a9913d34182 100644 --- a/translations/zh-CN/data/glossaries/README.md +++ b/translations/zh-CN/data/glossaries/README.md @@ -11,6 +11,6 @@ ms.locfileid: "145065957" 以下文件包括 [Crowdin 词汇表](https://support.crowdin.com/glossary/)： * `external.yml` 包含面向客户的词汇表条目。 - * `external.yml` 中的字符串支持 Liquid 条件。 请参阅 [contributing/liquid-helpers.md](/contributing/liquid-helpers.md)。 -* `internal.yml` 包含仅供翻译人员使用的条目。 这些术语显示在 Crowdin UI 中，为译员提供关于所翻译内容的附加上下文信息，以及相应术语的推荐本地化字符串。 + * `external.yml` 中的字符串支持 Liquid 条件。请参阅 [contributing/liquid-helpers.md](/contributing/liquid-helpers.md)。 +* `internal.yml` 包含仅供翻译人员使用的条目。这些术语显示在 Crowdin UI 中，为译员提供关于所翻译内容的附加上下文信息，以及相应术语的推荐本地化字符串。 * `candidates.yml` 包含可能位于内部或外部词汇表中但尚未定义的术语。 diff --git a/translations/zh-CN/data/learning-tracks/README.md b/translations/zh-CN/data/learning-tracks/README.md index 202fd9a6ba75..7020fd7bb8ee 100644 --- a/translations/zh-CN/data/learning-tracks/README.md +++ b/translations/zh-CN/data/learning-tracks/README.md @@ -8,7 +8,7 @@ ms.locfileid: "147887324" --- # 学习轨迹（又名学习路径） -学习轨迹是一系列帮助您掌握特定主题的文章。 学习轨迹按每个产品定义。 有关示例，请参阅 https://docs.github.com/en/actions/guides。 +学习轨迹是一系列帮助您掌握特定主题的文章。学习轨迹按每个产品定义。有关示例，请参阅 https://docs.github.com/en/actions/guides。 ## 工作原理 @@ -31,17 +31,17 @@ ms.locfileid: "147887324" 例如，在 `data/learning-tracks/actions.yml` 中，内容文件的 `learningTracks` 数组中的每个项目都用其他数据（如 `title`、`description` 和 `guides` 链接数组）表示。 - 每个版本的 YAML 中必须有一个学习轨道通过 `featured_track: true` 指定为“特色”学习轨道，这会使其显示在产品指南页面的顶部。 如果缺少此属性，测试将失败。 + 每个版本的 YAML 中必须有一个学习轨道通过 `featured_track: true` 指定为“特色”学习轨道，这会使其显示在产品指南页面的顶部。如果缺少此属性，测试将失败。 - `featured_track` 属性可以是简单的布尔值（即 `featured_track: true`），也可以是包含版本控制语句（例如 `featured_track: '{% ifversion fpt %}true{% else %}false{% endif %}'`）的字符串。 如果你使用版本控制，每个 YML 文件将有多个 `featured_track`，但请确保每个当前支持的版本中只有一个版本会呈现。 如果每个版本的特色链接多于或少于一个，测试将失败。 + `featured_track` 属性可以是简单的布尔值（即 `featured_track: true`），也可以是包含版本控制语句（例如 `featured_track: '{% ifversion fpt %}true{% else %}false{% endif %}'`）的字符串。如果你使用版本控制，每个 YML 文件将有多个 `featured_track`，但请确保每个当前支持的版本中只有一个版本会呈现。如果每个版本的特色链接多于或少于一个，测试将失败。 ## 版本控制 -学习轨迹的版本控制在页面渲染时进行处理。 代码位于 [`lib/learning-tracks.js`](lib/learning-tracks.js) 中，由 `page.render()` 调用。 然后，由 `components/guides` 呈现处理学习轨迹。 +学习轨迹的版本控制在页面渲染时进行处理。代码位于 [`lib/learning-tracks.js`](lib/learning-tracks.js) 中，由 `page.render()` 调用。然后，由 `components/guides` 呈现处理学习轨迹。 -液体条件不必用于指南的 YAML 文件中的版本控制。 只有适用于当前版本的学习跟踪指南才会自动呈现。 如果没有任何属于当前版本的指南的跟踪，学习跟踪部分将不会呈现。 +液体条件不必用于指南的 YAML 文件中的版本控制。只有适用于当前版本的学习跟踪指南才会自动呈现。如果没有任何属于当前版本的指南的跟踪，学习跟踪部分将不会呈现。 -还支持在产品的学习跟踪 YML 数据中的明确版本。 格式和允许的值与 [frontmatter 版本属性](/content#versions)相同。 +还支持在产品的学习跟踪 YML 数据中的明确版本。格式和允许的值与 [frontmatter 版本属性](/content#versions)相同。 例如： diff --git a/translations/zh-CN/data/product-examples/README.md b/translations/zh-CN/data/product-examples/README.md index 4b22249c2b0c..41c056ed3994 100644 --- a/translations/zh-CN/data/product-examples/README.md +++ b/translations/zh-CN/data/product-examples/README.md @@ -8,7 +8,7 @@ ms.locfileid: "145065955" --- # 产品登陆示例 -使用 `product-landing` 布局的页面可以选择包含 `Examples` 部分。 目前，我们支持三种类型的示例： +使用 `product-landing` 布局的页面可以选择包含 `Examples` 部分。目前，我们支持三种类型的示例： 1. 有关代码示例，请参阅 https://docs.github.com/en/codespaces#code-examples 。 @@ -18,11 +18,11 @@ ms.locfileid: "145065955" ## 工作原理 -每个产品的示例数据在 `data/product-landing-examples` 中定义，位于以 product 命名的子目录和以示例类型（例如 `data/product-examples/sponsors/user-examples.yml` 或 `data/product-examples/codespaces/code-examples.yml`）命名的 YML 文件 。 我们目前只支持每个产品一种示例。 +每个产品的示例数据在 `data/product-landing-examples` 中定义，位于以 product 命名的子目录和以示例类型（例如 `data/product-examples/sponsors/user-examples.yml` 或 `data/product-examples/codespaces/code-examples.yml`）命名的 YML 文件。我们目前只支持每个产品一种示例。 ### 版本控制 -目前，版本控制仅在代码示例中受支持。 如果示例块应该在“所有”版本中可用，你不需要做任何特殊的事情。 但如果一个示例块只能在某些版本可用，你可以添加如下 `versions` 代码块： +目前，版本控制仅在代码示例中受支持。如果示例块应该在“所有”版本中可用，你不需要做任何特殊的事情。但如果一个示例块只能在某些版本可用，你可以添加如下 `versions` 代码块： ``` - title: Dependabot version update PR