diff --git a/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md b/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md index 861e4e1e1521..5a870368d96c 100644 --- a/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md +++ b/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md @@ -465,7 +465,6 @@ name: Dependabot auto-merge on: pull_request_target permissions: - pull-requests: write contents: write jobs: @@ -497,7 +496,6 @@ name: Dependabot auto-merge on: pull_request permissions: - pull-requests: write contents: write jobs: diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index 1fa6faffaa87..681480f8736b 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -62,6 +62,7 @@ Para crear codespaces con permisos personalizados definidos, debes utilizar uno * `deployments` - lectura / escritura * `discussions` - lectura / escritura * `issues` - lectura / escritura + * `packages` - read * `pages` - lectura / escritura * `pull_requests` - lectura / escritura * `repository_projects` - lectura / escritura diff --git a/translations/es-ES/content/rest/actions/artifacts.md b/translations/es-ES/content/rest/actions/artifacts.md index 4f80761a43e6..5c144b8b9c92 100644 --- a/translations/es-ES/content/rest/actions/artifacts.md +++ b/translations/es-ES/content/rest/actions/artifacts.md @@ -1,6 +1,8 @@ --- -title: Artefactos -intro: 'La API de Artefactos te permite descargar, borrar y recuperar información acerca de los artefactos de los flujos de trabajo.' +title: GitHub Actions Artifacts +allowTitleToDifferFromFilename: true +shortTitle: Artefactos +intro: 'The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-artifacts %} Para obtener más información, consulta la sección "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". +## About the Artifacts API + +The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts. {% data reusables.actions.about-artifacts %} Para obtener más información, consulta la sección "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/es-ES/content/rest/actions/cache.md b/translations/es-ES/content/rest/actions/cache.md index bbf15991e04a..76c3f0a3e3c6 100644 --- a/translations/es-ES/content/rest/actions/cache.md +++ b/translations/es-ES/content/rest/actions/cache.md @@ -1,6 +1,8 @@ --- -title: Caché -intro: 'The Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' +title: GitHub Actions Cache +allowTitleToDifferFromFilename: true +shortTitle: Caché +intro: 'The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' topics: - API versions: @@ -8,4 +10,6 @@ versions: ghec: '*' --- -The cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories. Para obtener más información, consulta la sección "[Almacenar las dependencias en caché para agilizar los flujos de trabajo](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)". +## About the Cache API + +The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories. Para obtener más información, consulta la sección "[Almacenar las dependencias en caché para agilizar los flujos de trabajo](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)". diff --git a/translations/es-ES/content/rest/actions/permissions.md b/translations/es-ES/content/rest/actions/permissions.md index cf3660d222c9..ae2596936c4a 100644 --- a/translations/es-ES/content/rest/actions/permissions.md +++ b/translations/es-ES/content/rest/actions/permissions.md @@ -1,6 +1,8 @@ --- -title: Permisos -intro: 'The Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.' +title: GitHub Actions Permissions +allowTitleToDifferFromFilename: true +shortTitle: Permisos +intro: 'The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.' topics: - API versions: @@ -10,6 +12,6 @@ versions: ghec: '*' --- -## Permisos +## About the Permissions API -La API de permisos te permite configurar los permisos que pueden ejecutar las empresas, organizaciones y repositorios {% data variables.product.prodname_actions %}, así como las acciones{% if actions-workflow-policy %} y flujos de trabajo reutilizables{% endif %} también pueden hacerlo.{% ifversion fpt or ghec or ghes %} Para obtener más información, consulta la sección "[Límites de uso, facturación y administración](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)".{% endif %} +The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)."{% endif %} diff --git a/translations/es-ES/content/rest/actions/secrets.md b/translations/es-ES/content/rest/actions/secrets.md index 6684e53258a3..a83c762ae3e7 100644 --- a/translations/es-ES/content/rest/actions/secrets.md +++ b/translations/es-ES/content/rest/actions/secrets.md @@ -1,6 +1,8 @@ --- -title: Secretos -intro: 'La API de Secretos te permite crear, actualizar, borrar y recuperar información acerca de los secretos cifrados.' +title: GitHub Actions Secrets +allowTitleToDifferFromFilename: true +shortTitle: Secretos +intro: 'The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-secrets %} Para obtener más información, consulta la sección "[Crear y utilizar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". +## About the Secrets API + +The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows. {% data reusables.actions.about-secrets %} Para obtener más información, consulta la sección "[Crear y utilizar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". La {% data reusables.actions.actions-authentication %} en las {% data variables.product.prodname_github_apps %} debe contar con el permiso de `secrets` para utilizar esta API. Los usuarios autenticados deben tener acceso de colaborador en el repositorio para crear, actualizar o leer los secretos. diff --git a/translations/es-ES/content/rest/actions/self-hosted-runner-groups.md b/translations/es-ES/content/rest/actions/self-hosted-runner-groups.md index c66bdc3a458a..0c35316f7e6d 100644 --- a/translations/es-ES/content/rest/actions/self-hosted-runner-groups.md +++ b/translations/es-ES/content/rest/actions/self-hosted-runner-groups.md @@ -11,8 +11,8 @@ versions: --- -## Grupos de ejecutores auto-hospedados +## About the Self-hosted runner groups API -La API de Grupos de Ejecutores Auto-Hospedados te permite administrar grupos para los ejecutores auto-hospedados. Para obtener más información, consulta la sección "[Administrar el acceso a los ejecutores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)". +The Self-hosted runners groups API allows you manage groups of self-hosted runners. Para obtener más información, consulta la sección "[Administrar el acceso a los ejecutores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)". La {% data reusables.actions.actions-authentication %} en las {% data variables.product.prodname_github_apps %} debe contar con el permiso de `administration` para los repositorios o aquél de `organization_self_hosted_runners` para las organizaciones. Los usuarios autenticados deben contar con acceso administrativo a los repositorios u organizaciones o con el alcance de `manage_runners:enterprise` para empresas si quieren utilizar esta API. diff --git a/translations/es-ES/content/rest/actions/self-hosted-runners.md b/translations/es-ES/content/rest/actions/self-hosted-runners.md index 40c49dda0d9c..4233b8014f49 100644 --- a/translations/es-ES/content/rest/actions/self-hosted-runners.md +++ b/translations/es-ES/content/rest/actions/self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: Ejecutores autoalojados -intro: 'La API de Ejecutores auto-hospedados te permite registrar, ver, y borrar estos ejecutores.' +intro: 'The Self-hosted runners API allows you to register, view, and delete self-hosted runners.' topics: - API versions: @@ -11,8 +11,8 @@ versions: --- -## Ejecutores autoalojados +## About the Self-hosted runners API -La API de Ejecutores auto-hospedados te permite registrar, ver, y borrar estos ejecutores. {% data reusables.actions.about-self-hosted-runners %} Para obtener más información, consulta "[Alojar tus propios ejecutores](/actions/hosting-your-own-runners)". +The Self-hosted runners API allows you to register, view, and delete self-hosted runners. {% data reusables.actions.about-self-hosted-runners %} Para obtener más información, consulta "[Alojar tus propios ejecutores](/actions/hosting-your-own-runners)". La {% data reusables.actions.actions-authentication %} en las {% data variables.product.prodname_github_apps %} debe contar con el permiso de `administration` para los repositorios o aquél de `organization_self_hosted_runners` para las organizaciones. Los usuarios autenticados deben contar con acceso administrativo a los repositorios u organizaciones o con el alcance de `manage_runners:enterprise` para empresas si quieren utilizar esta API. diff --git a/translations/es-ES/content/rest/actions/workflow-jobs.md b/translations/es-ES/content/rest/actions/workflow-jobs.md index f6221e2005d8..42ef772cb9f0 100644 --- a/translations/es-ES/content/rest/actions/workflow-jobs.md +++ b/translations/es-ES/content/rest/actions/workflow-jobs.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-jobs %} Para obtener más información, consulta la sección "[Sintaxis de flujode trabajo para GitHub Actions](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)". +## About the Workflow jobs API + +The Workflow jobs API allows you to view logs and workflow jobs. {% data reusables.actions.about-workflow-jobs %} Para obtener más información, consulta la sección "[Sintaxis de flujode trabajo para GitHub Actions](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)". {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/es-ES/content/rest/actions/workflow-runs.md b/translations/es-ES/content/rest/actions/workflow-runs.md index 3fca12a420d1..832659840092 100644 --- a/translations/es-ES/content/rest/actions/workflow-runs.md +++ b/translations/es-ES/content/rest/actions/workflow-runs.md @@ -1,6 +1,6 @@ --- -title: Workflow runs -intro: 'The Workflow Runs API allows you to view, re-run, cancel, and view logs for workflow runs.' +title: Ejecuciones de flujo de trabajo +intro: 'The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs.' topics: - API versions: @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-runs %} For more information, see "[Managing a workflow run](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)." +## About the Workflow runs API -{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} \ No newline at end of file +The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs. {% data reusables.actions.about-workflow-runs %} Para obtener más información, consulta la sección "[Administrar una ejecución de flujo de trabajo](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)". + +{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/es-ES/content/rest/actions/workflows.md b/translations/es-ES/content/rest/actions/workflows.md index c188369749ad..49f5713cfa80 100644 --- a/translations/es-ES/content/rest/actions/workflows.md +++ b/translations/es-ES/content/rest/actions/workflows.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflows %} Para obtener más información, consulta la sección "[Automatizar tu flujo de trabajo con GitHub Actions](/actions/automating-your-workflow-with-github-actions)". +## About the Workflows API + +La API de flujos de trabajo te permite ver los flujos de trabajo de un repositorio. {% data reusables.actions.about-workflows %} Para obtener más información, consulta la sección "[Automatizar tu flujo de trabajo con GitHub Actions](/actions/automating-your-workflow-with-github-actions)". {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/es-ES/content/rest/activity/feeds.md b/translations/es-ES/content/rest/activity/feeds.md index a186e9531804..943608927a63 100644 --- a/translations/es-ES/content/rest/activity/feeds.md +++ b/translations/es-ES/content/rest/activity/feeds.md @@ -11,9 +11,13 @@ topics: miniTocMaxHeadingLevel: 3 --- -### Example of getting an Atom feed +## About the Feeds API -To get a feed in Atom format, you must specify the `application/atom+xml` type in the `Accept` header. For example, to get the Atom feed for GitHub security advisories: +To see what feeds are available to you, use the [Get feeds](#get-feeds) operation. You can then get a feed by sending a request to one of the feed URLs. + +### Ejemplo de obtención de un canal de Atom + +Para obtener un canal en formato de Atom, debes especificar el tipo `application/atom+xml` en el encabezado `Accept`. Por ejemplo, para obtener un canal de Atom para las asesorías de seguridad de GitHub: curl -H "Accept: application/atom+xml" https://github.com/security-advisories diff --git a/translations/es-ES/content/rest/activity/notifications.md b/translations/es-ES/content/rest/activity/notifications.md index dc8143e45b7d..480deea8283b 100644 --- a/translations/es-ES/content/rest/activity/notifications.md +++ b/translations/es-ES/content/rest/activity/notifications.md @@ -1,6 +1,6 @@ --- title: Notificaciones -intro: '' +intro: 'The Notifications API lets you manage {% data variables.product.product_name %} notifications.' versions: fpt: '*' ghes: '*' @@ -11,18 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -Los usuarios reciben notificaciones para las conversaciones en los repositorios que observan, incluyendo: +## About the Notifications API -* Las de los informes de problemas y sus comentarios -* Las de las solicitudes de extracción en sus comentarios -* Las de los comentarios en cualquier confirmación - -También se envían notificaciones para las conversaciones en los repositorios sin observar cuando el usuario está involucrado, incluyendo: - -* **@menciones** -* Asignaciones de informes de problemas -* Confirmaciones que confirme o cree el usuario -* Cualquier debate en el que el usuario participe activamente +The Notifications API lets you manage {% data variables.product.product_name %} notifications. For more information about notifications, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." Todas las llamadas de la API para notificaciones necesitan los alcances de la API para `notifications` o `repo`. El hacerlo te dará acceso de solo lectura a algunos contenidos de informes de problemas y de confirmaciones. Aún necesitarás el alcance de `repo` para acceder a los informes de problemas y a las confirmaciones desde sus respectivas terminales. @@ -44,11 +35,11 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" > X-Poll-Interval: 60 ``` -### Razones para obtener las notificaciones +### About notification reasons Cuando recuperas respuestas de la API de Notificaciones, cada carga útil tiene una clave que se titula `reason`. Estas corresponden a los eventos que activan una notificación. -Hay una lista potencial de `reason` para recibir una notificación: +These are the potential `reason`s for receiving a notification: | Nombre de la razón | Descripción | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/translations/es-ES/content/rest/activity/starring.md b/translations/es-ES/content/rest/activity/starring.md index 8e33fc3bdd8c..d904995cb3cd 100644 --- a/translations/es-ES/content/rest/activity/starring.md +++ b/translations/es-ES/content/rest/activity/starring.md @@ -1,6 +1,6 @@ --- title: Marcar con una estrella -intro: El marcar a los repositorios con una estrella es una característica que permite a los usuarios marcar a los repositorios como favoritos. +intro: The Starring API lets you bookmark a repository. versions: fpt: '*' ghes: '*' @@ -11,7 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -Las estrellas se muestran junto a los repositorios para denotar un nivel aproximado de interés. Las estrellas no tienen efecto alguno en las notificaciones o en los canales de actividad. +## About the Starring API + +The Starring API lets you bookmark a repository. Las estrellas se muestran junto a los repositorios para denotar un nivel aproximado de interés. Las estrellas no tienen efecto alguno en las notificaciones o en los canales de actividad. Para obtener más información, consulta la sección "[Guardar repositorios con estrellas](/get-started/exploring-projects-on-github/saving-repositories-with-stars)". ### Marcar con estrella vs. Observar diff --git a/translations/es-ES/content/rest/activity/watching.md b/translations/es-ES/content/rest/activity/watching.md index cdd6b09154e5..deec238e6ab3 100644 --- a/translations/es-ES/content/rest/activity/watching.md +++ b/translations/es-ES/content/rest/activity/watching.md @@ -1,6 +1,6 @@ --- title: Observar -intro: 'Observar un repositorio registra al usuario para recibir notificaciones en debates nuevos, así como en los eventos de los canales de actividad del mismo.' +intro: The Watching API lets users subscribe to notifications for activity in a repository. versions: fpt: '*' ghes: '*' @@ -11,4 +11,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -Para marcar a un repositorio como favorito de forma sencilla, consulta la sección "[Marcar repositorios con una estrella](/rest/reference/activity#starring)". +## About the Watching API + +The Watching API lets users subscribe to notifications for activity in a repository. To bookmark a repository instead, see "[Starring](/rest/reference/activity#starring)." diff --git a/translations/es-ES/content/rest/billing.md b/translations/es-ES/content/rest/billing.md index 5ca80fbda783..63b073c033d0 100644 --- a/translations/es-ES/content/rest/billing.md +++ b/translations/es-ES/content/rest/billing.md @@ -1,6 +1,6 @@ --- title: Facturación -intro: '' +intro: The Billing API lets you get billing information for an enterprise. topics: - API miniTocMaxHeadingLevel: 3 @@ -12,4 +12,6 @@ redirect_from: - /rest/reference/billing --- +## About the Billing API + Puedes obtener información de facturación para una empresa. Para obtener más información, consulta la API de REST para la "[ Administración de {% data variables.product.prodname_dotcom %} Enterprise](/rest/reference/enterprise-admin#billing)". diff --git a/translations/es-ES/content/rest/code-scanning.md b/translations/es-ES/content/rest/code-scanning.md index e395b5dd1ca4..01f567ab2790 100644 --- a/translations/es-ES/content/rest/code-scanning.md +++ b/translations/es-ES/content/rest/code-scanning.md @@ -1,6 +1,6 @@ --- title: Code Scanning -intro: '' +intro: 'La API del {% data variables.product.prodname_code_scanning %} te permite recuperar y actualizar las alertas del {% data variables.product.prodname_code_scanning %} desde un repositorio.' versions: fpt: '*' ghes: '*' @@ -17,6 +17,8 @@ redirect_from: {% data reusables.code-scanning.beta %} +## About the Code scanning API + La API del {% data variables.product.prodname_code_scanning %} te permite recuperar y actualizar las alertas del {% data variables.product.prodname_code_scanning %} desde un repositorio. Puedes utilizar las terminales para crear reportes automatizados para las alertas del {% data variables.product.prodname_code_scanning %} en una organización o cargar resutlados de análisis que se hayan generado utilizando con herramientas fuera de línea del {% data variables.product.prodname_code_scanning %}. Para obtener más información, consulta la sección "[Encontrar vulnerabilidades de seguridad y errores en tu código](/github/finding-security-vulnerabilities-and-errors-in-your-code)". {% ifversion fpt or ghes > 3.0 or ghae or ghec %} diff --git a/translations/es-ES/content/rest/codes-of-conduct.md b/translations/es-ES/content/rest/codes-of-conduct.md index 5e2f4926bf27..0ec0367018c5 100644 --- a/translations/es-ES/content/rest/codes-of-conduct.md +++ b/translations/es-ES/content/rest/codes-of-conduct.md @@ -1,6 +1,6 @@ --- -title: Codes of Conduct -intro: '' +title: Códigos de conducta +intro: The Codes of conduct API lets you retrieve information about a repository's code of conduct. versions: fpt: '*' ghes: '*' @@ -13,4 +13,6 @@ redirect_from: - /rest/reference/codes-of-conduct --- -Puedes usar la API de Códigos de Conducta para recuperar la información acerca del código de conducta de un repositorio. Para obtener el código de conducta de un repositorio, utiliza la terminal "[Obtener un repositorio](/rest/reference/repos#get-a-repository)". +## About the Codes of conduct API + +Puedes usar la API de Códigos de Conducta para recuperar la información acerca del código de conducta de un repositorio. To get a code of conduct for a repository, use the "[Get a repository](/rest/reference/repos#get-a-repository)" endpoint. diff --git a/translations/es-ES/content/rest/commits/comments.md b/translations/es-ES/content/rest/commits/comments.md index 16261dcded1c..c835d09e766b 100644 --- a/translations/es-ES/content/rest/commits/comments.md +++ b/translations/es-ES/content/rest/commits/comments.md @@ -1,6 +1,6 @@ --- title: Comentarios sobre confirmación de cambios -intro: '' +intro: The Commit comments API lets you create and edit comments that relate to specific commits. versions: fpt: '*' ghes: '*' @@ -12,6 +12,10 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- +## About the commit comments API + +The Commit comments API lets you create and edit comments that relate to specific commits. + ### Tipos de medios personalizados para los comentarios de las confirmaciones Estos son los tipos de medios compatibles para los comentarios de las confirmaciones. Puedes leer más sobre el uso de tipos de medios en la API [aquí](/rest/overview/media-types). diff --git a/translations/es-ES/content/rest/commits/statuses.md b/translations/es-ES/content/rest/commits/statuses.md index 81bef9df71ee..2c4174c59380 100644 --- a/translations/es-ES/content/rest/commits/statuses.md +++ b/translations/es-ES/content/rest/commits/statuses.md @@ -1,6 +1,6 @@ --- title: Estados de confirmación -intro: 'The status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits.' +intro: 'The Commit status API allows external services to mark commits with a status, which is then reflected in pull requests involving those commits.' versions: fpt: '*' ghes: '*' @@ -12,7 +12,9 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. +## About the Commit statuses API + +The Commit status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits. Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. As an example, one common use is for continuous integration services to mark commits as passing or failing builds using status. The `target_url` would be the full URL to the build output, and the `description` would be the high level summary of what happened with the build. diff --git a/translations/es-ES/content/rest/dependabot/secrets.md b/translations/es-ES/content/rest/dependabot/secrets.md index c947b21daf83..ce89fb3d751a 100644 --- a/translations/es-ES/content/rest/dependabot/secrets.md +++ b/translations/es-ES/content/rest/dependabot/secrets.md @@ -1,6 +1,7 @@ --- -title: Secretos -intro: 'Con la API de secretos del Dependabot, puedes administrar y controlar los secretos del Dependabot para una organización o repositorio.' +title: Dependabot secrets +shortTitle: Secretos +intro: 'With the {% data variables.product.prodname_dependabot %} secrets API, you can manage and control {% data variables.product.prodname_dependabot %} secrets for an organization or repository.' topics: - API versions: @@ -10,6 +11,8 @@ versions: allowTitleToDifferFromFilename: true --- -The {% data variables.product.prodname_dependabot %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} Para obtener más información, consulta "[Administrar los secretos cifrados para el Dependabot](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)". +## About the {% data variables.product.prodname_dependabot %} secrets API + +The {% data variables.product.prodname_dependabot %} secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} Para obtener más información, consulta "[Administrar los secretos cifrados para el Dependabot](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)". {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} must have the `dependabot_secrets` permission to use this API. Los usuarios autenticados deben tener acceso de colaborador en el repositorio para crear, actualizar o leer los secretos. diff --git a/translations/es-ES/content/rest/dependency-graph/dependency-review.md b/translations/es-ES/content/rest/dependency-graph/dependency-review.md index 96520c972227..c9602dc122ec 100644 --- a/translations/es-ES/content/rest/dependency-graph/dependency-review.md +++ b/translations/es-ES/content/rest/dependency-graph/dependency-review.md @@ -1,6 +1,6 @@ --- title: Revisión de dependencias -intro: 'The Dependency Review API allows you to understand dependency changes, and the security impact of these changes, before you add them to your environment.' +intro: 'The Dependency review API allows you to understand dependency changes, and the security impact of these changes, before you add them to your environment.' versions: fpt: '*' ghes: '>=3.6' @@ -12,7 +12,7 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -## Revisión de dependencias +## About the Dependency review API {% data reusables.dependency-review.dependency-review-api-beta-note %} diff --git a/translations/es-ES/content/rest/deploy-keys.md b/translations/es-ES/content/rest/deploy-keys.md index 5aff3dfaa8d0..f122272922af 100644 --- a/translations/es-ES/content/rest/deploy-keys.md +++ b/translations/es-ES/content/rest/deploy-keys.md @@ -1,6 +1,6 @@ --- -title: Deploy Keys -intro: '' +title: Llaves de implementación +intro: The Deploy keys API lets you create and manage deploy keys. versions: fpt: '*' ghes: '*' @@ -14,6 +14,8 @@ redirect_from: - /rest/reference/deploy_keys --- +## About the Deploy keys API + {% data reusables.repositories.deploy-keys %} Las llaves de despliegue pueden ya sea configurarse utilizando las siguientes terminales de la API, o mediante GitHub. Para aprender cómo configurar las llaves de despliegue en GitHub, consulta la sección "[Administrar las llaves de despliegue](/developers/overview/managing-deploy-keys)". diff --git a/translations/es-ES/content/rest/gists/comments.md b/translations/es-ES/content/rest/gists/comments.md index 1cc8c6c475be..c8f7fedd5633 100644 --- a/translations/es-ES/content/rest/gists/comments.md +++ b/translations/es-ES/content/rest/gists/comments.md @@ -1,6 +1,8 @@ --- -title: Comentarios -intro: '' +title: Gist comments +allowTitleToDifferFromFilename: true +shortTitle: Comentarios +intro: The Gist comments API lets you view and modify comments on a gist. versions: fpt: '*' ghes: '*' @@ -11,6 +13,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gist comments API + +The Gist comments API lets you view and modify comments on a gist. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### Tipos de medios personalizados para los comentarios de los Gists Estos son los tipos de medios compatibles para los comentarios de los gists. diff --git a/translations/es-ES/content/rest/gists/gists.md b/translations/es-ES/content/rest/gists/gists.md index fb3563f435af..37dd44d71503 100644 --- a/translations/es-ES/content/rest/gists/gists.md +++ b/translations/es-ES/content/rest/gists/gists.md @@ -11,6 +11,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gists API + +The Gist API lets you view and modify gists. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### Autenticación Puedes leer gists públicos {% ifversion ghae or ghes %}y crearlos para usuarios anónimos sin un token{% else %} de forma anónima, pero debes haber iniciado sesión en GitHub para crear gists.{% endif %} Para leer o escribir gists en nombre de un usuario, necesitas el alcance de OAuth para gists y un token. Par aobtener más información, consulta la sección "[Alcances para las Apps de OAuth](/developers/apps/scopes-for-oauth-apps)". diff --git a/translations/es-ES/content/rest/git/blobs.md b/translations/es-ES/content/rest/git/blobs.md index acec7a602d12..d71ecb60fa5c 100644 --- a/translations/es-ES/content/rest/git/blobs.md +++ b/translations/es-ES/content/rest/git/blobs.md @@ -1,6 +1,8 @@ --- -title: Blobs -intro: 'Un blob (objeto binario grande, por sus siglas en inglés) de Git es el tipo de objeto que se utiliza para almacenar el contenido de cada archivo en un repositorio.' +title: Git blobs +shortTitle: Blobs +allowTitleToDifferFromFilename: true +intro: 'The Git blob API lets you create and get a Git blob (binary large object), the object type used to store the contents of each file in a repository.' versions: fpt: '*' ghes: '*' @@ -11,7 +13,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -El hash SHA-1 del archivo se calcula y almacena en el objeto del blob. Estas terminales te permiten leer y escribir [objetos de blob](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects) en tu base de datos de Git en {% data variables.product.product_name %}. Los blobs aprovechan [estos tipos de medios personalizados](#custom-media-types-for-blobs). Puedes leer más acerca del uso de tipos de medios en la API [aquí](/rest/overview/media-types). +## About the Git blob API + +Un blob (objeto binario grande, por sus siglas en inglés) de Git es el tipo de objeto que se utiliza para almacenar el contenido de cada archivo en un repositorio. El hash SHA-1 del archivo se calcula y almacena en el objeto del blob. Estas terminales te permiten leer y escribir [objetos de blob](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects) en tu base de datos de Git en {% data variables.product.product_name %}. Los blobs aprovechan [estos tipos de medios personalizados](#custom-media-types-for-blobs). Puedes leer más acerca del uso de tipos de medios en la API [aquí](/rest/overview/media-types). ### Tipos de medios personalizados para los blobs diff --git a/translations/es-ES/content/rest/git/commits.md b/translations/es-ES/content/rest/git/commits.md index 41277f467b64..8528c14dfed9 100644 --- a/translations/es-ES/content/rest/git/commits.md +++ b/translations/es-ES/content/rest/git/commits.md @@ -1,6 +1,8 @@ --- -title: Confirmaciones -intro: 'A Git commit is a snapshot of the hierarchy ([Git tree](/rest/reference/git#trees)) and the contents of the files ([Git blob](/rest/reference/git#blobs)) in a Git repository.' +title: Git commits +shortTitle: Confirmaciones +allowTitleToDifferFromFilename: true +intro: 'The Git commits API lets you read and write commit objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}. +## About the Git commits API + +Una confirmación de Git es una impresión de pantalla de la jerarquía ([árbol de Git](/rest/reference/git#trees)) y del contenido de los archivos ([blob de Git](/rest/reference/git#blobs)) en un reposiotorio de Git. These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}. diff --git a/translations/es-ES/content/rest/git/refs.md b/translations/es-ES/content/rest/git/refs.md index 8dc668057b89..c38b8f391e45 100644 --- a/translations/es-ES/content/rest/git/refs.md +++ b/translations/es-ES/content/rest/git/refs.md @@ -1,6 +1,7 @@ --- -title: Referencias -intro: A Git reference (`git ref`) is just a file that contains a Git commit SHA-1 hash. +title: Git references +shortTitle: Referencias +intro: 'The Git references API lets you read and write references to your Git database on {% data variables.product.product_name %}' versions: fpt: '*' ghes: '*' @@ -12,4 +13,6 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is just a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}. +## About the Git references API + +A Git reference (`git ref`) is a file that contains a Git commit SHA-1 hash. When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}. diff --git a/translations/es-ES/content/rest/git/tags.md b/translations/es-ES/content/rest/git/tags.md index edd355b2f17c..23b43248c775 100644 --- a/translations/es-ES/content/rest/git/tags.md +++ b/translations/es-ES/content/rest/git/tags.md @@ -1,6 +1,8 @@ --- -title: Etiquetas -intro: 'A Git tag is similar to a [Git reference](/rest/reference/git#refs), but the Git commit that it points to never changes.' +title: Git tags +shortTitle: Etiquetas +allowTitleToDifferFromFilename: true +intro: 'The Git tags API lets you read and write tag objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -Las etiquetas de git son útiles cuando quieres apuntar a algún lanzamiento específico. Estas terminales te permiten leer y escribir [objetos de etiquetas](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)en tu base de datos de Git en {% data variables.product.product_name %}. La API de etiquetas de Git son compatibles únicamente con los [objetos de etiqueta anotados](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), no con etiquetas ligeras. +## About the Git tags API + +Una etiqueta de git es similar a una [referencia de Git](/rest/reference/git#refs), pero la confirmación de Git a la que apunta jamás cambia. Las etiquetas de git son útiles cuando quieres apuntar a algún lanzamiento específico. Estas terminales te permiten leer y escribir [objetos de etiquetas](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)en tu base de datos de Git en {% data variables.product.product_name %}. La API de etiquetas de Git son compatibles únicamente con los [objetos de etiqueta anotados](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), no con etiquetas ligeras. diff --git a/translations/es-ES/content/rest/git/trees.md b/translations/es-ES/content/rest/git/trees.md index 9ff78569ff3e..81026177e5c3 100644 --- a/translations/es-ES/content/rest/git/trees.md +++ b/translations/es-ES/content/rest/git/trees.md @@ -1,6 +1,8 @@ --- -title: Árboles -intro: Un objeto de árbol de Git crea la jerarquía entre archivos para un repositorio de Git. +title: Git trees +shortTitle: Árboles +allowTitleToDifferFromFilename: true +intro: 'The Git trees API lets you read and write tree objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -Puedes utilizar el objeto de árbol de Git para crear una relación entre directorios y entre los archivos que contienen. Estas terminales te permiten leer y escribir [objetos de árbol](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)en tu base de datos de Git en {% data variables.product.product_name %}. +## About the Git trees API + +Un objeto de árbol de Git crea la jerarquía entre archivos para un repositorio de Git. Puedes utilizar el objeto de árbol de Git para crear una relación entre directorios y entre los archivos que contienen. Estas terminales te permiten leer y escribir [objetos de árbol](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)en tu base de datos de Git en {% data variables.product.product_name %}. diff --git a/translations/es-ES/content/rest/gitignore.md b/translations/es-ES/content/rest/gitignore.md index f7dcdcd3c30a..b8eeb69e0f44 100644 --- a/translations/es-ES/content/rest/gitignore.md +++ b/translations/es-ES/content/rest/gitignore.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/gitignore --- +## About the Gitignore API + Cuando creas un repositorio nuevo en {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} a través de la API, puedes especificar una [plantilla de.gitignore](/github/getting-started-with-github/ignoring-files) para aplicarla al repositorio cuando lo crees. La API de plantillas de .gitignore lista y recupera plantillas del [repositorio de .gitignore](https://github.com/github/gitignore) de {% data variables.product.product_name %}. ### Tipos de medios personalizados para gitignore diff --git a/translations/es-ES/content/rest/licenses.md b/translations/es-ES/content/rest/licenses.md index 59743e567c08..4f8775d2161a 100644 --- a/translations/es-ES/content/rest/licenses.md +++ b/translations/es-ES/content/rest/licenses.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/licenses --- +## About the Licenses API + La API de licencias utiliza [el Licenciatario de código abierto de la Gema de Ruby ](https://github.com/benbalter/licensee) para intentar identificar la licencia del proyecto. Este licenciatario empata el contenido del archivo de `LICENSE` de un proyecto (si es que existe) contra una lista corta de licencias conocidas. Como resultado, la API no toma en cuenta las licencias de las dependencias del proyecto u otros medios de documentar la licencia de un proyecto tales como las referencias al nombre de la licencia en la documentación. Si una licencia empata, la llave de licencia y el nombre devuelto se apegan a la [especificación SPDX](https://spdx.org/). diff --git a/translations/es-ES/content/rest/oauth-authorizations.md b/translations/es-ES/content/rest/oauth-authorizations.md index 275c5b4379e8..2b18102a4d87 100644 --- a/translations/es-ES/content/rest/oauth-authorizations.md +++ b/translations/es-ES/content/rest/oauth-authorizations.md @@ -1,6 +1,6 @@ --- -title: Autorizaciones de OAuth -intro: La API de Migraciones solo está disponible para los propietarios autenticados de la organización. +title: OAuth authorizations +intro: The OAuth authorizations lets you manage the access OAuth applications have to your account. versions: fpt: '*' ghec: '*' @@ -12,6 +12,8 @@ redirect_from: - /rest/reference/oauth-authorizations --- +## About the OAuth authorizations API + Puedes utilizar esta API para administrar el acceso que las aplicaciones de OAuth tienen en tu cuenta. Solo puedes acceder a esta API a través de la [Autenticación Básica](/rest/overview/other-authentication-methods#basic-authentication) utilizando tu nombre de usuario y contraseña, y no los tokens. Si tú o tus usuarios habilitaron la autenticación de dos factores, asegúrate de que entiendes cómo [trabajar con la autenticación de dos factores](/rest/overview/other-authentication-methods#working-with-two-factor-authentication). diff --git a/translations/es-ES/content/rest/packages.md b/translations/es-ES/content/rest/packages.md index 97cc2d5bc060..2aed3772cece 100644 --- a/translations/es-ES/content/rest/packages.md +++ b/translations/es-ES/content/rest/packages.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/packages --- +## About the {% data variables.product.prodname_registry %} API + La API de {% data variables.product.prodname_registry %} te habilita para administrar paquetes utilizando la API de REST.{% ifversion fpt or ghec or ghes > 3.1 or ghae %} Para aprender más sobre cómo restablecer o borrar paquetes, consulta la sección "[restablecer y borrar paquetes](/packages/learn-github-packages/deleting-and-restoring-a-package)".{% endif %} Para utilizar esta API, primero tienes que autenticarte utilizando un token de acceso personal. diff --git a/translations/es-ES/content/rest/rate-limit.md b/translations/es-ES/content/rest/rate-limit.md index 88a47c21f328..a1637ea55e95 100644 --- a/translations/es-ES/content/rest/rate-limit.md +++ b/translations/es-ES/content/rest/rate-limit.md @@ -1,6 +1,6 @@ --- title: Limite de tasa -intro: 'Con la API de Límite de Tasa, puedes verificar el estado de límite de tasa actual para varias API de REST.' +intro: 'With the Rate limit API, you can check the current rate limit status of various REST APIs.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/rate-limit --- +## About the Rate limit API + La documentación general de la API de REST describe las [reglas de los límites de tasa](/rest/overview/resources-in-the-rest-api#rate-limiting). Puedes revisar tu estado actual de límite de tasa en cualquier momento utilizando la API de Límites de Tasa que se describe a continuación. ### Entender el estado de tu límite de tasa diff --git a/translations/es-ES/content/rest/reactions.md b/translations/es-ES/content/rest/reactions.md index f038ec28b217..45452535015d 100644 --- a/translations/es-ES/content/rest/reactions.md +++ b/translations/es-ES/content/rest/reactions.md @@ -13,8 +13,8 @@ redirect_from: - /rest/reference/reactions --- -### Reaction types +## About the Reactions API -When creating a reaction, the allowed values for the `content` parameter are as follows (with the corresponding emoji for reference): +You can create and manage reactions on comments using the Reactions API. Cuando creas una reacción, los valores permitidos para el parámetro `content` son los siguientes (con el emoji correspondiente como referencia): {% data reusables.repositories.reaction_list %} diff --git a/translations/es-ES/content/rest/scim.md b/translations/es-ES/content/rest/scim.md index 23403640ffe8..42adef46bd19 100644 --- a/translations/es-ES/content/rest/scim.md +++ b/translations/es-ES/content/rest/scim.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/scim --- +## About the SCIM API + ### Aprovisionamiento de SCIM para las Organizaciones Los proveedores de identidad (IdP) habilitados para SCIM utilizan la API de SCIM para automatizar el aprovisionamiento de la membrecía de las organizaciones de {% data variables.product.product_name %}. La API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} se basa en la versión 2.0 del [SCIM estándar](http://www.simplecloud.info/). La terminal de SCIM de {% data variables.product.product_name %} que deben utilizar los IdP es: `{% data variables.product.api_url_code %}/scim/v2/organizations/{org}/`. @@ -18,7 +20,7 @@ Los proveedores de identidad (IdP) habilitados para SCIM utilizan la API de SCIM {% note %} **Notas:** - - The SCIM API is available only for individual organizations that use [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) with [SAML SSO](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) enabled. For more information about SCIM, see "[About SCIM for organizations](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)." + - The SCIM API is available only for individual organizations that use [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) with [SAML SSO](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) enabled. Para obtener más información sobre SCIM, consulta la sección "[Acerca de SCIM para las organizaciones](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)". - The SCIM API cannot be used with an enterprise account or with an {% data variables.product.prodname_emu_org %}. {% endnote %} diff --git a/translations/es-ES/content/rest/search.md b/translations/es-ES/content/rest/search.md index be1e53e41087..beb638a1a21c 100644 --- a/translations/es-ES/content/rest/search.md +++ b/translations/es-ES/content/rest/search.md @@ -1,6 +1,6 @@ --- title: Buscar -intro: The GitHub Search API lets you to search for the specific item efficiently. +intro: 'The Search API lets you to search for specific items on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/search --- +## About the Search API + La API de Búsqueda te ayuda a buscar el elemento específico que quieres encontrar. Por ejemplo, puedes buscar un usuario o un archivo específico en el repositorio. Tómalo como el simil de realizar una búsqueda en Google. Se diseñó para ayudarte a encontrar el resultado exacto que estás buscando (o tal vez algunos de los resultados que buscas). Tal como la búsqueda en Google, a veces quieres ver algunas páginas de los resultados de búsqueda para que puedas encontrar el elemento que mejor satisfaga tus necesidades. Para satisfacer esta necesidad, la API de Búsqueda de {% data variables.product.product_name %} proporciona **hasta 1,000 resultados por búsqueda**. Puedes delimitar tu búsqueda utilizando consultas. Para aprender más sobre la sintaxis de las consultas de búsqueda, dirígete a "[Construir una consulta de búsqueda](/rest/reference/search#constructing-a-search-query)". diff --git a/translations/es-ES/content/rest/secret-scanning.md b/translations/es-ES/content/rest/secret-scanning.md index 6847e3f95d4a..f6052ce44a24 100644 --- a/translations/es-ES/content/rest/secret-scanning.md +++ b/translations/es-ES/content/rest/secret-scanning.md @@ -1,6 +1,6 @@ --- -title: Secret Scanning -intro: Use the Secret Scanning API to retrieve and update secret alerts from a repository. +title: Escaneo de secretos +intro: Use the Secret scanning API to retrieve and update secret alerts from a repository. versions: ghes: '*' ghae: '*' @@ -14,6 +14,8 @@ redirect_from: {% data reusables.secret-scanning.api-beta %} +## About the Secret scanning API + La API del {% data variables.product.prodname_secret_scanning %} te permite {% ifversion fpt or ghec or ghes > 3.1 or ghae %}: - Enable or disable {% data variables.product.prodname_secret_scanning %}{% if secret-scanning-push-protection %} and push protection{% endif %} for a repository. Para obtener más información, consulta la sección "[Repositorios](/rest/reference/repos#update-a-repository)" y expande la sección de "Propiedades del objeto `security_and_analysis`" en la documentación de la API de REST. diff --git a/translations/es-ES/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml b/translations/es-ES/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml index 7d8bb703555f..02961dba8300 100644 --- a/translations/es-ES/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml +++ b/translations/es-ES/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml @@ -21,13 +21,6 @@ upcoming_changes: date: '2020-01-01T00:00:00+00:00' criticality: breaking owner: tambling - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros pendientes consumen una licencia - date: '2020-07-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: Issue.timeline description: 'Se eliminará a `timeline`. Utiliza Issue.timelineItems en sustitución.' @@ -42,20 +35,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: breaking owner: mikesea - - - location: EnterpriseMemberEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los colaboradores externos consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: 'El `DRAFT` se eliminará. Utiliza PullRequest.isDraft en su lugar.' diff --git a/translations/es-ES/data/graphql/ghec/graphql_upcoming_changes.public.yml b/translations/es-ES/data/graphql/ghec/graphql_upcoming_changes.public.yml index 489c287176cd..1a6182b8eb16 100644 --- a/translations/es-ES/data/graphql/ghec/graphql_upcoming_changes.public.yml +++ b/translations/es-ES/data/graphql/ghec/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: breaking owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros pendientes consumen una licencia - date: '2020-07-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: Issue.timeline description: 'Se eliminará a `timeline`. Utiliza Issue.timelineItems en sustitución.' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: breaking owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los colaboradores externos consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: 'El `DRAFT` se eliminará. Utiliza PullRequest.isDraft en su lugar.' diff --git a/translations/es-ES/data/graphql/graphql_upcoming_changes.public.yml b/translations/es-ES/data/graphql/graphql_upcoming_changes.public.yml index 489c287176cd..1a6182b8eb16 100644 --- a/translations/es-ES/data/graphql/graphql_upcoming_changes.public.yml +++ b/translations/es-ES/data/graphql/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: breaking owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros pendientes consumen una licencia - date: '2020-07-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: Issue.timeline description: 'Se eliminará a `timeline`. Utiliza Issue.timelineItems en sustitución.' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: breaking owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los miembros consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: 'Se eliminará a `isUnlicensed`.' - reason: Todos los colaboradores externos consumen una licencia - date: '2021-01-01T00:00:00+00:00' - criticality: breaking - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: 'El `DRAFT` se eliminará. Utiliza PullRequest.isDraft en su lugar.' diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md index 09abfdc4b052..382361acd9f7 100644 --- a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ b/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md @@ -50,7 +50,7 @@ CircleCIと{% data variables.product.prodname_actions %}は、どちらも似た CircleCIと{% data variables.product.prodname_actions %}は、どちらもワークフロー中のタスクを再利用し、共有するための仕組みを提供しています。 CircleCIはorbsという概念を利用します。これはYAMLで書かれ、ワークフロー中で再利用できるタスクを提供します。 {% data variables.product.prodname_actions %}はアクションと呼ばれる強力で柔軟な再利用できるコンポーネントを持っており、これはJavaScriptファイルもしくはDockerイメージで構築できます。 {% data variables.product.product_name %} の API やパブリックに利用可能なサードパーティ API との統合など、リポジトリと相互作用するカスタムコードを書いてアクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急のIssueが発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 詳細については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 -CircleCIは、YAMLのアンカーとエイリアスでワークフローの部分を再利用できます。 {% data variables.product.prodname_actions %} supports the most common need for reusability using matrices. For more information about matrices, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)." +CircleCIは、YAMLのアンカーとエイリアスでワークフローの部分を再利用できます。 {% data variables.product.prodname_actions %} supports the most common need for reusability using matrices. マトリクスに関する詳しい情報については「[ジョブでのマトリクスの利用](/actions/using-jobs/using-a-matrix-for-your-jobs)」を参照してください。 ## Dockerイメージの利用 diff --git a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md index bfe243d739ba..a8a4b67b069a 100644 --- a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md +++ b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md @@ -68,7 +68,7 @@ topics: - {% data variables.product.prodname_code_scanning %} ワークフローから `autobuild` ステップを削除し、特定のビルドステップを追加します。 ワークフローの編集に関する詳しい情報は、「[{% data variables.product.prodname_code_scanning %} を設定する](/code-security/secure-coding/configuring-code-scanning#editing-a-code-scanning-workflow)」を参照してください。 `autobuild` ステップの置き換えに関する詳細は、「[コンパイル型言語の {% data variables.product.prodname_codeql %} ワークフローを設定する](/code-security/secure-coding/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)」を参照してください。 -- ワークフローが解析する言語を明示的に指定していない場合、{% data variables.product.prodname_codeql %} はコードベースでサポートされている言語を暗黙的に検出します。 この設定では、コンパイル型言語である C/C++、C#、Java のうち、{% data variables.product.prodname_codeql %} はソースファイルの数が最も多い言語のみを解析します。 Edit the workflow and add a matrix specifying the languages you want to analyze. デフォルトの CodeQL 解析では、こうしたマトリクスを使用しています。 +- ワークフローが解析する言語を明示的に指定していない場合、{% data variables.product.prodname_codeql %} はコードベースでサポートされている言語を暗黙的に検出します。 この設定では、コンパイル型言語である C/C++、C#、Java のうち、{% data variables.product.prodname_codeql %} はソースファイルの数が最も多い言語のみを解析します。 ワークフローを編集し、解析する言語を指定したマトリクスを追加してください。 デフォルトの CodeQL 解析では、こうしたマトリクスを使用しています。 以下はワークフローからの抜粋で、まず言語を指定するジョブ戦略におけるマトリクスの使用法を示し、次に「Initialize {% data variables.product.prodname_codeql %}」のステップで各言語を参照しています。 @@ -188,7 +188,7 @@ C/C++、C#、Go、Javaなどのコンパイル言語については、{% data va ### マトリックスビルドを使用して分析を並列化する -The default {% data variables.product.prodname_codeql_workflow %} uses a matrix of languages, which causes the analysis of each language to run in parallel. 「Initialize CodeQL」ステップで解析する言語を直接指定している場合、各言語の解析は順次行われます。 複数の言語で解析を高速化するには、マトリクスを使用するようワークフローを変更してください。 詳しい情報については、上記「[コンパイル言語の自動ビルドの失敗](#automatic-build-for-a-compiled-language-fails)」にあるワークフローの抜粋を参照してください。 +デフォルトの {% data variables.product.prodname_codeql_workflow %} は言語のマトリクスを使用しており、これにより各言語の解析が並列で実行される場合があります。 「Initialize CodeQL」ステップで解析する言語を直接指定している場合、各言語の解析は順次行われます。 複数の言語で解析を高速化するには、マトリクスを使用するようワークフローを変更してください。 詳しい情報については、上記「[コンパイル言語の自動ビルドの失敗](#automatic-build-for-a-compiled-language-fails)」にあるワークフローの抜粋を参照してください。 ### 1 つのワークフローで分析されるコードの量を減らす diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md b/translations/ja-JP/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md index 2cf90bd9901d..6063d726f1cb 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md @@ -59,7 +59,7 @@ topics: {% endnote %} -![Screenshot showing an alert with the "Vulnerable call" label](/assets/images/help/repository/dependabot-alerts-vulnerable-call-label.png) +!["Vulnerable call"ラベルの付いたアラート表示のスクリーンショット](/assets/images/help/repository/dependabot-alerts-vulnerable-call-label.png) 検索フィールドで`has:vulnerable-calls`フィルタを使い、少なくとも1つの脆弱性のある関数の呼び出しを{% data variables.product.prodname_dependabot %}が検出したところでだけアラートを表示するよう、ビューをフィルタリングできます。 @@ -68,7 +68,7 @@ topics: - 関数が使われている場所、もしくは複数の呼び出しがある場合には最初の呼び出しがあるコードブロック。 - 関数自体をリストしているアノテーション。関数が呼ばれている行へのリンク付きで。 -![Screenshot showing the alert details page for an alert with a "Vulnerable call" label](/assets/images/help/repository/review-calls-to-vulnerable-functions.png) +!["Vulnerable call"ラベルの付いたアラートのアラート詳細ページを表示しているスクリーンショット](/assets/images/help/repository/review-calls-to-vulnerable-functions.png) 詳しい情報については以下の「[脆弱性のある依存関係のレビューと修正](#reviewing-and-fixing-vulnerable-dependencies)」を参照してください。 @@ -80,7 +80,7 @@ topics: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-dependabot-alerts %} -1. あるいは、アラートをフィルタリングするには、**Repository（リポジトリ）**、**Package（パッケージ）**、**Ecosystem（エコシステム）**、**Manifest（マニフェスト）**ドロップダウンメニューを選択し、続いて適用したいフィルタをクリックしてください。 検索バーにフィルタを入力することもできます。 たとえば`ecosystem:npm`あるいは`has:patch`といったようにです。 アラートをソートするには**Sort（ソート）**ドロップダウンメニューを選択し、ソートに使いたい選択肢をクリックしてください。 ![Screenshot of the filter and sort menus in the {% data variables.product.prodname_dependabot_alerts %} tab](/assets/images/help/graphs/dependabot-alerts-filters.png) +1. あるいは、アラートをフィルタリングするには、**Repository（リポジトリ）**、**Package（パッケージ）**、**Ecosystem（エコシステム）**、**Manifest（マニフェスト）**ドロップダウンメニューを選択し、続いて適用したいフィルタをクリックしてください。 検索バーにフィルタを入力することもできます。 たとえば`ecosystem:npm`あるいは`has:patch`といったようにです。 アラートをソートするには**Sort（ソート）**ドロップダウンメニューを選択し、ソートに使いたい選択肢をクリックしてください。 ![{% data variables.product.prodname_dependabot_alerts %}タブ中のフィルタ及びソートメニューのスクリーンショット](/assets/images/help/graphs/dependabot-alerts-filters.png) 1. 表示したいアラートをクリックしてください。 ![アラートリストで選択されたアラート](/assets/images/help/graphs/click-alert-in-alerts-list-ungrouped.png) {% else %} @@ -100,18 +100,18 @@ topics: {% if dependabot-alerts-vulnerable-calls %} -For supported languages, {% data variables.product.prodname_dependabot %} detects calls to vulnerable functions for you. When you view an alert labeled as "Vulnerable call", the details include the name of the function and a link to the code that calls it. Often you will be able to take decisions based on this information, without exploring further. +サポートされている言語では、{% data variables.product.prodname_dependabot %}は脆弱性のある関数の呼び出しを検出してくれます。 "Vulnerable call（脆弱性のある呼び出し）"というラベルの付いたアラートを見ると、関数名とそれを呼び出しているコードへのリンクを含む詳細が含まれています。 多くの場合、それ以上調べることなくこの情報に基づいて判断を下すことができるでしょう。 {% endif %} -### Fixing vulnerable dependencies +### 脆弱性のある依存関係の修復 -1. View the details for an alert. For more information, see "[Viewing vulnerable dependencies](#viewing-vulnerable-dependencies)" (above). +1. アラートの詳細を表示させます。 詳しい情報については上の「[脆弱性のある依存関係の表示](#viewing-vulnerable-dependencies)」を参照してください。 {% ifversion fpt or ghec or ghes > 3.2 %} -1. If you have {% data variables.product.prodname_dependabot_security_updates %} enabled, there may be a link to a pull request that will fix the dependency. Alternatively, you can click **Create {% data variables.product.prodname_dependabot %} security update** at the top of the alert details page to create a pull request. ![{% data variables.product.prodname_dependabot %} セキュリティアップデートボタンを作成](/assets/images/help/repository/create-dependabot-security-update-button-ungrouped.png) -1. Optionally, if you do not use {% data variables.product.prodname_dependabot_security_updates %}, you can use the information on the page to decide which version of the dependency to upgrade to and create a pull request to update the dependency to a secure version. +1. {% data variables.product.prodname_dependabot_security_updates %}を有効にしているなら、その依存関係を修復するPull Requestへのリンクがあるかもしれません。 あるいは、アラートの詳細ページの上部にある**Create {% data variables.product.prodname_dependabot %} security update**をクリックして、Pull Requestを作成することもできます。 ![{% data variables.product.prodname_dependabot %} セキュリティアップデートボタンを作成](/assets/images/help/repository/create-dependabot-security-update-button-ungrouped.png) +1. あるいは、{% data variables.product.prodname_dependabot_security_updates %}を使っていないなら、ページにある情報を使ってアップグレードすべき依存関係のバージョンを判断し、セキュアなバージョンへ依存関係を更新するためのPull Requestを作成できます。 {% elsif ghes < 3.3 or ghae %} -1. You can use the information on the page to decide which version of the dependency to upgrade to and create a pull request to the manifest or lock file to a secure version. +1. ページ上のこの情報を使って、アップグレードすべき依存関係のバージョンを判断し、セキュアなバージョンへのマニフェストもしくはロックファイルへのPull Requestを作成できます。 {% endif %} 1. 依存関係を更新して脆弱性を解決する準備ができたら、プルリクエストをマージしてください。 @@ -119,22 +119,22 @@ For supported languages, {% data variables.product.prodname_dependabot %} detect {% data variables.product.prodname_dependabot %} によって発行される各プルリクエストには、{% data variables.product.prodname_dependabot %} の制御に使用できるコマンドの情報が含まれています。 詳しい情報については、「[依存関係の更新に関するプルリクエストを管理する](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-pull-requests-for-dependency-updates#managing-dependabot-pull-requests-with-comment-commands) 」を参照してください。 {% endif %} -### Dismissing {% data variables.product.prodname_dependabot_alerts %} +### {% data variables.product.prodname_dependabot_alerts %}の却下 -If you schedule extensive work to upgrade a dependency, or decide that an alert does not need to be fixed, you can dismiss the alert. Dismissing alerts that you have already assessed makes it easier to triage new alerts as they appear. +依存関係のアップグレードのための広汎な作業をスケジュールしていたり、アラートを修正する必要はないと判断したりした場合、アラートを却下できます。 すでに評価済みのアラートを却下すると、新しいアラートが現れたときにトリアージしやすくなります。 -1. View the details for an alert. For more information, see "[Viewing vulnerable dependencies](#viewing-vulnerable-dependencies)" (above). -1. Select the "Dismiss" dropdown, and click a reason for dismissing the alert.{% if reopen-dependabot-alerts %} Unfixed dismissed alerts can be reopened later.{% endif %} ![[Dismiss] ドロップダウンでアラートを却下する理由を選択する](/assets/images/help/repository/dependabot-alert-dismiss-drop-down-ungrouped.png) +1. アラートの詳細を表示させます。 詳しい情報については上の「[脆弱性のある依存関係の表示](#viewing-vulnerable-dependencies)」を参照してください。 +1. "Dismiss（却下）"ドロップダウンを選択し、アラートを却下する理由をクリックしてください。{% if reopen-dependabot-alerts %}却下された未修正のアラートは、後で再度オープンできます。{% endif %} ![[Dismiss] ドロップダウンでアラートを却下する理由を選択する](/assets/images/help/repository/dependabot-alert-dismiss-drop-down-ungrouped.png) {% if reopen-dependabot-alerts %} -## Viewing and updating closed alerts +## クローズされたアラートの表示と更新 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-dependabot-alerts %} -1. To just view closed alerts, click **Closed**. ![Screenshot showing the "Closed" option](/assets/images/help/repository/dependabot-alerts-closed.png) -1. Click the alert that you would like to view or update. ![Screenshot showing a highlighted dependabot alert](/assets/images/help/repository/dependabot-alerts-select-closed-alert.png) -2. Optionally, if the alert was dismissed and you wish to reopen it, click **Reopen**. ![Screenshot showing the "Reopen" button](/assets/images/help/repository/reopen-dismissed-alert.png) +1. クローズされたアラートを単に表示するには**Closed（クローズ済み）**をクリックしてください。 !["Closed"オプションを表示しているスクリーンショット](/assets/images/help/repository/dependabot-alerts-closed.png) +1. 表示もしくは更新したいアラートをクリックしてください。 ![ハイライトされているdependabotアラートを表示しているスクリーンショット](/assets/images/help/repository/dependabot-alerts-select-closed-alert.png) +2. あるいはアラートが却下されていて、再度オープンしたい場合は、**Reopen（再オープン）**をクリックしてください。 !["Reopen"ボタンを表示しているスクリーンショット](/assets/images/help/repository/reopen-dismissed-alert.png) {% endif %} diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md index 4b9cc30b4dbe..278efb2684dc 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md @@ -1,7 +1,7 @@ --- -title: Dependabot のセキュリティアップデート -intro: '{% data variables.product.prodname_dependabot %} は、セキュリティアップデートプログラムを使用してプルリクエストを発行することにより、脆弱性のある依存関係を修正できます。' -shortTitle: Dependabotセキュリティアップデート +title: About Dependabot security updates +intro: '{% data variables.product.prodname_dependabot %} can fix vulnerable dependencies for you by raising pull requests with security updates.' +shortTitle: Dependabot security updates redirect_from: - /github/managing-security-vulnerabilities/about-github-dependabot-security-updates - /github/managing-security-vulnerabilities/about-dependabot-security-updates @@ -26,42 +26,42 @@ topics: {% data reusables.dependabot.beta-security-and-version-updates %} {% data reusables.dependabot.enterprise-enable-dependabot %} -## {% data variables.product.prodname_dependabot_security_updates %}について +## About {% data variables.product.prodname_dependabot_security_updates %} -{% data variables.product.prodname_dependabot_security_updates %} で、リポジトリ内の脆弱性のある依存関係を簡単に修正できます。 この機能を有効にすると、リポジトリの依存関係グラフで脆弱性のある依存関係に対して {% data variables.product.prodname_dependabot %} アラートが発生すると、{% data variables.product.prodname_dependabot %} は自動的にそれを修正しようとします。 詳しい情報については、「[{% data variables.product.prodname_dependabot_alerts %} について](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)」および「[{% data variables.product.prodname_dependabot_security_updates %} の設定](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)」を参照してください。 +{% data variables.product.prodname_dependabot_security_updates %} make it easier for you to fix vulnerable dependencies in your repository. If you enable this feature, when a {% data variables.product.prodname_dependabot %} alert is raised for a vulnerable dependency in the dependency graph of your repository, {% data variables.product.prodname_dependabot %} automatically tries to fix it. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)" and "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)." {% data variables.product.prodname_dotcom %} may send {% data variables.product.prodname_dependabot_alerts %} to repositories affected by a vulnerability disclosed by a recently published {% data variables.product.prodname_dotcom %} security advisory. {% data reusables.security-advisory.link-browsing-advisory-db %} -{% data variables.product.prodname_dependabot %} は、リポジトリの依存関係グラフを中断することなく、脆弱性のある依存関係を修正バージョンにアップグレードできるかどうかを確認します。 次に、 {% data variables.product.prodname_dependabot %} はプルリクエストを発生させて、パッチを含む最小バージョンに依存関係を更新し、プルリクエストを {% data variables.product.prodname_dependabot %} アラートにリンクするか、アラートのエラーを報告します。 詳しい情報については、「[{% data variables.product.prodname_dependabot %} エラーのトラブルシューティング](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)」を参照してください。 +{% data variables.product.prodname_dependabot %} checks whether it's possible to upgrade the vulnerable dependency to a fixed version without disrupting the dependency graph for the repository. Then {% data variables.product.prodname_dependabot %} raises a pull request to update the dependency to the minimum version that includes the patch and links the pull request to the {% data variables.product.prodname_dependabot %} alert, or reports an error on the alert. For more information, see "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)." {% note %} -**注釈** +**Note** -{% data variables.product.prodname_dependabot_security_updates %} 機能は、依存関係グラフと {% data variables.product.prodname_dependabot_alerts %} を有効にしているリポジトリで使用できます。 完全な依存関係グラフで識別されたすべての脆弱性のある依存関係について、{% data variables.product.prodname_dependabot %} アラートが表示されます。 ただし、セキュリティアップデートプログラムは、マニフェストファイルまたはロックファイルで指定されている依存関係に対してのみトリガーされます。 {% data variables.product.prodname_dependabot %} は、明示的に定義されていない間接的または推移的な依存関係を更新できません。 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#dependencies-included)」を参照してください。 +The {% data variables.product.prodname_dependabot_security_updates %} feature is available for repositories where you have enabled the dependency graph and {% data variables.product.prodname_dependabot_alerts %}. You will see a {% data variables.product.prodname_dependabot %} alert for every vulnerable dependency identified in your full dependency graph. However, security updates are triggered only for dependencies that are specified in a manifest or lock file. {% data variables.product.prodname_dependabot %} is unable to update an indirect or transitive dependency that is not explicitly defined. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#dependencies-included)." {% endnote %} -関連する機能 {% data variables.product.prodname_dependabot_version_updates %} を有効にして、{% data variables.product.prodname_dependabot %} が古い依存関係を検出するたびに、マニフェストを最新バージョンの依存関係に更新するプルリクエストを生成させることができます。 詳しい情報については、「[{% data variables.product.prodname_dependabot %} バージョン更新について](/github/administering-a-repository/about-dependabot-version-updates)」を参照してください。 +You can enable a related feature, {% data variables.product.prodname_dependabot_version_updates %}, so that {% data variables.product.prodname_dependabot %} raises pull requests to update the manifest to the latest version of the dependency, whenever it detects an outdated dependency. For more information, see "[About {% data variables.product.prodname_dependabot %} version updates](/github/administering-a-repository/about-dependabot-version-updates)." {% data reusables.dependabot.pull-request-security-vs-version-updates %} -## セキュリティアップデートのプルリクエストについて +## About pull requests for security updates -各プルリクエストには、提案された修正を迅速かつ安全に確認してプロジェクトにマージするために必要なすべてのものが含まれています。 これには、リリースノート、変更ログエントリ、コミットの詳細などの脆弱性に関する情報が含まれます。 プルリクエストが解決する脆弱性の詳細は、リポジトリの {% data variables.product.prodname_dependabot_alerts %} にアクセスできないユーザには表示されません。 +Each pull request contains everything you need to quickly and safely review and merge a proposed fix into your project. This includes information about the vulnerability like release notes, changelog entries, and commit details. Details of which vulnerability a pull request resolves are hidden from anyone who does not have access to {% data variables.product.prodname_dependabot_alerts %} for the repository. -セキュリティアップデートを含むプルリクエストをマージすると、対応する {% data variables.product.prodname_dependabot %} アラートがリポジトリに対して解決済みとしてマークされます。 {% data variables.product.prodname_dependabot %} プルリクエストの詳細については、「[依存関係の更新に関するプルリクエストを管理する](/github/administering-a-repository/managing-pull-requests-for-dependency-updates)」を参照してください。 +When you merge a pull request that contains a security update, the corresponding {% data variables.product.prodname_dependabot %} alert is marked as resolved for your repository. For more information about {% data variables.product.prodname_dependabot %} pull requests, see "[Managing pull requests for dependency updates](/github/administering-a-repository/managing-pull-requests-for-dependency-updates)." {% data reusables.dependabot.automated-tests-note %} {% ifversion fpt or ghec %} -## 互換性スコアについて +## About compatibility scores -{% data variables.product.prodname_dependabot_security_updates %} may include compatibility scores to let you know whether updating a dependency could cause breaking changes to your project. これらは、同じセキュリティアップデートプログラムが生成された他のパブリックリポジトリでの CI テストから計算されます。 更新の互換性スコアは、依存関係の特定のバージョンの更新前後で、実行した CI がパスした割合です。 +{% data variables.product.prodname_dependabot_security_updates %} may include compatibility scores to let you know whether updating a dependency could cause breaking changes to your project. These are calculated from CI tests in other public repositories where the same security update has been generated. An update's compatibility score is the percentage of CI runs that passed when updating between specific versions of the dependency. {% endif %} -## {% data variables.product.prodname_dependabot %} セキュリティアップデートの通知について +## About notifications for {% data variables.product.prodname_dependabot %} security updates -{% data variables.product.company_short %} で通知をフィルタして、{% data variables.product.prodname_dependabot %} セキュリティアップデートを表示できます。 詳しい情報については「[インボックスからの通知を管理する](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)」を参照してください。 +You can filter your notifications on {% data variables.product.company_short %} to show {% data variables.product.prodname_dependabot %} security updates. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)." diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/index.md b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/index.md index 30b0fe607032..1d5887972e4f 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/index.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/index.md @@ -1,6 +1,6 @@ --- -title: Automatically updating dependencies with known vulnerabilities with Dependabot security updates -intro: '{% data variables.product.prodname_dependabot %} can help you fix vulnerable dependencies by automatically raising pull requests to update dependencies to secure versions.' +title: Dependabotセキュリティアップデートで既知の脆弱性を持つ依存関係を自動的にアップデート +intro: '{% data variables.product.prodname_dependabot %}は、依存関係をセキュアなバージョンにアップデートするPull Requestを自動的に起こすことで、脆弱性のある依存関係の修復を助けることができます。' allowTitleToDifferFromFilename: true versions: fpt: '*' diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md b/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md index 87eeddddfbcf..6a521b3bb00e 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md @@ -32,9 +32,9 @@ shortTitle: Dependabotバージョンアップデート 設定ファイルをリポジトリにチェックインすることにより、{% data variables.product.prodname_dependabot_version_updates %} を有効化します。 設定ファイルは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 {% data variables.product.prodname_dependabot %} はこの情報を使用して、古いパッケージとアプリケーションをチェックします。 {% data variables.product.prodname_dependabot %} は、依存関係のセマンティックバージョニング（[semver](https://semver.org/)）を調べて、そのバージョンへの更新の必要性を判断することにより、依存関係の新しいバージョンの有無を決定します。 特定のパッケージマネージャーでは、{% data variables.product.prodname_dependabot_version_updates %} もベンダをサポートしています。 ベンダ (またはキャッシュ) された依存関係は、マニフェストで参照されるのではなく、リポジトリ内の特定のディレクトリにチェックインされる依存関係です。 パッケージサーバーが利用できない場合でも、ビルド時にベンダ依存関係を利用できます。 {% data variables.product.prodname_dependabot_version_updates %} は、ベンダの依存関係をチェックして新しいバージョンを確認し、必要に応じて更新するように設定できます。 -{% data variables.product.prodname_dependabot %} が古い依存関係を特定すると、プルリクエストを発行して、マニフェストを依存関係の最新バージョンに更新します。 ベンダーの依存関係の場合、{% data variables.product.prodname_dependabot %} はプルリクエストを生成して、古い依存関係を新しいバージョンに直接置き換えます。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 For more information, see "[Configuring {% data variables.product.prodname_dependabot %} version updates](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)." +{% data variables.product.prodname_dependabot %} が古い依存関係を特定すると、プルリクエストを発行して、マニフェストを依存関係の最新バージョンに更新します。 ベンダーの依存関係の場合、{% data variables.product.prodname_dependabot %} はプルリクエストを生成して、古い依存関係を新しいバージョンに直接置き換えます。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳しい情報については「[{% data variables.product.prodname_dependabot %}のバージョンアップデートの設定](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)」を参照してください。 -If you enable _security updates_, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 +_セキュリティアップデート_を有効にすると、{% data variables.product.prodname_dependabot %} は脆弱性のある依存関係を更新するPull Requestを起こします。 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 {% data reusables.dependabot.pull-request-security-vs-version-updates %} @@ -62,8 +62,8 @@ If you enable _security updates_, {% data variables.product.prodname_dependabot {% data reusables.dependabot.supported-package-managers %} -リポジトリですでに依存関係管理にインテグレーションを使用している場合は、{% data variables.product.prodname_dependabot %} を有効にする前にそれを無効にする必要があります。 {% ifversion fpt or ghec %}For more information, see "[About integrations](/github/customizing-your-github-workflow/about-integrations)."{% endif %} +リポジトリですでに依存関係管理にインテグレーションを使用している場合は、{% data variables.product.prodname_dependabot %} を有効にする前にそれを無効にする必要があります。 {% ifversion fpt or ghec %}詳しい情報については「[インテグレーションについて](/github/customizing-your-github-workflow/about-integrations)」を参照してください。{% endif %} ## {% data variables.product.prodname_dependabot %} バージョン更新の通知について -You can filter your notifications on {% data variables.product.company_short %} to show notifications for pull requests created by {% data variables.product.prodname_dependabot %}. 詳しい情報については「[インボックスからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)」を参照してください。 +{% data variables.product.company_short %}上の通知をフィルタリングして、{% data variables.product.prodname_dependabot %}が作成したPull Requestの通知を表示させることができます。 詳しい情報については「[インボックスからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)」を参照してください。 diff --git a/translations/ja-JP/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md b/translations/ja-JP/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md index 745be17fc84c..4f72a205b6cf 100644 --- a/translations/ja-JP/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md +++ b/translations/ja-JP/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md @@ -465,7 +465,6 @@ name: Dependabot auto-merge on: pull_request_target permissions: - pull-requests: write contents: write jobs: @@ -497,7 +496,6 @@ name: Dependabot auto-merge on: pull_request permissions: - pull-requests: write contents: write jobs: diff --git a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index a0fd4e08ff99..85c36842d689 100644 --- a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -62,6 +62,7 @@ To create codespaces with custom permissions defined, you must use one of the fo * `deployments` - read / write * `discussions` - read / write * `issues` - read / write + * `packages` - read * `pages` - read / write * `pull_requests` - read / write * `repository_projects` - read / write diff --git a/translations/ja-JP/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md b/translations/ja-JP/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md index dbd0eb1ae1f7..d90de570aa24 100644 --- a/translations/ja-JP/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md +++ b/translations/ja-JP/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md @@ -23,7 +23,7 @@ permissions: Organization owners can remove members from an organization. **警告:** Organization からメンバーを削除する際は次の点にご注意ください: - 有料ライセンスのカウントは自動的にはダウングレードされません。 Organization からユーザを削除したあとに有料シートの数を減らすには、「[Organization の有料ライセンスをダウングレードする](/articles/downgrading-your-organization-s-paid-seats)」の手順に従ってください。 - 削除されたメンバーは Organization のプライベートリポジトリのプライベートフォークへのアクセスは失いますが、ローカルコピーを自分で持っておくことは可能です。 ただし、ローカルコピーを Organization のリポジトリと同期させることはできません。 そのプライベートフォークは、そのユーザが Organization から削除されてから 3 か月以内に [Organization メンバーとして復帰した](/articles/reinstating-a-former-member-of-your-organization)場合、リストアできます。 最終的に、リポジトリへのアクセスを失った個人に、機密情報や知的財産を確実に削除してもらうのは、あなたの責任です。 -- When private repositories are forked to other organizations, those organizations are able to control access to the fork network. This means users may retain access to the forks even after losing access to the original organization because they will still have explicit access via a fork. +- プライベートリポジトリが他のOrganizationにフォークされた場合、それらのOrganizationはフォークネットワークへのアクセスを制御できます。 これはすなわち、オリジナルのOrganizaitionへのアクセスをユーザが失っても、そのユーザは依然としてフォークへの明示的なアクセスを持ち続け、フォークへのアクセスは残されるかもしれないということです。 {%- ifversion ghec %} - 削除されたメンバーは、同じEnterpriseアカウントが所有する他のOrganizationのメンバーではない場合、Organizationのインターナルリポジトリのプライベートフォークへのアクセスも失うことになります。 詳細は「[Enterprise アカウントについて](/admin/overview/about-enterprise-accounts)」を参照してください。 {%- endif %} diff --git a/translations/ja-JP/content/rest/actions/artifacts.md b/translations/ja-JP/content/rest/actions/artifacts.md index e433bcbf4219..7ce0adae565c 100644 --- a/translations/ja-JP/content/rest/actions/artifacts.md +++ b/translations/ja-JP/content/rest/actions/artifacts.md @@ -1,6 +1,8 @@ --- -title: 成果物 -intro: 成果物 API では、ワークフローの成果物に関する情報をダウンロード、削除、および取得できます。 +title: GitHub Actions Artifacts +allowTitleToDifferFromFilename: true +shortTitle: 成果物 +intro: 'The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-artifacts %} 詳しい情報については、「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 +## About the Artifacts API + +The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts. {% data reusables.actions.about-artifacts %} 詳しい情報については、「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/ja-JP/content/rest/actions/cache.md b/translations/ja-JP/content/rest/actions/cache.md index e50798e8badd..1ff8f5410e6e 100644 --- a/translations/ja-JP/content/rest/actions/cache.md +++ b/translations/ja-JP/content/rest/actions/cache.md @@ -1,6 +1,8 @@ --- -title: キャッシュ -intro: 'キャッシュAPIを使うと、リポジトリの{% data variables.product.prodname_actions %}キャッシュに対するクエリと管理を行えます。' +title: GitHub Actions Cache +allowTitleToDifferFromFilename: true +shortTitle: キャッシュ +intro: 'The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' topics: - API versions: @@ -8,4 +10,6 @@ versions: ghec: '*' --- -キャッシュAPIを使うと、リポジトリの{% data variables.product.prodname_actions %}キャッシュに対するクエリと管理を行えます。 詳しい情報については、「[ワークフローを高速化するための依存関係のキャッシュ](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)」を参照してください。 +## About the Cache API + +The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories. 詳しい情報については、「[ワークフローを高速化するための依存関係のキャッシュ](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)」を参照してください。 diff --git a/translations/ja-JP/content/rest/actions/permissions.md b/translations/ja-JP/content/rest/actions/permissions.md index 0e165558bd5a..f334dc299cd5 100644 --- a/translations/ja-JP/content/rest/actions/permissions.md +++ b/translations/ja-JP/content/rest/actions/permissions.md @@ -1,6 +1,8 @@ --- -title: 権限 -intro: 'Permissions API では、どのEnterprise、組織、リポジトリが {% data variables.product.prodname_actions %} を実行できるか、どのアクション{% if actions-workflow-policy %}と再利用可能なワークフロー{% endif %}を実行できるかについて権限を設定できます。' +title: GitHub Actions Permissions +allowTitleToDifferFromFilename: true +shortTitle: 権限 +intro: 'The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.' topics: - API versions: @@ -10,6 +12,6 @@ versions: ghec: '*' --- -## 権限 +## About the Permissions API -Permissions API では、どのEnterprise、組織、リポジトリが {% data variables.product.prodname_actions %} を実行できるか、どのアクション{% if actions-workflow-policy %}と再利用可能なワークフロー{% endif %}を実行できるかについて権限を設定できます。{% ifversion fpt or ghec or ghes %}詳しい情報については[利用制限、支払い、管理](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)」を参照してください。{% endif %} +The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)."{% endif %} diff --git a/translations/ja-JP/content/rest/actions/secrets.md b/translations/ja-JP/content/rest/actions/secrets.md index 77563f5f1f14..6764a63bf3d4 100644 --- a/translations/ja-JP/content/rest/actions/secrets.md +++ b/translations/ja-JP/content/rest/actions/secrets.md @@ -1,6 +1,8 @@ --- -title: シークレット -intro: シークレット API では、暗号化されたシークレットに関する情報を作成、更新、削除、および取得できます。 +title: GitHub Actions Secrets +allowTitleToDifferFromFilename: true +shortTitle: シークレット +intro: 'The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-secrets %} 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +## About the Secrets API + +The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows. {% data reusables.actions.about-secrets %} 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}がこのAPIを使うためには`secrets`権限を持っていなければなりません。 認証されたユーザは、シークレットを作成、更新、または読み取るために、リポジトリへのコラボレータアクセス権を持っている必要があります。 diff --git a/translations/ja-JP/content/rest/actions/self-hosted-runner-groups.md b/translations/ja-JP/content/rest/actions/self-hosted-runner-groups.md index 4a402f7dc53a..450dbf9b1212 100644 --- a/translations/ja-JP/content/rest/actions/self-hosted-runner-groups.md +++ b/translations/ja-JP/content/rest/actions/self-hosted-runner-groups.md @@ -11,8 +11,8 @@ versions: --- -## セルフホストランナーグループ +## About the Self-hosted runner groups API -セルフホストランナーグループ API を使用すると、セルフホストランナーのグループを管理できます。 詳しい情報については、「[グループを使用したセルフホストランナーへのアクセスを管理する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)」を参照してください。 +The Self-hosted runners groups API allows you manage groups of self-hosted runners. 詳しい情報については、「[グループを使用したセルフホストランナーへのアクセスを管理する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}は、リポジトリに対する`administration`権限もしくはOrganizationに対する`organization_self_hosted_runners`権限を持っていなければなりません。 認証されたユーザがこのAPIを使うためには、リポジトリもしくはOrganizationに対する管理アクセス、あるいはEnterpriseに対する`manage_runners:enterprise`スコープを持っていなければなりません。 diff --git a/translations/ja-JP/content/rest/actions/self-hosted-runners.md b/translations/ja-JP/content/rest/actions/self-hosted-runners.md index 12b1dd928ef5..1cf1ebeadbbb 100644 --- a/translations/ja-JP/content/rest/actions/self-hosted-runners.md +++ b/translations/ja-JP/content/rest/actions/self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: セルフホストランナー -intro: セルフホストランナー API では、自分のホストランナーの登録、表示、削除ができます。 +intro: 'The Self-hosted runners API allows you to register, view, and delete self-hosted runners.' topics: - API versions: @@ -11,8 +11,8 @@ versions: --- -## セルフホストランナー +## About the Self-hosted runners API -セルフホストランナー API では、自分のホストランナーの登録、表示、削除ができます。 {% data reusables.actions.about-self-hosted-runners %} 詳しい情報については「[自分のランナーのホスト](/actions/hosting-your-own-runners)」を参照してください。 +The Self-hosted runners API allows you to register, view, and delete self-hosted runners. {% data reusables.actions.about-self-hosted-runners %} 詳しい情報については「[自分のランナーのホスト](/actions/hosting-your-own-runners)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}は、リポジトリに対する`administration`権限もしくはOrganizationに対する`organization_self_hosted_runners`権限を持っていなければなりません。 認証されたユーザがこのAPIを使うためには、リポジトリもしくはOrganizationに対する管理アクセス、あるいはEnterpriseに対する`manage_runners:enterprise`スコープを持っていなければなりません。 diff --git a/translations/ja-JP/content/rest/actions/workflow-jobs.md b/translations/ja-JP/content/rest/actions/workflow-jobs.md index ea91cd06f1dd..27907765918f 100644 --- a/translations/ja-JP/content/rest/actions/workflow-jobs.md +++ b/translations/ja-JP/content/rest/actions/workflow-jobs.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-jobs %}詳しい情報については、「[GitHub Actions のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)」を参照してください。 +## About the Workflow jobs API + +The Workflow jobs API allows you to view logs and workflow jobs. {% data reusables.actions.about-workflow-jobs %}詳しい情報については、「[GitHub Actions のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/ja-JP/content/rest/actions/workflow-runs.md b/translations/ja-JP/content/rest/actions/workflow-runs.md index 3427dd2c61c4..e03f60d66520 100644 --- a/translations/ja-JP/content/rest/actions/workflow-runs.md +++ b/translations/ja-JP/content/rest/actions/workflow-runs.md @@ -1,6 +1,6 @@ --- title: ワークフローの実行 -intro: Workflow Runs APIを使うと、ワークフローの実行の表示、再実行、キャンセル、ログの表示が行えます。 +intro: 'The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs.' topics: - API versions: @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-runs %} 詳しい情報については「[ワークフローの実行の管理](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)」を参照してください。 +## About the Workflow runs API + +The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs. {% data reusables.actions.about-workflow-runs %} 詳しい情報については「[ワークフローの実行の管理](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/ja-JP/content/rest/actions/workflows.md b/translations/ja-JP/content/rest/actions/workflows.md index 9e7a0ab2065f..8470cee0a43b 100644 --- a/translations/ja-JP/content/rest/actions/workflows.md +++ b/translations/ja-JP/content/rest/actions/workflows.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflows %}詳しい情報については、「[GitHub Actions でワークフローを自動化する](/actions/automating-your-workflow-with-github-actions)」を参照してください。 +## About the Workflows API + +ワークフロー API を使用すると、リポジトリのワークフローを表示できます。 {% data reusables.actions.about-workflows %}詳しい情報については、「[GitHub Actions でワークフローを自動化する](/actions/automating-your-workflow-with-github-actions)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/ja-JP/content/rest/activity/feeds.md b/translations/ja-JP/content/rest/activity/feeds.md index bc75b862b5b1..7caaf484d44c 100644 --- a/translations/ja-JP/content/rest/activity/feeds.md +++ b/translations/ja-JP/content/rest/activity/feeds.md @@ -11,9 +11,13 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Feeds API + +To see what feeds are available to you, use the [Get feeds](#get-feeds) operation. You can then get a feed by sending a request to one of the feed URLs. + ### Atomフィードの取得例 -フィードをAtom形式で取得するには、`Accept`ヘッダ中で`application/atom+xml`タイプを指定しなければなりません。 以下は、GitHubセキュリティアドバイザリに対するAtomフィードの取得例です。 +Atom 形式のフィードを取得するには、`Accept` ヘッダで `application/atom+xml` タイプを指定する必要があります。 たとえば、GitHub のセキュリティアドバイザリの Atom フィードを取得するには、次のように記述します。 curl -H "Accept: application/atom+xml" https://github.com/security-advisories diff --git a/translations/ja-JP/content/rest/activity/notifications.md b/translations/ja-JP/content/rest/activity/notifications.md index ff27deb9fa07..f5a3d2bc9d90 100644 --- a/translations/ja-JP/content/rest/activity/notifications.md +++ b/translations/ja-JP/content/rest/activity/notifications.md @@ -1,6 +1,6 @@ --- title: 通知 -intro: '' +intro: 'The Notifications API lets you manage {% data variables.product.product_name %} notifications.' versions: fpt: '*' ghes: '*' @@ -11,18 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -ユーザは、Watch しているリポジトリでの会話の通知を受け取ります。 +## About the Notifications API -* Issue とそのコメント -* プルリクエストとそのコメント -* コミットに関するコメント - -ユーザが関わっている場合、Watch 解除したリポジトリでの会話の通知も送信されます。 - -* **@メンション** -* Issue の割り当て -* ユーザの作者のコミット、またはコミット -* ユーザが参加しているディスカッション +The Notifications API lets you manage {% data variables.product.product_name %} notifications. For more information about notifications, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." すべての通知 API 呼び出しには、`notifications` または `repo` API スコープが必要です。 これを行うと、一部の Issue およびコミットコンテンツへの読み取り専用アクセス権が付与されます。 それぞれのエンドポイントから Issue とコミットにアクセスするには、`repo` スコープが必要です。 @@ -44,11 +35,11 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" > X-Poll-Interval: 60 ``` -### 通知理由 +### About notification reasons 通知 API からレスポンスを取得するとき、各ペイロードには `reason` というタイトルのキーがあります。 これらは、通知をトリガーするイベントに対応しています。 -通知を受け取る `reason`（理由）には、次のようなものがあります。 +These are the potential `reason`s for receiving a notification: | 理由名 | 説明 | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/translations/ja-JP/content/rest/activity/starring.md b/translations/ja-JP/content/rest/activity/starring.md index 8079e00497d1..bf4224951259 100644 --- a/translations/ja-JP/content/rest/activity/starring.md +++ b/translations/ja-JP/content/rest/activity/starring.md @@ -1,6 +1,6 @@ --- title: Star -intro: リポジトリに Star を付けると、ユーザがリポジトリをブックマークできます。 +intro: The Starring API lets you bookmark a repository. versions: fpt: '*' ghes: '*' @@ -11,7 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -おおよその関心レベルを示すために、リポジトリの横に Star が表示されます。 Star は通知やアクティビティフィードには影響しません。 +## About the Starring API + +The Starring API lets you bookmark a repository. おおよその関心レベルを示すために、リポジトリの横に Star が表示されます。 Star は通知やアクティビティフィードには影響しません。 詳しい情報については、「[Star を付けてリポジトリを保存する](/get-started/exploring-projects-on-github/saving-repositories-with-stars)」を参照してください。 ### Star と Watch diff --git a/translations/ja-JP/content/rest/activity/watching.md b/translations/ja-JP/content/rest/activity/watching.md index 3b4536a5cc0f..e9f8b8893660 100644 --- a/translations/ja-JP/content/rest/activity/watching.md +++ b/translations/ja-JP/content/rest/activity/watching.md @@ -1,6 +1,6 @@ --- title: Watch の違い -intro: リポジトリを Watch すると、ユーザは登録され、新しいディスカッションやユーザのアクティビティフィードのイベントに関する通知を受け取ります。 +intro: The Watching API lets users subscribe to notifications for activity in a repository. versions: fpt: '*' ghes: '*' @@ -11,4 +11,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -基本的なリポジトリブックマークについては、「[リポジトリの Star 付け](/rest/reference/activity#starring)」を参照してください。 +## About the Watching API + +The Watching API lets users subscribe to notifications for activity in a repository. To bookmark a repository instead, see "[Starring](/rest/reference/activity#starring)." diff --git a/translations/ja-JP/content/rest/billing.md b/translations/ja-JP/content/rest/billing.md index 9b23bd320b4f..29d3c196f4d5 100644 --- a/translations/ja-JP/content/rest/billing.md +++ b/translations/ja-JP/content/rest/billing.md @@ -1,6 +1,6 @@ --- title: 支払い -intro: '' +intro: The Billing API lets you get billing information for an enterprise. topics: - API miniTocMaxHeadingLevel: 3 @@ -12,4 +12,6 @@ redirect_from: - /rest/reference/billing --- +## About the Billing API + Enterprise の支払情報を取得できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#billing)」REST API を参照してください。 diff --git a/translations/ja-JP/content/rest/code-scanning.md b/translations/ja-JP/content/rest/code-scanning.md index a93ba7ee5c64..6fcd75874c2c 100644 --- a/translations/ja-JP/content/rest/code-scanning.md +++ b/translations/ja-JP/content/rest/code-scanning.md @@ -1,6 +1,6 @@ --- title: Code Scanning -intro: '' +intro: '{% data variables.product.prodname_code_scanning %} APIを使うと、リオジトリから{% data variables.product.prodname_code_scanning %}アラートを取得して更新できます。' versions: fpt: '*' ghes: '*' @@ -17,6 +17,8 @@ redirect_from: {% data reusables.code-scanning.beta %} +## About the Code scanning API + {% data variables.product.prodname_code_scanning %} APIを使うと、リオジトリから{% data variables.product.prodname_code_scanning %}アラートを取得して更新できます。 このエンドポイントを使って、Organization内で{% data variables.product.prodname_code_scanning %}アラートの自動化されたレポートを作成したり、オフラインの{% data variables.product.prodname_code_scanning %}ツールを使って生成された分析結果をアップロードしたりできます。 詳しい情報については、「[コード内のセキュリティの脆弱性とエラーを検出する](/github/finding-security-vulnerabilities-and-errors-in-your-code)」を参照してください。 {% ifversion fpt or ghes > 3.0 or ghae or ghec %} diff --git a/translations/ja-JP/content/rest/codes-of-conduct.md b/translations/ja-JP/content/rest/codes-of-conduct.md index 7363ab1f021f..9fe98abf1c49 100644 --- a/translations/ja-JP/content/rest/codes-of-conduct.md +++ b/translations/ja-JP/content/rest/codes-of-conduct.md @@ -1,6 +1,6 @@ --- title: 行動規範 -intro: '' +intro: The Codes of conduct API lets you retrieve information about a repository's code of conduct. versions: fpt: '*' ghes: '*' @@ -13,4 +13,6 @@ redirect_from: - /rest/reference/codes-of-conduct --- -Codes of Conduct API を使用して、リポジトリの行動規範に関する情報を取得できます。 リポジトリの行動規範を取得するには、「[Get a repository](/rest/reference/repos#get-a-repository)」エンドポイントを使用します。 +## About the Codes of conduct API + +Codes of Conduct API を使用して、リポジトリの行動規範に関する情報を取得できます。 To get a code of conduct for a repository, use the "[Get a repository](/rest/reference/repos#get-a-repository)" endpoint. diff --git a/translations/ja-JP/content/rest/commits/comments.md b/translations/ja-JP/content/rest/commits/comments.md index 802c4b59ab0d..3366d9f29fba 100644 --- a/translations/ja-JP/content/rest/commits/comments.md +++ b/translations/ja-JP/content/rest/commits/comments.md @@ -1,6 +1,6 @@ --- title: コミットのコメント -intro: '' +intro: The Commit comments API lets you create and edit comments that relate to specific commits. versions: fpt: '*' ghes: '*' @@ -12,6 +12,10 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- +## About the commit comments API + +The Commit comments API lets you create and edit comments that relate to specific commits. + ### コミットコメントのカスタムメディアタイプ 以下がコミットコメントでサポートされているメディアタイプです。 API におけるメディアタイプの使用に関する詳細は、[こちら](/rest/overview/media-types)を参照してください。 diff --git a/translations/ja-JP/content/rest/commits/statuses.md b/translations/ja-JP/content/rest/commits/statuses.md index 9d22dd87098b..617b0406b7f1 100644 --- a/translations/ja-JP/content/rest/commits/statuses.md +++ b/translations/ja-JP/content/rest/commits/statuses.md @@ -1,6 +1,6 @@ --- title: コミットのステータス -intro: ステータス API を使用すると、外部サービスがコミットに `error`、`failure`、`pending`、`success`ステータスを付けることができ、このステータスはコミットが含まれるPull Requestに反映されます。 +intro: 'The Commit status API allows external services to mark commits with a status, which is then reflected in pull requests involving those commits.' versions: fpt: '*' ghes: '*' @@ -12,7 +12,9 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -ステータスには、オプションとして `description` と `target_url` を含めることもできます。これにより GitHub UI でステータスをより有用なものにできるので、強くおすすめします。 +## About the Commit statuses API + +The Commit status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits. ステータスには、オプションとして `description` と `target_url` を含めることもできます。これにより GitHub UI でステータスをより有用なものにできるので、強くおすすめします。 たとえば、継続的インテグレーションサービスの典型的な使用方法の一つが、ステータスを使用してコミットに成功もしくは失敗のビルドとマークすることです。 `target_url` でビルドの出力先の完全な URL、`description` でビルドで発生したことの概要を示すといったようにします。 diff --git a/translations/ja-JP/content/rest/dependabot/secrets.md b/translations/ja-JP/content/rest/dependabot/secrets.md index 1d96178d2c4c..84f7e553aa58 100644 --- a/translations/ja-JP/content/rest/dependabot/secrets.md +++ b/translations/ja-JP/content/rest/dependabot/secrets.md @@ -1,6 +1,7 @@ --- -title: シークレット -intro: Dependabot Secrets API を使用すると、OrganizationまたはリポジトリのDependabotシークレットを管理および制御できます。 +title: Dependabot secrets +shortTitle: シークレット +intro: 'With the {% data variables.product.prodname_dependabot %} secrets API, you can manage and control {% data variables.product.prodname_dependabot %} secrets for an organization or repository.' topics: - API versions: @@ -10,6 +11,8 @@ versions: allowTitleToDifferFromFilename: true --- -{% data variables.product.prodname_dependabot %} Secret APIを使用すると、暗号化されたシークレットに関する情報の作成、更新、削除、取得ができます。 {% data reusables.actions.about-secrets %} 詳しい情報については「[Dependabotの暗号化されたシークレットの管理](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)」を参照してください。 +## About the {% data variables.product.prodname_dependabot %} secrets API + +The {% data variables.product.prodname_dependabot %} secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} 詳しい情報については「[Dependabotの暗号化されたシークレットの管理](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)」を参照してください。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %}がこのAPIを使うには、`dependabot_secrets`権限を持っていなければなりません。 認証されたユーザは、シークレットを作成、更新、または読み取るために、リポジトリへのコラボレータアクセス権を持っている必要があります。 diff --git a/translations/ja-JP/content/rest/dependency-graph/dependency-review.md b/translations/ja-JP/content/rest/dependency-graph/dependency-review.md index c0efa51048a7..aab0eec577b8 100644 --- a/translations/ja-JP/content/rest/dependency-graph/dependency-review.md +++ b/translations/ja-JP/content/rest/dependency-graph/dependency-review.md @@ -1,6 +1,6 @@ --- title: 依存関係のレビュー -intro: Dependency Review APIを使うと、依存関係の変更や、それらの変更のセキュリティへの影響を理解することが、依存関係を環境に追加する前に行えます。 +intro: 'The Dependency review API allows you to understand dependency changes, and the security impact of these changes, before you add them to your environment.' versions: fpt: '*' ghes: '>=3.6' @@ -12,7 +12,7 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -## 依存関係のレビュー +## About the Dependency review API {% data reusables.dependency-review.dependency-review-api-beta-note %} diff --git a/translations/ja-JP/content/rest/deploy-keys.md b/translations/ja-JP/content/rest/deploy-keys.md index d6bcdc517f0b..e5440a509782 100644 --- a/translations/ja-JP/content/rest/deploy-keys.md +++ b/translations/ja-JP/content/rest/deploy-keys.md @@ -1,6 +1,6 @@ --- title: デプロイキー -intro: '' +intro: The Deploy keys API lets you create and manage deploy keys. versions: fpt: '*' ghes: '*' @@ -14,6 +14,8 @@ redirect_from: - /rest/reference/deploy_keys --- +## About the Deploy keys API + {% data reusables.repositories.deploy-keys %} デプロイキーは、以下の API エンドポイントを使用するか、GitHub を使用することでセットアップできます。 GitHub でデプロイキーを設定する方法については、「[デプロイキーを管理する](/developers/overview/managing-deploy-keys)」を参照してください。 diff --git a/translations/ja-JP/content/rest/gists/comments.md b/translations/ja-JP/content/rest/gists/comments.md index 45cd5e6f9bf1..09896a8ef72c 100644 --- a/translations/ja-JP/content/rest/gists/comments.md +++ b/translations/ja-JP/content/rest/gists/comments.md @@ -1,6 +1,8 @@ --- -title: コメント -intro: '' +title: Gist comments +allowTitleToDifferFromFilename: true +shortTitle: コメント +intro: The Gist comments API lets you view and modify comments on a gist. versions: fpt: '*' ghes: '*' @@ -11,6 +13,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gist comments API + +The Gist comments API lets you view and modify comments on a gist. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### Gist コメントのカスタムメディアタイプ これらは、Gist コメントでサポートされているメディアタイプです。 diff --git a/translations/ja-JP/content/rest/gists/gists.md b/translations/ja-JP/content/rest/gists/gists.md index 38d9994eb423..cfa0809f8907 100644 --- a/translations/ja-JP/content/rest/gists/gists.md +++ b/translations/ja-JP/content/rest/gists/gists.md @@ -11,6 +11,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gists API + +The Gist API lets you view and modify gists. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### 認証 パブリック Gist {% ifversion ghae or ghes %} を読んで、トークンなしで匿名ユーザ向けに作成できます。{% else %} 匿名でも、Gist を作成するには GitHub にサインインする必要があります。{% endif %}ユーザに代わって Gist を読み書きするには、Gist OAuth スコープとトークンが必要です。 詳しい情報については、「[OAuth App のスコープ](/developers/apps/scopes-for-oauth-apps)」を参照してください。 diff --git a/translations/ja-JP/content/rest/git/blobs.md b/translations/ja-JP/content/rest/git/blobs.md index 83efcdff0322..501ce75b24d2 100644 --- a/translations/ja-JP/content/rest/git/blobs.md +++ b/translations/ja-JP/content/rest/git/blobs.md @@ -1,6 +1,8 @@ --- -title: Blob -intro: Git blob (バイナリラージオブジェクト) は、各ファイルのコンテンツをリポジトリに保存する際に使用されるオブジェクトタイプです。 +title: Git blobs +shortTitle: Blob +allowTitleToDifferFromFilename: true +intro: 'The Git blob API lets you create and get a Git blob (binary large object), the object type used to store the contents of each file in a repository.' versions: fpt: '*' ghes: '*' @@ -11,7 +13,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -ファイルの SHA-1 ハッシュが計算され、blob オブジェクトに保存されます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [blob オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)の読み書きができます。 blob は[これらのカスタムメディアタイプ](#custom-media-types-for-blobs)を利用します。 API でのメディアタイプの使用について詳しくは、[こちら](/rest/overview/media-types)をご覧ください。 +## About the Git blob API + +Git blob (バイナリラージオブジェクト) は、各ファイルのコンテンツをリポジトリに保存する際に使用されるオブジェクトタイプです。 ファイルの SHA-1 ハッシュが計算され、blob オブジェクトに保存されます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [blob オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)の読み書きができます。 blob は[これらのカスタムメディアタイプ](#custom-media-types-for-blobs)を利用します。 API でのメディアタイプの使用について詳しくは、[こちら](/rest/overview/media-types)をご覧ください。 ### Blob のカスタムメディアタイプ diff --git a/translations/ja-JP/content/rest/git/commits.md b/translations/ja-JP/content/rest/git/commits.md index 7eb1f414a14b..7117676af761 100644 --- a/translations/ja-JP/content/rest/git/commits.md +++ b/translations/ja-JP/content/rest/git/commits.md @@ -1,6 +1,8 @@ --- -title: コミット -intro: 'Gitのコミットは、Gitリポジトリ中の階層([Git tree](/rest/reference/git#trees)) とファイルの内容([Git blob](/rest/reference/git#blobs))のスナップショットです。' +title: Git commits +shortTitle: コミット +allowTitleToDifferFromFilename: true +intro: 'The Git commits API lets you read and write commit objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [コミットオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects)の読み書きができます。 +## About the Git commits API + +Git コミットは、Git リポジトリ内の階層（[Git ツリー](/rest/reference/git#trees)）とファイルのコンテンツ（[Git blob](/rest/reference/git#blobs)）のスナップショットです。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [コミットオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects)の読み書きができます。 diff --git a/translations/ja-JP/content/rest/git/refs.md b/translations/ja-JP/content/rest/git/refs.md index 70e02109b6e9..c0d66a0937d0 100644 --- a/translations/ja-JP/content/rest/git/refs.md +++ b/translations/ja-JP/content/rest/git/refs.md @@ -1,6 +1,7 @@ --- -title: リファレンス -intro: Git リファレンス（`git ref`）は、Git コミット SHA-1 ハッシュを含むファイルです。 +title: Git references +shortTitle: リファレンス +intro: 'The Git references API lets you read and write references to your Git database on {% data variables.product.product_name %}' versions: fpt: '*' ghes: '*' @@ -12,4 +13,6 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -Gitコミットを参照するときは、ハッシュではなく覚えやすい名前の Gitリファレンスを使用できます。 Gitリファレンスは、新しいコミットを指すように書き換えることができます。 ブランチは、新しいGitコミットハッシュを保存する Git リファレンスです。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [リファレンス](https://git-scm.com/book/en/v1/Git-Internals-Git-References)の読み書きができます。 +## About the Git references API + +A Git reference (`git ref`) is a file that contains a Git commit SHA-1 hash. Gitコミットを参照するときは、ハッシュではなく覚えやすい名前の Gitリファレンスを使用できます。 Gitリファレンスは、新しいコミットを指すように書き換えることができます。 A branch is a Git reference that stores the new Git commit hash. これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [リファレンス](https://git-scm.com/book/en/v1/Git-Internals-Git-References)の読み書きができます。 diff --git a/translations/ja-JP/content/rest/git/tags.md b/translations/ja-JP/content/rest/git/tags.md index 4060d9b572fd..6c6778d253b8 100644 --- a/translations/ja-JP/content/rest/git/tags.md +++ b/translations/ja-JP/content/rest/git/tags.md @@ -1,6 +1,8 @@ --- -title: タグ -intro: 'Git タグは [Gitリファレンス](/rest/reference/git#refs)に似ていますが、変更されることがないところを指す Gitコミットです。' +title: Git tags +shortTitle: タグ +allowTitleToDifferFromFilename: true +intro: 'The Git tags API lets you read and write tag objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -Git タグは、特定のリリースを指すときに役立ちます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [タグオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)の読み書きができます。 Git タグ API は、[アノテーションされたタグオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)のみをサポートし、軽量タグはサポートしません。 +## About the Git tags API + +Git タグは [Git リファレンス](/rest/reference/git#refs)に似ていますが、変更しないことを指す Git コミットです。 Git タグは、特定のリリースを指すときに役立ちます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [タグオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)の読み書きができます。 Git タグ API は、[アノテーションされたタグオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)のみをサポートし、軽量タグはサポートしません。 diff --git a/translations/ja-JP/content/rest/git/trees.md b/translations/ja-JP/content/rest/git/trees.md index 79e6f4310fd4..ca1ad832ee92 100644 --- a/translations/ja-JP/content/rest/git/trees.md +++ b/translations/ja-JP/content/rest/git/trees.md @@ -1,6 +1,8 @@ --- -title: ツリー -intro: Git ツリーオブジェクトは、Git リポジトリ内のファイル間の階層を作成します。 +title: Git trees +shortTitle: ツリー +allowTitleToDifferFromFilename: true +intro: 'The Git trees API lets you read and write tree objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -Git ツリーオブジェクトを使用して、ディレクトリとそこに含まれるファイルの関係を作成できます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [ツリーオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)の読み書きができます。 +## About the Git trees API + +Git ツリーオブジェクトは、Git リポジトリ内のファイル間の階層を作成します。 Git ツリーオブジェクトを使用して、ディレクトリとそこに含まれるファイルの関係を作成できます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに対して [ツリーオブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)の読み書きができます。 diff --git a/translations/ja-JP/content/rest/gitignore.md b/translations/ja-JP/content/rest/gitignore.md index 528e1d9eb782..6aad177162e6 100644 --- a/translations/ja-JP/content/rest/gitignore.md +++ b/translations/ja-JP/content/rest/gitignore.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/gitignore --- +## About the Gitignore API + {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}上に新しいリポジトリをAPIを介して作成する場合、作成時にリポジトリに適用する[.gitignoreテンプレート](/github/getting-started-with-github/ignoring-files)を指定できます。 .gitignore テンプレート API は、{% data variables.product.product_name %} の [.gitignore リポジトリ](https://github.com/github/gitignore)からテンプレートを一覧表示してフェッチします。 ### gitignore のカスタムメディアタイプ diff --git a/translations/ja-JP/content/rest/licenses.md b/translations/ja-JP/content/rest/licenses.md index 98c4c948335f..baa38b9ab025 100644 --- a/translations/ja-JP/content/rest/licenses.md +++ b/translations/ja-JP/content/rest/licenses.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/licenses --- +## About the Licenses API + ライセンス API は[オープンソースの Ruby Gem ライセンス](https://github.com/benbalter/licensee)を使用して、プロセスのライセンスを特定しようとします。 ライセンシーは、プロジェクトの `LICENSE` ファイル (存在する場合) を既知のライセンスの短いリストと照合します。 そのためライセンス API では、プロジェクト依存関係のライセンス、あるいはプロジェクトのライセンスをドキュメント化するその他の方法、たとえばドキュメントにおけるライセンス名の参照などは考慮されません。 ライセンスが一致した場合、返されるライセンスキーおよび名前は[SPDX 仕様](https://spdx.org/)に適合します。 diff --git a/translations/ja-JP/content/rest/oauth-authorizations.md b/translations/ja-JP/content/rest/oauth-authorizations.md index e23b54e64a4b..2529f430cb1a 100644 --- a/translations/ja-JP/content/rest/oauth-authorizations.md +++ b/translations/ja-JP/content/rest/oauth-authorizations.md @@ -1,6 +1,6 @@ --- -title: OAuth 認証 -intro: 移行 API を使用できるのは、認証済みの Organization オーナーのみです。 +title: OAuth authorizations +intro: The OAuth authorizations lets you manage the access OAuth applications have to your account. versions: fpt: '*' ghec: '*' @@ -12,6 +12,8 @@ redirect_from: - /rest/reference/oauth-authorizations --- +## About the OAuth authorizations API + この API を使用すると、OAuth アプリケーションから自分のアカウントへのアクセスを管理することができます。 この API にアクセスするには、ユーザ名とパスワードを使用する [Basic 認証](/rest/overview/other-authentication-methods#basic-authentication) が必要であり、トークンは使用できません。 自分または自分のユーザが 2 要素認証を有効にしている場合は、必ず [2 要素認証の使用方法](/rest/overview/other-authentication-methods#working-with-two-factor-authentication)を理解していることを確認してください。 diff --git a/translations/ja-JP/content/rest/packages.md b/translations/ja-JP/content/rest/packages.md index ead5fa8efac9..7e759ee1a44a 100644 --- a/translations/ja-JP/content/rest/packages.md +++ b/translations/ja-JP/content/rest/packages.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/packages --- +## About the {% data variables.product.prodname_registry %} API + {% data variables.product.prodname_registry %} APIを使用すると、REST APIを利用してパッケージを管理できます。{% ifversion fpt or ghec or ghes > 3.1 or ghae %}パッケージの復元もしくは削除に関してさらに学ぶには、「[パッケージの復元と削除](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% endif %} このAPIを使うには、個人アクセストークンを使って認証を受けなければなりません。 diff --git a/translations/ja-JP/content/rest/rate-limit.md b/translations/ja-JP/content/rest/rate-limit.md index 9e49028f1206..0f1ad6451d78 100644 --- a/translations/ja-JP/content/rest/rate-limit.md +++ b/translations/ja-JP/content/rest/rate-limit.md @@ -1,6 +1,6 @@ --- title: レート制限 -intro: Rate Limit APIを使うと、様々なREST APIの現在のレート制限のステータスをチェックできます。 +intro: 'With the Rate limit API, you can check the current rate limit status of various REST APIs.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/rate-limit --- +## About the Rate limit API + REST API 概要ドキュメンテーションでは、[レート制限のルール](/rest/overview/resources-in-the-rest-api#rate-limiting)について説明しています。 以下で説明する Rate Limit API を使用して、現在のレート制限ステータスをいつでも確認できます。 ### レート制限のステータスを理解する diff --git a/translations/ja-JP/content/rest/reactions.md b/translations/ja-JP/content/rest/reactions.md index 3b15226cb989..afb94ecfe4f0 100644 --- a/translations/ja-JP/content/rest/reactions.md +++ b/translations/ja-JP/content/rest/reactions.md @@ -13,8 +13,8 @@ redirect_from: - /rest/reference/reactions --- -### リアクションタイプ +## About the Reactions API -リアクションを作成する際、`content`パラメータで利用可能な値は以下の通りです (参考のため、対応する絵文字も掲載します)。 +You can create and manage reactions on comments using the Reactions API. リアクションを作成する際、`content`パラメータで利用可能な値は以下の通りです (参考のため、対応する絵文字も掲載します)。 {% data reusables.repositories.reaction_list %} diff --git a/translations/ja-JP/content/rest/scim.md b/translations/ja-JP/content/rest/scim.md index 1a1f115db121..8547d26b266f 100644 --- a/translations/ja-JP/content/rest/scim.md +++ b/translations/ja-JP/content/rest/scim.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/scim --- +## About the SCIM API + ### Organization 向け SCIM プロビジョニング SCIM API は SCIM を有効にしたアイデンティティプロバイダ (IdPs) で、{% data variables.product.product_name %} Organization メンバーシップのプロビジョニングを自動化するために用いられます。 {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIは、[SCIM標準](http://www.simplecloud.info/)バージョン2に基づいています。 IdP が使用するべき {% data variables.product.product_name %} SCIM エンドポイントは、`{% data variables.product.api_url_code %}/scim/v2/organizations/{org}/` です。 diff --git a/translations/ja-JP/content/rest/search.md b/translations/ja-JP/content/rest/search.md index b0e59b9602c8..6559749e38f5 100644 --- a/translations/ja-JP/content/rest/search.md +++ b/translations/ja-JP/content/rest/search.md @@ -1,6 +1,6 @@ --- title: 検索 -intro: GitHub Search APIを使うと、特定のアイテムを効率的に検索できます。 +intro: 'The Search API lets you to search for specific items on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/search --- +## About the Search API + Search API は、見つけたい特定の項目を検索するために役立ちます。 たとえば、リポジトリ内のユーザや特定のファイルを見つけることができます。 Google で検索を実行するのと同じように考えてください。 Search API は、探している 1 つの結果 (または探しているいくつかの結果) を見つけるために役立つよう設計されています。 Google で検索する場合と同じように、ニーズに最も合う項目を見つけるため、検索結果を数ページ表示したい場合もあるでしょう。 こうしたニーズを満たすため、{% data variables.product.product_name %} Search API では**各検索につき 最大 1,000 件の結果**を提供します。 クエリを使って、検索を絞り込めます。 検索クエリ構文の詳細については、「[検索クエリの構築](/rest/reference/search#constructing-a-search-query)」を参照してください。 diff --git a/translations/ja-JP/content/rest/secret-scanning.md b/translations/ja-JP/content/rest/secret-scanning.md index 4150c82b1ad1..0addf737e4a5 100644 --- a/translations/ja-JP/content/rest/secret-scanning.md +++ b/translations/ja-JP/content/rest/secret-scanning.md @@ -1,6 +1,6 @@ --- -title: Secret Scanning -intro: Secret Scanning APIを使うと、リポジトリのシークレットアラートの取得と更新ができます。 +title: Secret scanning +intro: Use the Secret scanning API to retrieve and update secret alerts from a repository. versions: ghes: '*' ghae: '*' @@ -14,6 +14,8 @@ redirect_from: {% data reusables.secret-scanning.api-beta %} +## About the Secret scanning API + {% data variables.product.prodname_secret_scanning %} APIを使うと{% ifversion fpt or ghec or ghes > 3.1 or ghae %}以下のことができます。 - リポジトリの{% data variables.product.prodname_secret_scanning %}{% if secret-scanning-push-protection %}及びプッシュ保護{% endif %}の有効化あるいは無効化。 詳しい情報については「[リポジトリ](/rest/reference/repos#update-a-repository)」を参照し、REST APIドキュメンテーションの「`security_and_analysis`のプロパティ」セクションを展開してください。 diff --git a/translations/ja-JP/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml b/translations/ja-JP/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml index ea46ac2d2e3c..026c8aaa4a0e 100644 --- a/translations/ja-JP/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml +++ b/translations/ja-JP/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml @@ -21,13 +21,6 @@ upcoming_changes: date: '2020-01-01T00:00:00+00:00' criticality: 破壊的 owner: tambling - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: 保留中の全メンバーはライセンスを消費します - date: '2020-07-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline`は削除されます。代わりにIssue.timelineItemsを使ってください。' @@ -42,20 +35,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 破壊的 owner: mikesea - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべてのメンバーはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべての外部コラボレータはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT`は削除されます。代わりにPullRequest.isDraftを使ってください。' diff --git a/translations/ja-JP/data/graphql/ghec/graphql_upcoming_changes.public.yml b/translations/ja-JP/data/graphql/ghec/graphql_upcoming_changes.public.yml index 59a5df10181c..785baf021e94 100644 --- a/translations/ja-JP/data/graphql/ghec/graphql_upcoming_changes.public.yml +++ b/translations/ja-JP/data/graphql/ghec/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: 破壊的 owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: 保留中の全メンバーはライセンスを消費します - date: '2020-07-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline`は削除されます。代わりにIssue.timelineItemsを使ってください。' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 破壊的 owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべてのメンバーはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべての外部コラボレータはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT`は削除されます。代わりにPullRequest.isDraftを使ってください。' diff --git a/translations/ja-JP/data/graphql/graphql_upcoming_changes.public.yml b/translations/ja-JP/data/graphql/graphql_upcoming_changes.public.yml index 59a5df10181c..785baf021e94 100644 --- a/translations/ja-JP/data/graphql/graphql_upcoming_changes.public.yml +++ b/translations/ja-JP/data/graphql/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: 破壊的 owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: 保留中の全メンバーはライセンスを消費します - date: '2020-07-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline`は削除されます。代わりにIssue.timelineItemsを使ってください。' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 破壊的 owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべてのメンバーはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed`は削除されます。' - reason: すべての外部コラボレータはライセンスを消費します - date: '2021-01-01T00:00:00+00:00' - criticality: 破壊的 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT`は削除されます。代わりにPullRequest.isDraftを使ってください。' diff --git a/translations/log/cn-resets.csv b/translations/log/cn-resets.csv index 2834f0a4355a..a5ebdbd4e279 100644 --- a/translations/log/cn-resets.csv +++ b/translations/log/cn-resets.csv @@ -310,7 +310,7 @@ translations/zh-CN/data/reusables/package_registry/packages-cluster-support.md,b translations/zh-CN/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md,broken liquid tags translations/zh-CN/data/reusables/repositories/github-reviews-security-advisories.md,broken liquid tags translations/zh-CN/data/reusables/saml/you-must-periodically-authenticate.md,Listed in localization-support#489 -translations/zh-CN/data/reusables/saml/you-must-periodically-authenticate.md,broken liquid tags +translations/zh-CN/data/reusables/saml/you-must-periodically-authenticate.md,rendering error translations/zh-CN/data/reusables/scim/after-you-configure-saml.md,broken liquid tags translations/zh-CN/data/reusables/secret-scanning/enterprise-enable-secret-scanning.md,broken liquid tags translations/zh-CN/data/reusables/sponsors/feedback.md,broken liquid tags diff --git a/translations/log/es-resets.csv b/translations/log/es-resets.csv index 9801890c09f0..d3610cf37278 100644 --- a/translations/log/es-resets.csv +++ b/translations/log/es-resets.csv @@ -311,8 +311,8 @@ translations/es-ES/data/release-notes/github-ae/2021-06/2021-12-06.yml,broken li translations/es-ES/data/reusables/actions/contacting-support.md,broken liquid tags translations/es-ES/data/reusables/actions/enterprise-marketplace-actions.md,broken liquid tags translations/es-ES/data/reusables/actions/enterprise-storage-ha-backups.md,broken liquid tags -translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runner-groups.md,broken liquid tags -translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runners.md,broken liquid tags +translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runner-groups.md,rendering error +translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runners.md,rendering error translations/es-ES/data/reusables/code-scanning/codeql-context-for-actions-and-third-party-tools.md,broken liquid tags translations/es-ES/data/reusables/code-scanning/edit-workflow.md,broken liquid tags translations/es-ES/data/reusables/code-scanning/enabling-options.md,broken liquid tags diff --git a/translations/log/ja-resets.csv b/translations/log/ja-resets.csv index 4fffa56cb619..9d03fdf79ff5 100644 --- a/translations/log/ja-resets.csv +++ b/translations/log/ja-resets.csv @@ -115,6 +115,7 @@ translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scannin translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/dependabot-alerts/about-dependabot-alerts.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/dependabot-alerts/browsing-security-vulnerabilities-in-the-github-advisory-database.md,broken liquid tags +translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/working-with-dependabot/troubleshooting-the-detection-of-vulnerable-dependencies.md,broken liquid tags @@ -259,9 +260,9 @@ translations/ja-JP/data/reusables/dotcom_billing/lfs-remove-data.md,broken liqui translations/ja-JP/data/reusables/education/apply-for-team.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/actions-tab.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/hooks-tab.md,Listed in localization-support#489 -translations/ja-JP/data/reusables/enterprise-accounts/hooks-tab.md,broken liquid tags +translations/ja-JP/data/reusables/enterprise-accounts/hooks-tab.md,rendering error translations/ja-JP/data/reusables/enterprise-accounts/messages-tab.md,Listed in localization-support#489 -translations/ja-JP/data/reusables/enterprise-accounts/messages-tab.md,broken liquid tags +translations/ja-JP/data/reusables/enterprise-accounts/messages-tab.md,rendering error translations/ja-JP/data/reusables/enterprise-accounts/pages-tab.md,broken liquid tags translations/ja-JP/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md,broken liquid tags translations/ja-JP/data/reusables/enterprise_installation/upgrade-hardware-requirements.md,broken liquid tags diff --git a/translations/zh-CN/content/actions/automating-builds-and-tests/building-and-testing-swift.md b/translations/zh-CN/content/actions/automating-builds-and-tests/building-and-testing-swift.md index a4e83ea4bfb6..a85293f7ad02 100644 --- a/translations/zh-CN/content/actions/automating-builds-and-tests/building-and-testing-swift.md +++ b/translations/zh-CN/content/actions/automating-builds-and-tests/building-and-testing-swift.md @@ -65,7 +65,7 @@ jobs: ### 使用多个 Swift 版本 -You can configure your job to use multiple versions of Swift in a matrix. +您可以将作业配置为在矩阵中使用多个版本的 Swift。 ```yaml{:copy} {% data reusables.actions.actions-not-certified-by-github-comment %} diff --git a/translations/zh-CN/content/actions/learn-github-actions/contexts.md b/translations/zh-CN/content/actions/learn-github-actions/contexts.md index 7d3a1280eb83..9f71e8a7b4a5 100644 --- a/translations/zh-CN/content/actions/learn-github-actions/contexts.md +++ b/translations/zh-CN/content/actions/learn-github-actions/contexts.md @@ -23,7 +23,7 @@ miniTocMaxHeadingLevel: 3 上下文是一种访问工作流程运行、运行器环境、作业及步骤相关信息的方式。 每个上下文都是一个包含属性的对象，属性可以是字符串或其他对象。 -{% data reusables.actions.context-contents %} For example, the `matrix` context is only populated for jobs in a [matrix](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). +{% data reusables.actions.context-contents %} 例如，`matrix` 上下文中仅填充 [matrix](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix) 中的作业。 您可以使用表达式语法访问上下文。 更多信息请参阅“[表达式](/actions/learn-github-actions/expressions)”。 @@ -537,19 +537,19 @@ jobs: ## `strategy` 上下文 -For workflows with a matrix, the `strategy` context contains information about the matrix execution strategy for the current job. +对于具有矩阵的工作流程，`strategy` 上下文包含有关当前作业的矩阵执行策略的信息。 -| 属性名称 | 类型 | 描述 | -| ----------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `strategy` | `对象` | 此上下文针对工作流程运行中的每项作业而改变。 您可以从工作流程中的任何作业或步骤访问此上下文。 此对象包含下面列出的所有属性。 | -| `strategy.fail-fast` | `字符串` | When `true`, all in-progress jobs are canceled if any job in a matrix fails. 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)”。 | -| `strategy.job-index` | `字符串` | The index of the current job in the matrix. **注意：** 此数字是零基数字。 The first job's index in the matrix is `0`. | -| `strategy.job-total` | `字符串` | The total number of jobs in the matrix. **注意：** 此数字 **不是**从零基数字。 For example, for a matrix with four jobs, the value of `job-total` is `4`. | -| `strategy.max-parallel` | `字符串` | 使用 `matrix` 作业策略时可同时运行的最大作业数。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel)”。 | +| 属性名称 | 类型 | 描述 | +| ----------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `strategy` | `对象` | 此上下文针对工作流程运行中的每项作业而改变。 您可以从工作流程中的任何作业或步骤访问此上下文。 此对象包含下面列出的所有属性。 | +| `strategy.fail-fast` | `字符串` | 为 `true` 时，如果矩阵中的任何作业失败，所有正在进行的作业都将被取消。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)”。 | +| `strategy.job-index` | `字符串` | 矩阵中当前作业的索引。 **注意：** 此数字是零基数字。 矩阵中第一个作业的索引是 `0`。 | +| `strategy.job-total` | `字符串` | 矩阵中的作业总数。 **注意：** 此数字 **不是**从零基数字。 例如，对于具有四个作业的矩阵，`job-total` 的值为 `4`。 | +| `strategy.max-parallel` | `字符串` | 使用 `matrix` 作业策略时可同时运行的最大作业数。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel)”。 | ### `strategy` 上下文的示例内容 -The following example contents of the `strategy` context is from a matrix with four jobs, and is taken from the final job. 请注意零基 `job-index` 数字与 `job-total` （非零基）之间的差异。 +`strategy` 上下文的以下示例内容来自具有四个作业的矩阵，取自最终作业。 请注意零基 `job-index` 数字与 `job-total` （非零基）之间的差异。 ```yaml { @@ -562,7 +562,7 @@ The following example contents of the `strategy` context is from a matrix with f ### `strategy` 上下文的示例用法 -This example workflow uses the `strategy.job-index` property to set a unique name for a log file for each job in a matrix. +此示例工作流程使用 `strategy.job-index` 属性为矩阵中每个作业的日志文件设置唯一名称。 ```yaml{:copy} name: Test matrix @@ -587,18 +587,18 @@ jobs: ## `matrix` 上下文 -For workflows with a matrix, the `matrix` context contains the matrix properties defined in the workflow file that apply to the current job. For example, if you configure a matrix with the `os` and `node` keys, the `matrix` context object includes the `os` and `node` properties with the values that are being used for the current job. +对于具有矩阵的工作流程，`matrix` 上下文包含工作流程文件中定义的适用于当前作业的矩阵属性。 例如，如果使用 `os` 和 `node` 键配置矩阵，则 `matrix` 上下文对象将包括 `os` 和 `node` 属性，具有用于当前作业的值。 `matrix` 上下文中没有标准属性，只有工作流程文件中定义的属性。 -| 属性名称 | 类型 | 描述 | -| ------------------------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------- | -| `matrix` | `对象` | This context is only available for jobs in a matrix, and changes for each job in a workflow run. 您可以从工作流程中的任何作业或步骤访问此上下文。 此对象包含下面列出的属性。 | -| `matrix.` | `字符串` | 矩阵属性的值。 | +| 属性名称 | 类型 | 描述 | +| ------------------------------ | ----- | ----------------------------------------------------------------------------- | +| `matrix` | `对象` | 此上下文仅适用于矩阵中的作业，并且对于工作流程运行中的每个作业都会发生更改。 您可以从工作流程中的任何作业或步骤访问此上下文。 此对象包含下面列出的属性。 | +| `matrix.` | `字符串` | 矩阵属性的值。 | ### `matrix` 上下文的示例内容 -The following example contents of the `matrix` context is from a job in a matrix that has the `os` and `node` matrix properties defined in the workflow. 该作业执行 `ubuntu-latest` OS 和 Node.js 版本 `16` 的矩阵组合。 +`matrix` 上下文的以下示例内容来自矩阵中的作业，该矩阵具有工作流中定义的 `os` 和 `node` 矩阵属性。 该作业执行 `ubuntu-latest` OS 和 Node.js 版本 `16` 的矩阵组合。 ```yaml { @@ -609,7 +609,7 @@ The following example contents of the `matrix` context is from a job in a matrix ### `matrix` 上下文的示例用法 -This example workflow creates a matrix with `os` and `node` keys. 它使用 `matrix.os` 属性为每个作业设置运行器类型，并使用 `matrix.node` 属性为每个作业设置 Node.js 版本。 +此示例工作流程创建一个包含 `os` 和 `node` 键的矩阵。 它使用 `matrix.os` 属性为每个作业设置运行器类型，并使用 `matrix.node` 属性为每个作业设置 Node.js 版本。 ```yaml{:copy} name: Test matrix diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md index c2d60d3ad81e..8467680b8d9a 100644 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md @@ -50,7 +50,7 @@ CircleCI 和 {% data variables.product.prodname_actions %} 在配置文件中使 CircleCI 和 {% data variables.product.prodname_actions %} 都提供在工作流程中重复使用和共享任务的机制。 CircleCI 使用以 YAML 编写的概念 orbs 来提供人们可以在工作流程中重复使用的任务。 {% data variables.product.prodname_actions %} 具有强大而灵活的可重复使用的组件，称为“操作”，您可以使用 JavaScript 文件或 Docker 映像来构建操作。 您可以编写自定义代码来创建操作，以您喜欢的方式与仓库交互，包括使用 {% data variables.product.product_name %} 的 API 以及任何公开的第三方 API 进行交互。 例如，操作可以发布 npm 模块、在创建紧急议题时发送短信提醒，或者部署可用于生产的代码。 更多信息请参阅“[创建操作](/actions/creating-actions)”。 -CircleCI 可以使用 YAML 锚点和别名来重复使用工作流程的组件。 {% data variables.product.prodname_actions %} supports the most common need for reusability using matrices. For more information about matrices, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)." +CircleCI 可以使用 YAML 锚点和别名来重复使用工作流程的组件。 {% data variables.product.prodname_actions %} 使用矩阵支持对可重用性的最常见需求。 有关矩阵的详细信息，请参阅“[对作业使用矩阵](/actions/using-jobs/using-a-matrix-for-your-jobs)”。 ## 使用 Docker 映像 diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md index a42304f601fd..659902489229 100644 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md @@ -83,9 +83,9 @@ Jenkins 可以并行运行 `stages` 和 `steps`，而 {% data variables.product. | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | -### Matrix +### 矩阵 -Both {% data variables.product.prodname_actions %} and Jenkins let you use a matrix to define various system combinations. +{% data variables.product.prodname_actions %} 和 Jenkins 都允许您使用矩阵来定义各种系统组合。 | Jenkins | {% data variables.product.prodname_actions %} | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md index dc2ed3d7c0de..90976169f951 100644 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -59,9 +59,9 @@ Travis CI 可以使用 `stages` 并行运行作业。 同样，{% data variables Travis CI 和 {% data variables.product.prodname_actions %} 都支持状态徽章，用于表示构建是通过还是失败。 更多信息请参阅“[将工作流程状态徽章添加到仓库](/actions/managing-workflow-runs/adding-a-workflow-status-badge)”。 -### Using a matrix +### 使用矩阵 -Travis CI and {% data variables.product.prodname_actions %} both support a matrix, allowing you to perform testing using combinations of operating systems and software packages. For more information, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)." +Travis CI和 {% data variables.product.prodname_actions %} 都支持矩阵，允许您使用操作系统和软件包的组合进行测试。 更多信息请参阅“[对作业使用矩阵](/actions/using-jobs/using-a-matrix-for-your-jobs)”。 下面是比较每个系统的语法示例： diff --git a/translations/zh-CN/content/actions/using-jobs/using-a-matrix-for-your-jobs.md b/translations/zh-CN/content/actions/using-jobs/using-a-matrix-for-your-jobs.md index 40615bed484c..6cf64dbe09a9 100644 --- a/translations/zh-CN/content/actions/using-jobs/using-a-matrix-for-your-jobs.md +++ b/translations/zh-CN/content/actions/using-jobs/using-a-matrix-for-your-jobs.md @@ -1,6 +1,6 @@ --- title: Using a matrix for your jobs -shortTitle: Using a matrix +shortTitle: 使用矩阵 intro: Create a matrix to define variations for each job. versions: fpt: '*' @@ -23,15 +23,15 @@ redirect_from: {% data reusables.actions.jobs.using-matrix-strategy %} -### Example: Using a single-dimension matrix +### 示例：使用单维矩阵 {% data reusables.actions.jobs.single-dimension-matrix %} -### Example: Using a multi-dimension matrix +### 示例：使用多维矩阵 {% data reusables.actions.jobs.multi-dimension-matrix %} -### Example: Using contexts to create matrices +### 示例：使用上下文创建矩阵 {% data reusables.actions.jobs.matrix-from-context %} @@ -39,11 +39,11 @@ redirect_from: {% data reusables.actions.jobs.matrix-include %} -### Example: Expanding configurations +### 示例：展开配置 {% data reusables.actions.jobs.matrix-expand-with-include %} -### Example: Adding configurations +### 示例：添加配置 {% data reusables.actions.jobs.matrix-add-with-include %} diff --git a/translations/zh-CN/content/actions/using-workflows/about-workflows.md b/translations/zh-CN/content/actions/using-workflows/about-workflows.md index 3b4d8736dc41..50b59306e4cc 100644 --- a/translations/zh-CN/content/actions/using-workflows/about-workflows.md +++ b/translations/zh-CN/content/actions/using-workflows/about-workflows.md @@ -105,7 +105,7 @@ jobs: 更多信息请参阅“[定义先决条件作业](/actions/using-jobs/using-jobs-in-a-workflow#defining-prerequisite-jobs)”。 -### Using a matrix +### 使用矩阵 {% data reusables.actions.jobs.about-matrix-strategy %} The matrix is created using the `strategy` keyword, which receives the build options as an array. For example, this matrix will run the job multiple times, using different versions of Node.js: @@ -122,7 +122,7 @@ jobs: node-version: {% raw %}${{ matrix.node }}{% endraw %} ``` -For more information, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)." +更多信息请参阅“[对作业使用矩阵](/actions/using-jobs/using-a-matrix-for-your-jobs)”。 {% ifversion fpt or ghec %} ### 缓存依赖项 diff --git a/translations/zh-CN/content/actions/using-workflows/workflow-syntax-for-github-actions.md b/translations/zh-CN/content/actions/using-workflows/workflow-syntax-for-github-actions.md index 9cb491be0630..967e4576cafe 100644 --- a/translations/zh-CN/content/actions/using-workflows/workflow-syntax-for-github-actions.md +++ b/translations/zh-CN/content/actions/using-workflows/workflow-syntax-for-github-actions.md @@ -745,21 +745,21 @@ steps: ## `jobs..strategy` -Use `jobs..strategy` to use a matrix strategy for your jobs. {% data reusables.actions.jobs.about-matrix-strategy %} For more information, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)." +使用 `jobs..strategy` 为您的任务使用矩阵策略。 {% data reusables.actions.jobs.about-matrix-strategy %} 更多信息请参阅“[对作业使用矩阵](/actions/using-jobs/using-a-matrix-for-your-jobs)”。 ### `jobs..strategy.matrix` {% data reusables.actions.jobs.using-matrix-strategy %} -#### Example: Using a single-dimension matrix +#### 示例：使用单维矩阵 {% data reusables.actions.jobs.single-dimension-matrix %} -#### Example: Using a multi-dimension matrix +#### 示例：使用多维矩阵 {% data reusables.actions.jobs.multi-dimension-matrix %} -#### Example: Using contexts to create matrices +#### 示例：使用上下文创建矩阵 {% data reusables.actions.jobs.matrix-from-context %} @@ -767,11 +767,11 @@ Use `jobs..strategy` to use a matrix strategy for your jobs. {% data reu {% data reusables.actions.jobs.matrix-include %} -#### Example: Expanding configurations +#### 示例：展开配置 {% data reusables.actions.jobs.matrix-expand-with-include %} -#### Example: Adding configurations +#### 示例：添加配置 {% data reusables.actions.jobs.matrix-add-with-include %} diff --git a/translations/zh-CN/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md b/translations/zh-CN/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md index bb12d996c023..2d2daaaf8bfa 100644 --- a/translations/zh-CN/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md +++ b/translations/zh-CN/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md @@ -465,7 +465,6 @@ name: Dependabot auto-merge on: pull_request_target permissions: - pull-requests: write contents: write jobs: @@ -497,7 +496,6 @@ name: Dependabot auto-merge on: pull_request permissions: - pull-requests: write contents: write jobs: diff --git a/translations/zh-CN/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/zh-CN/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index 8293c6099c41..ec00950abee1 100644 --- a/translations/zh-CN/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/zh-CN/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -62,6 +62,7 @@ redirect_from: * `deployments` - 读/写 * `discussions` - 读/写 * `issues` - 读/写 + * `packages` - read * `pages` - 读/写 * `pull_requests` - 读/写 * `repository_projects` - 读/写 diff --git a/translations/zh-CN/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md b/translations/zh-CN/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md index 242eb1309553..e1ec45f21df0 100644 --- a/translations/zh-CN/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md +++ b/translations/zh-CN/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md @@ -1,6 +1,6 @@ --- title: 开发容器简介 -intro: 'When you work in a codespace, the environment you are working in is created using a development container, or dev container, hosted on a virtual machine.' +intro: 在代码空间中工作时，将使用虚拟机上托管的开发容器或开发容器创建您使用的环境。 permissions: People with write permissions to a repository can create or edit the codespace configuration. redirect_from: - /github/developing-online-with-github-codespaces/configuring-github-codespaces-for-your-project @@ -21,25 +21,25 @@ product: '{% data reusables.gated-features.codespaces %}' ## 关于开发容器 -Development containers, or dev containers, are Docker containers that are specifically configured to provide a full-featured development environment. Whenever you work in a codespace, you are using a dev container on a virtual machine. +开发容器或开发容器是专门配置为提供功能齐全的开发环境的 Docker 容器。 每当在代码空间中工作时，都会在虚拟机上使用开发容器。 -You can configure the dev container for a repository so that codespaces created for that repository give you a tailored development environment, complete with all the tools and runtimes you need to work on a specific project. If you don't define a configuration in the repository then {% data variables.product.prodname_github_codespaces %} uses a default configuration, which contains many of the common tools that your team might need for development with your project. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +您可以为存储库配置开发容器，以便为该存储库创建的代码空间为您提供量身定制的开发环境，其中包含处理特定项目所需的所有工具和运行时。 如果未在存储库中定义配置，则 {% data variables.product.prodname_github_codespaces %} 使用默认配置，其中包含团队在项目开发时可能需要的许多常用工具。 更多信息请参阅“[使用默认开发容器配置](#using-the-default-dev-container-configuration)”。 -The configuration files for a dev container are contained in a `.devcontainer` directory in your repository. You can use {% data variables.product.prodname_vscode %} to add configuration files for you. You can choose from a selection of predefined configurations for various project types. You can use these without further configuration, or you can edit the configurations to refine the development environment they produce. For more information, see "[Using a predefined dev container configuration](#using-a-predefined-dev-container-configuration)." +开发容器的配置文件包含在存储库中的 `.devcontainer` 目录中。 您可以使用 {% data variables.product.prodname_vscode %} 为您添加配置文件。 您可以从各种项目类型的预定义配置中进行选择。 您可以使用它们而无需进一步配置，也可以编辑配置以优化它们生成的开发环境。 更多信息请参阅“[使用预定义的开发容器配置](#using-a-predefined-dev-container-configuration)”。 -Alternatively, you can add your own custom configuration files. For more information, see "[Creating a custom dev container configuration](#creating-a-custom-dev-container-configuration)." +或者，您可以添加自己的自定义配置文件。 更多信息请参阅“[创建自定义开发容器配置](#creating-a-custom-dev-container-configuration)”。 -You can define a single dev container configuration for a repository, different configurations for different branches, or multiple configurations. When multiple configurations are available, users can choose their preferred configuration when they create a codespace. This is particularly useful for large repositories that contain source code in different programming languages or for different projects. You can create a choice of configurations that allow different teams to work in a codespace that's set up appropriately for the work they are doing. +可以为存储库定义单个开发容器配置，为不同分支定义不同的配置，或为多个配置定义多个配置。 当有多个配置可用时，用户可以在创建代码空间时选择其首选配置。 这对于包含不同编程语言源代码的大型存储库或不同的项目特别有用。 您可以创建一系列配置，允许不同的团队在为他们正在执行的工作而适当设置的代码空间中工作。 ### devcontainer.json -The primary file in a dev container configuration is the `devcontainer.json` file. You can use this file to determine the environment of codespaces created for your repository. The contents of this file define a dev container that can include frameworks, tools, extensions, and port forwarding. The `devcontainer.json` file usually contains a reference to a Dockerfile, which is typically located alongside the `devcontainer.json` file. +开发容器配置中的主文件是 `devcontainer.json` 文件。 您可以使用此文件来确定为存储库创建的代码空间的环境。 此文件的内容定义一个开发容器，其中可以包含框架、工具、扩展和端口转发。 `devcontainer.json` 文件通常包含对 Dockerfile 的引用，Dockerfile 通常位于 `devcontainer.json` 文件旁边。 -If you don't add a `devcontainer.json` file to your repository. the default dev container configuration is used. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +如果您没有将 `devcontainer.json` 文件添加到您的仓库。 使用默认的开发容器配置。 更多信息请参阅“[使用默认开发容器配置](#using-the-default-dev-container-configuration)”。 -The `devcontainer.json` file is usually located in the `.devcontainer` directory of your repository. Alternatively, you can locate it directly in the root of the repository, in which case the file name must begin with a period: `.devcontainer.json`. +`devcontainer.json` 文件通常位于存储库的 `.devcontainer` 目录中。 或者，您可以直接在存储库的根目录中找到它，在这种情况下，文件名必须以点开头：`.devcontainer.json`。 -If you want to have a choice of dev container configurations in your repository, any alternatives to the `.devcontainer/devcontainer.json` (or `.devcontainer.json`) file must be located in their own subdirectory at the path `.devcontainer/SUBDIRECTORY/devcontainer.json`. For example, you could have a choice of two configurations: +如果要在存储库中选择开发容器配置，则 `.devcontainer/devcontainer.json`（或 `.devcontainer.json`）文件的任何替代项都必须位于其自己的子目录中，路径为 `.devcontainer/SUBDIRECTORY/devcontainer.json`。 For example, you could have a choice of two configurations: * `.devcontainer/database-dev/devcontainer.json` * `.devcontainer/gui-dev/devcontainer.json` @@ -65,7 +65,7 @@ The Dockerfile for a dev container is typically located in the `.devcontainer` f {% note %} -**Note**: As an alternative to using a Dockerfile you can use the `image` property in the `devcontainer.json` file to refer directly to an existing image you want to use. If neither a Dockerfile nor an image is found then the default container image is used. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +**Note**: As an alternative to using a Dockerfile you can use the `image` property in the `devcontainer.json` file to refer directly to an existing image you want to use. If neither a Dockerfile nor an image is found then the default container image is used. 更多信息请参阅“[使用默认开发容器配置](#using-the-default-dev-container-configuration)”。 {% endnote %} @@ -150,7 +150,7 @@ You can add a predefined dev container configuration either while working in a c {% endnote %} -You can add features to your predefined container configuration to customize which tools are available and extend the functionality of your workspace without having to create a custom dev container configuration from scratch. For example, you could use a predefined container configuration and add the {% data variables.product.prodname_cli %}. 在设置容器配置时，可以通过将这些功能添加到 `devcontainer.json` 文件，使这些附加功能可用于项目。 +You can add features to your predefined container configuration to customize which tools are available and extend the functionality of your workspace without having to create a custom dev container configuration from scratch. 例如，您可以使用预定义的容器配置并添加 {% data variables.product.prodname_cli %}。 在设置容器配置时，可以通过将这些功能添加到 `devcontainer.json` 文件，使这些附加功能可用于项目。 您可以通过在配置预定义容器时选择一些最常用的功能来添加这些功能。 有关可用功能的详细信息，请参阅 `vscode-dev-containers` 存储库中的[脚本库](https://github.com/microsoft/vscode-dev-containers/tree/main/script-library#scripts) 。 @@ -161,17 +161,17 @@ You can add features to your predefined container configuration to customize whi 1. 更新您的功能选择，然后单击**确定**。 - ![The select additional features menu during container configuration](/assets/images/help/codespaces/select-additional-features.png) + ![容器配置期间的选择其他功能菜单。](/assets/images/help/codespaces/select-additional-features.png) 1. 要应用更改，请在屏幕右下角单击 **Rebuild now（立即重建）**。 有关重建容器的更多信息，请参阅“[应用对配置的更改](#applying-changes-to-your-configuration)”。 ![命令面板中的"Codespaces：重建容器"](/assets/images/help/codespaces/rebuild-prompt.png) -## Creating a custom dev container configuration +## 创建自定义开发容器配置 -If none of the predefined configurations meets your needs, you can create a custom configuration by writing your own `devcontainer.json` file. +如果预定义的配置都不能满足您的需求，则可以通过编写自己的 `devcontainer.json` 文件来创建自定义配置。 -* If you're adding a single `devcontainer.json` file that will be used by everyone who creates a codespace from your repository, create the file within a `.devcontainer` directory at the root of the repository. +* 如果要添加供从存储库创建代码空间的每个人使用的单个 `devcontainer.json` 文件，请在存储库根目录下的 `.devcontainer` 目录中创建该文件。 * If you want to offer users a choice of configuration, you can create multiple custom `devcontainer.json` files, each located within a separate subdirectory of the `.devcontainer` directory. {% note %} diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/reuse-an-assignment.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/reuse-an-assignment.md index a32d1ac2002c..fa4cca7bb0d0 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/reuse-an-assignment.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/reuse-an-assignment.md @@ -1,38 +1,38 @@ --- -title: Reuse an assignment -intro: 'You can reuse an existing assignment in more than one classroom, including classrooms in a different organization.' +title: 重复使用分配 +intro: 您可以在多个教室（包括其他组织中的教室）中重复使用现有作业。 versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can reuse assignments from a classroom. {% data reusables.classroom.classroom-admins-link %}' -shortTitle: Reuse an assignment +shortTitle: 重复使用分配 --- -## About reusing assignments +## 关于重复使用作业 -You can reuse an existing individual or group assignment in any other classroom you have access to, including classrooms in a different organization. If you choose to reuse an assignment, {% data variables.product.prodname_classroom %} will copy the assignment to the classroom you choose. If the assignment uses a template repository and you choose to reuse it in a classroom from a different organization, {% data variables.product.prodname_classroom %} will create a copy of the repository and its contents in the target organization. +您可以在您有权访问的任何其他教室（包括其他组织中的教室）中重复使用现有的个人或小组作业。 如果您选择重复使用作业，{% data variables.product.prodname_classroom %} 会将作业复制到您选择的教室。 如果作业使用模板存储库，并且您选择在其他组织的教室中重复使用它，{% data variables.product.prodname_classroom %} 将在目标组织中创建存储库及其内容的副本。 -The copied assignment includes assignment details such as the name, source repository, autograding test, and preferred editor. You can edit the assignment after it has been copied to make changes. You cannot make changes to the preferred editor. +复制的作业包括作业详细信息，例如名称、源存储库、自动评分测试和首选编辑器。 复制任务后，您可以对其进行编辑以进行更改。 您无法对首选编辑器进行更改。 -## Reusing an assignment +## 重复使用作业 1. 登录 {% data variables.product.prodname_classroom_with_url %}。 -1. Navigate to the classroom that has the assignment that you want to reuse. +1. 导航到包含要重复使用的作业的教室。 ![组织教室列表中的教室](/assets/images/help/classroom/click-classroom-in-list.png) -1. In the list of assignments, click the assignment you want to reuse. +1. 在作业列表中，单击要重复使用的作业。 ![课堂作业列表中的作业](/assets/images/help/classroom/click-assignment-in-list.png) -1. Select the **{% octicon "pencil" aria-label="The pencil icon" %} Edit** dropdown menu in the top right of the page, then click **{% octicon "sync" aria-label="The sync icon" %} Reuse assignment**. +1. 选择页面右上角的 **{% octicon "pencil" aria-label="The pencil icon" %} Edit（编辑）**下拉菜单，然后单击 **{% octicon "sync" aria-label="The sync icon" %} Reuse assignment（重复使用作业）**。 - ![Reuse assignment button](/assets/images/help/classroom/reuse-assignment-button.png) + ![重复使用作业按钮](/assets/images/help/classroom/reuse-assignment-button.png) -1. In "Reuse assignment" modal, use the **Choose an organization** dropdown menu to select the organization you want the assignment to be in. Then use the **Choose a classroom** dropdown menu to select the classroom within that organization that you want to copy the assignment to. +1. 在“Reuse assignment（重复使用作业）”模式中，使用 **Choose an organization（选择组织）**下拉菜单选择您希望作业所在的组织。 然后使用 **Choose a classroom（选择教室）**下拉菜单选择要将作业复制到的组织中教室。 - ![Reuse assignment modal](/assets/images/help/classroom/reuse-assignment-modal.png) + ![重复使用作业模式](/assets/images/help/classroom/reuse-assignment-modal.png) -1. Click **Create assignment**. -1. The assignment is copied to the selected classroom, and a confirmation message is shown. If you chose to reuse an assignment with a template repository, the copying process may take a few minutes to complete, and you may need to refresh the page to see the completed message. +1. 单击 **Create assignment（创建作业）**。 +1. 作业将复制到所选教室，并显示一条确认消息。 如果选择在模板存储库中重复使用作业，则复制过程可能需要几分钟才能完成，并且可能需要刷新页面才能看到已完成的消息。 - ![Completed message for reused assignment](/assets/images/help/classroom/reuse-assignment-completed-message.png) + ![重复使用的作业已完成消息](/assets/images/help/classroom/reuse-assignment-completed-message.png) diff --git a/translations/zh-CN/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md b/translations/zh-CN/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md index 99cf4ba09af3..92acbec8915e 100644 --- a/translations/zh-CN/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md +++ b/translations/zh-CN/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md @@ -23,7 +23,7 @@ permissions: Organization owners can remove members from an organization. **警告：**当您从组织删除成员时： - 付费的许可数不会自动降级。 要在从组织中删除用户后减少付费的许可数，请按照“[降级组织的付费席位](/articles/downgrading-your-organization-s-paid-seats)”中的步骤操作。 - 被删除的成员将无法访问组织私有仓库的私人复刻，但仍可拥有本地副本。 但是，它们无法将本地副本与组织的仓库同步。 如果用户在从组织中删除后的三个月内[恢复为组织成员](/articles/reinstating-a-former-member-of-your-organization)，则可以恢复其私人复刻。 最终，您负责确保无法访问仓库的人员删除任何机密信息或知识产权。 -- When private repositories are forked to other organizations, those organizations are able to control access to the fork network. This means users may retain access to the forks even after losing access to the original organization because they will still have explicit access via a fork. +- 当私有存储库复刻到其他组织时，这些组织能够控制对复刻网络的访问。 这意味着用户即使在失去对原始组织的访问权限后，仍可以保留对复刻的访问权限，因为他们仍可以通过复刻进行显式访问。 {%- ifversion ghec %} - 如果被删除成员不是同一企业帐户拥有的任何其他组织的成员，则被删除成员也将失去对组织内部仓库私人复刻的访问权限。 更多信息请参阅“[关于企业帐户](/admin/overview/about-enterprise-accounts)”。 {%- endif %} diff --git a/translations/zh-CN/content/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization.md b/translations/zh-CN/content/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization.md index 71cc39fb9d25..03787aab0a65 100644 --- a/translations/zh-CN/content/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization.md +++ b/translations/zh-CN/content/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization.md @@ -19,7 +19,7 @@ You can also manage repository discussions. For more information, see "[Enabling ## Enabling or disabling {% data variables.product.prodname_discussions %} for your organization {% data reusables.discussions.enabling-or-disabling-github-discussions-for-your-organization %} -1. To disable discussions, under "Discussions", unselect **Enable discussions for this organization**. +1. 要禁用讨论，请在“Discussions（讨论）”下，取消选择 **Enable discussions for this organization（为此组织启用讨论）**。 ## 延伸阅读 diff --git a/translations/zh-CN/content/rest/actions/artifacts.md b/translations/zh-CN/content/rest/actions/artifacts.md index 8dc3038c7f1b..1eef8c22c68c 100644 --- a/translations/zh-CN/content/rest/actions/artifacts.md +++ b/translations/zh-CN/content/rest/actions/artifacts.md @@ -1,6 +1,8 @@ --- -title: 构件 -intro: 构件 API 允许您下载、删除和检索有关工作流程构件的信息。 +title: GitHub Actions Artifacts +allowTitleToDifferFromFilename: true +shortTitle: 构件 +intro: 'The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-artifacts %}更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 +## About the Artifacts API + +The {% data variables.product.prodname_actions %} Artifacts API allows you to download, delete, and retrieve information about workflow artifacts. {% data reusables.actions.about-artifacts %}更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/zh-CN/content/rest/actions/cache.md b/translations/zh-CN/content/rest/actions/cache.md index 0bfe14d308a1..359b5a818b3e 100644 --- a/translations/zh-CN/content/rest/actions/cache.md +++ b/translations/zh-CN/content/rest/actions/cache.md @@ -1,6 +1,8 @@ --- -title: 缓存 -intro: 'The Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' +title: GitHub Actions Cache +allowTitleToDifferFromFilename: true +shortTitle: 缓存 +intro: 'The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' topics: - API versions: @@ -8,4 +10,6 @@ versions: ghec: '*' --- -The cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories. 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)”。 +## About the Cache API + +The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories. 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)”。 diff --git a/translations/zh-CN/content/rest/actions/permissions.md b/translations/zh-CN/content/rest/actions/permissions.md index 431c24cd2e33..dde543c8d5eb 100644 --- a/translations/zh-CN/content/rest/actions/permissions.md +++ b/translations/zh-CN/content/rest/actions/permissions.md @@ -1,6 +1,8 @@ --- -title: 权限 -intro: 'The Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.' +title: GitHub Actions Permissions +allowTitleToDifferFromFilename: true +shortTitle: 权限 +intro: 'The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.' topics: - API versions: @@ -10,6 +12,6 @@ versions: ghec: '*' --- -## 权限 +## About the Permissions API -The Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)."{% endif %} +The {% data variables.product.prodname_actions %} Permissions API allows you to set permissions for what enterprises, organizations, and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions{% if actions-workflow-policy %} and reusable workflows{% endif %} are allowed to run.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)."{% endif %} diff --git a/translations/zh-CN/content/rest/actions/secrets.md b/translations/zh-CN/content/rest/actions/secrets.md index bcf0fac8ac94..80b2ffe09b86 100644 --- a/translations/zh-CN/content/rest/actions/secrets.md +++ b/translations/zh-CN/content/rest/actions/secrets.md @@ -1,6 +1,8 @@ --- -title: 密码 -intro: 密码 API 允许您创建、更新、删除和检索有关加密密码的信息。 +title: GitHub Actions Secrets +allowTitleToDifferFromFilename: true +shortTitle: 密码 +intro: 'The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows.' topics: - API versions: @@ -10,6 +12,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-secrets %}更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 +## About the Secrets API + +The {% data variables.product.prodname_actions %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets that can be used in {% data variables.product.prodname_actions %} workflows. {% data reusables.actions.about-secrets %}更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} 必须具有`密码`权限才可使用此 API。 经过身份验证的用户必须对仓库具有协作者权限才可创建、更新或读取密码。 diff --git a/translations/zh-CN/content/rest/actions/self-hosted-runner-groups.md b/translations/zh-CN/content/rest/actions/self-hosted-runner-groups.md index ffc23e760860..6de07c641222 100644 --- a/translations/zh-CN/content/rest/actions/self-hosted-runner-groups.md +++ b/translations/zh-CN/content/rest/actions/self-hosted-runner-groups.md @@ -11,8 +11,8 @@ versions: --- -## 自托管运行器组 +## About the Self-hosted runner groups API -自托管运行器组 API 允许您管理自托运行器组。 更多信息请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。 +The Self-hosted runners groups API allows you manage groups of self-hosted runners. 更多信息请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} 必须对仓库具有`管理`权限，或者对组织具有 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。 diff --git a/translations/zh-CN/content/rest/actions/self-hosted-runners.md b/translations/zh-CN/content/rest/actions/self-hosted-runners.md index f3e760972fc1..152675f7896e 100644 --- a/translations/zh-CN/content/rest/actions/self-hosted-runners.md +++ b/translations/zh-CN/content/rest/actions/self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: 自托管运行器 -intro: 自托管运行器 API 允许您注册、查看和删除自托管的运行器。 +intro: 'The Self-hosted runners API allows you to register, view, and delete self-hosted runners.' topics: - API versions: @@ -11,8 +11,8 @@ versions: --- -## 自托管运行器 +## About the Self-hosted runners API -自托管运行器 API 允许您注册、查看和删除自托管的运行器。 {% data reusables.actions.about-self-hosted-runners %} 更多信息请参阅“[托管您自己的运行器](/actions/hosting-your-own-runners)”。 +The Self-hosted runners API allows you to register, view, and delete self-hosted runners. {% data reusables.actions.about-self-hosted-runners %} 更多信息请参阅“[托管您自己的运行器](/actions/hosting-your-own-runners)”。 {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} 必须对仓库具有`管理`权限，或者对组织具有 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须具有对存储库或组织的管理员访问权限或者企业的 `manage_runners:enterprise` 作用域才能使用此 API。 diff --git a/translations/zh-CN/content/rest/actions/workflow-jobs.md b/translations/zh-CN/content/rest/actions/workflow-jobs.md index c642b051e43e..fb3793e430a1 100644 --- a/translations/zh-CN/content/rest/actions/workflow-jobs.md +++ b/translations/zh-CN/content/rest/actions/workflow-jobs.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-jobs %} 更多信息请参阅“[GitHub Actions 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”。 +## About the Workflow jobs API + +The Workflow jobs API allows you to view logs and workflow jobs. {% data reusables.actions.about-workflow-jobs %} 更多信息请参阅“[GitHub Actions 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/zh-CN/content/rest/actions/workflow-runs.md b/translations/zh-CN/content/rest/actions/workflow-runs.md index 3fca12a420d1..f3779d70488a 100644 --- a/translations/zh-CN/content/rest/actions/workflow-runs.md +++ b/translations/zh-CN/content/rest/actions/workflow-runs.md @@ -1,6 +1,6 @@ --- -title: Workflow runs -intro: 'The Workflow Runs API allows you to view, re-run, cancel, and view logs for workflow runs.' +title: 工作流程运行 +intro: 'The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs.' topics: - API versions: @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflow-runs %} For more information, see "[Managing a workflow run](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)." +## About the Workflow runs API -{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} \ No newline at end of file +The Workflow runs API allows you to view, re-run, cancel, and view logs for workflow runs. {% data reusables.actions.about-workflow-runs %} 更多信息请参阅“[管理工作流程运行](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)”。 + +{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/zh-CN/content/rest/actions/workflows.md b/translations/zh-CN/content/rest/actions/workflows.md index f1ad5b3ea636..b99c7a9dbd77 100644 --- a/translations/zh-CN/content/rest/actions/workflows.md +++ b/translations/zh-CN/content/rest/actions/workflows.md @@ -10,6 +10,8 @@ versions: ghec: '*' --- -{% data reusables.actions.about-workflows %} 更多信息请参阅“[使用 GitHub Actions 自动化工作流程](/actions/automating-your-workflow-with-github-actions)”。 +## About the Workflows API + +工作流程 API 允许您查看仓库的工作流程。 {% data reusables.actions.about-workflows %} 更多信息请参阅“[使用 GitHub Actions 自动化工作流程](/actions/automating-your-workflow-with-github-actions)”。 {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} diff --git a/translations/zh-CN/content/rest/activity/feeds.md b/translations/zh-CN/content/rest/activity/feeds.md index 22a0be6f20db..b5def8924fff 100644 --- a/translations/zh-CN/content/rest/activity/feeds.md +++ b/translations/zh-CN/content/rest/activity/feeds.md @@ -11,9 +11,13 @@ topics: miniTocMaxHeadingLevel: 3 --- -### Example of getting an Atom feed +## About the Feeds API -To get a feed in Atom format, you must specify the `application/atom+xml` type in the `Accept` header. For example, to get the Atom feed for GitHub security advisories: +To see what feeds are available to you, use the [Get feeds](#get-feeds) operation. You can then get a feed by sending a request to one of the feed URLs. + +### 获取 Atom 馈送的示例 + +要获取 Atom 格式的馈送，您必须在 `Accept` 标头中指定 `application/atom+xml` 类型。 例如，要获取 GitHub 安全通告的 Atom 馈送： curl -H "Accept: application/atom+xml" https://github.com/security-advisories diff --git a/translations/zh-CN/content/rest/activity/notifications.md b/translations/zh-CN/content/rest/activity/notifications.md index d5954e25d23f..562228f287b9 100644 --- a/translations/zh-CN/content/rest/activity/notifications.md +++ b/translations/zh-CN/content/rest/activity/notifications.md @@ -1,6 +1,6 @@ --- title: 通知 -intro: '' +intro: 'The Notifications API lets you manage {% data variables.product.product_name %} notifications.' versions: fpt: '*' ghes: '*' @@ -11,18 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -用户将收到其关注的仓库中各种对话的通知，包括： +## About the Notifications API -* 议题及其评论 -* 拉取请求及其评论 -* 对任何提交的评论 - -当用户涉及未关注仓库中的对话时也会发送通知，包括： - -* **@提及** -* 议题分配 -* 提交用户作者或提交 -* 用户积极参与的任何讨论 +The Notifications API lets you manage {% data variables.product.product_name %} notifications. For more information about notifications, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." 所有通知 API 调用都需要 `notifications` 或 `repo` API 作用域。 这将赋予对某些议题和提交内容的只读权限。 您仍需要 `repo` 作用域才能从相应的端点访问议题和提交。 @@ -44,11 +35,11 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" > X-Poll-Interval: 60 ``` -### 通知原因 +### About notification reasons 从通知 API 检索响应时，每个有效负载都有一个名为 `reason` 的键。 这些键对应于触发通知的事件。 -以下是收到通知的可能 `reason` 列表： +These are the potential `reason`s for receiving a notification: | 原因名称 | 描述 | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | diff --git a/translations/zh-CN/content/rest/activity/starring.md b/translations/zh-CN/content/rest/activity/starring.md index 7586b266b256..7aff50956b35 100644 --- a/translations/zh-CN/content/rest/activity/starring.md +++ b/translations/zh-CN/content/rest/activity/starring.md @@ -1,6 +1,6 @@ --- title: 标星 -intro: 仓库标星是允许用户为仓库添加书签的功能。 +intro: The Starring API lets you bookmark a repository. versions: fpt: '*' ghes: '*' @@ -11,7 +11,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -显示在仓库旁边的星标表示大致的兴趣程度。 星标对通知或活动馈送没有影响。 +## About the Starring API + +The Starring API lets you bookmark a repository. 显示在仓库旁边的星标表示大致的兴趣程度。 星标对通知或活动馈送没有影响。 更多信息请参阅“[使用星标保存仓库](/get-started/exploring-projects-on-github/saving-repositories-with-stars)”。 ### 标星与 关注 diff --git a/translations/zh-CN/content/rest/activity/watching.md b/translations/zh-CN/content/rest/activity/watching.md index 081083333b8e..09416c06d836 100644 --- a/translations/zh-CN/content/rest/activity/watching.md +++ b/translations/zh-CN/content/rest/activity/watching.md @@ -1,6 +1,6 @@ --- title: 关注 -intro: 关注仓库会注册用户接收有关新讨论的通知以及用户活动馈送中的事件。 +intro: The Watching API lets users subscribe to notifications for activity in a repository. versions: fpt: '*' ghes: '*' @@ -11,4 +11,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -有关简单的仓库书签制作，请参阅“[仓库标星](/rest/reference/activity#starring)”。 +## About the Watching API + +The Watching API lets users subscribe to notifications for activity in a repository. To bookmark a repository instead, see "[Starring](/rest/reference/activity#starring)." diff --git a/translations/zh-CN/content/rest/billing.md b/translations/zh-CN/content/rest/billing.md index fcb6913843a8..d9f0213c64b2 100644 --- a/translations/zh-CN/content/rest/billing.md +++ b/translations/zh-CN/content/rest/billing.md @@ -1,6 +1,6 @@ --- title: 计费 -intro: '' +intro: The Billing API lets you get billing information for an enterprise. topics: - API miniTocMaxHeadingLevel: 3 @@ -12,4 +12,6 @@ redirect_from: - /rest/reference/billing --- +## About the Billing API + 您可以获取企业的帐单信息。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#billing)”REST API。 diff --git a/translations/zh-CN/content/rest/code-scanning.md b/translations/zh-CN/content/rest/code-scanning.md index 83b252779689..4b8127019050 100644 --- a/translations/zh-CN/content/rest/code-scanning.md +++ b/translations/zh-CN/content/rest/code-scanning.md @@ -1,6 +1,6 @@ --- title: Code Scanning -intro: '' +intro: '{% data variables.product.prodname_code_scanning %} API 可让您从仓库检索和更新 {% data variables.product.prodname_code_scanning %} 警报。' versions: fpt: '*' ghes: '*' @@ -17,6 +17,8 @@ redirect_from: {% data reusables.code-scanning.beta %} +## About the Code scanning API + {% data variables.product.prodname_code_scanning %} API 可让您从仓库检索和更新 {% data variables.product.prodname_code_scanning %} 警报。 您可以使用端点为组织中的 {% data variables.product.prodname_code_scanning %} 警报创建自动报告，或上传使用离线 {% data variables.product.prodname_code_scanning %} 工具生成的分析结果。 更多信息请参阅“[查找代码中的安全漏洞和错误](/github/finding-security-vulnerabilities-and-errors-in-your-code)”。 {% ifversion fpt or ghes > 3.0 or ghae or ghec %} diff --git a/translations/zh-CN/content/rest/codes-of-conduct.md b/translations/zh-CN/content/rest/codes-of-conduct.md index 93bef913ca1e..a3e3ece07059 100644 --- a/translations/zh-CN/content/rest/codes-of-conduct.md +++ b/translations/zh-CN/content/rest/codes-of-conduct.md @@ -1,6 +1,6 @@ --- -title: Codes of Conduct -intro: '' +title: 行为准则 +intro: The Codes of conduct API lets you retrieve information about a repository's code of conduct. versions: fpt: '*' ghes: '*' @@ -13,4 +13,6 @@ redirect_from: - /rest/reference/codes-of-conduct --- -您可以使用行为准则 API 检索有关仓库行为准则的信息。 要获取仓库的行为准则，请使用“[获取仓库](/rest/reference/repos#get-a-repository)”端点。 +## About the Codes of conduct API + +您可以使用行为准则 API 检索有关仓库行为准则的信息。 To get a code of conduct for a repository, use the "[Get a repository](/rest/reference/repos#get-a-repository)" endpoint. diff --git a/translations/zh-CN/content/rest/commits/comments.md b/translations/zh-CN/content/rest/commits/comments.md index b2727938f8a4..3e5183e61614 100644 --- a/translations/zh-CN/content/rest/commits/comments.md +++ b/translations/zh-CN/content/rest/commits/comments.md @@ -1,6 +1,6 @@ --- title: 提交注释 -intro: '' +intro: The Commit comments API lets you create and edit comments that relate to specific commits. versions: fpt: '*' ghes: '*' @@ -12,6 +12,10 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- +## About the commit comments API + +The Commit comments API lets you create and edit comments that relate to specific commits. + ### 提交评论的自定义媒体类型 以下是提交评论支持的媒体类型。 您可以在[此处](/rest/overview/media-types)阅读有关 API 中媒体类型使用情况的更多信息。 diff --git a/translations/zh-CN/content/rest/commits/statuses.md b/translations/zh-CN/content/rest/commits/statuses.md index 3f99c9d4a797..06eab3f1c7b8 100644 --- a/translations/zh-CN/content/rest/commits/statuses.md +++ b/translations/zh-CN/content/rest/commits/statuses.md @@ -1,6 +1,6 @@ --- title: 提交状态 -intro: 'The status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits.' +intro: 'The Commit status API allows external services to mark commits with a status, which is then reflected in pull requests involving those commits.' versions: fpt: '*' ghes: '*' @@ -12,7 +12,9 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. +## About the Commit statuses API + +The Commit status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits. Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. As an example, one common use is for continuous integration services to mark commits as passing or failing builds using status. The `target_url` would be the full URL to the build output, and the `description` would be the high level summary of what happened with the build. diff --git a/translations/zh-CN/content/rest/dependabot/secrets.md b/translations/zh-CN/content/rest/dependabot/secrets.md index c1cbce2714c1..12a82396d647 100644 --- a/translations/zh-CN/content/rest/dependabot/secrets.md +++ b/translations/zh-CN/content/rest/dependabot/secrets.md @@ -1,6 +1,7 @@ --- -title: 密码 -intro: 'With the Dependabot Secrets API, you can manage and control Dependabot secrets for an organization or repository.' +title: Dependabot secrets +shortTitle: 密码 +intro: 'With the {% data variables.product.prodname_dependabot %} secrets API, you can manage and control {% data variables.product.prodname_dependabot %} secrets for an organization or repository.' topics: - API versions: @@ -10,6 +11,8 @@ versions: allowTitleToDifferFromFilename: true --- -The {% data variables.product.prodname_dependabot %} Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} For more information, see "[Managing encrypted secrets for Dependabot](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)." +## About the {% data variables.product.prodname_dependabot %} secrets API + +The {% data variables.product.prodname_dependabot %} secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} For more information, see "[Managing encrypted secrets for Dependabot](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)." {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} must have the `dependabot_secrets` permission to use this API. 经过身份验证的用户必须对仓库具有协作者权限才可创建、更新或读取密码。 diff --git a/translations/zh-CN/content/rest/dependency-graph/dependency-review.md b/translations/zh-CN/content/rest/dependency-graph/dependency-review.md index 83ece1c9bc5b..2d3bd59d5e7a 100644 --- a/translations/zh-CN/content/rest/dependency-graph/dependency-review.md +++ b/translations/zh-CN/content/rest/dependency-graph/dependency-review.md @@ -1,6 +1,6 @@ --- title: 依赖项审查 -intro: 'The Dependency Review API allows you to understand dependency changes, and the security impact of these changes, before you add them to your environment.' +intro: 'The Dependency review API allows you to understand dependency changes, and the security impact of these changes, before you add them to your environment.' versions: fpt: '*' ghes: '>=3.6' @@ -12,7 +12,7 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -## 依赖项审查 +## About the Dependency review API {% data reusables.dependency-review.dependency-review-api-beta-note %} diff --git a/translations/zh-CN/content/rest/deploy-keys.md b/translations/zh-CN/content/rest/deploy-keys.md index 2b0606fe3e19..08999db85aab 100644 --- a/translations/zh-CN/content/rest/deploy-keys.md +++ b/translations/zh-CN/content/rest/deploy-keys.md @@ -1,6 +1,6 @@ --- -title: 管理部署密钥 -intro: '' +title: 部署密钥 +intro: The Deploy keys API lets you create and manage deploy keys. versions: fpt: '*' ghes: '*' @@ -14,6 +14,8 @@ redirect_from: - /rest/reference/deploy_keys --- +## About the Deploy keys API + {% data reusables.repositories.deploy-keys %} 部署密钥可以使用以下 API 端点进行设置，也可以使用 GitHub 进行设置。 要了解如何在 GitHub 中设置部署密钥，请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys)”。 diff --git a/translations/zh-CN/content/rest/gists/comments.md b/translations/zh-CN/content/rest/gists/comments.md index 20e248158fe3..4e566344c9a0 100644 --- a/translations/zh-CN/content/rest/gists/comments.md +++ b/translations/zh-CN/content/rest/gists/comments.md @@ -1,6 +1,8 @@ --- -title: 评论 -intro: '' +title: Gist comments +allowTitleToDifferFromFilename: true +shortTitle: 评论 +intro: The Gist comments API lets you view and modify comments on a gist. versions: fpt: '*' ghes: '*' @@ -11,6 +13,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gist comments API + +The Gist comments API lets you view and modify comments on a gist. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### Gist 评论的自定义媒体类型 以下是 Gist 评论支持的媒体类型。 diff --git a/translations/zh-CN/content/rest/gists/gists.md b/translations/zh-CN/content/rest/gists/gists.md index 0f07714bcfd6..dd848b14390c 100644 --- a/translations/zh-CN/content/rest/gists/gists.md +++ b/translations/zh-CN/content/rest/gists/gists.md @@ -11,6 +11,10 @@ topics: miniTocMaxHeadingLevel: 3 --- +## About the Gists API + +The Gist API lets you view and modify gists. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)." + ### 身份验证 您可以匿名读取公开 Gist {% ifversion ghae or ghes %}并为没有令牌的匿名用户创建它们。{% else %}，但是您必须登录到 GitHub 才能创建 Gist。{% endif %} 要代表用户读取或写入 Gist，您需要 Gist OAuth 作用域和令牌。 更多信息请参阅“[OAuth 应用程序的作用域](/developers/apps/scopes-for-oauth-apps)”。 diff --git a/translations/zh-CN/content/rest/git/blobs.md b/translations/zh-CN/content/rest/git/blobs.md index 3aeeffbcd2a1..b5afa5668ef7 100644 --- a/translations/zh-CN/content/rest/git/blobs.md +++ b/translations/zh-CN/content/rest/git/blobs.md @@ -1,6 +1,8 @@ --- -title: Blob -intro: Git Blob（二进制大对象）是用于将每个文件的内容存储在仓库中的对象类型。 +title: Git blobs +shortTitle: Blob +allowTitleToDifferFromFilename: true +intro: 'The Git blob API lets you create and get a Git blob (binary large object), the object type used to store the contents of each file in a repository.' versions: fpt: '*' ghes: '*' @@ -11,7 +13,9 @@ topics: miniTocMaxHeadingLevel: 3 --- -文件的 SHA-1 哈希在 Blob 对象中计算和存储。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入 [blob 对象](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)。 Blob 使用[这些自定义媒体类型](#custom-media-types-for-blobs)。 您可以在[此处](/rest/overview/media-types)阅读有关 API 中媒体类型使用情况的更多信息。 +## About the Git blob API + +Git Blob（二进制大对象）是用于将每个文件的内容存储在仓库中的对象类型。 文件的 SHA-1 哈希在 Blob 对象中计算和存储。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入 [blob 对象](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)。 Blob 使用[这些自定义媒体类型](#custom-media-types-for-blobs)。 您可以在[此处](/rest/overview/media-types)阅读有关 API 中媒体类型使用情况的更多信息。 ### Blob 的自定义媒体类型 diff --git a/translations/zh-CN/content/rest/git/commits.md b/translations/zh-CN/content/rest/git/commits.md index 308e8d966e66..affa2ba246ea 100644 --- a/translations/zh-CN/content/rest/git/commits.md +++ b/translations/zh-CN/content/rest/git/commits.md @@ -1,6 +1,8 @@ --- -title: 提交 -intro: 'A Git commit is a snapshot of the hierarchy ([Git tree](/rest/reference/git#trees)) and the contents of the files ([Git blob](/rest/reference/git#blobs)) in a Git repository.' +title: Git commits +shortTitle: 提交 +allowTitleToDifferFromFilename: true +intro: 'The Git commits API lets you read and write commit objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}. +## About the Git commits API + +A Git commit is a snapshot of the hierarchy ([Git tree](/rest/reference/git#trees)) and the contents of the files ([Git blob](/rest/reference/git#blobs)) in a Git repository. These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}. diff --git a/translations/zh-CN/content/rest/git/refs.md b/translations/zh-CN/content/rest/git/refs.md index b53ce3b0b2d9..9be59d2be6c3 100644 --- a/translations/zh-CN/content/rest/git/refs.md +++ b/translations/zh-CN/content/rest/git/refs.md @@ -1,6 +1,7 @@ --- -title: 引用 -intro: A Git reference (`git ref`) is just a file that contains a Git commit SHA-1 hash. +title: Git references +shortTitle: 引用 +intro: 'The Git references API lets you read and write references to your Git database on {% data variables.product.product_name %}' versions: fpt: '*' ghes: '*' @@ -12,4 +13,6 @@ miniTocMaxHeadingLevel: 3 allowTitleToDifferFromFilename: true --- -When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is just a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}. +## About the Git references API + +A Git reference (`git ref`) is a file that contains a Git commit SHA-1 hash. When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}. diff --git a/translations/zh-CN/content/rest/git/tags.md b/translations/zh-CN/content/rest/git/tags.md index 3d05bb6d366a..c58efcb9db17 100644 --- a/translations/zh-CN/content/rest/git/tags.md +++ b/translations/zh-CN/content/rest/git/tags.md @@ -1,6 +1,8 @@ --- -title: 标记 -intro: 'A Git tag is similar to a [Git reference](/rest/reference/git#refs), but the Git commit that it points to never changes.' +title: Git tags +shortTitle: 标记 +allowTitleToDifferFromFilename: true +intro: 'The Git tags API lets you read and write tag objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -当您想要指向特定发行版时，Git 标记非常有用。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入[标记对象](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)。 Git 标记 API 只支持[标注的标记对象](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)，而不支持轻量级标记。 +## About the Git tags API + +Git 标记类似于 [Git 引用](/rest/reference/git#refs)，但它指向的 Git 提交永远不变。 当您想要指向特定发行版时，Git 标记非常有用。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入[标记对象](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)。 Git 标记 API 只支持[标注的标记对象](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)，而不支持轻量级标记。 diff --git a/translations/zh-CN/content/rest/git/trees.md b/translations/zh-CN/content/rest/git/trees.md index 55a392f30dab..b5561a7e832f 100644 --- a/translations/zh-CN/content/rest/git/trees.md +++ b/translations/zh-CN/content/rest/git/trees.md @@ -1,6 +1,8 @@ --- -title: 树 -intro: Git 树对象在 Git 仓库中的文件之间创建层次结构。 +title: Git trees +shortTitle: 树 +allowTitleToDifferFromFilename: true +intro: 'The Git trees API lets you read and write tree objects to your Git database on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -11,4 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -您可以使用 Git 树对象创建目录与其包含的文件之间的关系。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入[树对象](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)。 +## About the Git trees API + +Git 树对象在 Git 仓库中的文件之间创建层次结构。 您可以使用 Git 树对象创建目录与其包含的文件之间的关系。 这些端点允许您在 {% data variables.product.product_name %} 上的 Git 数据库中读取和写入[树对象](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)。 diff --git a/translations/zh-CN/content/rest/gitignore.md b/translations/zh-CN/content/rest/gitignore.md index 4160d7dec8a5..5ad1999b151b 100644 --- a/translations/zh-CN/content/rest/gitignore.md +++ b/translations/zh-CN/content/rest/gitignore.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/gitignore --- +## About the Gitignore API + 当您通过 API 在 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上创建新仓库时，您可以指定一个 [.gitignore 模板](/github/getting-started-with-github/ignoring-files) 在创建时应用于仓库。 .gitignore 模板 API 可列出 {% data variables.product.product_name %} [.gitignore 仓库](https://github.com/github/gitignore)并从中获取模板。 ### gitignore 的自定义媒体类型 diff --git a/translations/zh-CN/content/rest/licenses.md b/translations/zh-CN/content/rest/licenses.md index 88741ee752dc..d2216d7cf8f8 100644 --- a/translations/zh-CN/content/rest/licenses.md +++ b/translations/zh-CN/content/rest/licenses.md @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/licenses --- +## About the Licenses API + 许可证 API 使用[开源 Ruby Gem 许可](https://github.com/benbalter/licensee)来尝试识别项目的许可。 被许可人将项目 `LICENSE` 文件（如果有）的内容与已知许可的简短列表相匹配。 因此，API 不考虑项目依赖项的许可或其他记录项目许可的方式，例如对文档中许可名称的引用。 如果许可匹配，则返回的许可密钥和名称符合 [SPDX 规格](https://spdx.org/)。 diff --git a/translations/zh-CN/content/rest/oauth-authorizations.md b/translations/zh-CN/content/rest/oauth-authorizations.md index f8ec60b51fe6..f1c58dc7fc8d 100644 --- a/translations/zh-CN/content/rest/oauth-authorizations.md +++ b/translations/zh-CN/content/rest/oauth-authorizations.md @@ -1,6 +1,6 @@ --- -title: OAuth 授权 -intro: 迁移 API 仅适用于经过身份验证的组织所有者。 +title: OAuth authorizations +intro: The OAuth authorizations lets you manage the access OAuth applications have to your account. versions: fpt: '*' ghec: '*' @@ -12,6 +12,8 @@ redirect_from: - /rest/reference/oauth-authorizations --- +## About the OAuth authorizations API + 您可以使用此 API 来管理 OAuth 应用程序对您帐户的访问权限。 您只能使用您的用户名和密码（而不是令牌），通过[基本身份验证](/rest/overview/other-authentication-methods#basic-authentication)访问此 API。 如果您或您的用户启用了双重身份验证，请务必了解如何[使用双重身份验证](/rest/overview/other-authentication-methods#working-with-two-factor-authentication)。 diff --git a/translations/zh-CN/content/rest/packages.md b/translations/zh-CN/content/rest/packages.md index 32204571ada8..f21db595d7f3 100644 --- a/translations/zh-CN/content/rest/packages.md +++ b/translations/zh-CN/content/rest/packages.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/packages --- +## About the {% data variables.product.prodname_registry %} API + The {% data variables.product.prodname_registry %} API enables you to manage packages using the REST API.{% ifversion fpt or ghec or ghes > 3.1 or ghae %} To learn more about restoring or deleting packages, see "[Restoring and deleting packages](/packages/learn-github-packages/deleting-and-restoring-a-package)."{% endif %} To use this API, you must authenticate using a personal access token. diff --git a/translations/zh-CN/content/rest/rate-limit.md b/translations/zh-CN/content/rest/rate-limit.md index 5405694ebffc..2b666b6311d6 100644 --- a/translations/zh-CN/content/rest/rate-limit.md +++ b/translations/zh-CN/content/rest/rate-limit.md @@ -1,6 +1,6 @@ --- title: 速率限制 -intro: 使用速率限制 API，您可以检查各种 REST API 的当前速率限制状态。 +intro: 'With the Rate limit API, you can check the current rate limit status of various REST APIs.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/rate-limit --- +## About the Rate limit API + REST API 概述文档描述了[速率限制规则](/rest/overview/resources-in-the-rest-api#rate-limiting)。 您可以随时使用下面描述的速率限制 API 来检查您当前的速率限制状态。 ### 了解您的速率限制状态 diff --git a/translations/zh-CN/content/rest/reactions.md b/translations/zh-CN/content/rest/reactions.md index 3f14257ef021..5e6faf37d75b 100644 --- a/translations/zh-CN/content/rest/reactions.md +++ b/translations/zh-CN/content/rest/reactions.md @@ -13,8 +13,8 @@ redirect_from: - /rest/reference/reactions --- -### Reaction types +## About the Reactions API -When creating a reaction, the allowed values for the `content` parameter are as follows (with the corresponding emoji for reference): +You can create and manage reactions on comments using the Reactions API. 创建反应时，`content` 参数的允许值如下（带有相应的表情符号供参考）： {% data reusables.repositories.reaction_list %} diff --git a/translations/zh-CN/content/rest/scim.md b/translations/zh-CN/content/rest/scim.md index adf280d91bc3..c065c452acd4 100644 --- a/translations/zh-CN/content/rest/scim.md +++ b/translations/zh-CN/content/rest/scim.md @@ -11,6 +11,8 @@ redirect_from: - /rest/reference/scim --- +## About the SCIM API + ### 组织的 SCIM 预配 SCIM API 由 SCIM 启用的身份提供程序 (IdP) 用来自动预配 {% data variables.product.product_name %} 组织成员身份。 {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API 基于 2.0 版的 [SCIM 标准](http://www.simplecloud.info/)。 IdP 应使用的 {% data variables.product.product_name %} SCIM 端点是：`{% data variables.product.api_url_code %}/scim/v2/organisation/{org}/`。 @@ -18,7 +20,7 @@ SCIM API 由 SCIM 启用的身份提供程序 (IdP) 用来自动预配 {% data v {% note %} **注意：** - - The SCIM API is available only for individual organizations that use [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) with [SAML SSO](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) enabled. For more information about SCIM, see "[About SCIM for organizations](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)." + - The SCIM API is available only for individual organizations that use [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) with [SAML SSO](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) enabled. 有关 SCIM 的详细信息，请参阅“[关于组织的 SCIM](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)”。 - The SCIM API cannot be used with an enterprise account or with an {% data variables.product.prodname_emu_org %}. {% endnote %} diff --git a/translations/zh-CN/content/rest/search.md b/translations/zh-CN/content/rest/search.md index b5fcf1d595ff..104fb8a84a8c 100644 --- a/translations/zh-CN/content/rest/search.md +++ b/translations/zh-CN/content/rest/search.md @@ -1,6 +1,6 @@ --- title: 搜索 -intro: The GitHub Search API lets you to search for the specific item efficiently. +intro: 'The Search API lets you to search for specific items on {% data variables.product.product_name %}.' versions: fpt: '*' ghes: '*' @@ -13,6 +13,8 @@ redirect_from: - /rest/reference/search --- +## About the Search API + 搜索 API 可帮助您搜索要查找的特定条目。 例如，您可以在仓库中找到用户或特定文件。 就像您在 Google 上执行搜索一样。 它旨在帮助您找到要查找的一个或几个结果。 就像在 Google 上搜索一样，有时您希望查看几页搜索结果，以便找到最能满足您需求的条目。 为了满足这一需求， {% data variables.product.product_name %} 搜索 API **为每个搜索提供最多 1,000 个结果**。 您可以使用查询缩小搜索范围。 要了解有关搜索查询语法的更多信息，请查看“[构建搜索查询](/rest/reference/search#constructing-a-search-query)”。 diff --git a/translations/zh-CN/content/rest/secret-scanning.md b/translations/zh-CN/content/rest/secret-scanning.md index 7597c9c4d15e..d176be5653a9 100644 --- a/translations/zh-CN/content/rest/secret-scanning.md +++ b/translations/zh-CN/content/rest/secret-scanning.md @@ -1,6 +1,6 @@ --- -title: Secret Scanning -intro: Use the Secret Scanning API to retrieve and update secret alerts from a repository. +title: 秘密扫描 +intro: Use the Secret scanning API to retrieve and update secret alerts from a repository. versions: ghes: '*' ghae: '*' @@ -14,6 +14,8 @@ redirect_from: {% data reusables.secret-scanning.api-beta %} +## About the Secret scanning API + {% data variables.product.prodname_secret_scanning %} API 可让您{% ifversion fpt or ghec or ghes > 3.1 or ghae %}： - Enable or disable {% data variables.product.prodname_secret_scanning %}{% if secret-scanning-push-protection %} and push protection{% endif %} for a repository. 更多信息请参阅“[存储库](/rest/reference/repos#update-a-repository)”，并展开 REST API 文档中的“`security_and_analysis` 对象的属性”部分。 diff --git a/translations/zh-CN/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml b/translations/zh-CN/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml index c7791cac9a6e..9204af5e65dc 100644 --- a/translations/zh-CN/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml +++ b/translations/zh-CN/data/graphql/ghae/graphql_upcoming_changes.public-ghae.yml @@ -21,13 +21,6 @@ upcoming_changes: date: '2020-01-01T00:00:00+00:00' criticality: 重大 owner: tambling - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有挂起的成员都会使用许可证 - date: '2020-07-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline` 将被删除。使用 Issue.timelineItems 代替。' @@ -42,20 +35,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 重大 owner: mikesea - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有成员都会使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有外部协作者使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT` 将被删除。改为使用 PullRequest.isDraft。' diff --git a/translations/zh-CN/data/graphql/ghec/graphql_upcoming_changes.public.yml b/translations/zh-CN/data/graphql/ghec/graphql_upcoming_changes.public.yml index 36bc00c2f2d0..8a97d9adc713 100644 --- a/translations/zh-CN/data/graphql/ghec/graphql_upcoming_changes.public.yml +++ b/translations/zh-CN/data/graphql/ghec/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: 重大 owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有挂起的成员都会使用许可证 - date: '2020-07-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline` 将被删除。使用 Issue.timelineItems 代替。' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 重大 owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有成员都会使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有外部协作者使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT` 将被删除。改为使用 PullRequest.isDraft。' diff --git a/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml b/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml index 36bc00c2f2d0..8a97d9adc713 100644 --- a/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml +++ b/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml @@ -28,13 +28,6 @@ upcoming_changes: date: '2020-04-01T00:00:00+00:00' criticality: 重大 owner: antn - - - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有挂起的成员都会使用许可证 - date: '2020-07-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: Issue.timeline description: '`timeline` 将被删除。使用 Issue.timelineItems 代替。' @@ -56,20 +49,6 @@ upcoming_changes: date: '2020-10-01T00:00:00+00:00' criticality: 重大 owner: nholden - - - location: EnterpriseMemberEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有成员都会使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - - - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: '`isUnlicensed` 将被删除。' - reason: 所有外部协作者使用许可证 - date: '2021-01-01T00:00:00+00:00' - criticality: 重大 - owner: BrentWheeldon - location: MergeStateStatus.DRAFT description: '`DRAFT` 将被删除。改为使用 PullRequest.isDraft。'