зеркало из https://github.com/github/docs.git
New translation batch for pt (#31420)
This commit is contained in:
docubot
GitHub
Родитель
005e8e4318
Коммит
9334a2d42d
|
|
@ -176,6 +176,7 @@ translations/pt-BR/content/site-policy/github-terms/github-community-forum-code-
|
|||
translations/pt-BR/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/glossaries/internal.yml,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/graphql/ghes-3.1/graphql_previews.enterprise.yml,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/reusables/actions/link-to-example-library.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/reusables/actions/self-hosted-runner-configure-runner-group.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/reusables/actions/self-hosted-runner-groups-navigate-to-repo-org-enterprise.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/reusables/billing/per-user-pricing-reference.md,file deleted because it no longer exists in main
|
||||
|
|
@ -234,8 +235,10 @@ translations/pt-BR/data/reusables/rest-reference/webhooks/repos.md,file deleted
|
|||
translations/pt-BR/data/reusables/security-center/beta.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/data/reusables/server-statistics/release-phase.md,file deleted because it no longer exists in main
|
||||
translations/pt-BR/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md,rendering error
|
||||
translations/pt-BR/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md,broken liquid tags
|
||||
translations/pt-BR/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md,rendering error
|
||||
translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md,rendering error
|
||||
translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md,broken liquid tags
|
||||
translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md,broken liquid tags
|
||||
translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/index.md,broken liquid tags
|
||||
translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md,rendering error
|
||||
|
|
@ -292,7 +295,7 @@ translations/pt-BR/content/admin/configuration/configuring-your-enterprise/confi
|
|||
translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error
|
||||
translations/pt-BR/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,broken liquid tags
|
||||
translations/pt-BR/content/admin/configuration/configuring-your-enterprise/site-admin-dashboard.md,broken liquid tags
|
||||
translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,broken liquid tags
|
||||
translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error
|
||||
translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error
|
||||
translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,rendering error
|
||||
translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md,rendering error
|
||||
|
|
@ -345,6 +348,7 @@ translations/pt-BR/content/code-security/code-scanning/using-codeql-code-scannin
|
|||
translations/pt-BR/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md,rendering error
|
||||
translations/pt-BR/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/dependabot/dependabot-alerts/browsing-security-advisories-in-the-github-advisory-database.md,rendering error
|
||||
translations/pt-BR/content/code-security/dependabot/dependabot-alerts/configuring-notifications-for-dependabot-alerts.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/dependabot/dependabot-alerts/editing-security-advisories-in-the-github-advisory-database.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md,rendering error
|
||||
translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,rendering error
|
||||
|
|
@ -421,25 +425,33 @@ translations/pt-BR/content/codespaces/troubleshooting/troubleshooting-prebuilds.
|
|||
translations/pt-BR/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md,broken liquid tags
|
||||
translations/pt-BR/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error
|
||||
translations/pt-BR/content/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors.md,broken liquid tags
|
||||
translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags
|
||||
translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags
|
||||
translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags
|
||||
translations/pt-BR/content/copilot/quickstart.md,broken liquid tags
|
||||
translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/index.md,broken liquid tags
|
||||
translations/pt-BR/content/developers/apps/building-github-apps/authenticating-with-github-apps.md,rendering error
|
||||
translations/pt-BR/content/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app.md,rendering error
|
||||
translations/pt-BR/content/developers/apps/getting-started-with-apps/differences-between-github-apps-and-oauth-apps.md,broken liquid tags
|
||||
translations/pt-BR/content/developers/overview/about-githubs-apis.md,broken liquid tags
|
||||
translations/pt-BR/content/developers/overview/managing-deploy-keys.md,broken liquid tags
|
||||
translations/pt-BR/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md,rendering error
|
||||
translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md,broken liquid tags
|
||||
translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md,broken liquid tags
|
||||
translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags
|
||||
translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags
|
||||
translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/exploring-projects-on-github/following-organizations.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/getting-started-with-git/associating-text-editors-with-git.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/learning-about-github/about-github-advanced-security.md,rendering error
|
||||
translations/pt-BR/content/get-started/quickstart/be-social.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/quickstart/communicating-on-github.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/quickstart/git-and-github-learning-resources.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/quickstart/github-glossary.md,rendering error
|
||||
translations/pt-BR/content/get-started/using-github/keyboard-shortcuts.md,rendering error
|
||||
translations/pt-BR/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error
|
||||
translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md,broken liquid tags
|
||||
translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md,rendering error
|
||||
|
|
@ -475,6 +487,7 @@ translations/pt-BR/content/packages/learn-github-packages/viewing-packages.md,re
|
|||
translations/pt-BR/content/packages/working-with-a-github-packages-registry/working-with-the-container-registry.md,rendering error
|
||||
translations/pt-BR/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md,rendering error
|
||||
translations/pt-BR/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md,rendering error
|
||||
translations/pt-BR/content/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line.md,broken liquid tags
|
||||
translations/pt-BR/content/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request.md,broken liquid tags
|
||||
translations/pt-BR/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository.md,rendering error
|
||||
translations/pt-BR/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/keeping-your-pull-request-in-sync-with-the-base-branch.md,rendering error
|
||||
|
|
@ -623,6 +636,7 @@ translations/pt-BR/data/reusables/gated-features/secret-scanning-partner.md,rend
|
|||
translations/pt-BR/data/reusables/gated-features/secret-scanning.md,rendering error
|
||||
translations/pt-BR/data/reusables/identity-and-permissions/ip-allow-lists-enable.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/notifications-v2/custom-notification-types.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/notifications/vulnerable-dependency-notification-options.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/organizations/billing_plans.md,rendering error
|
||||
translations/pt-BR/data/reusables/organizations/github-apps-settings-sidebar.md,rendering error
|
||||
translations/pt-BR/data/reusables/organizations/member-privileges.md,rendering error
|
||||
|
|
|
|||
|
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Visualizando suas assinaturas
|
||||
intro: 'Para entender de onde suas notificações estão vindo e o volume de suas notificações, recomendamos analisar suas assinaturas e repositórios inspecionados regularmente.'
|
||||
title: Viewing your subscriptions
|
||||
intro: 'To understand where your notifications are coming from and your notifications volume, we recommend reviewing your subscriptions and watched repositories regularly.'
|
||||
redirect_from:
|
||||
- /articles/subscribing-to-conversations
|
||||
- /articles/unsubscribing-from-conversations
|
||||
|
|
@ -24,63 +24,61 @@ versions:
|
|||
topics:
|
||||
- Notifications
|
||||
shortTitle: View subscriptions
|
||||
ms.openlocfilehash: 34faad79004d34f5beb14e8992b9aff4e6a3ab39
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '145095108'
|
||||
---
|
||||
Você recebe notificações para suas assinaturas de atividades contínuas em {% data variables.product.product_name %}. Há muitos motivos para você assinar uma conversa. Para obter mais informações, confira "[Sobre as notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notifications-and-subscriptions)".
|
||||
You receive notifications for your subscriptions of ongoing activity on {% data variables.product.product_name %}. There are many reasons you can be subscribed to a conversation. For more information, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notifications-and-subscriptions)."
|
||||
|
||||
Recomendamos a auditoria e o cancelamento das suas assinaturas como parte de um fluxo de trabalho de notificações saudáveis. Para obter mais informações sobre as opções de cancelamento de assinatura, confira "[Como gerenciar assinaturas](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)".
|
||||
We recommend auditing and unsubscribing from your subscriptions as a part of a healthy notifications workflow. For more information about your options for unsubscribing, see "[Managing subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)."
|
||||
|
||||
## Diagnosticando os motivos de receber muitas notificações
|
||||
## Diagnosing why you receive too many notifications
|
||||
|
||||
Quando sua caixa de entrada tiver muitas notificações para gerenciar, considere se você se inscreveu mais de uma vez ou como você pode alterar suas configurações de notificação para reduzir as assinaturas que você tem e os tipos de notificações que está recebendo. Por exemplo, você pode considerar desabilitar as configurações para inspecionar automaticamente todos os repositórios e todas as discussões da equipe sempre que você ingressar em uma equipe ou repositório.
|
||||
When your inbox has too many notifications to manage, consider whether you have oversubscribed or how you can change your notification settings to reduce the subscriptions you have and the types of notifications you're receiving. For example, you may consider disabling the settings to automatically watch all repositories and all team discussions whenever you've joined a team or repository.
|
||||
|
||||
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
|
||||
{% else %}
|
||||
{% endif %}
|
||||
|
||||
Para obter mais informações, confira "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#automatic-watching)".
|
||||
For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#automatic-watching)."
|
||||
|
||||
Para ter uma visão geral das assinaturas do repositório, confira "[Como revisar repositórios que você está inspecionando](#reviewing-repositories-that-youre-watching)". {% tip %}
|
||||
To see an overview of your repository subscriptions, see "[Reviewing repositories that you're watching](#reviewing-repositories-that-youre-watching)."
|
||||
{% tip %}
|
||||
|
||||
**Dica:** selecione os tipos de evento para notificação usando a opção **Personalizado** do menu suspenso **Inspecionar/Cancelar a inspeção** na [página Inspeção](https://github.com/watching) ou em qualquer página do repositório no {% data variables.product.product_name %}. Para obter mais informações, confira "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)".
|
||||
**Tip:** You can select the types of event to be notified of by using the **Custom** option of the **Watch/Unwatch** dropdown list in your [watching page](https://github.com/watching) or on any repository page on {% data variables.product.product_name %}. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
Muitas pessoas esquecem os repositórios que eles escolheram inspecionar no passado. Na página "Repositórios inspecionados" você pode rapidamente deixar de acompanhar repositórios. Para obter mais informações sobre as maneiras de cancelar a assinatura, confira "[Recomendações de cancelamento da inspeção](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" no {% data variables.product.prodname_blog %} e "[Como gerenciar suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)". Também é possível criar um fluxo de trabalho de triagem para ajudar com as notificações que você recebe. Para obter diretrizes sobre os fluxos de trabalho de triagem, confira "[Como personalizar um fluxo de trabalho para fazer a triagem das notificações](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)".
|
||||
Many people forget about repositories that they've chosen to watch in the past. From the "Watched repositories" page you can quickly unwatch repositories. For more information on ways to unsubscribe, see "[Unwatch recommendations](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" on {% data variables.product.prodname_blog %} and "[Managing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." You can also create a triage workflow to help with the notifications you receive. For guidance on triage workflows, see "[Customizing a workflow for triaging your notifications](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)."
|
||||
|
||||
## Revisando todas as suas assinaturas
|
||||
## Reviewing all of your subscriptions
|
||||
|
||||
{% data reusables.notifications.access_notifications %}
|
||||
1. Na barra lateral esquerda, na lista de repositórios dos quais você tem notificações, use o menu suspenso "Gerenciar notificações" para clicar em **Assinaturas**.
|
||||
|
||||
1. In the left sidebar, under the list of repositories that you have notifications from, use the "Manage notifications" drop-down to click **Subscriptions**.
|
||||
|
||||
|
||||
2. Use os filtros e classifique para limitar a lista de assinaturas e comece a cancelar as assinaturas de conversas das quais você não deseja mais receber notificações.
|
||||
2. Use the filters and sort to narrow the list of subscriptions and begin unsubscribing to conversations you no longer want to receive notifications for.
|
||||
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Dicas:**
|
||||
- Para revisar as assinaturas que você pode ter esquecido, classifique por "assinada menos recentemente".
|
||||
**Tips:**
|
||||
- To review subscriptions you may have forgotten about, sort by "least recently subscribed."
|
||||
|
||||
- Para revisar uma lista de repositórios para os quais você ainda pode receber notificações, consulte a lista de repositórios no menu suspenso "filtrar por repositório".
|
||||
- To review a list of repositories that you can still receive notifications for, see the repository list in the "filter by repository" drop-down menu.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Revisando repositórios que você está inspecionando
|
||||
## Reviewing repositories that you're watching
|
||||
|
||||
1. Na barra lateral esquerda, na lista de repositórios, use o menu suspenso "Gerenciar notificações" e clique em **Repositórios inspecionados**.
|
||||
|
||||
2. Avalie os repositórios que você está inspecionando e decida se suas atualizações ainda são relevantes e úteis. Quando você inspeciona um repositório, você será notificado de todas as conversas desse repositório.
|
||||
|
||||
1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down menu and click **Watched repositories**.
|
||||
|
||||
2. Evaluate the repositories that you are watching and decide if their updates are still relevant and helpful. When you watch a repository, you will be notified of all conversations for that repository.
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Dica:** em vez de inspecionar um repositório, considere a possibilidade de apenas receber notificações quando houver atualizações nos {% data reusables.notifications-v2.custom-notification-types %} (se habilitado para o repositório) ou qualquer combinação dessas opções ou cancelar a inspeção por completo de um repositório.
|
||||
**Tip:** Instead of watching a repository, consider only receiving notifications when there are updates to {% data reusables.notifications-v2.custom-notification-types %} (if enabled for the repository), or any combination of these options, or completely unwatching a repository.
|
||||
|
||||
Quando você cancelar a inspeção de um repositório, ainda poderá receber notificações quando for @mentioned ou estiver participando de uma conversa. Quando você configura o recebimento de notificações para determinados tipos de eventos, só é notificado quando há atualizações para esses tipos de eventos no repositório, quando está participando de uma conversa ou quando você ou uma equipe em que você está é @mentioned.
|
||||
When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned.
|
||||
|
||||
{% endtip %}
|
||||
|
|
|
|||
|
|
@ -79,15 +79,27 @@ You can customize notifications for a repository. For example, you can choose to
|
|||
### Participating in conversations
|
||||
Anytime you comment in a conversation or when someone @mentions your username, you are _participating_ in a conversation. By default, you are automatically subscribed to a conversation when you participate in it. You can unsubscribe from a conversation you've participated in manually by clicking **Unsubscribe** on the issue or pull request or through the **Unsubscribe** option in the notifications inbox.
|
||||
|
||||
For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on {% data variables.product.product_location %}{% ifversion fpt or ghes or ghec %} and {% data variables.product.prodname_mobile %}{% endif %}.
|
||||
{% ifversion update-notification-settings-22 %}For conversations you're watching or participating in, you can choose whether you want to receive notifications on {% data variables.product.company_short %} or by email in your notification settings. For more information, see "[Choosing your notification settings](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#choosing-your-notification-settings)."
|
||||
|
||||
|
||||
|
||||
{% else %}
|
||||
|
||||
For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on {% data variables.product.product_location %}{% ifversion ghes %} and {% data variables.product.prodname_mobile %}{% endif %}. For more information, see "[Choosing your notification settings](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#choosing-your-notification-settings)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
|
||||
|
||||
For example:
|
||||
- If you don't want notifications to be sent to your email, unselect **email** for participating and watching notifications.
|
||||
- If you want to receive notifications by email when you've participated in a conversation, then you can select **email** under "Participating".
|
||||
|
||||
If you do not enable watching or participating notifications for web{% ifversion fpt or ghes or ghec %} and mobile{% endif %}, then your notifications inbox will not have any updates.
|
||||
{% ifversion update-notification-settings-22 %}If you do not enable "Notify me: On GitHub" for watching or participating notifications, then your notifications inbox will not have any updates.
|
||||
|
||||
{% else %}
|
||||
|
||||
If you do not enable watching or participating notifications for web{% ifversion ghes %} and mobile{% endif %}, then your notifications inbox will not have any updates.{% endif %}
|
||||
|
||||
## Customizing your email notifications
|
||||
|
||||
|
|
@ -146,11 +158,16 @@ Email notifications from {% data variables.product.product_location %} contain t
|
|||
|
||||
## Automatic watching
|
||||
|
||||
By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options.
|
||||
By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options in your notification settings.
|
||||
|
||||
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
|
||||
{% else %}
|
||||
{% endif %}
|
||||
|
||||
If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option.
|
||||
If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option.
|
||||
|
||||
For more information, see "[Choosing your notification settings](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#choosing-your-notification-settings)."
|
||||
|
||||
## Configuring your watch settings for an individual repository
|
||||
|
||||
|
|
@ -172,9 +189,17 @@ If you belong to an organization, you can choose the email account you want noti
|
|||
|
||||
{% data reusables.notifications.access_notifications %}
|
||||
{% data reusables.notifications-v2.manage-notifications %}
|
||||
|
||||
3. Under "Default notification email", select the email address you'd like notifications sent to.
|
||||
|
||||
4. Click **Save**.
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
|
||||
|
||||
|
||||
{% else %}
|
||||
|
||||
{% endif %}
|
||||
{% ifversion ghes or ghae %}
|
||||
4. Click **Save**.{% endif %}
|
||||
|
||||
### Customizing email routes per organization
|
||||
|
||||
|
|
@ -182,12 +207,35 @@ If you are a member of more than one organization, you can configure each one to
|
|||
|
||||
{% data reusables.notifications.access_notifications %}
|
||||
{% data reusables.notifications-v2.manage-notifications %}
|
||||
3. Under "Custom routing," find your organization's name in the list.
|
||||
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
3. Under "Default notifications email", click **Custom routing**.
|
||||
|
||||
|
||||
|
||||
4. Click **Add new route**.
|
||||
|
||||
|
||||
|
||||
5. Click **Pick organization**, then select the organization you want to customize from the dropdown.
|
||||
|
||||
|
||||
|
||||
6. Select one of your verified email addresses, then click **Save**.
|
||||
|
||||
|
||||
|
||||
{% else %}
|
||||
3. Under "Custom routing," find your organization's name in the list.
|
||||
|
||||
|
||||
|
||||
4. Click **Edit** next to the email address you want to change.
|
||||
|
||||
|
||||
|
||||
|
||||
5. Select one of your verified email addresses, then click **Save**.
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
## {% data variables.product.prodname_dependabot_alerts %} notification options
|
||||
|
||||
|
|
@ -197,14 +245,17 @@ If you are a member of more than one organization, you can configure each one to
|
|||
|
||||
For more information about the notification delivery methods available to you, and advice on optimizing your notifications for {% data variables.product.prodname_dependabot_alerts %}, see "[Configuring notifications for {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/configuring-notifications-for-dependabot-alerts)."
|
||||
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
{% ifversion update-notification-settings-22 or ghes %}
|
||||
## {% data variables.product.prodname_actions %} notification options
|
||||
|
||||
Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs.
|
||||
Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs.{% endif %}
|
||||
|
||||
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %}
|
||||
## Organization alerts notification options
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Gerenciar o README do seu perfil
|
||||
intro: 'Você pode adicionar um README ao seu perfil de{% data variables.product.prodname_dotcom %} para contar a outras pessoas sobre você.'
|
||||
title: Managing your profile README
|
||||
intro: 'You can add a README to your {% data variables.product.prodname_dotcom %} profile to tell other people about yourself.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
|
|
@ -11,71 +11,67 @@ redirect_from:
|
|||
- /github/setting-up-and-managing-your-github-profile/managing-your-profile-readme
|
||||
- /github/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme
|
||||
shortTitle: Your profile README
|
||||
ms.openlocfilehash: 587bcea1e1a0f96aad8882b41196afcc6e433363
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147578897'
|
||||
---
|
||||
## Sobre o README do seu perfil
|
||||
## About your profile README
|
||||
|
||||
Você pode compartilhar informações sobre si mesmo com a comunidade no {% data variables.product.product_location %} criando um LEIAME do perfil. {% data variables.product.prodname_dotcom %} mostra o README do seu perfil na parte superior da sua página de perfil.
|
||||
You can share information about yourself with the community on {% data variables.product.product_location %} by creating a profile README. {% data variables.product.prodname_dotcom %} shows your profile README at the top of your profile page.
|
||||
|
||||
Você decide quais informações incluir no README do seu perfil. Portanto, você tem total controle sobre a forma como se apresenta no {% data variables.product.prodname_dotcom %}. Aqui estão alguns exemplos de informações que os visitantes podem achar interessantes, divertidas ou úteis no README do seu perfil.
|
||||
You decide what information to include in your profile README, so you have full control over how you present yourself on {% data variables.product.prodname_dotcom %}. Here are some examples of information that visitors may find interesting, fun, or useful in your profile README.
|
||||
|
||||
- Uma seção "Sobre mim" que descreve seu trabalho e seus interesses
|
||||
- Contribuições das quais você está orgulhoso, bem como contexto dessas contribuições
|
||||
- Orientação para obter ajuda nas comunidades onde você está envolvido
|
||||
- An "About me" section that describes your work and interests
|
||||
- Contributions you're proud of, and context about those contributions
|
||||
- Guidance for getting help in communities where you're involved
|
||||
|
||||
|
||||
|
||||
|
||||
Você pode formatar texto e incluir emoji, imagens e GIFs no seu perfil README usando o markdown específico do {% data variables.product.company_short %}. Para obter mais informações, confira "[Introdução à escrita e à formatação no {% data variables.product.prodname_dotcom %}](/github/writing-on-github/getting-started-with-writing-and-formatting-on-github)".
|
||||
You can format text and include emoji, images, and GIFs in your profile README by using {% data variables.product.company_short %} Flavored Markdown. For more information, see "[Getting started with writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/getting-started-with-writing-and-formatting-on-github)." For a hands-on guide to customizing your profile README, see "[Quickstart for writing on {% data variables.product.prodname_dotcom %}](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)."
|
||||
|
||||
## Pré-requisitos
|
||||
## Prerequisites
|
||||
|
||||
O GitHub irá exibir o README do seu perfil na sua página de perfil se todas as informações a seguir forem verdadeiras.
|
||||
GitHub will display your profile README on your profile page if all of the following are true.
|
||||
|
||||
- Você criou um repositório com um nome que corresponde ao nome de usuário do {% data variables.product.prodname_dotcom %}.
|
||||
- O repositório é público.
|
||||
- O repositório contém um arquivo denominado README.md na sua raiz.
|
||||
- O arquivo README.md contém qualquer conteúdo.
|
||||
- You've created a repository with a name that matches your {% data variables.product.prodname_dotcom %} username.
|
||||
- The repository is public.
|
||||
- The repository contains a file named README.md in its root.
|
||||
- The README.md file contains any content.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação**: se você criou um repositório público com o mesmo nome do nome de usuário antes de julho de 2020, o {% data variables.product.prodname_dotcom %} não mostra automaticamente o LEIAME do repositório no seu perfil. Você pode compartilhar manualmente o LEIAME do repositório para o seu perfil acessando o repositório no {% data variables.product.prodname_dotcom_the_website %} e clicando em **Compartilhar no perfil**.
|
||||
**Note**: If you created a public repository with the same name as your username before July 2020, {% data variables.product.prodname_dotcom %} won't automatically show the repository's README on your profile. You can manually share the repository's README to your profile by going to the repository on {% data variables.product.prodname_dotcom_the_website %} and clicking **Share to profile**.
|
||||
|
||||
|
||||
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Adicionar um README do perfil
|
||||
## Adding a profile README
|
||||
|
||||
{% data reusables.repositories.create_new %}
|
||||
2. Em "Nome do repositório", digite um nome de repositório que corresponde ao nome de usuário do {% data variables.product.prodname_dotcom %}. Por exemplo, se seu nome de usuário for "octocat", o nome do repositório deverá ser "octocat".
|
||||
|
||||
3. Opcionalmente, adicione uma descrição do repositório. Por exemplo, "Meu repositório pessoal".
|
||||
|
||||
4. Selecione **Público**.
|
||||
 {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %}
|
||||
7. Acima da barra lateral direita, clique em **Editar LEIAME**.
|
||||
|
||||
2. Under "Repository name", type a repository name that matches your {% data variables.product.prodname_dotcom %} username. For example, if your username is "octocat", the repository name must be "octocat".
|
||||
|
||||
3. Optionally, add a description of your repository. For example, "My personal repository."
|
||||
|
||||
4. Select **Public**.
|
||||
|
||||
{% data reusables.repositories.initialize-with-readme %}
|
||||
{% data reusables.repositories.create-repo %}
|
||||
7. Above the right sidebar, click **Edit README**.
|
||||
|
||||
|
||||
O arquivo README gerado é pré-preenchido com um modelo para dar alguma inspiração para o README do seu perfil.
|
||||
|
||||
The generated README file is pre-populated with a template to give you some inspiration for your profile README.
|
||||
|
||||
|
||||
Para ver um resumo de todos os emojis disponíveis e os respectivos códigos, confira "[Folha de referências de emojis](https://www.webfx.com/tools/emoji-cheat-sheet/)".
|
||||
For a summary of all the available emojis and their codes, see "[Emoji cheat sheet](https://www.webfx.com/tools/emoji-cheat-sheet/)."
|
||||
|
||||
## Remover um README do perfil
|
||||
## Removing a profile README
|
||||
|
||||
O perfil README é removido do seu perfil de {% data variables.product.prodname_dotcom %} se algum dos pontos seguintes se aplicar:
|
||||
The profile README is removed from your {% data variables.product.prodname_dotcom %} profile if any of the following apply:
|
||||
|
||||
- O arquivo README está vazio ou não existe.
|
||||
- O repositório é privado.
|
||||
- O nome do repositório não corresponde mais ao seu nome de usuário.
|
||||
- The README file is empty or doesn't exist.
|
||||
- The repository is private.
|
||||
- The repository name no longer matches your username.
|
||||
|
||||
The method you choose is dependant upon your needs, but if you're unsure, we recommend making your repository private. Para ver as etapas de como tornar seu repositório privado, confira "[Como alterar a visibilidade de um repositório](/github/administering-a-repository/setting-repository-visibility#changing-a-repositorys-visibility)".
|
||||
The method you choose depends upon your needs, but if you're unsure, we recommend making your repository private. For steps on how to make your repository private, see "[Changing a repository's visibility](/github/administering-a-repository/setting-repository-visibility#changing-a-repositorys-visibility)."
|
||||
|
||||
## Leitura adicional
|
||||
## Further reading
|
||||
|
||||
- "[Sobre os arquivos LEIAME](/github/creating-cloning-and-archiving-repositories/about-readmes)"
|
||||
- [About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)
|
||||
|
|
|
|||
|
|
@ -63,7 +63,7 @@ By default, self-hosted runners will automatically perform a software update whe
|
|||
To turn off automatic software updates and install software updates yourself, specify the `--disableupdate` flag when registering your runner using `config.sh`. For example:
|
||||
|
||||
```shell
|
||||
./config.sh --url <em>https://github.com/octo-org</em> --token <em>example-token</em> --disableupdate
|
||||
./config.sh --url https://github.com/YOUR-ORGANIZATION --token EXAMPLE-TOKEN --disableupdate
|
||||
```
|
||||
|
||||
If you disable automatic updates, you must still update your runner version regularly. New functionality in {% data variables.product.prodname_actions %} requires changes in both the {% data variables.product.prodname_actions %} service _and_ the runner software. The runner may not be able to correctly process jobs that take advantage of new features in {% data variables.product.prodname_actions %} without a software update.
|
||||
|
|
|
|||
|
|
@ -77,7 +77,7 @@ You can manage the runner service in the Windows **Services** application, or yo
|
|||
1. Alternatively, the command takes an optional `user` argument to install the service as a different user.
|
||||
|
||||
```shell
|
||||
./svc.sh install <em>USERNAME</em>
|
||||
./svc.sh install USERNAME
|
||||
```
|
||||
|
||||
{% endlinux %}
|
||||
|
|
|
|||
|
|
@ -201,7 +201,7 @@ The `github` context contains information about the workflow run and the event t
|
|||
| `github.ref` | `string` | {% data reusables.actions.ref-description %} |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %}
|
||||
| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} |
|
||||
| `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} |
|
||||
| `github.ref_protected` | `boolean` | {% data reusables.actions.ref_protected-description %} |
|
||||
| `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %} |
|
||||
{%- endif %}
|
||||
| `github.path` | `string` | Path on the runner to the file that sets system `PATH` variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)." |
|
||||
|
|
|
|||
|
|
@ -87,15 +87,9 @@ For more information, see "[Creating actions](/actions/creating-actions)."
|
|||
|
||||
{% data reusables.actions.workflow-basic-example-and-explanation %}
|
||||
|
||||
## More complex examples
|
||||
{% data reusables.actions.link-to-example-library %}
|
||||
|
||||
## Next steps
|
||||
|
||||
- To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)."
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
- To understand how billing works for {% data variables.product.prodname_actions %}, see "[About billing for {% data variables.product.prodname_actions %}](/actions/reference/usage-limits-billing-and-administration#about-billing-for-github-actions)."
|
||||
{% endif %}
|
||||
{% data reusables.actions.onboarding-next-steps %}
|
||||
|
||||
## Contacting support
|
||||
|
||||
|
|
|
|||
|
|
@ -48,14 +48,14 @@ Re-running a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %
|
|||
To re-run a failed workflow run, use the `run rerun` subcommand. Replace `run-id` with the ID of the failed run that you want to re-run. If you don't specify a `run-id`, {% data variables.product.prodname_cli %} returns an interactive menu for you to choose a recent failed run.
|
||||
|
||||
```shell
|
||||
gh run rerun <em>run-id</em>
|
||||
gh run rerun RUN_ID
|
||||
```
|
||||
|
||||
{% ifversion debug-reruns %}
|
||||
{% data reusables.actions.enable-debug-logging-cli %}
|
||||
|
||||
```shell
|
||||
gh run rerun <em>run-id</em> --debug
|
||||
gh run rerun RUN_ID --debug
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
|
@ -90,14 +90,14 @@ If any jobs in a workflow run failed, you can re-run just the jobs that failed.
|
|||
To re-run failed jobs in a workflow run, use the `run rerun` subcommand with the `--failed` flag. Replace `run-id` with the ID of the run for which you want to re-run failed jobs. If you don't specify a `run-id`, {% data variables.product.prodname_cli %} returns an interactive menu for you to choose a recent failed run.
|
||||
|
||||
```shell
|
||||
gh run rerun <em>run-id</em> --failed
|
||||
gh run rerun RUN_ID --failed
|
||||
```
|
||||
|
||||
{% ifversion debug-reruns %}
|
||||
{% data reusables.actions.enable-debug-logging-cli %}
|
||||
|
||||
```shell
|
||||
gh run rerun <em>run-id</em> --failed --debug
|
||||
gh run rerun RUN_ID --failed --debug
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
|
@ -127,14 +127,14 @@ When you re-run a specific job in a workflow, a new workflow run will start for
|
|||
To re-run a specific job in a workflow run, use the `run rerun` subcommand with the `--job` flag. Replace `job-id` with the ID of the job that you want to re-run.
|
||||
|
||||
```shell
|
||||
gh run rerun --job <em>job-id</em>
|
||||
gh run rerun --job JOB_ID
|
||||
```
|
||||
|
||||
{% ifversion debug-reruns %}
|
||||
{% data reusables.actions.enable-debug-logging-cli %}
|
||||
|
||||
```shell
|
||||
gh run rerun --job <em>job-id</em> --debug
|
||||
gh run rerun --job JOB_ID --debug
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
|
|
|||
|
|
@ -77,21 +77,13 @@ Committing the workflow file to a branch in your repository triggers the `push`
|
|||
|
||||
For example, you can see the list of files in your repository:
|
||||
|
||||
|
||||
|
||||
The example workflow you just added is triggered each time code is pushed to the branch, and shows you how {% data variables.product.prodname_actions %} can work with the contents of your repository. For an in-depth tutorial, see "[Understanding {% data variables.product.prodname_actions %}](/actions/learn-github-actions/understanding-github-actions)."
|
||||
|
||||
## More starter workflows
|
||||
|
||||
{% data reusables.actions.workflow-template-overview %}
|
||||
|
||||
## More complex examples
|
||||
{% data reusables.actions.link-to-example-library %}
|
||||
|
||||
## Next steps
|
||||
|
||||
The example workflow you just added runs each time code is pushed to the branch, and shows you how {% data variables.product.prodname_actions %} can work with the contents of your repository. But this is only the beginning of what you can do with {% data variables.product.prodname_actions %}:
|
||||
|
||||
- Your repository can contain multiple workflows that trigger different jobs based on different events.
|
||||
- You can use a workflow to install software testing apps and have them automatically test your code on {% data variables.product.prodname_dotcom %}'s runners.
|
||||
|
||||
{% data variables.product.prodname_actions %} can help you automate nearly every aspect of your application development processes. Ready to get started? Here are some helpful resources for taking your next steps with {% data variables.product.prodname_actions %}:
|
||||
|
||||
- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" for an in-depth tutorial.
|
||||
{% data reusables.actions.onboarding-next-steps %}
|
||||
|
|
|
|||
|
|
@ -93,13 +93,13 @@ If your repository has environment secrets or can access secrets from the parent
|
|||
To add a repository secret, use the `gh secret set` subcommand. Replace `secret-name` with the name of your secret.
|
||||
|
||||
```shell
|
||||
gh secret set <em>secret-name</em>
|
||||
gh secret set SECRET_NAME
|
||||
```
|
||||
|
||||
The CLI will prompt you to enter a secret value. Alternatively, you can read the value of the secret from a file.
|
||||
|
||||
```shell
|
||||
gh secret set <em>secret-name</em> < secret.txt
|
||||
gh secret set SECRET_NAME < secret.txt
|
||||
```
|
||||
|
||||
To list all secrets for the repository, use the `gh secret list` subcommand.
|
||||
|
|
@ -128,13 +128,13 @@ To list all secrets for the repository, use the `gh secret list` subcommand.
|
|||
To add a secret for an environment, use the `gh secret set` subcommand with the `--env` or `-e` flag followed by the environment name.
|
||||
|
||||
```shell
|
||||
gh secret set --env <em>environment-name</em> <em>secret-name</em>
|
||||
gh secret set --env ENV_NAME SECRET_NAME
|
||||
```
|
||||
|
||||
To list all secrets for an environment, use the `gh secret list` subcommand with the `--env` or `-e` flag followed by the environment name.
|
||||
|
||||
```shell
|
||||
gh secret list --env <em>environment-name</em>
|
||||
gh secret list --env ENV_NAME
|
||||
```
|
||||
|
||||
{% endcli %}
|
||||
|
|
@ -173,25 +173,25 @@ gh auth login --scopes "admin:org"
|
|||
To add a secret for an organization, use the `gh secret set` subcommand with the `--org` or `-o` flag followed by the organization name.
|
||||
|
||||
```shell
|
||||
gh secret set --org <em>organization-name</em> <em>secret-name</em>
|
||||
gh secret set --org ORG_NAME SECRET_NAME
|
||||
```
|
||||
|
||||
By default, the secret is only available to private repositories. To specify that the secret should be available to all repositories within the organization, use the `--visibility` or `-v` flag.
|
||||
|
||||
```shell
|
||||
gh secret set --org <em>organization-name</em> <em>secret-name</em> --visibility all
|
||||
gh secret set --org ORG_NAME SECRET_NAME --visibility all
|
||||
```
|
||||
|
||||
To specify that the secret should be available to selected repositories within the organization, use the `--repos` or `-r` flag.
|
||||
|
||||
```shell
|
||||
gh secret set --org <em>organization-name</em> <em>secret-name</em> --repos <em>repo-name-1</em>,<em>repo-name-2</em>"
|
||||
gh secret set --org ORG_NAME SECRET_NAME --repos REPO-NAME-1, REPO-NAME-2"
|
||||
```
|
||||
|
||||
To list all secrets for an organization, use the `gh secret list` subcommand with the `--org` or `-o` flag followed by the organization name.
|
||||
|
||||
```shell
|
||||
gh secret list --org <em>organization-name</em>
|
||||
gh secret list --org ORG_NAME
|
||||
```
|
||||
|
||||
{% endcli %}
|
||||
|
|
|
|||
|
|
@ -87,7 +87,7 @@ You can add a {% data variables.actions.hosted_runner %} to an organization, whe
|
|||
|
||||
## Running jobs on your runner
|
||||
|
||||
Once your runner type has been been defined, you can update your workflows to send jobs to the runner instances for processing. In this example, a runner group is populated with Ubuntu 16-core runners, which have been assigned the label `ubuntu-20.04-16core`. If you have a runner matching this label, the `check-bats-version` job then uses the `runs-on` key to target that runner whenever the job is run:
|
||||
Once your runner type has been defined, you can update your workflow YAML files to send jobs to your newly created runner instances for processing. In this example, a runner group is populated with Ubuntu 16-core runners, which have been assigned the label `ubuntu-20.04-16core`. If you have a runner matching this label, the `check-bats-version` job then uses the `runs-on` key to target that runner whenever the job is run:
|
||||
|
||||
```yaml
|
||||
name: learn-github-actions
|
||||
|
|
@ -104,6 +104,8 @@ jobs:
|
|||
- run: bats -v
|
||||
```
|
||||
|
||||
To find out which runners are enabled for your repository and organization, you must contact your organization admin. Your organization admin can create new runners and runner groups, as well as configure permissions to specify which repositories can access a runner group.
|
||||
|
||||
## Managing access to your runners
|
||||
|
||||
{% note %}
|
||||
|
|
|
|||
|
|
@ -93,7 +93,7 @@ By default, the rate limit for {% data variables.product.prodname_actions %} is
|
|||
|
||||
```shell
|
||||
ghe-config actions-rate-limiting.enabled true
|
||||
ghe-config actions-rate-limiting.queue-runs-per-minute <em>RUNS-PER-MINUTE</em>
|
||||
ghe-config actions-rate-limiting.queue-runs-per-minute RUNS-PER-MINUTE
|
||||
```
|
||||
1. To disable the rate limit after it's been enabled, run the following command.
|
||||
|
||||
|
|
|
|||
|
|
@ -67,7 +67,7 @@ You can also access these reports programmatically via standard HTTP authenticat
|
|||
For example, here is how you would download the "all users" report using cURL:
|
||||
|
||||
```shell
|
||||
curl -L -u <em>username</em>:<em>token</em> http(s)://<em>hostname</em>/stafftools/reports/all_users.csv
|
||||
curl -L -u USERNAME:TOKEN http(s)://HOSTNAME/stafftools/reports/all_users.csv
|
||||
```
|
||||
|
||||
To access the other reports programmatically, replace `all_users` with `active_users`, `dormant_users`, `suspended_users`, `all_organizations`, or `all_repositories`.
|
||||
|
|
|
|||
|
|
@ -118,7 +118,7 @@ If the upgrade target you're presented with is a feature release instead of a pa
|
|||
{% data reusables.enterprise_installation.download-package %}
|
||||
4. Run the `ghe-upgrade` command using the package file name:
|
||||
```shell
|
||||
admin@<em>HOSTNAME</em>:~$ ghe-upgrade <em>GITHUB-UPGRADE.hpkg</em>
|
||||
admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg
|
||||
*** verifying upgrade package signature...
|
||||
```
|
||||
5. If a reboot is required for updates for kernel, MySQL, Elasticsearch or other programs, the hotpatch upgrade script notifies you.
|
||||
|
|
@ -170,14 +170,14 @@ While you can use a hotpatch to upgrade to the latest patch release within a fea
|
|||
|
||||
5. Run the `ghe-upgrade` command using the package file name:
|
||||
```shell
|
||||
admin@<em>HOSTNAME</em>:~$ ghe-upgrade <em>GITHUB-UPGRADE.pkg</em>
|
||||
admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg
|
||||
*** verifying upgrade package signature...
|
||||
```
|
||||
6. Confirm that you'd like to continue with the upgrade and restart after the package signature verifies. The new root filesystem writes to the secondary partition and the instance automatically restarts in maintenance mode:
|
||||
```shell
|
||||
*** applying update...
|
||||
This package will upgrade your installation to version <em>version-number</em>
|
||||
Current root partition: /dev/xvda1 [<em>version-number</em>]
|
||||
This package will upgrade your installation to version VERSION-NUMBER
|
||||
Current root partition: /dev/xvda1 [VERSION-NUMBER]
|
||||
Target root partition: /dev/xvda2
|
||||
Proceed with installation? [y/N]
|
||||
```
|
||||
|
|
|
|||
|
|
@ -86,12 +86,6 @@ For information on creating or accessing your access key ID and secret key, see
|
|||
{% ifversion streaming-oidc-s3 %}
|
||||
#### Setting up streaming to S3 with OpenID Connect
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Streaming to Amazon S3 with OpenID Connect is currently in beta and subject to change.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. In AWS, add the {% data variables.product.prodname_dotcom %} OIDC provider to IAM. For more information, see [Creating OpenID Connect (OIDC) identity providers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) in the AWS documentation.
|
||||
|
||||
- For the provider URL, use `https://oidc-configuration.audit-log.githubusercontent.com`.
|
||||
|
|
|
|||
|
|
@ -121,7 +121,7 @@ For more information about the audit log REST API, see "[Enterprise administrati
|
|||
The query below searches for audit log events created on Jan 1st, 2022 in the `avocado-corp` enterprise, and return the first page with a maximum of 100 items per page using [REST API pagination](/rest/overview/resources-in-the-rest-api#pagination):
|
||||
|
||||
```shell
|
||||
curl -H "Authorization: Bearer <em>TOKEN</em>" \
|
||||
curl -H "Authorization: Bearer TOKEN" \
|
||||
--request GET \
|
||||
"https://api.github.com/enterprises/avocado-corp/audit-log?phrase=created:2022-01-01&page=1&per_page=100"
|
||||
```
|
||||
|
|
@ -133,7 +133,7 @@ You can specify multiple search phrases, such as `created` and `actor`, by separ
|
|||
The query below searches for audit log events for pull requests, where the event occurred on or after Jan 1st, 2022 in the `avocado-corp` enterprise, and the action was performed by the `octocat` user:
|
||||
|
||||
```shell
|
||||
curl -H "Authorization: Bearer <em>TOKEN</em>" \
|
||||
curl -H "Authorization: Bearer TOKEN" \
|
||||
--request GET \
|
||||
"https://api.github.com/enterprises/avocado-corp/audit-log?phrase=action:pull_request+created:>=2022-01-01+actor:octocat"
|
||||
```
|
||||
|
|
|
|||
|
|
@ -44,17 +44,19 @@ If you are a site administrator for {% data variables.product.product_location %
|
|||
{%- ifversion ghae %}
|
||||
<!-- GitHub AE is FIPS 140-2 compliant. FIPS does not yet permit keys that use the ed25519 algorithm. -->
|
||||
```shell
|
||||
$ ssh-keygen -t rsa -b 4096 -C "<em>your_email@example.com</em>"
|
||||
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||||
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||||
|
||||
```
|
||||
{%- else %}
|
||||
```shell
|
||||
$ ssh-keygen -t ed25519 -C "<em>your_email@example.com</em>"
|
||||
$ ssh-keygen -t ed25519 -C "your_email@example.com"
|
||||
```
|
||||
{% note %}
|
||||
|
||||
**Note:** If you are using a legacy system that doesn't support the Ed25519 algorithm, use:
|
||||
```shell
|
||||
$ ssh-keygen -t rsa -b 4096 -C "<em>your_email@example.com</em>"
|
||||
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||||
```
|
||||
|
||||
{% endnote %}
|
||||
|
|
@ -62,14 +64,14 @@ If you are a site administrator for {% data variables.product.product_location %
|
|||
|
||||
This creates a new SSH key, using the provided email as a label.
|
||||
```shell
|
||||
> Generating public/private <em>algorithm</em> key pair.
|
||||
> Generating public/private ALGORITHM key pair.
|
||||
```
|
||||
3. When you're prompted to "Enter a file in which to save the key," press Enter. This accepts the default file location.
|
||||
|
||||
{% mac %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/Users/<em>you</em>/.ssh/id_<em>algorithm</em>): <em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/Users/YOU/.ssh/id_ALGORITHM: [Press enter]
|
||||
```
|
||||
|
||||
{% endmac %}
|
||||
|
|
@ -77,7 +79,7 @@ If you are a site administrator for {% data variables.product.product_location %
|
|||
{% windows %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/c/Users/<em>you</em>/.ssh/id_<em>algorithm</em>):<em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/c/Users/YOU/.ssh/id_ALGORITHM):[Press enter]
|
||||
```
|
||||
|
||||
{% endwindows %}
|
||||
|
|
@ -85,15 +87,15 @@ If you are a site administrator for {% data variables.product.product_location %
|
|||
{% linux %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/home/<em>you</em>/.ssh/<em>algorithm</em>): <em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/home/YOU/.ssh/ALGORITHM):[Press enter]
|
||||
```
|
||||
|
||||
{% endlinux %}
|
||||
|
||||
4. At the prompt, type a secure passphrase. For more information, see ["Working with SSH key passphrases](/articles/working-with-ssh-key-passphrases)."
|
||||
```shell
|
||||
> Enter passphrase (empty for no passphrase): <em>[Type a passphrase]</em>
|
||||
> Enter same passphrase again: <em>[Type passphrase again]</em>
|
||||
> Enter passphrase (empty for no passphrase): [Type a passphrase]
|
||||
> Enter same passphrase again: [Type passphrase again]
|
||||
```
|
||||
|
||||
## Adding your SSH key to the ssh-agent
|
||||
|
|
@ -110,7 +112,7 @@ Before adding a new SSH key to the ssh-agent to manage your keys, you should hav
|
|||
|
||||
```shell
|
||||
$ open ~/.ssh/config
|
||||
> The file /Users/<em>you</em>/.ssh/config does not exist.
|
||||
> The file /Users/YOU/.ssh/config does not exist.
|
||||
```
|
||||
|
||||
* If the file doesn't exist, create the file.
|
||||
|
|
@ -198,7 +200,7 @@ If you are using macOS or Linux, you may need to update your SSH client or insta
|
|||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Paste the text below, substituting in the email address for your account on {% data variables.product.product_name %}.
|
||||
```shell
|
||||
$ ssh-keygen -t {% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}-sk -C "<em>your_email@example.com</em>"
|
||||
$ ssh-keygen -t {% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}-sk -C "YOUR_EMAIL"
|
||||
```
|
||||
|
||||
{%- ifversion not ghae %}
|
||||
|
|
@ -217,7 +219,7 @@ If you are using macOS or Linux, you may need to update your SSH client or insta
|
|||
{% mac %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/Users/<em>you</em>/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk): <em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/Users/YOU/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk): [Press enter]
|
||||
```
|
||||
|
||||
{% endmac %}
|
||||
|
|
@ -225,7 +227,7 @@ If you are using macOS or Linux, you may need to update your SSH client or insta
|
|||
{% windows %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/c/Users/<em>you</em>/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk):<em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/c/Users/YOU/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk):[Press enter]
|
||||
```
|
||||
|
||||
{% endwindows %}
|
||||
|
|
@ -233,14 +235,14 @@ If you are using macOS or Linux, you may need to update your SSH client or insta
|
|||
{% linux %}
|
||||
|
||||
```shell
|
||||
> Enter a file in which to save the key (/home/<em>you</em>/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk): <em>[Press enter]</em>
|
||||
> Enter a file in which to save the key (/home/YOU/.ssh/id_{% ifversion ghae %}ecdsa{% else %}ed25519{% endif %}_sk):[Press enter]
|
||||
```
|
||||
|
||||
{% endlinux %}
|
||||
|
||||
6. When you are prompted to type a passphrase, press **Enter**.
|
||||
```shell
|
||||
> Enter passphrase (empty for no passphrase): <em>[Type a passphrase]</em>
|
||||
> Enter same passphrase again: <em>[Type passphrase again]</em>
|
||||
> Enter passphrase (empty for no passphrase): [Type a passphrase]
|
||||
> Enter same passphrase again: [Type passphrase again]
|
||||
```
|
||||
7. Add the SSH key to your account on {% data variables.product.prodname_dotcom %}. For more information, see "[Adding a new SSH key to your {% data variables.product.prodname_dotcom %} account](/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account)."
|
||||
|
|
|
|||
|
|
@ -36,7 +36,7 @@ If you have multiple keys or are attempting to sign commits or tags with a key t
|
|||
|
||||
1. When committing changes in your local branch, add the -S flag to the git commit command:
|
||||
```shell
|
||||
$ git commit -S -m <em>"your commit message"</em>
|
||||
$ git commit -S -m "YOUR_COMMIT_MESSAGE"
|
||||
# Creates a signed commit
|
||||
```
|
||||
2. If you're using GPG, after you create your commit, provide the passphrase you set up when you [generated your GPG key](/articles/generating-a-new-gpg-key).
|
||||
|
|
|
|||
|
|
@ -19,12 +19,12 @@ topics:
|
|||
|
||||
1. To sign a tag, add `-s` to your `git tag` command.
|
||||
```shell
|
||||
$ git tag -s <em>mytag</em>
|
||||
$ git tag -s MYTAG
|
||||
# Creates a signed tag
|
||||
```
|
||||
2. Verify your signed tag by running `git tag -v [tag-name]`.
|
||||
```shell
|
||||
$ git tag -v <em>mytag</em>
|
||||
$ git tag -v MYTAG
|
||||
# Verifies the signed tag
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Configurando notificações para alertas do Dependabot
|
||||
title: Configuring notifications for Dependabot alerts
|
||||
shortTitle: Configure notifications
|
||||
intro: 'Otimize a forma como você recebe notificações sobre {% data variables.product.prodname_dependabot_alerts %}.'
|
||||
intro: 'Optimize how you receive notifications about {% data variables.product.prodname_dependabot_alerts %}.'
|
||||
redirect_from:
|
||||
- /github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies
|
||||
- /code-security/supply-chain-security/configuring-notifications-for-vulnerable-dependencies
|
||||
|
|
@ -19,50 +19,51 @@ topics:
|
|||
- Vulnerabilities
|
||||
- Dependencies
|
||||
- Repositories
|
||||
ms.openlocfilehash: b8810c27a10302a7873fc61a32189f33855140bb
|
||||
ms.sourcegitcommit: ac00e2afa6160341c5b258d73539869720b395a4
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147875524'
|
||||
---
|
||||
## Sobre as notificações de {% data variables.product.prodname_dependabot_alerts %}.
|
||||
|
||||
Quando o {% data variables.product.prodname_dependabot %} detecta dependências vulneráveis {% ifversion GH-advisory-db-supports-malware %} ou malware{% endif %} nos seus repositórios, geramos um alerta do {% data variables.product.prodname_dependabot %} que é exibido na guia Segurança do repositório. O {% data variables.product.product_name %} notifica os mantenedores dos repositórios afetados sobre o novo alerta de acordo com as preferências de notificação.{% ifversion fpt or ghec %} Por padrão, o {% data variables.product.prodname_dependabot %} está habilitado em todos os repositórios públicos. Para {% data variables.product.prodname_dependabot_alerts %}, por padrão, você receberá {% data variables.product.prodname_dependabot_alerts %} por e-mail, agrupado pela vulnerabilidade específica.
|
||||
## About notifications for {% data variables.product.prodname_dependabot_alerts %}
|
||||
|
||||
When {% data variables.product.prodname_dependabot %} detects vulnerable dependencies{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %} in your repositories, we generate a {% data variables.product.prodname_dependabot %} alert and display it on the Security tab for the repository. {% data variables.product.product_name %} notifies the maintainers of affected repositories about the new alert according to their notification preferences.{% ifversion fpt or ghec %} {% data variables.product.prodname_dependabot %} is enabled by default on all public repositories. For {% data variables.product.prodname_dependabot_alerts %}, by default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability.
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %}Se você é proprietário de uma organização, habilite ou desabilite os {% data variables.product.prodname_dependabot_alerts %} em todos os repositórios da organização com um clique. Você também pode definir se os {% data variables.product.prodname_dependabot_alerts %} serão habilitados ou desabilitados para repositórios recém-criados. Para obter mais informações, confira "[Como gerenciar as configurações de segurança e de análise da sua organização](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization#enabling-or-disabling-a-feature-for-all-new-repositories-when-they-are-added)".
|
||||
{% ifversion fpt or ghec %}If you're an organization owner, you can enable or disable {% data variables.product.prodname_dependabot_alerts %} for all repositories in your organization with one click. You can also set whether {% data variables.product.prodname_dependabot_alerts %} will be enabled or disabled for newly-created repositories. For more information, see "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization#enabling-or-disabling-a-feature-for-all-new-repositories-when-they-are-added)."
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes or ghae %} Por padrão, se o proprietário da sua empresa configurou o email para receber notificações sobre sua empresa, você receberá os {% data variables.product.prodname_dependabot_alerts %} por email.
|
||||
{% ifversion ghes or ghae %}
|
||||
By default, if your enterprise owner has configured email for notifications on your enterprise, you will receive {% data variables.product.prodname_dependabot_alerts %} by email.
|
||||
|
||||
Os proprietários das empresas também podem habilitar {% data variables.product.prodname_dependabot_alerts %} sem notificações. Para obter mais informações, confira "[Como habilitar o {% data variables.product.prodname_dependabot %} para sua empresa](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)".
|
||||
Enterprise owners can also enable {% data variables.product.prodname_dependabot_alerts %} without notifications. For more information, see "[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)."
|
||||
{% endif %}
|
||||
|
||||
## Configurar notificações para {% data variables.product.prodname_dependabot_alerts %}
|
||||
## Configuring notifications for {% data variables.product.prodname_dependabot_alerts %}
|
||||
|
||||
{% ifversion fpt or ghes or ghec %} Quando um novo alerta do {% data variables.product.prodname_dependabot %} é detectado, o {% data variables.product.product_name %} notifica todos os usuários com acesso aos {% data variables.product.prodname_dependabot_alerts %} no repositório de acordo com as respectivas preferências de notificação. Você receberá alertas se estiver acompanhando o repositório, caso tenha habilitado notificações para alertas de segurança ou para toda a atividade no repositório e não estiver ignorando o repositório. Para obter mais informações, confira "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)".
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
When a new {% data variables.product.prodname_dependabot %} alert is detected, {% data variables.product.product_name %} notifies all users with access to {% data variables.product.prodname_dependabot_alerts %} for the repository according to their notification preferences. You will receive alerts if you are watching the repository, have enabled notifications for security alerts or for all the activity on the repository, and are not ignoring the repository. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)."
|
||||
{% endif %}
|
||||
|
||||
Você pode definir as configurações de notificação para si mesmo ou para sua organização no menu suspenso Gerenciar notificações {% octicon "bell" aria-label="The notifications bell" %} exibido na parte superior de cada página. Para obter mais informações, confira "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)".
|
||||
You can configure notification settings for yourself or your organization from the Manage notifications drop-down {% octicon "bell" aria-label="The notifications bell" %} shown at the top of each page. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)."
|
||||
|
||||
{% data reusables.notifications.vulnerable-dependency-notification-delivery-method-customization2 %} {% data reusables.notifications.vulnerable-dependency-notification-options %}
|
||||
{% data reusables.notifications.vulnerable-dependency-notification-delivery-method-customization2 %}
|
||||
{% data reusables.notifications.vulnerable-dependency-notification-options %}
|
||||
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
{% else %}
|
||||
{% endif %}
|
||||
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** você pode filtrar suas notificações no {% data variables.product.company_short %} para mostrar os {% data variables.product.prodname_dependabot_alerts %}. Para obter mais informações, confira "[Como gerenciar notificações na sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)".
|
||||
**Note:** You can filter your notifications on {% data variables.product.company_short %} to show {% data variables.product.prodname_dependabot_alerts %}. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.repositories.security-alerts-x-github-severity %} Para obter mais informações, confira "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications)".
|
||||
{% data reusables.repositories.security-alerts-x-github-severity %} For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications)."
|
||||
|
||||
## Como reduzir as notificações desnecessárias de {% data variables.product.prodname_dependabot_alerts %}.
|
||||
## How to reduce the noise from notifications for {% data variables.product.prodname_dependabot_alerts %}
|
||||
|
||||
Se você estiver preocupado em receber muitas notificações para {% data variables.product.prodname_dependabot_alerts %}, recomendamos que você opte pelo resumo semanal de e-mail ou desabilite as notificações enquanto mantém {% data variables.product.prodname_dependabot_alerts %} habilitado. Você ainda pode navegar para ver os {% data variables.product.prodname_dependabot_alerts %} na guia Segurança do repositório. Para obter mais informações, confira "[Como ver os {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)".
|
||||
If you are concerned about receiving too many notifications for {% data variables.product.prodname_dependabot_alerts %}, we recommend you opt into the weekly email digest, or turn off notifications while keeping {% data variables.product.prodname_dependabot_alerts %} enabled. You can still navigate to see your {% data variables.product.prodname_dependabot_alerts %} in your repository's Security tab. For more information, see "[Viewing and updating {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)."
|
||||
|
||||
## Leitura adicional
|
||||
## Further reading
|
||||
|
||||
- "[Como configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)"
|
||||
- "[Como gerenciar notificações na sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-is-queries)"
|
||||
- "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)"
|
||||
- "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-is-queries)"
|
||||
|
|
|
|||
|
|
@ -33,6 +33,12 @@ You must store this file in the `.github` directory of your repository. When you
|
|||
|
||||
Any options that also affect security updates are used the next time a security alert triggers a pull request for a security update. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-dependabot-security-updates)."
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** You cannot configure {% data variables.product.prodname_dependabot_alerts %} using the *dependabot.yml* file.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
The *dependabot.yml* file has two mandatory top-level keys: `version`, and `updates`. You can, optionally, include a top-level `registries` key{% ifversion ghes = 3.5 %} and/or a `enable-beta-ecosystems` key{% endif %}. The file must start with `version: 2`.
|
||||
|
||||
## Configuration options for the *dependabot.yml* file
|
||||
|
|
|
|||
|
|
@ -73,6 +73,8 @@ Organization owners can specify who can create and use codespaces at the organiz
|
|||
|
||||
|
||||
|
||||
If codespaces for this repository are billable, a message is displayed below the **Create codespace on BRANCH** button telling you who will pay for the codespace.
|
||||
|
||||
1. Create your codespace, either using the default options, or after configuring advanced options:
|
||||
|
||||
* **Use the default options**
|
||||
|
|
@ -131,12 +133,12 @@ To create a new codespace, use the `gh codespace create` subcommand.
|
|||
gh codespace create
|
||||
```
|
||||
|
||||
You are prompted to choose a repository, a branch, a dev container configuration file (if more than one is available), and a machine type (if more than one is available).
|
||||
You are prompted to choose a repository. If codespaces for this repository are billable, a message is displayed telling you who will pay for the codespace. You are then prompted to choose a branch, a dev container configuration file (if more than one is available), and a machine type (if more than one is available).
|
||||
|
||||
Alternatively, you can use flags to specify some or all of the options:
|
||||
|
||||
```shell
|
||||
gh codespace create -r <em>owner</em>/<em>repo</em> -b <em>branch</em> --devcontainer-path <em>path</em> -m <em>machine-type</em>
|
||||
gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE
|
||||
```
|
||||
|
||||
In this example, replace `owner/repo` with the repository identifier. Replace `branch` with the name of the branch, or the full SHA hash of the commit, that you want to be initially checked out in the codespace. If you use the `-r` flag without the `b` flag, the codespace is created from the default branch.
|
||||
|
|
|
|||
|
|
@ -78,7 +78,7 @@ By default, {% data variables.product.prodname_github_codespaces %} forwards por
|
|||
To forward a port use the `gh codespace ports forward` subcommand. Replace `codespace-port:local-port` with the remote and local ports that you want to connect. After entering the command choose from the list of codespaces that's displayed.
|
||||
|
||||
```shell
|
||||
gh codespace ports forward <em>codespace-port</em>:<em>local-port</em>
|
||||
gh codespace ports forward CODESPACE-PORT:LOCAL-PORT
|
||||
```
|
||||
|
||||
For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_ports_forward).
|
||||
|
|
@ -132,7 +132,7 @@ To change the visibility of a forwarded port, use the `gh codespace ports visibi
|
|||
Replace `codespace-port` with the forwarded port number. Replace `setting` with `private`, `org`, or `public`. After entering the command choose from the list of codespaces that's displayed.
|
||||
|
||||
```shell
|
||||
gh codespace ports visibility <em>codespace-port</em>:<em>setting</em>
|
||||
gh codespace ports visibility CODESPACE-PORT:SETTINGS
|
||||
```
|
||||
|
||||
You can set the visibility for multiple ports with one command. For example:
|
||||
|
|
|
|||
|
|
@ -50,7 +50,7 @@ Changing the display name of a codespace can be useful if you have multiple code
|
|||
To rename a codespace, use the `gh codespace edit` subcommand:
|
||||
|
||||
```shell
|
||||
gh codespace edit -c <em>permanent name of the codespace</em> -d <em>new display name</em>
|
||||
gh codespace edit -c PERMANENT-NAME-OF-CODESPACE -d NEW-DISPLAY-NAME
|
||||
```
|
||||
|
||||
In this example, replace `permanent name of the codespace` with the permanent name of the codespace. Replace `new display name` with the desired display name.
|
||||
|
|
@ -62,7 +62,7 @@ For a complete reference of `gh` commands for {% data variables.product.prodname
|
|||
|
||||
{% note %}
|
||||
|
||||
**Note**: The `-c <em>codespace-name</em>` flag, used with many commands, is optional. If you omit it a list of codespaces is displayed for you to choose from.
|
||||
**Note**: The `-c CODESPACE_NAME` flag, used with many commands, is optional. If you omit it a list of codespaces is displayed for you to choose from.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
|
@ -77,7 +77,7 @@ The list includes the unique name of each codespace, which you can use in other
|
|||
### Create a new codespace
|
||||
|
||||
```shell
|
||||
gh codespace create -r <em>owner/repository</em> [-b <em>branch</em>]
|
||||
gh codespace create -r OWNER/REPO_NAME [-b BRANCH]
|
||||
```
|
||||
|
||||
For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace)."
|
||||
|
|
@ -85,7 +85,7 @@ For more information, see "[Creating a codespace](/codespaces/developing-in-code
|
|||
### Stop a codespace
|
||||
|
||||
```shell
|
||||
gh codespace stop -c <em>codespace-name</em>
|
||||
gh codespace stop -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
For more information, see "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)."
|
||||
|
|
@ -93,7 +93,7 @@ For more information, see "[Deep dive into {% data variables.product.prodname_gi
|
|||
### Delete a codespace
|
||||
|
||||
```shell
|
||||
gh codespace delete -c <em>codespace-name</em>
|
||||
gh codespace delete -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)."
|
||||
|
|
@ -103,7 +103,7 @@ For more information, see "[Deleting a codespace](/codespaces/developing-in-code
|
|||
To run commands on the remote codespace machine, from your terminal, you can SSH into the codespace.
|
||||
|
||||
```shell
|
||||
gh codespace ssh -c <em>codespace-name</em>
|
||||
gh codespace ssh -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
{% data variables.product.prodname_github_codespaces %} copies your GitHub SSH keys into the codespace on creation for a seamless authentication experience. You may be asked to enter the passphrase for your SSH key, after which you will get a command prompt from the remote codespace machine.
|
||||
|
|
@ -113,7 +113,7 @@ If you don't have any SSH keys, follow the instructions in "[Generating a new SS
|
|||
### Open a codespace in {% data variables.product.prodname_vscode %}
|
||||
|
||||
```shell
|
||||
gh codespace code -c <em>codespace-name</em>
|
||||
gh codespace code -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code)."
|
||||
|
|
@ -121,13 +121,13 @@ For more information, see "[Using {% data variables.product.prodname_github_code
|
|||
### Open a codespace in JupyterLab
|
||||
|
||||
```shell
|
||||
gh codespace jupyter -c <em>codespace-name</em>
|
||||
gh codespace jupyter -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
### Copy a file to/from a codespace
|
||||
|
||||
```shell
|
||||
gh codespace cp [-r] <em>source(s)</em> <em>destination</em>
|
||||
gh codespace cp [-r] SOURCE(S) DESTINATION
|
||||
```
|
||||
|
||||
Use the prefix `remote:` on a file or directory name to indicate that it's on the codespace. As with the UNIX `cp` command, the first argument specifies the source and the last specifies the destination. If the destination is a directory, you can specify multiple sources. Use the `-r` (recursive) flag if any of the sources is a directory.
|
||||
|
|
@ -171,7 +171,7 @@ For more information about the `gh codespace cp` command, including additional f
|
|||
You can forward a port on a codespace to a local port. The port remains forwarded as long as the process is running. To stop forwarding the port, press <kbd>Control</kbd>+<kbd>C</kbd>.
|
||||
|
||||
```shell
|
||||
gh codespace ports forward <em>codespace-port-number</em>:<em>local-port-number</em> -c <em>codespace-name</em>
|
||||
gh codespace ports forward CODESPACE-PORT_NAME:LOCAL-PORT-NAME -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
To see details of forwarded ports enter `gh codespace ports` and then choose a codespace.
|
||||
|
|
@ -179,13 +179,13 @@ To see details of forwarded ports enter `gh codespace ports` and then choose a c
|
|||
You can set the visibility of a forwarded port. {% data reusables.codespaces.port-visibility-settings %}
|
||||
|
||||
```shell
|
||||
gh codespace ports visibility <em>codespace-port</em>:<em>private|org|public</em> -c <em>codespace-name</em>
|
||||
gh codespace ports visibility CODESPACE-PORT:private|org|public -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
You can set the visibility for multiple ports with one command. For example:
|
||||
|
||||
```shell
|
||||
gh codespace ports visibility 80:private 3000:public 3306:org -c <em>codespace-name</em>
|
||||
gh codespace ports visibility 80:private 3000:public 3306:org -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)."
|
||||
|
|
@ -195,7 +195,7 @@ For more information, see "[Forwarding ports in your codespace](/codespaces/deve
|
|||
You can see the creation log for a codespace. After entering this command you will be asked to enter the passphrase for your SSH key.
|
||||
|
||||
```shell
|
||||
gh codespace logs -c <em>codespace-name</em>
|
||||
gh codespace logs -c CODESPACE-NAME
|
||||
```
|
||||
|
||||
For more information about the creation log, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs#creation-logs)."
|
||||
|
|
|
|||
|
|
@ -41,3 +41,5 @@ You can also personalize aspects of your codespace environment by using a public
|
|||
For information on pricing, storage, and usage for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
|
||||
|
||||
{% data reusables.codespaces.codespaces-spending-limit-requirement %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
|
||||
|
||||
You can see who will pay for a codespace before you create it. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Configurar diretrizes para os contribuidores do repositório
|
||||
intro: Você pode criar diretrizes para informar como as pessoas devem contribuir com o projeto.
|
||||
title: Setting guidelines for repository contributors
|
||||
intro: You can create guidelines to communicate how people should contribute to your project.
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
|
|
@ -13,59 +13,56 @@ redirect_from:
|
|||
topics:
|
||||
- Community
|
||||
shortTitle: Contributor guidelines
|
||||
ms.openlocfilehash: b418c5a3d10f8b8f7572f33b17a9ebfbb3de27d3
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147578785'
|
||||
---
|
||||
## Sobre diretrizes de contribuição
|
||||
Para ajudar os colaboradores do projeto a fazer um bom trabalho, você pode adicionar um arquivo com diretrizes de contribuição à raiz do repositório de projeto, a `docs` ou à pasta `.github`. Quando alguém abrir uma pull request ou criar um problema, verá um link para esse arquivo. O link usado para as diretrizes de contribuição também é exibido na página do repositório `contribute`. Para ver um exemplo de uma página `contribute`, confira [github/docs/contribute](https://github.com/github/docs/contribute).
|
||||
## About contributing guidelines
|
||||
To help your project contributors do good work, you can add a file with contribution guidelines to your project repository's root, `docs`, or `.github` folder. When someone opens a pull request or creates an issue, they will see a link to that file. The link to the contributing guidelines also appears on your repository's `contribute` page. For an example of a `contribute` page, see [github/docs/contribute](https://github.com/github/docs/contribute).
|
||||
|
||||
|
||||
|
||||
|
||||
Para o proprietário do repositório, as diretrizes de contribuição são uma forma de informar como as pessoas devem contribuir.
|
||||
For the repository owner, contribution guidelines are a way to communicate how people should contribute.
|
||||
|
||||
Para contribuidores, as diretrizes ajudam a verificar se eles estão enviando pull requests corretas e abrindo problemas úteis.
|
||||
For contributors, the guidelines help them verify that they're submitting well-formed pull requests and opening useful issues.
|
||||
|
||||
Para proprietários e contribuidores, as diretrizes de contribuição economizam tempo e evitam aborrecimentos causados por pull requests ou problemas incorretos que precisam ser rejeitados e enviados novamente.
|
||||
For both owners and contributors, contribution guidelines save time and hassle caused by improperly created pull requests or issues that have to be rejected and re-submitted.
|
||||
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
|
||||
Você pode criar diretrizes de contribuição padrão para sua conta de organização{% ifversion fpt or ghes or ghec %} ou pessoal {% endif %}. Para obter mais informações, confira "[Como criar um arquivo padrão de integridade da comunidade](//communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)".
|
||||
You can create default contribution guidelines for your organization{% ifversion fpt or ghes or ghec %} or personal account{% endif %}. For more information, see "[Creating a default community health file](//communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Dica:** os mantenedores do repositório podem definir diretrizes específicas para problemas criando um modelo de solicitação de pull ou de problema para o repositório. Para obter mais informações, confira "[Sobre os modelos de solicitações de pull e de problemas](/articles/about-issue-and-pull-request-templates)".
|
||||
**Tip:** Repository maintainers can set specific guidelines for issues by creating an issue or pull request template for the repository. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Como adicionar um arquivo *CONTRIBUTING*
|
||||
## Adding a *CONTRIBUTING* file
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %}
|
||||
3. Decida se deseja armazenar suas diretrizes de contribuição na raiz do repositório, em `docs` ou no diretório `.github`. Em seguida, no campo de nome do arquivo, digite o nome e a extensão do arquivo. Os nomes de arquivos com diretrizes de contribuição não são sensíveis a maiúsculas de minúsculas. Os arquivos são renderizados no formato de texto rich se a extensão do arquivo estiver em um formato compatível. Para obter mais informações, confira "[Como trabalhar com arquivos que não são de código](/repositories/working-with-files/using-files/working-with-non-code-files#rendering-differences-in-prose-documents)".
|
||||
|
||||
- Para tornar as diretrizes de contribuição visíveis no diretório raiz do repositório, digite *CONTRIBUTING*.
|
||||
- Para tornar as diretrizes de contribuição visíveis no diretório `docs` do repositório, digite *docs/* para criar o diretório e, depois, *CONTRIBUTING*.
|
||||
- Se um repositório contiver mais de um arquivo *CONTRIBUTING*, o arquivo mostrado nos links será escolhido dos locais na seguinte ordem: o diretório `.github`, o diretório raiz do repositório e, por fim, o diretório `docs`.
|
||||
4. Adicione as diretrizes de contribuição ao novo arquivo. Elas podem conter:
|
||||
- Etapas para criar bons problemas ou pull requests.
|
||||
- Links para documentações externas, listas de distribuição ou um código de conduta.
|
||||
- Expectativas de comportamento e da comunidade.
|
||||
{% data reusables.files.write_commit_message %} {% data reusables.files.choose_commit_branch %} {% data reusables.files.propose_new_file %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.files.add-file %}
|
||||
3. Decide whether to store your contributing guidelines in your repository's root, `docs`, or `.github` directory. Then, in the filename field, type the name and extension for the file. Contributing guidelines filenames are not case sensitive. Files are rendered in rich text format if the file extension is in a supported format. For more information, see "[Working with non-code files](/repositories/working-with-files/using-files/working-with-non-code-files#rendering-differences-in-prose-documents)."
|
||||
|
||||
- To make your contributing guidelines visible in the repository's root directory, type *CONTRIBUTING*.
|
||||
- To make your contributing guidelines visible in the repository's `docs` directory, type *docs/* to create the new directory, then *CONTRIBUTING*.
|
||||
- If a repository contains more than one *CONTRIBUTING* file, then the file shown in links is chosen from locations in the following order: the `.github` directory, then the repository's root directory, and finally the `docs` directory.
|
||||
4. In the new file, add contribution guidelines. These could include:
|
||||
- Steps for creating good issues or pull requests.
|
||||
- Links to external documentation, mailing lists, or a code of conduct.
|
||||
- Community and behavioral expectations.
|
||||
{% data reusables.files.write_commit_message %}
|
||||
{% data reusables.files.choose_commit_branch %}
|
||||
{% data reusables.files.propose_new_file %}
|
||||
|
||||
## Exemplos de diretrizes de contribuição
|
||||
## Examples of contribution guidelines
|
||||
|
||||
Caso tenha dúvidas, estes são alguns bons exemplos de diretrizes de contribuição:
|
||||
If you're stumped, here are some good examples of contribution guidelines:
|
||||
|
||||
- As [diretrizes de contribuição](https://github.com/atom/atom/blob/master/CONTRIBUTING.md) do editor do Atom.
|
||||
- As [diretrizes de contribuição](https://github.com/rails/rails/blob/main/CONTRIBUTING.md) do Ruby on Rails.
|
||||
- As [diretrizes de contribuição](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md) do Open Government.
|
||||
- The {% data variables.product.prodname_docs %} [contribution guidelines](https://github.com/github/docs/blob/main/CONTRIBUTING.md).
|
||||
- The Ruby on Rails [contribution guidelines](https://github.com/rails/rails/blob/main/CONTRIBUTING.md).
|
||||
- The Open Government [contribution guidelines](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md).
|
||||
|
||||
## Leitura adicional
|
||||
- A seção "[Como iniciar um projeto de código aberto](https://opensource.guide/starting-a-project/)" dos Guias de Código Aberto{% ifversion fpt or ghec %}
|
||||
## Further reading
|
||||
- The Open Source Guides' section "[Starting an Open Source Project](https://opensource.guide/starting-a-project/)"{% ifversion fpt or ghec %}
|
||||
- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% ifversion fpt or ghes or ghec %}
|
||||
- "[Como adicionar uma licença a um repositório](/articles/adding-a-license-to-a-repository)"{% endif %}
|
||||
- "[Adding a license to a repository](/articles/adding-a-license-to-a-repository)"{% endif %}
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Fazer alterações em um branch
|
||||
intro: 'Faça alterações no projeto usando seu editor de texto favorito, como o [Atom](https://atom.io/) e use o {% data variables.product.prodname_desktop %} para exibir commits relevantes.'
|
||||
title: Making changes in a branch
|
||||
intro: 'Use your favorite text editor, such as [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/), to make changes to your project, then use {% data variables.product.prodname_desktop %} to visualize useful commits.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects/making-changes-in-a-branch
|
||||
versions:
|
||||
|
|
@ -12,11 +12,5 @@ children:
|
|||
- /viewing-the-branch-history
|
||||
- /pushing-changes-to-github
|
||||
shortTitle: Make changes in a branch
|
||||
ms.openlocfilehash: 3ff1729cdf050f3604c383d965dda117b5a18e42
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '145084072'
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -48,7 +48,7 @@ To verify a private key:
|
|||
|
||||
2. Generate the fingerprint of your private key (PEM) locally by using the following command:
|
||||
```shell
|
||||
$ openssl rsa -in <em>PATH_TO_PEM_FILE</em> -pubout -outform DER | openssl sha256 -binary | openssl base64
|
||||
$ openssl rsa -in PATH_TO_PEM_FILE -pubout -outform DER | openssl sha256 -binary | openssl base64
|
||||
```
|
||||
3. Compare the results of the locally generated fingerprint to the fingerprint you see in {% data variables.product.product_name %}.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Gerenciar chaves de implantação
|
||||
intro: Aprenda maneiras diferentes de gerenciar chaves SSH em seus servidores ao automatizar scripts de implantação e da melhor maneira para você.
|
||||
title: Managing deploy keys
|
||||
intro: Learn different ways to manage SSH keys on your servers when you automate deployment scripts and which way is best for you.
|
||||
redirect_from:
|
||||
- /guides/managing-deploy-keys
|
||||
- /v3/guides/managing-deploy-keys
|
||||
|
|
@ -14,91 +14,90 @@ versions:
|
|||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: 425535eb582c84801d79f00df751bb48d4a5b05e
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '146058465'
|
||||
---
|
||||
Você pode gerenciar chaves SSH em seus servidores ao automatizar scripts de implantação usando o encaminhamento do agente SSH, HTTPS com tokens do OAuth, chaves de implantação ou usuários de máquina.
|
||||
|
||||
## Encaminhamento de agente SSH
|
||||
|
||||
Em muitos casos, especialmente no início de um projeto, o encaminhamento de agentes SSH é o método mais rápido e simples de utilizar. O encaminhamento de agentes usa as mesmas chaves SSH que o seu computador de desenvolvimento local.
|
||||
You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users.
|
||||
|
||||
#### Vantagens
|
||||
## SSH agent forwarding
|
||||
|
||||
* Você não tem que gerar ou monitorar nenhuma chave nova.
|
||||
* Não há gerenciamento de chaves; os usuários têm as mesmas permissões no servidor e localmente.
|
||||
* Não há chaves armazenadas no servidor. Portanto, caso o servidor esteja comprometido, você não precisa buscar e remover as chaves comprometidas.
|
||||
In many cases, especially in the beginning of a project, SSH agent forwarding is the quickest and simplest method to use. Agent forwarding uses the same SSH keys that your local development computer uses.
|
||||
|
||||
#### Desvantagens
|
||||
#### Pros
|
||||
|
||||
* Os usuários **precisam** usar o SSH para fazer a implantação: processos de implantação automatizados não podem ser usados.
|
||||
* Pode ser problemático executar o encaminhamento de agente SSH para usuários do Windows.
|
||||
* You do not have to generate or keep track of any new keys.
|
||||
* There is no key management; users have the same permissions on the server that they do locally.
|
||||
* No keys are stored on the server, so in case the server is compromised, you don't need to hunt down and remove the compromised keys.
|
||||
|
||||
#### Configuração
|
||||
#### Cons
|
||||
|
||||
1. Ativar o encaminhamento do agente localmente. Confira [nosso guia sobre o encaminhamento do agente SSH][ssh-agent-forwarding] para obter mais informações.
|
||||
2. Defina seus scripts de implantação para usar o encaminhamento de agentes. Por exemplo, em um script do Bash, a habilitação do encaminhamento do agente será algo assim: `ssh -A serverA 'bash -s' < deploy.sh`
|
||||
* Users **must** SSH in to deploy; automated deploy processes can't be used.
|
||||
* SSH agent forwarding can be troublesome to run for Windows users.
|
||||
|
||||
## Clonagem de HTTPS com tokens do OAuth
|
||||
#### Setup
|
||||
|
||||
Se você não quiser usar chaves SSH, você poderá usar HTTPS com tokens OAuth.
|
||||
1. Turn on agent forwarding locally. See [our guide on SSH agent forwarding][ssh-agent-forwarding] for more information.
|
||||
2. Set your deploy scripts to use agent forwarding. For example, on a bash script, enabling agent forwarding would look something like this:
|
||||
`ssh -A serverA 'bash -s' < deploy.sh`
|
||||
|
||||
#### Vantagens
|
||||
## HTTPS cloning with OAuth tokens
|
||||
|
||||
* Qualquer pessoa com acesso ao servidor pode implantar o repositório.
|
||||
* Os usuários não precisam alterar suas configurações SSH locais.
|
||||
* Não são necessários vários tokens (um para cada usuário); um token por servidor é suficiente.
|
||||
* Um token pode ser revogado a qualquer momento, transformando-o, basicamente, em uma senha de uso único.
|
||||
If you don't want to use SSH keys, you can use HTTPS with OAuth tokens.
|
||||
|
||||
#### Pros
|
||||
|
||||
* Anyone with access to the server can deploy the repository.
|
||||
* Users don't have to change their local SSH settings.
|
||||
* Multiple tokens (one for each user) are not needed; one token per server is enough.
|
||||
* A token can be revoked at any time, turning it essentially into a one-use password.
|
||||
{% ifversion ghes %}
|
||||
* A geração de novos tokens pode ser inserida com facilidade em um script por meio [da API do OAuth](/rest/reference/oauth-authorizations#create-a-new-authorization).
|
||||
* Generating new tokens can be easily scripted using [the OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization).
|
||||
{% endif %}
|
||||
|
||||
#### Desvantagens
|
||||
#### Cons
|
||||
|
||||
* Você deve certificar-se de configurar seu token com os escopos de acesso corretos.
|
||||
* Os Tokens são, basicamente, senhas e devem ser protegidos da mesma maneira.
|
||||
* You must make sure that you configure your token with the correct access scopes.
|
||||
* Tokens are essentially passwords, and must be protected the same way.
|
||||
|
||||
#### Configuração
|
||||
#### Setup
|
||||
|
||||
Confira [nosso guia sobre como criar um token de acesso pessoal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
|
||||
See [our guide on creating a personal access token](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
|
||||
|
||||
## Chaves de implantação
|
||||
## Deploy keys
|
||||
|
||||
{% data reusables.repositories.deploy-keys %}
|
||||
|
||||
{% data reusables.repositories.deploy-keys-write-access %}
|
||||
|
||||
#### Vantagens
|
||||
#### Pros
|
||||
|
||||
* Qualquer pessoa com acesso ao repositório e servidor é capaz de implantar o projeto.
|
||||
* Os usuários não precisam alterar suas configurações SSH locais.
|
||||
* As chaves de implantação são somente leitura por padrão, mas você pode dar a elas acesso de gravação ao adicioná-las a um repositório.
|
||||
* Anyone with access to the repository and server has the ability to deploy the project.
|
||||
* Users don't have to change their local SSH settings.
|
||||
* Deploy keys are read-only by default, but you can give them write access when adding them to a repository.
|
||||
|
||||
#### Desvantagens
|
||||
#### Cons
|
||||
|
||||
* As chaves de implementação só concedem acesso a um único repositório. Projetos mais complexos podem ter muitos repositórios para extrair para o mesmo servidor.
|
||||
* De modo geral, as chaves de implantação não são protegidas por uma frase secreta, o que a chave facilmente acessível se o servidor estiver comprometido.
|
||||
* Deploy keys only grant access to a single repository. More complex projects may have many repositories to pull to the same server.
|
||||
* Deploy keys are usually not protected by a passphrase, making the key easily accessible if the server is compromised.
|
||||
|
||||
#### Configuração
|
||||
#### Setup
|
||||
|
||||
1. [Execute o procedimento `ssh-keygen`][generating-ssh-keys] no servidor e lembre-se do local em que salvou o par de chaves RSA público e privado gerado.
|
||||
2. No canto superior direito de qualquer página do {% data variables.product.product_name %}, clique na foto do seu perfil e clique em **Seu perfil**. 
|
||||
3. Na página do seu perfil, clique em **Repositórios** e clique no nome do repositório. 
|
||||
4. No seu repositório, clique em **Configurações**. 
|
||||
5. Na barra lateral, clique em **Implantar Chaves** e em **Adicionar chave de implantação**. 
|
||||
6. Forneça um título e cole na sua chave pública. 
|
||||
7. Selecione **Permitir acesso de gravação** se desejar que essa chave tenha acesso de gravação no repositório. Uma chave de implantação com acesso de gravação permite que uma implantação faça push no repositório.
|
||||
8. Clique em **Adicionar chave**.
|
||||
1. [Run the `ssh-keygen` procedure][generating-ssh-keys] on your server, and remember where you save the generated public and private rsa key pair.
|
||||
{% data reusables.profile.navigating-to-profile %}
|
||||
|
||||
#### Usar vários repositórios em um servidor
|
||||
|
||||
1. On your profile page, click **Repositories**, then click the name of your repository. 
|
||||
2. From your repository, click **Settings**. 
|
||||
3. In the sidebar, click **Deploy Keys**, then click **Add deploy key**. 
|
||||
4. Provide a title, paste in your public key. 
|
||||
5. Select **Allow write access** if you want this key to have write access to the repository. A deploy key with write access lets a deployment push to the repository.
|
||||
6. Click **Add key**.
|
||||
|
||||
Se você usar vários repositórios em um servidor, você deverá gerar um par de chaves dedicado para cada um. Você não pode reutilizar uma chave de implantação para vários repositórios.
|
||||
#### Using multiple repositories on one server
|
||||
|
||||
No arquivo de configuração do SSH do servidor (geralmente, `~/.ssh/config`), adicione uma entrada de alias para cada repositório. Por exemplo:
|
||||
If you use multiple repositories on one server, you will need to generate a dedicated key pair for each one. You can't reuse a deploy key for multiple repositories.
|
||||
|
||||
In the server's SSH configuration file (usually `~/.ssh/config`), add an alias entry for each repository. For example:
|
||||
|
||||
```bash
|
||||
Host {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}-repo-0
|
||||
|
|
@ -110,79 +109,79 @@ Host {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif
|
|||
IdentityFile=/home/user/.ssh/repo-1_deploy_key
|
||||
```
|
||||
|
||||
* `Host {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}-repo-0` – O alias do repositório.
|
||||
* `Hostname {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}` – Configura o nome do host a ser usado com o alias.
|
||||
* `IdentityFile=/home/user/.ssh/repo-0_deploy_key` – Atribui uma chave privada ao alias.
|
||||
* `Host {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}-repo-0` - The repository's alias.
|
||||
* `Hostname {% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}` - Configures the hostname to use with the alias.
|
||||
* `IdentityFile=/home/user/.ssh/repo-0_deploy_key` - Assigns a private key to the alias.
|
||||
|
||||
Em seguida, você pode usar o apelido do host para interagir com o repositório usando SSH, que usará a chave de deploy exclusiva atribuída a esse pseudônimo. Por exemplo:
|
||||
You can then use the hostname's alias to interact with the repository using SSH, which will use the unique deploy key assigned to that alias. For example:
|
||||
|
||||
```bash
|
||||
$ git clone git@{% ifversion fpt or ghec %}github.com{% else %}my-GHE-hostname.com{% endif %}-repo-1:OWNER/repo-1.git
|
||||
```
|
||||
|
||||
## Tokens do servidor para servidor
|
||||
## Server-to-server tokens
|
||||
|
||||
Se o servidor precisar acessar repositórios em uma ou mais organizações, use um Aplicativo do GitHub para definir o acesso necessário e gere tokens _de servidor para servidor_ com _escopo delimitado_ por meio desse Aplicativo do GitHub. Os tokens do servidor para servidor podem ter escopo de repositório único ou múltiplo e podem ter permissões refinadas. Por exemplo, você pode gerar um token com acesso somente leitura para o conteúdo de um repositório.
|
||||
If your server needs to access repositories across one or more organizations, you can use a GitHub App to define the access you need, and then generate _tightly-scoped_, _server-to-server_ tokens from that GitHub App. The server-to-server tokens can be scoped to single or multiple repositories, and can have fine-grained permissions. For example, you can generate a token with read-only access to a repository's contents.
|
||||
|
||||
Uma vez que os aplicativos GitHub são um ator de primeira classe em {% data variables.product.product_name %}, os tokens do servidor para servidor são dissociados de qualquer usuário do GitHub, o que os torna comparáveis aos "tokens de serviço". Além disso, tokens de servidor para servidor têm limites de taxa dedicados que escalam com o tamanho das organizações sobre as quais eles atuam. Para obter mais informações, confira [Limites de taxa dos {% data variables.product.prodname_github_apps %}](/developers/apps/rate-limits-for-github-apps).
|
||||
Since GitHub Apps are a first class actor on {% data variables.product.product_name %}, the server-to-server tokens are decoupled from any GitHub user, which makes them comparable to "service tokens". Additionally, server-to-server tokens have dedicated rate limits that scale with the size of the organizations that they act upon. For more information, see [Rate limits for {% data variables.product.prodname_github_apps %}](/developers/apps/rate-limits-for-github-apps).
|
||||
|
||||
#### Vantagens
|
||||
#### Pros
|
||||
|
||||
- Tokens com escopo limitado com conjuntos de permissões bem definidos e tempos de expiração (1 hora, ou menos se for revogado manualmente usando a API).
|
||||
- Limites de taxa dedicados que crescem com a sua organização.
|
||||
- Separados das identidades de usuários do GitHub para que não consumam nenhuma estação licenciada.
|
||||
- Nunca concedeu uma senha. Portanto, não pode efetuar o login diretamente.
|
||||
- Tightly-scoped tokens with well-defined permission sets and expiration times (1 hour, or less if revoked manually using the API).
|
||||
- Dedicated rate limits that grow with your organization.
|
||||
- Decoupled from GitHub user identities, so they do not consume any licensed seats.
|
||||
- Never granted a password, so cannot be directly signed in to.
|
||||
|
||||
#### Desvantagens
|
||||
#### Cons
|
||||
|
||||
- É necessária uma configuração adicional para criar o aplicativo GitHub.
|
||||
- Os tokens de servidor para servidor expiram após 1 hora. Portanto, precisam ser gerados novamente, geralmente sob demanda e usando código.
|
||||
- Additional setup is needed to create the GitHub App.
|
||||
- Server-to-server tokens expire after 1 hour, and so need to be re-generated, typically on-demand using code.
|
||||
|
||||
#### Configuração
|
||||
#### Setup
|
||||
|
||||
1. Determine se seu aplicativo GitHub deve ser público ou privado. Se o seu aplicativo GitHub agir apenas nos repositórios da organização, é provável que você queira que ele seja privado.
|
||||
1. Determine as permissões que o aplicativo GitHub exige, como acesso somente leitura ao conteúdo do repositório.
|
||||
1. Crie seu aplicativo GitHub por meio da página de configurações da sua organização. Para obter mais informações, confira [Como criar um Aplicativo do GitHub](/developers/apps/creating-a-github-app).
|
||||
1. Anote a `id` do Aplicativo do GitHub.
|
||||
1. Gere e faça o download da chave privada do seu aplicativo GitHub e armazene-a com segurança. Para obter mais informações, confira [Como gerar uma chave privada](/developers/apps/authenticating-with-github-apps#generating-a-private-key).
|
||||
1. Instale o aplicativo GitHub nos repositórios nos quais ele precisa agir. Opcionalmente você poderá instalar o aplicativo GitHub em todos os repositórios da sua organização.
|
||||
1. Identifique a `installation_id` que representa a conexão entre o Aplicativo do GitHub e os repositórios da organização que ele pode acessar. Cada par de Aplicativo do GitHub e de organização têm, no máximo, uma `installation_id`. Você pode identificar essa `installation_id` por meio de [Obter uma instalação da organização para o aplicativo autenticado](/rest/reference/apps#get-an-organization-installation-for-the-authenticated-app). Isso exige a autenticação como um Aplicativo do GitHub com um JWT. Para obter mais informações, confira [Autenticação como um Aplicativo do GitHub](/developers/apps/authenticating-with-github-apps#authenticating-as-a-github-app).
|
||||
1. Gere um token de servidor para servidor usando o ponto de extremidade da API REST correspondente: [Criar um token de acesso de instalação para um aplicativo](/rest/reference/apps#create-an-installation-access-token-for-an-app). Isso exige a autenticação como um Aplicativo do GitHub com um JWT. Para obter mais informações, confira [Autenticação como um Aplicativo do GitHub](/developers/apps/authenticating-with-github-apps#authenticating-as-a-github-app) e [Autenticação como uma instalação](/developers/apps/authenticating-with-github-apps#authenticating-as-an-installation).
|
||||
1. Use este token de servidor para servidor para interagir com seus repositórios, seja por meio das APIs REST ou GraphQL, ou por meio de um cliente Git.
|
||||
1. Determine if your GitHub App should be public or private. If your GitHub App will only act on repositories within your organization, you likely want it private.
|
||||
1. Determine the permissions your GitHub App requires, such as read-only access to repository contents.
|
||||
1. Create your GitHub App via your organization's settings page. For more information, see [Creating a GitHub App](/developers/apps/creating-a-github-app).
|
||||
1. Note your GitHub App `id`.
|
||||
1. Generate and download your GitHub App's private key, and store this safely. For more information, see [Generating a private key](/developers/apps/authenticating-with-github-apps#generating-a-private-key).
|
||||
1. Install your GitHub App on the repositories it needs to act upon, optionally you may install the GitHub App on all repositories in your organization.
|
||||
1. Identify the `installation_id` that represents the connection between your GitHub App and the organization repositories it can access. Each GitHub App and organization pair have at most a single `installation_id`. You can identify this `installation_id` via [Get an organization installation for the authenticated app](/rest/reference/apps#get-an-organization-installation-for-the-authenticated-app). This requires authenticating as a GitHub App using a JWT, for more information see [Authenticating as a GitHub App](/developers/apps/authenticating-with-github-apps#authenticating-as-a-github-app).
|
||||
1. Generate a server-to-server token using the corresponding REST API endpoint, [Create an installation access token for an app](/rest/reference/apps#create-an-installation-access-token-for-an-app). This requires authenticating as a GitHub App using a JWT, for more information see [Authenticating as a GitHub App](/developers/apps/authenticating-with-github-apps#authenticating-as-a-github-app), and [Authenticating as an installation](/developers/apps/authenticating-with-github-apps#authenticating-as-an-installation).
|
||||
1. Use this server-to-server token to interact with your repositories, either via the REST or GraphQL APIs, or via a Git client.
|
||||
|
||||
## Usuários máquina
|
||||
## Machine users
|
||||
|
||||
Se o servidor tiver de acessar vários repositórios, você poderá criar uma nova conta em {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} e anexar uma chave SSH que será usada exclusivamente para automatização. Como essa conta do {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} não será usada por uma pessoa, ela é chamada de _usuário de computador_. Você pode adicionar o usuário de computador como um [colaborador][collaborator] em um repositório pessoal (permitindo acesso de leitura e gravação), como um [colaborador externo][outside-collaborator] em um repositório da organização (permitindo acesso de leitura, gravação ou administrador) ou como uma [equipe][team] com acesso aos repositórios necessários para automação (concedendo as permissões da equipe).
|
||||
If your server needs to access multiple repositories, you can create a new account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} and attach an SSH key that will be used exclusively for automation. Since this account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} won't be used by a human, it's called a _machine user_. You can add the machine user as a [collaborator][collaborator] on a personal repository (granting read and write access), as an [outside collaborator][outside-collaborator] on an organization repository (granting read, write, or admin access), or to a [team][team] with access to the repositories it needs to automate (granting the permissions of the team).
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Dica:** nossos [termos de serviço][tos] indicam:
|
||||
**Tip:** Our [terms of service][tos] state:
|
||||
|
||||
> *Contas registradas por "bots" ou outros métodos automatizados não são permitidas.*
|
||||
> *Accounts registered by "bots" or other automated methods are not permitted.*
|
||||
|
||||
Isto significa que você não pode automatizar a criação de contas. Mas se você desejar criar um único usuário máquina para automatizar tarefas como scripts de implantação em seu projeto ou organização, isso é muito legal.
|
||||
This means that you cannot automate the creation of accounts. But if you want to create a single machine user for automating tasks such as deploy scripts in your project or organization, that is totally cool.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
#### Vantagens
|
||||
#### Pros
|
||||
|
||||
* Qualquer pessoa com acesso ao repositório e servidor é capaz de implantar o projeto.
|
||||
* Nenhum usuário (humano) precisa alterar suas configurações de SSH locais.
|
||||
* Não são necessárias várias chaves; o adequado é uma por servidor.
|
||||
* Anyone with access to the repository and server has the ability to deploy the project.
|
||||
* No (human) users need to change their local SSH settings.
|
||||
* Multiple keys are not needed; one per server is adequate.
|
||||
|
||||
#### Desvantagens
|
||||
#### Cons
|
||||
|
||||
* Apenas organizações podem restringir os usuários máquina para acesso somente leitura. Os repositórios pessoais sempre concedem aos colaboradores acesso de leitura/gravação.
|
||||
* Chaves dos usuário máquina, como chaves de implantação, geralmente não são protegidas por senha.
|
||||
* Only organizations can restrict machine users to read-only access. Personal repositories always grant collaborators read/write access.
|
||||
* Machine user keys, like deploy keys, are usually not protected by a passphrase.
|
||||
|
||||
#### Configuração
|
||||
#### Setup
|
||||
|
||||
1. [Execute o procedimento `ssh-keygen`][generating-ssh-keys] no servidor e anexe a chave pública à conta do usuário de computador.
|
||||
2. Dê acesso à conta de usuário máquina aos repositórios que deseja automatizar. Faça isso adicionando a conta como um [colaborador][collaborator], como um [colaborador externo][outside-collaborator] ou como uma [equipe][team] a uma organização.
|
||||
1. [Run the `ssh-keygen` procedure][generating-ssh-keys] on your server and attach the public key to the machine user account.
|
||||
2. Give the machine user account access to the repositories you want to automate. You can do this by adding the account as a [collaborator][collaborator], as an [outside collaborator][outside-collaborator], or to a [team][team] in an organization.
|
||||
|
||||
[ssh-agent-forwarding]: /guides/using-ssh-agent-forwarding/
|
||||
[generating-ssh-keys]: /articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#generating-a-new-ssh-key
|
||||
|
|
@ -192,5 +191,5 @@ Isto significa que você não pode automatizar a criação de contas. Mas se voc
|
|||
[outside-collaborator]: /articles/adding-outside-collaborators-to-repositories-in-your-organization
|
||||
[team]: /articles/adding-organization-members-to-a-team
|
||||
|
||||
## Leitura adicional
|
||||
- [Como configurar notificações](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#organization-alerts-notification-options)
|
||||
## Further reading
|
||||
- [Configuring notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#organization-alerts-notification-options)
|
||||
|
|
|
|||
|
|
@ -106,7 +106,7 @@ Activity related to a branch protection rule. For more information, see "[About
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with at least `read-only` access on repositories administration
|
||||
- {% data variables.product.prodname_github_apps %} with **Administration** repository permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -161,7 +161,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks only receive payloads for the `created` and `completed` event types in a repository
|
||||
- Organization webhooks only receive payloads for the `created` and `completed` event types in repositories
|
||||
- {% data variables.product.prodname_github_apps %} with the `checks:read` permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have the `checks:write` permission to receive the `rerequested` and `requested_action` event types. The `rerequested` and `requested_action` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with the `checks:write` are automatically subscribed to this webhook event.
|
||||
- {% data variables.product.prodname_github_apps %} with **Checks** read permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have **Checks** write permission to receive the `rerequested` and `requested_action` event types. The `rerequested` and `requested_action` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with **Checks** write permission are automatically subscribed to this webhook event.
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -185,7 +185,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks only receive payloads for the `completed` event types in a repository
|
||||
- Organization webhooks only receive payloads for the `completed` event types in repositories
|
||||
- {% data variables.product.prodname_github_apps %} with the `checks:read` permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have the `checks:write` permission to receive the `requested` and `rerequested` event types. The `requested` and `rerequested` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with the `checks:write` are automatically subscribed to this webhook event.
|
||||
- {% data variables.product.prodname_github_apps %} with **Checks** read permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have **Checks** write permission to receive the `requested` and `rerequested` event types. The `requested` and `rerequested` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with **Checks** write permission are automatically subscribed to this webhook event.
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -207,7 +207,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `security_events :read` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Code scanning alerts** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -229,7 +229,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -273,7 +273,7 @@ Webhook events are triggered based on the specificity of the domain you register
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -302,7 +302,7 @@ Webhook events are triggered based on the specificity of the domain you register
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -345,7 +345,7 @@ Webhook events are triggered based on the specificity of the domain you register
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `deployments` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Deployments** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -370,7 +370,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `deployments` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Deployments** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -401,7 +401,7 @@ Activity related to a discussion. For more information, see the "[Using the Grap
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `discussions` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Discussions** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -427,7 +427,7 @@ Activity related to a comment in a discussion. For more information, see "[Using
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `discussions` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Discussions** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -475,7 +475,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -518,7 +518,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -576,7 +576,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `issues` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Issues** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -599,7 +599,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `issues` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Issues** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -622,7 +622,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `metadata` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Metadata** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -673,7 +673,7 @@ For a detailed description of this payload and the payload for each type of `act
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `members` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Members** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -695,7 +695,7 @@ For a detailed description of this payload and the payload for each type of `act
|
|||
### Availability
|
||||
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `members` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Members** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -721,7 +721,7 @@ Activity related to merge groups in a merge queue. The type of activity is speci
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `merge_queues` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Merge queues** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -775,7 +775,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pull requests** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -798,7 +798,7 @@ Key | Type | Description
|
|||
{% ifversion ghes or ghae %}
|
||||
- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/).{% endif %}
|
||||
- Organization webhooks only receive the `deleted`, `added`, `removed`, `renamed`, and `invited` events
|
||||
- {% data variables.product.prodname_github_apps %} with the `members` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Members** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -824,7 +824,7 @@ Key | Type | Description
|
|||
### Availability
|
||||
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `organization_administration` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Administration** organization permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -870,7 +870,7 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pages` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pages** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -921,7 +921,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Projects** repository or organization permission
|
||||
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
|
@ -953,7 +953,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Projects** repository or organization permission
|
||||
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
|
@ -983,7 +983,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Projects** repository or organization permission
|
||||
|
||||
{% ifversion projects-v2 %}
|
||||
{% note %}
|
||||
|
|
@ -1020,7 +1020,7 @@ Activity related to items in a {% data variables.projects.project_v2 %}. {% data
|
|||
### Availability
|
||||
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `organization_projects` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Projects** organization permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1046,7 +1046,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `metadata` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Metadata** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1073,7 +1073,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pull requests** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1098,7 +1098,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pull requests** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1120,7 +1120,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pull requests** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1143,7 +1143,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Pull requests** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1171,7 +1171,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1215,7 +1215,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `contents` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1236,7 +1236,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends
|
|||
|
||||
### Availability
|
||||
|
||||
- {% data variables.product.prodname_github_apps %} must have the `contents` permission to receive this webhook.
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload example
|
||||
|
||||
|
|
@ -1250,7 +1250,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends
|
|||
|
||||
- Repository webhooks receive all event types except `deleted`
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `metadata` permission receive all event types except `deleted`
|
||||
- {% data variables.product.prodname_github_apps %} with **Metadata** permission receive all event types except `deleted`
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1319,7 +1319,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `secret_scanning_alerts:read` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Secret scanning alerts** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1343,7 +1343,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `secret_scanning_alerts:read` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Secret scanning alerts** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1366,7 +1366,7 @@ The security advisory dataset also powers the GitHub {% data variables.product.p
|
|||
|
||||
### Availability
|
||||
|
||||
- {% data variables.product.prodname_github_apps %} with the `security_events` permission
|
||||
- {% data variables.product.prodname_github_apps %}
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1391,7 +1391,7 @@ Activity related to enabling or disabling code security and analysis features fo
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with at least `read-only` access on repositories administration
|
||||
- {% data variables.product.prodname_github_apps %} with **Administration** repository permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1464,7 +1464,7 @@ You can only create a sponsorship webhook on {% data variables.product.prodname_
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `statuses` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Commit statuses** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1492,7 +1492,7 @@ Key | Type | Description
|
|||
### Availability
|
||||
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `members` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Members** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1523,7 +1523,7 @@ Key | Type | Description
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `members` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Members** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1564,7 +1564,7 @@ The event’s actor is the [user](/rest/reference/users) who starred a repositor
|
|||
|
||||
- Repository webhooks
|
||||
- Organization webhooks
|
||||
- {% data variables.product.prodname_github_apps %} with the `metadata` permission
|
||||
- {% data variables.product.prodname_github_apps %} with **Metadata** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1585,7 +1585,7 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS
|
|||
|
||||
### Availability
|
||||
|
||||
- {% data variables.product.prodname_github_apps %} must have the `contents` permission to receive this webhook.
|
||||
- {% data variables.product.prodname_github_apps %} with **Contents** permission
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
@ -1634,7 +1634,7 @@ When a {% data variables.product.prodname_actions %} workflow run is requested o
|
|||
|
||||
### Availability
|
||||
|
||||
- {% data variables.product.prodname_github_apps %} with the `actions` or `contents` permissions.
|
||||
- {% data variables.product.prodname_github_apps %} with **Actions** or **Contents** permissions
|
||||
|
||||
### Webhook payload object
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Extensões e integrações do GitHub
|
||||
intro: 'Use extensões {% data variables.product.product_name %} para trabalhar com facilidade nos repositórios {% data variables.product.product_name %} dentro de aplicativos de terceiros.'
|
||||
title: GitHub extensions and integrations
|
||||
intro: 'Use {% data variables.product.product_name %} extensions to work seamlessly in {% data variables.product.product_name %} repositories within third-party applications.'
|
||||
redirect_from:
|
||||
- /articles/about-github-extensions-for-third-party-applications
|
||||
- /articles/github-extensions-and-integrations
|
||||
|
|
@ -10,53 +10,43 @@ versions:
|
|||
fpt: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Extensions & integrations
|
||||
ms.openlocfilehash: f33ce9b9ae55e523bedff1309f3f2f15202dcf82
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147884210'
|
||||
---
|
||||
## Ferramentas de edição
|
||||
## Editor tools
|
||||
|
||||
Você pode conectar-se aos repositórios do {% data variables.product.product_name %} por meio de ferramentas de editores de terceiros, como o Atom, Unity e o {% data variables.product.prodname_vs %}.
|
||||
You can connect to {% data variables.product.product_name %} repositories within third-party editor tools such as Unity and {% data variables.product.prodname_vs %}.
|
||||
|
||||
### {% data variables.product.product_name %} para Atom
|
||||
### {% data variables.product.product_name %} for Unity
|
||||
|
||||
É possível fazer commits, push, pull, resolver conflitos de merge e mais no editor Atom, usando a extensão {% data variables.product.product_name %} para Atom. Para obter mais informações, confira o [site oficial do {% data variables.product.product_name %} para Atom](https://github.atom.io/).
|
||||
With the {% data variables.product.product_name %} for Unity editor extension, you can develop on Unity, the open source game development platform, and see your work on {% data variables.product.product_name %}. For more information, see the official Unity editor extension [site](https://unity.github.com/) or the [documentation](https://github.com/github-for-unity/Unity/tree/master/docs).
|
||||
|
||||
### {% data variables.product.product_name %} para Unity
|
||||
### {% data variables.product.product_name %} for {% data variables.product.prodname_vs %}
|
||||
|
||||
Você pode desenvolver em Unity, a plataforma de desenvolvimento de jogos de código aberto, e ver seu trabalho em {% data variables.product.product_name %}, usando a extensão de editor {% data variables.product.product_name %} para Unity. Para obter mais informações, confira o [site](https://unity.github.com/) ou a [documentação](https://github.com/github-for-unity/Unity/tree/master/docs) oficial da extensão do editor do Unity.
|
||||
With the {% data variables.product.product_name %} for {% data variables.product.prodname_vs %} extension, you can work in {% data variables.product.product_name %} repositories without leaving {% data variables.product.prodname_vs %}. For more information, see the official {% data variables.product.prodname_vs %} extension [site](https://visualstudio.github.com/) or [documentation](https://github.com/github/VisualStudio/tree/master/docs).
|
||||
|
||||
### {% data variables.product.product_name %} para {% data variables.product.prodname_vs %}
|
||||
### {% data variables.product.prodname_dotcom %} for {% data variables.product.prodname_vscode %}
|
||||
|
||||
Com o {% data variables.product.product_name %} para a extensão do {% data variables.product.prodname_vs %}, você pode trabalhar em repositórios do {% data variables.product.product_name %} sem sair do {% data variables.product.prodname_vs %}. Para obter mais informações, veja o [site](https://visualstudio.github.com/) ou a [documentação](https://github.com/github/VisualStudio/tree/master/docs) oficial do {% data variables.product.prodname_vs %}.
|
||||
With the {% data variables.product.prodname_dotcom %} for {% data variables.product.prodname_vscode %} extension, you can review and manage {% data variables.product.product_name %} pull requests in {% data variables.product.prodname_vscode_shortname %}. For more information, see the official {% data variables.product.prodname_vscode_shortname %} extension [site](https://vscode.github.com/) or [documentation](https://github.com/Microsoft/vscode-pull-request-github).
|
||||
|
||||
### {% data variables.product.prodname_dotcom %} para {% data variables.product.prodname_vscode %}
|
||||
## Project management tools
|
||||
|
||||
Com a extensão do {% data variables.product.prodname_dotcom %} para {% data variables.product.prodname_vscode %}, você pode revisar e gerenciar solicitações de pull do {% data variables.product.product_name %} no {% data variables.product.prodname_vscode_shortname %}. Para obter mais informações, veja o [site](https://vscode.github.com/) ou a [documentação](https://github.com/Microsoft/vscode-pull-request-github) oficial do {% data variables.product.prodname_vscode_shortname %}.
|
||||
You can integrate your personal or organization account on {% data variables.product.product_location %} with third-party project management tools, such as Jira.
|
||||
|
||||
## Ferramentas de gerenciamento de projetos
|
||||
### Jira Cloud and {% data variables.product.product_name %}.com integration
|
||||
|
||||
Você pode integrar a sua conta pessoal ou de organização no {% data variables.product.product_location %} com ferramentas de gerenciamento de projetos de terceiros, como o Jira.
|
||||
You can integrate Jira Cloud with your personal or organization account to scan commits and pull requests, creating relevant metadata and hyperlinks in any mentioned Jira issues. For more information, visit the [Jira integration app](https://github.com/marketplace/jira-software-github) in the marketplace.
|
||||
|
||||
### Integração Jira Cloud e {% data variables.product.product_name %}.com
|
||||
## Team communication tools
|
||||
|
||||
É possível integrar o Jira Cloud à sua conta pessoal ou de sua organização para analisar commits e pull requests e criar metadados e hyperlinks relevantes em qualquer problema mencionado no Jira. Para obter mais informações, acesse o [aplicativo de integração do Jira](https://github.com/marketplace/jira-software-github) no marketplace.
|
||||
You can integrate your personal or organization account on {% data variables.product.product_location %} with third-party team communication tools, such as Slack or Microsoft Teams.
|
||||
|
||||
## Ferramentas de comunicação de equipe
|
||||
### Slack and {% data variables.product.product_name %} integration
|
||||
|
||||
Você pode integrar sua conta pessoal ou de organização no {% data variables.product.product_location %} com ferramentas de comunicação de equipes de terceiros, como o Slack ou o Microsoft Teams.
|
||||
The Slack + {% data variables.product.prodname_dotcom %} app lets you subscribe to your repositories or organizations and get realtime updates about issues, pull requests, commits, discussions, releases, deployment reviews and deployment statuses. You can also perform activities like opening and closing issues, and you can see detailed references to issues and pull requests without leaving Slack. The app will also ping you personally in Slack if you are mentioned as part of any {% data variables.product.prodname_dotcom %} notifications that you receive in your channels or personal chats.
|
||||
|
||||
### Integração com Slack e {% data variables.product.product_name %}
|
||||
The Slack + {% data variables.product.prodname_dotcom %} app is also compatible with [Slack Enterprise Grid](https://slack.com/intl/en-in/help/articles/360000281563-Manage-apps-on-Enterprise-Grid). For more information, visit the [Slack + {% data variables.product.prodname_dotcom %} app](https://github.com/marketplace/slack-github) in the marketplace.
|
||||
|
||||
O aplicativo Slack + de {% data variables.product.prodname_dotcom %} permite que você assine seus repositórios ou organizações e obtenha atualizações em tempo real sobre problemas, pull requests, commits, discussões, versões, revisões de implantação e status da implantação. Você também pode executar atividades como abrir e fechar problemas, além de poder ver referências detalhadas para problemas e pull requests sem sair do Slack. O aplicativo também irá marcar você pessoalmente no Slack se você for mencionado como parte de quaisquer notificações de {% data variables.product.prodname_dotcom %} que você receber nos seus canais ou chats pessoais.
|
||||
### Microsoft Teams and {% data variables.product.product_name %} integration
|
||||
|
||||
O aplicativo Slack + {% data variables.product.prodname_dotcom %} também é compatível com o [Slack Enterprise Grid](https://slack.com/intl/en-in/help/articles/360000281563-Manage-apps-on-Enterprise-Grid). Para obter mais informações, acesse o [aplicativo Slack + {% data variables.product.prodname_dotcom %}](https://github.com/marketplace/slack-github) no marketplace.
|
||||
The {% data variables.product.prodname_dotcom %} for Teams app lets you subscribe to your repositories or organizations and get realtime updates about issues, pull requests, commits, discussions, releases, deployment reviews and deployment statuses. You can also perform activities like opening and closing issues, commenting on your issues and pull requests, and you can see detailed references to issues and pull requests without leaving Microsoft Teams. The app will also ping you personally in Teams if you are mentioned as part of any {% data variables.product.prodname_dotcom %} notifications that you receive in your channels or personal chats.
|
||||
|
||||
### Integração com o Microsoft Teams e {% data variables.product.product_name %}
|
||||
|
||||
O {% data variables.product.prodname_dotcom %} para o aplicativo Teams permite que você assine seus repositórios ou organizações e obtenha atualizações em tempo real sobre problemas, pull requests, commits, discussões, versões, revisões de implantação e status da implantação. Você também pode realizar atividades como abrir e fechar problemas, comentar nos seus problemase pull requests, e você pode ver referências detalhadas a problemas e pull requests sem sair do Microsoft Teams. O aplicativo também irá marcar você pessoalmente no Teams se você for mencionado como parte de quaisquer notificações de {% data variables.product.prodname_dotcom %} que você receber nos seus canais ou chats pessoais.
|
||||
|
||||
Para obter mais informações, acesse o [aplicativo {% data variables.product.prodname_dotcom %} para Teams](https://appsource.microsoft.com/en-us/product/office/WA200002077) no Microsoft AppSource.
|
||||
For more information, visit the [{% data variables.product.prodname_dotcom %} for Teams app](https://appsource.microsoft.com/en-us/product/office/WA200002077) in Microsoft AppSource.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Associar editores de texto ao Git
|
||||
intro: Use um editor de texto para abrir e editar seus arquivos com o Git.
|
||||
title: Associating text editors with Git
|
||||
intro: Use a text editor to open and edit your files with Git.
|
||||
redirect_from:
|
||||
- /textmate
|
||||
- /articles/using-textmate-as-your-default-editor
|
||||
|
|
@ -15,48 +15,33 @@ versions:
|
|||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Associate text editors
|
||||
ms.openlocfilehash: 0d02c32ff04d4a5a2a1003464175e866630603f4
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145148749'
|
||||
---
|
||||
{% mac %}
|
||||
|
||||
## Usar o Atom como seu editor
|
||||
## Using {% data variables.product.prodname_vscode %} as your editor
|
||||
|
||||
1. Instale o [Atom](https://atom.io/). Para obter mais informações, confira "[Como instalar o Atom](https://flight-manual.atom.io/getting-started/sections/installing-atom/)" na documentação do Atom.
|
||||
1. Install [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). For more information, see "[Setting up {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" in the {% data variables.product.prodname_vscode_shortname %} documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
```shell
|
||||
$ git config --global core.editor "atom --wait"
|
||||
```
|
||||
|
||||
## Usando o {% data variables.product.prodname_vscode %} como editor
|
||||
|
||||
1. Instale o [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). Para obter mais informações, confira "[Configurar o {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" na documentação do {% data variables.product.prodname_vscode_shortname %}.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "code --wait"
|
||||
```
|
||||
|
||||
## Usar o Sublime Text como seu editor
|
||||
## Using Sublime Text as your editor
|
||||
|
||||
1. Instale o [Sublime Text](https://www.sublimetext.com/). Para obter mais informações, confira "[Instalação](https://docs.sublimetext.io/guide/getting-started/installation.html)" na documentação do Sublime Text.
|
||||
1. Install [Sublime Text](https://www.sublimetext.com/). For more information, see "[Installation](https://docs.sublimetext.io/guide/getting-started/installation.html)" in the Sublime Text documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "subl -n -w"
|
||||
```
|
||||
|
||||
## Usar o TextMate como seu editor
|
||||
## Using TextMate as your editor
|
||||
|
||||
1. Instale o [TextMate](https://macromates.com/).
|
||||
2. Instale o utilitário de shell `mate` do TextMate. Para obter mais informações, confira "[`mate` e `rmate`](https://macromates.com/blog/2011/mate-and-rmate/)" na documentação do TextMate.
|
||||
1. Install [TextMate](https://macromates.com/).
|
||||
2. Install TextMate's `mate` shell utility. For more information, see "[`mate` and `rmate`](https://macromates.com/blog/2011/mate-and-rmate/)" in the TextMate documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
4. Digite este comando:
|
||||
4. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "mate -w"
|
||||
```
|
||||
|
|
@ -64,38 +49,29 @@ ms.locfileid: '145148749'
|
|||
|
||||
{% windows %}
|
||||
|
||||
## Usar o Atom como seu editor
|
||||
## Using {% data variables.product.prodname_vscode %} as your editor
|
||||
|
||||
1. Instale o [Atom](https://atom.io/). Para obter mais informações, confira "[Como instalar o Atom](https://flight-manual.atom.io/getting-started/sections/installing-atom/)" na documentação do Atom.
|
||||
1. Install [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). For more information, see "[Setting up {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" in the {% data variables.product.prodname_vscode_shortname %} documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
```shell
|
||||
$ git config --global core.editor "atom --wait"
|
||||
```
|
||||
|
||||
## Usando o {% data variables.product.prodname_vscode %} como editor
|
||||
|
||||
1. Instale o [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). Para obter mais informações, confira "[Configurar o {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" na documentação do {% data variables.product.prodname_vscode_shortname %}.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "code --wait"
|
||||
```
|
||||
|
||||
## Usar o Sublime Text como seu editor
|
||||
## Using Sublime Text as your editor
|
||||
|
||||
1. Instale o [Sublime Text](https://www.sublimetext.com/). Para obter mais informações, confira "[Instalação](https://docs.sublimetext.io/guide/getting-started/installation.html)" na documentação do Sublime Text.
|
||||
1. Install [Sublime Text](https://www.sublimetext.com/). For more information, see "[Installation](https://docs.sublimetext.io/guide/getting-started/installation.html)" in the Sublime Text documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "'C:/Program Files (x86)/sublime text 3/subl.exe' -w"
|
||||
```
|
||||
|
||||
## Usar o Notepad++ como seu editor
|
||||
## Using Notepad++ as your editor
|
||||
|
||||
1. Instale o Notepad++ por meio de https://notepad-plus-plus.org/. Para obter mais informações, confira "[Introdução](https://npp-user-manual.org/docs/getting-started/)" na documentação do Notepad++.
|
||||
1. Install Notepad++ from https://notepad-plus-plus.org/. For more information, see "[Getting started](https://npp-user-manual.org/docs/getting-started/)" in the Notepad++ documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "'C:/Program Files (x86)/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
|
||||
```
|
||||
|
|
@ -103,29 +79,20 @@ ms.locfileid: '145148749'
|
|||
|
||||
{% linux %}
|
||||
|
||||
## Usar o Atom como seu editor
|
||||
## Using {% data variables.product.prodname_vscode %} as your editor
|
||||
|
||||
1. Instale o [Atom](https://atom.io/). Para obter mais informações, confira "[Como instalar o Atom](https://flight-manual.atom.io/getting-started/sections/installing-atom/)" na documentação do Atom.
|
||||
1. Install [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). For more information, see "[Setting up {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" in the {% data variables.product.prodname_vscode_shortname %} documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
```shell
|
||||
$ git config --global core.editor "atom --wait"
|
||||
```
|
||||
|
||||
## Usando o {% data variables.product.prodname_vscode %} como editor
|
||||
|
||||
1. Instale o [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) ({% data variables.product.prodname_vscode_shortname %}). Para obter mais informações, confira "[Configurar o {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/Docs/setup/setup-overview)" na documentação do {% data variables.product.prodname_vscode_shortname %}.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "code --wait"
|
||||
```
|
||||
|
||||
## Usar o Sublime Text como seu editor
|
||||
## Using Sublime Text as your editor
|
||||
|
||||
1. Instale o [Sublime Text](https://www.sublimetext.com/). Para obter mais informações, confira "[Instalação](https://docs.sublimetext.io/guide/getting-started/installation.html)" na documentação do Sublime Text.
|
||||
1. Install [Sublime Text](https://www.sublimetext.com/). For more information, see "[Installation](https://docs.sublimetext.io/guide/getting-started/installation.html)" in the Sublime Text documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
3. Digite este comando:
|
||||
3. Type this command:
|
||||
```shell
|
||||
$ git config --global core.editor "subl -n -w"
|
||||
```
|
||||
|
|
|
|||
|
|
@ -32,6 +32,7 @@ featuredLinks:
|
|||
- /get-started/onboarding/getting-started-with-github-enterprise-cloud
|
||||
- /get-started/onboarding/getting-started-with-github-enterprise-server
|
||||
- /get-started/onboarding/getting-started-with-github-ae
|
||||
- /get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github
|
||||
popular:
|
||||
- /github/getting-started-with-github/signing-up-for-a-new-github-account
|
||||
- /get-started/quickstart/hello-world
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Comunicar-se no GitHub
|
||||
intro: 'Você pode discutir projetos e alterações específicas, bem como ideias mais amplas ou objetivos de equipe, usando diferentes tipos de discussões em {% data variables.product.product_name %}.'
|
||||
title: Communicating on GitHub
|
||||
intro: 'You can discuss specific projects and changes, as well as broader ideas or team goals, using different types of discussions on {% data variables.product.product_name %}.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /github/collaborating-with-issues-and-pull-requests/getting-started/quickstart-for-communicating-on-github
|
||||
|
|
@ -18,137 +18,137 @@ topics:
|
|||
- Issues
|
||||
- Discussions
|
||||
- Fundamentals
|
||||
ms.openlocfilehash: 6c7461a01cd0bc44bff93b1eb4e8a013d26bc147
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147408888'
|
||||
---
|
||||
## Introdução
|
||||
## Introduction
|
||||
|
||||
{% data variables.product.product_name %} fornece ferramentas de comunicação colaborativa embutidas que permitem que você interaja de perto com sua comunidade. Este guia de início rápido irá mostrar como escolher a ferramenta certa para suas necessidades.
|
||||
{% data variables.product.product_name %} provides built-in collaborative communication tools allowing you to interact closely with your community. This quickstart guide will show you how to pick the right tool for your needs.
|
||||
|
||||
{% ifversion discussions %} Você pode criar problemas, solicitações de pull, {% data variables.product.prodname_discussions %} e discussões em equipe e participar deles, dependendo do tipo de conversa que deseja ter.
|
||||
{% else %} Você pode criar e participar de problemas, pull requests e discussões de equipe, dependendo do tipo de conversa que você gostaria de ter.
|
||||
{% ifversion discussions %}
|
||||
You can create and participate in issues, pull requests, {% data variables.product.prodname_discussions %}, and team discussions, depending on the type of conversation you'd like to have.
|
||||
{% else %}
|
||||
You can create and participate in issues, pull requests and team discussions, depending on the type of conversation you'd like to have.
|
||||
{% endif %}
|
||||
|
||||
### {% data variables.product.prodname_github_issues %}
|
||||
- são úteis para discutir detalhes específicos de um projeto como relatórios de erros, melhorias e feedbacks planejados.
|
||||
- são específicos para um repositório e geralmente têm um proprietário claro.
|
||||
- muitas vezes são referidos como o sistema de rastreamento de erros de {% data variables.product.prodname_dotcom %}.
|
||||
- are useful for discussing specific details of a project such as bug reports, planned improvements and feedback.
|
||||
- are specific to a repository, and usually have a clear owner.
|
||||
- are often referred to as {% data variables.product.prodname_dotcom %}'s bug-tracking system.
|
||||
|
||||
### Solicitações de pull
|
||||
- permite que você proponha alterações específicas.
|
||||
- permite que comente diretamente as alterações propostas por outros.
|
||||
- são específicos para um repositório.
|
||||
### Pull requests
|
||||
- allow you to propose specific changes.
|
||||
- allow you to comment directly on proposed changes suggested by others.
|
||||
- are specific to a repository.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
### {% data variables.product.prodname_discussions %}
|
||||
- são como um fórum e são mais utilizados para ideias de forma aberta e discussões em que a colaboração é importante.
|
||||
- poderá incluir muitos repositórios.
|
||||
- oferecem uma experiência colaborativa fora da base de código, permitindo o debate de ideias e a criação de uma base de conhecimento comunitária.
|
||||
- frequentemente não têm um proprietário claro.
|
||||
- muitas vezes não resultam em uma tarefa exequível.
|
||||
- are like a forum, and are best used for open-form ideas and discussions where collaboration is important.
|
||||
- may span many repositories.
|
||||
- provide a collaborative experience outside the codebase, allowing the brainstorming of ideas, and the creation of a community knowledge base.
|
||||
- often don’t have a clear owner.
|
||||
- often do not result in an actionable task.
|
||||
{% endif %}
|
||||
|
||||
### Discussões em equipe
|
||||
- na página da sua equipe podem ser iniciadas para conversas que abrangem projetos e não pertencem a um problema específico ou pull request. Em vez de abrir uma issue em um repositório para discutir uma ideia, você pode incluir toda a equipe tendo uma conversa em uma discussão de equipe.
|
||||
- permitem que você realize discussões com sua equipe sobre planejamento, análise, design, pesquisa de usuário e tomada de decisão geral do projeto em um só lugar.{% ifversion ghes or ghae %}
|
||||
- oferecem uma experiência colaborativa fora do código, o que viabiliza o levantamento de hipóteses.
|
||||
- frequentemente não têm um proprietário claro.
|
||||
- muitas vezes não resultam em uma tarefa útil.{% endif %}
|
||||
### Team discussions
|
||||
- can be started on your team's page for conversations that span across projects and don't belong in a specific issue or pull request. Instead of opening an issue in a repository to discuss an idea, you can include the entire team by having a conversation in a team discussion.
|
||||
- allow you to hold discussions with your team about planning, analysis, design, user research and general project decision making in one place.{% ifversion ghes or ghae %}
|
||||
- provide a collaborative experience outside the codebase, allowing the brainstorming of ideas.
|
||||
- often don’t have a clear owner.
|
||||
- often do not result in an actionable task.{% endif %}
|
||||
|
||||
## Que ferramenta de discussão devo usar?
|
||||
## Which discussion tool should I use?
|
||||
|
||||
### Cenários para problemas
|
||||
### Scenarios for issues
|
||||
|
||||
- Quero acompanhar as tarefas, melhorias e erros.
|
||||
- Eu quero arquivar um relatório de erro.
|
||||
- Quero partilhar o feedback sobre um recurso específico.
|
||||
- Quero fazer uma pergunta sobre os arquivos do repositório.
|
||||
- I want to keep track of tasks, enhancements and bugs.
|
||||
- I want to file a bug report.
|
||||
- I want to share feedback about a specific feature.
|
||||
- I want to ask a question about files in the repository.
|
||||
|
||||
#### Exemplo de problema
|
||||
#### Issue example
|
||||
|
||||
Este exemplo ilustra como um usuário do {% data variables.product.prodname_dotcom %} criou um problema na nossa documentação de repositório de código aberto para chamar a nossa atenção para um erro e discutir uma correção.
|
||||
This example illustrates how a {% data variables.product.prodname_dotcom %} user created an issue in our documentation open source repository to make us aware of a bug, and discuss a fix.
|
||||
|
||||
|
||||
|
||||
|
||||
- Um usuário notou que a cor azul do banner na parte superior da página na versão em chinês da documentação do {% data variables.product.prodname_dotcom %} torna o texto no banner ilegível.
|
||||
- O usuário criou um problema no repositório, identificando o problema e sugerindo uma correção (que se trata de usar uma cor de fundo diferente para o banner).
|
||||
- Uma discussão se inicia e, eventualmente, será alcançado um consenso sobre a correção a ser aplicada.
|
||||
- Em seguida, um contribuidor pode criar um pull request com a correção.
|
||||
- A user noticed that the blue color of the banner at the top of the page in the Chinese version of the {% data variables.product.prodname_dotcom %} Docs makes the text in the banner unreadable.
|
||||
- The user created an issue in the repository, stating the problem and suggesting a fix (which is, use a different background color for the banner).
|
||||
- A discussion ensues, and eventually, a consensus will be reached about the fix to apply.
|
||||
- A contributor can then create a pull request with the fix.
|
||||
|
||||
### Cenários para pull requests
|
||||
### Scenarios for pull requests
|
||||
|
||||
- Eu quero corrigir um erro de digitação em um repositório.
|
||||
- Quero fazer alterações em um repositório.
|
||||
- Eu quero fazer alterações para consertar um problema.
|
||||
- Eu quero comentar as alterações sugeridas por outras pessoas.
|
||||
- I want to fix a typo in a repository.
|
||||
- I want to make changes to a repository.
|
||||
- I want to make changes to fix an issue.
|
||||
- I want to comment on changes suggested by others.
|
||||
|
||||
#### Exemplo de solicitação de pull
|
||||
#### Pull request example
|
||||
|
||||
Este exemplo ilustra como um usuário do {% data variables.product.prodname_dotcom %} criou um pull request na nossa documentação do repositório de código aberto para corrigir um erro de digitação.
|
||||
This example illustrates how a {% data variables.product.prodname_dotcom %} user created a pull request in our documentation open source repository to fix a typo.
|
||||
|
||||
Na guia **Conversa** da solicitação de pull, o autor explica o motivo da criação da solicitação de pull.
|
||||
In the **Conversation** tab of the pull request, the author explains why they created the pull request.
|
||||
|
||||
|
||||
|
||||
|
||||
A guia **Arquivos alterados** da solicitação de pull mostra a correção implementada.
|
||||
The **Files changed** tab of the pull request shows the implemented fix.
|
||||
|
||||
|
||||
|
||||
|
||||
- Este contribuidor observa um erro de digitação no repositório.
|
||||
- O usuário cria um pull request com a correção.
|
||||
- Um mantenedor do repositório revisa o pull request, comenta e faz merge nela.
|
||||
- This contributor notices a typo in the repository.
|
||||
- The user creates a pull request with the fix.
|
||||
- A repository maintainer reviews the pull request, comments on it, and merges it.
|
||||
|
||||
{% ifversion discussions %}
|
||||
### Cenários para {% data variables.product.prodname_discussions %}
|
||||
### Scenarios for {% data variables.product.prodname_discussions %}
|
||||
|
||||
- Tenho uma pergunta que não é necessariamente relacionada a arquivos específicos no repositório.
|
||||
- Eu quero compartilhar notícias com meus colaboradores ou com minha equipe.
|
||||
- Eu quero começar ou participar de uma conversa aberta.
|
||||
- Eu quero fazer um anúncio à minha comunidade.
|
||||
- I have a question that's not necessarily related to specific files in the repository.
|
||||
- I want to share news with my collaborators, or my team.
|
||||
- I want to start or participate in an open-ended conversation.
|
||||
- I want to make an announcement to my community.
|
||||
|
||||
#### Exemplo de {% data variables.product.prodname_discussions %}
|
||||
#### {% data variables.product.prodname_discussions %} example
|
||||
|
||||
Este exemplo mostra a postagem de boas-vindas de {% data variables.product.prodname_discussions %} para a documentação do repositório de código aberto {% data variables.product.prodname_dotcom %} e ilustra como a equipe quer colaborar com sua comunidade.
|
||||
This example shows the {% data variables.product.prodname_discussions %} welcome post for the {% data variables.product.prodname_dotcom %} Docs open source repository, and illustrates how the team wants to collaborate with their community.
|
||||
|
||||
|
||||
|
||||
|
||||
Este mantenedor da comunidade iniciou uma discussão para dar as boas-vindas à comunidade e pedir aos integrantes que se apresentem. Esta postagem promove uma atmosfera de acolhedora para visitantes e contribuidores. A postagem também esclarece que a equipe tem o prazer em ajudar com as contribuições para o repositório.
|
||||
This community maintainer started a discussion to welcome the community, and to ask members to introduce themselves. This post fosters an inviting atmosphere for visitors and contributors. The post also clarifies that the team's happy to help with contributions to the repository.
|
||||
|
||||
{% endif %}
|
||||
### Cenários para discussões em equipe
|
||||
### Scenarios for team discussions
|
||||
|
||||
- Tenho uma pergunta que não é necessariamente relacionada a arquivos específicos no repositório.
|
||||
- Eu quero compartilhar notícias com meus colaboradores ou com minha equipe.
|
||||
- Eu quero começar ou participar de uma conversa aberta.
|
||||
- Eu quero fazer um anúncio à minha equipe.
|
||||
- I have a question that's not necessarily related to specific files in the repository.
|
||||
- I want to share news with my collaborators, or my team.
|
||||
- I want to start or participate in an open-ended conversation.
|
||||
- I want to make an announcement to my team.
|
||||
|
||||
{% ifversion fpt or ghec %} Como você pode ver, as discussões em equipe são muito parecidas com o {% data variables.product.prodname_discussions %}. Para {% data variables.product.prodname_dotcom_the_website %}, recomendamos usar {% data variables.product.prodname_discussions %} como ponto de partida para conversas. Você pode usar {% data variables.product.prodname_discussions %} para colaborar com qualquer comunidade em {% data variables.product.prodname_dotcom %}. Se você faz parte de uma organização e gostaria de iniciar conversas dentro da sua organização ou equipe dentro dessa organização, você deverá usar discussões de equipe.
|
||||
{% ifversion fpt or ghec %}
|
||||
As you can see, team discussions are very similar to {% data variables.product.prodname_discussions %}. For {% data variables.product.prodname_dotcom_the_website %}, we recommend using {% data variables.product.prodname_discussions %} as the starting point for conversations. You can use {% data variables.product.prodname_discussions %} to collaborate with any community on {% data variables.product.prodname_dotcom %}. If you are part of an organization, and would like to initiate conversations within your organization or team within that organization, you should use team discussions.
|
||||
{% endif %}
|
||||
|
||||
#### Exemplo de discussão em equipe
|
||||
#### Team discussion example
|
||||
|
||||
Este exemplo mostra uma postagem da equipe para a equipe `octo-team`.
|
||||
This example shows a team post for the `octo-team` team.
|
||||
|
||||
|
||||
|
||||
|
||||
O membro da equipe `octocat` postou uma discussão em equipe, informando a equipe de várias coisas:
|
||||
- Um integrante da equipe denominado Mona iniciou eventos remotos de jogos.
|
||||
- Há uma postagem no blogue que descreve como as equipes usam {% data variables.product.prodname_actions %} para produzir sua documentação.
|
||||
- Material sobre a "All Hands" de Abril agora está disponível para ver todos os integrantes da equipe.
|
||||
The `octocat` team member posted a team discussion, informing the team of various things:
|
||||
- A team member called Mona started remote game events.
|
||||
- There is a blog post describing how the teams use {% data variables.product.prodname_actions %} to produce their docs.
|
||||
- Material about the April All Hands is now available for all team members to view.
|
||||
|
||||
## Próximas etapas
|
||||
## Next steps
|
||||
|
||||
Estes exemplos mostraram como decidir qual é a melhor ferramenta para suas conversas em {% data variables.product.product_name %}. Mas esse é apenas o começo; há muito mais que você pode fazer para adaptar essas ferramentas às suas necessidades.
|
||||
These examples showed you how to decide which is the best tool for your conversations on {% data variables.product.product_name %}. But this is only the beginning; there is so much more you can do to tailor these tools to your needs.
|
||||
|
||||
Para problemas, por exemplo, você pode marcar problemas com etiquetas para uma pesquisa mais rápida e criar modelos de problemas para ajudar os colaboradores a abrir problemas significativos. Para obter mais informações, confira "[Sobre os modelos de solicitações de pull](/github/managing-your-work-on-github/about-issues#working-with-issues)[ e de problemas](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)".
|
||||
For issues, for example, you can tag issues with labels for quicker searching and create issue templates to help contributors open meaningful issues. For more information, see "[About issues](/github/managing-your-work-on-github/about-issues#working-with-issues)" and "[About issue and pull request templates](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)."
|
||||
|
||||
Para pull requests, você pode criar pull requests de rascunho se as suas alterações propostas ainda forem um trabalho em andamento. Não é possível fazer o merge dos pull requests de rascunho até que estejam prontos para revisão. Para obter mais informações, confira "[Sobre as solicitações de pull](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)".
|
||||
For pull requests, you can create draft pull requests if your proposed changes are still a work in progress. Draft pull requests cannot be merged until they're marked as ready for review. For more information, see "[About pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)."
|
||||
|
||||
{% ifversion discussions %} Para o {% data variables.product.prodname_discussions %}, você pode {% ifversion fpt or ghec %} configurar um código de conduta e{% endif %} fixar discuessões que contêm informações importantes para sua comunidade. Para obter mais informações, confira "[Sobre as discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)".
|
||||
{% ifversion discussions %}
|
||||
For {% data variables.product.prodname_discussions %}, you can{% ifversion fpt or ghec %} set up a code of conduct and{% endif %} pin discussions that contain important information for your community. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)."
|
||||
{% endif %}
|
||||
|
||||
Para discussões em equipe, você pode editar ou excluir discussões na página de uma equipe, além de poder configurar notificações para discussões em equipe. Para obter mais informações, confira "[Sobre as discussões em equipe](/organizations/collaborating-with-your-team/about-team-discussions)".
|
||||
For team discussions, you can edit or delete discussions on a team's page, and you can configure notifications for team discussions. For more information, see "[About team discussions](/organizations/collaborating-with-your-team/about-team-discussions)."
|
||||
|
||||
To learn some advanced formatting features that will help you communicate, see "[Quickstart for writing on {% data variables.product.prodname_dotcom %}](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)."
|
||||
|
|
@ -1,12 +1,12 @@
|
|||
---
|
||||
title: Recursos de aprendizagem Git e GitHub
|
||||
title: Git and GitHub learning resources
|
||||
redirect_from:
|
||||
- /articles/good-resources-for-learning-git-and-github
|
||||
- /articles/what-are-other-good-resources-for-learning-git-and-github
|
||||
- /articles/git-and-github-learning-resources
|
||||
- /github/getting-started-with-github/git-and-github-learning-resources
|
||||
- /github/getting-started-with-github/quickstart/git-and-github-learning-resources
|
||||
intro: 'Existem muitos recursos Git e {% data variables.product.product_name %} na Web. Essa é uma lista de nossos preferidos!'
|
||||
intro: 'There are a lot of helpful Git and {% data variables.product.product_name %} resources on the web. This is a short list of our favorites!'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
|
|
@ -15,55 +15,49 @@ versions:
|
|||
authors:
|
||||
- GitHub
|
||||
shortTitle: Learning resources
|
||||
ms.openlocfilehash: d8d0457de2842392febee0c90660285e9b1afef8
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '146139293'
|
||||
---
|
||||
## Usar o Git
|
||||
## Using Git
|
||||
|
||||
Familiarize-se com o Git acessando o [site oficial do projeto Git](https://git-scm.com) e lendo o [livro ProGit](http://git-scm.com/book). Você também pode revisar a [Lista de comandos do Git](https://git-scm.com/docs).
|
||||
Familiarize yourself with Git by visiting the [official Git project site](https://git-scm.com) and reading the [ProGit book](http://git-scm.com/book). You can also review the [Git command list](https://git-scm.com/docs).
|
||||
|
||||
## Usar {% data variables.product.product_name %}
|
||||
## Using {% data variables.product.product_name %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
O {% data variables.product.prodname_learning %} oferece cursos interativos grátis que são desenvolvidos em {% data variables.product.prodname_dotcom %} e possuem ajuda e respostas automáticas e instantâneas. Aprenda a abrir sua primeira pull request, fazer sua primeira contribuição a um código aberto, criar um site {% data variables.product.prodname_pages %} e muito mais. Para obter mais informações sobre as ofertas de cursos, confira [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}).
|
||||
{% data variables.product.prodname_learning %} offers free interactive courses that are built into {% data variables.product.prodname_dotcom %} with instant automated feedback and help. Learn to open your first pull request, make your first open source contribution, create a {% data variables.product.prodname_pages %} site, and more. For more information about course offerings, see [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}).
|
||||
|
||||
{% endif %}
|
||||
|
||||
Familiarize-se melhor com o {% data variables.product.product_name %} por meio de nossos artigos de [introdução](/categories/getting-started-with-github/). Confira nosso [fluxo do {% data variables.product.prodname_dotcom %}](https://guides.github.com/introduction/flow) para ver uma introdução ao processo. Veja nossos [guias de visão geral](https://guides.github.com) para aprender conceitos básicos.
|
||||
Become better acquainted with {% data variables.product.product_name %} through our [getting started](/categories/getting-started-with-github/) articles. See our [{% data variables.product.prodname_dotcom %} flow](https://guides.github.com/introduction/flow) for a process introduction. Refer to our [overview guides](https://guides.github.com) to walk through basic concepts.
|
||||
|
||||
{% data reusables.support.ask-and-answer-forum %}
|
||||
|
||||
### Branches, bifurcações e pull requests
|
||||
### Branches, forks, and pull requests
|
||||
|
||||
Saiba mais sobre a [ramificação do Git](http://learngitbranching.js.org/) usando uma ferramenta interativa. Leia mais sobre [forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) e [solicitações de pull](/articles/using-pull-requests) e descubra [como usamos as solicitações de pull](https://github.com/blog/1124-how-we-use-pull-requests-to-build-github) no {% data variables.product.prodname_dotcom %}. Acesse as referências sobre como usar o {% data variables.product.prodname_dotcom %} na [linha de comando](https://cli.github.com/).
|
||||
Learn about [Git branching](http://learngitbranching.js.org/) using an interactive tool. Read about [forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) and [pull requests](/articles/using-pull-requests) as well as [how we use pull requests](https://github.com/blog/1124-how-we-use-pull-requests-to-build-github) at {% data variables.product.prodname_dotcom %}. Access references about using {% data variables.product.prodname_dotcom %} from the [command line](https://cli.github.com/).
|
||||
|
||||
### Fique antenado
|
||||
### Tune in
|
||||
|
||||
Nosso [canal de Treinamento e Guias no YouTube](https://youtube.com/githubguides) do {% data variables.product.prodname_dotcom %} oferece tutoriais sobre [solicitações de pull](https://www.youtube.com/watch?v=d5wpJ5VimSU&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=19), [criação de forks](https://www.youtube.com/watch?v=5oJHRbqEofs), [troca de base](https://www.youtube.com/watch?v=SxzjZtJwOgo&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=22) e funções de [redefinição](https://www.youtube.com/watch?v=BKPjPMVB81g). Cada tema é abordado em cinco minutos ou menos.
|
||||
Our {% data variables.product.prodname_dotcom %} [YouTube Training and Guides channel](https://youtube.com/githubguides) offers tutorials about [pull requests](https://www.youtube.com/watch?v=d5wpJ5VimSU&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=19), [forking](https://www.youtube.com/watch?v=5oJHRbqEofs), [rebase](https://www.youtube.com/watch?v=SxzjZtJwOgo&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=22), and [reset](https://www.youtube.com/watch?v=BKPjPMVB81g) functions. Each topic is covered in 5 minutes or less.
|
||||
|
||||
## Treinamento
|
||||
## Training
|
||||
|
||||
### Cursos grátis
|
||||
### Free courses
|
||||
|
||||
O {% data variables.product.product_name %} oferece uma série de [cursos de treinamento interativos sob demanda](https://skills.github.com/), incluindo [Introdução ao {% data variables.product.prodname_dotcom %}](https://github.com/skills/introduction-to-github) e cursos sobre ferramentas específicas do {% data variables.product.product_name %}, como o {% data variables.product.prodname_actions %}.
|
||||
{% data variables.product.product_name %} offers a series of interactive, [on-demand training courses](https://skills.github.com/) including [Introduction to {% data variables.product.prodname_dotcom %}](https://github.com/skills/introduction-to-github); and courses on {% data variables.product.product_name %} specific tools such as {% data variables.product.prodname_actions %}.
|
||||
|
||||
### Programas educacionais online do {% data variables.product.prodname_dotcom %}
|
||||
### {% data variables.product.prodname_dotcom %}'s web-based educational programs
|
||||
|
||||
O {% data variables.product.prodname_dotcom %} oferece [treinamentos](https://services.github.com/#upcoming-events) online com uma abordagem prática baseada em projeto tanto para aqueles que adoram a linha de comando quanto para aqueles que não gostam dela.
|
||||
{% data variables.product.prodname_dotcom %} offers live [trainings](https://services.github.com/#upcoming-events) with a hands-on, project-based approach for those who love the command line and those who don't.
|
||||
|
||||
### Treinamentos para sua empresa
|
||||
### Training for your company
|
||||
|
||||
O {% data variables.product.prodname_dotcom %} oferece [aulas presenciais](https://services.github.com/#offerings) ministradas por nossos educadores altamente experientes. [Fale conosco](https://services.github.com/#contact) para fazer perguntas relacionadas ao treinamento.
|
||||
{% data variables.product.prodname_dotcom %} offers [in-person classes](https://services.github.com/#offerings) taught by our highly-experienced educators. [Contact us](https://services.github.com/#contact) to ask your training-related questions.
|
||||
|
||||
## Extras
|
||||
|
||||
Um [curso interativo do Git online](https://www.pluralsight.com/courses/code-school-git-real) do [Pluralsight](https://www.pluralsight.com/codeschool) traz sete níveis com dezenas de exercícios em um formato de jogo divertido. Fique à vontade para adaptar nossos [modelos .gitignore](https://github.com/github/gitignore) de acordo com suas necessidades.
|
||||
An interactive [online Git course](https://www.pluralsight.com/courses/code-school-git-real) from [Pluralsight](https://www.pluralsight.com/codeschool) has seven levels with dozens of exercises in a fun game format. Feel free to adapt our [.gitignore templates](https://github.com/github/gitignore) to meet your needs.
|
||||
|
||||
Estenda o alcance do {% data variables.product.prodname_dotcom %} por meio de {% ifversion fpt or ghec %}[integrações](/articles/about-integrations){% else %}integrações{% endif %} ou instalando o [{% data variables.product.prodname_desktop %}](https://desktop.github.com) e o robusto editor de texto [Atom](https://atom.io).
|
||||
Extend your {% data variables.product.prodname_dotcom %} reach through {% ifversion fpt or ghec %}[integrations](/articles/about-integrations){% else %}integrations{% endif %}, or by installing [{% data variables.product.prodname_desktop %}](https://desktop.github.com) and the robust [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) text editor.
|
||||
|
||||
Saiba como iniciar e expandir seu projeto de código aberto com os [Guias de Código Aberto](https://opensource.guide/).
|
||||
Learn how to launch and grow your open source project with the [Open Source Guides](https://opensource.guide/).
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Sobre gravação e formatação no GitHub
|
||||
intro: O GitHub combina uma sintaxe para formatar texto chamada markdown em estilo GitHub com alguns recursos de escrita exclusivos.
|
||||
title: About writing and formatting on GitHub
|
||||
intro: GitHub combines a syntax for formatting text called GitHub Flavored Markdown with a few unique writing features.
|
||||
redirect_from:
|
||||
- /articles/about-writing-and-formatting-on-github
|
||||
- /github/writing-on-github/about-writing-and-formatting-on-github
|
||||
|
|
@ -10,40 +10,36 @@ versions:
|
|||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Write & format on GitHub
|
||||
ms.openlocfilehash: 7819ebc6bbf3ffa8696c87f82745a19c103c8134
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147860831'
|
||||
shortTitle: About writing & formatting
|
||||
---
|
||||
[Markdown](http://daringfireball.net/projects/markdown/) é uma sintaxe fácil de ler e de gravar para formatar textos sem formatação.
|
||||
[Markdown](http://daringfireball.net/projects/markdown/) is an easy-to-read, easy-to-write syntax for formatting plain text.
|
||||
|
||||
Adicionamos algumas funcionalidades personalizadas para criar o markdown em estilo {% data variables.product.prodname_dotcom %}, usadas para formatar prosa e código em nosso site.
|
||||
We've added some custom functionality to create {% data variables.product.prodname_dotcom %} Flavored Markdown, used to format prose and code across our site.
|
||||
|
||||
Você também pode interagir com outros usuários em solicitações de pull e problemas usando recursos como [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams), [referências de problemas e de RP](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests) e [emojis](/articles/basic-writing-and-formatting-syntax/#using-emoji).
|
||||
You can also interact with other users in pull requests and issues using features like [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams), [issue and PR references](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests), and [emoji](/articles/basic-writing-and-formatting-syntax/#using-emoji).
|
||||
|
||||
## Barra de ferramentas de formatação de texto
|
||||
## Text formatting toolbar
|
||||
|
||||
Cada campo de comentário no {% data variables.product.product_name %} contém uma barra de ferramentas de formatação de texto, permitindo que você formate texto sem precisar aprender a sintaxe markdown. Além da formatação Markdown, como estilos em negrito e itálico e criação de cabeçalhos, links e listas, a barra de ferramentas inclui recursos específicos do {% data variables.product.product_name %}, como @mentions, listas de tarefas e links para problemas e solicitações de pull.
|
||||
Every comment field on {% data variables.product.product_name %} contains a text formatting toolbar, allowing you to format your text without learning Markdown syntax. In addition to Markdown formatting like bold and italic styles and creating headers, links, and lists, the toolbar includes {% data variables.product.product_name %}-specific features such as @mentions, task lists, and links to issues and pull requests.
|
||||
|
||||
{% ifversion fixed-width-font-gfm-fields %}
|
||||
|
||||
## Habilitando fontes de largura fixa no editor
|
||||
## Enabling fixed-width fonts in the editor
|
||||
|
||||
Você pode habilitar uma fonte de largura fixa em cada campo de comentário em {% data variables.product.product_name %}. Cada caractere em uma largura fixa, ou em monoespaço, a fonte ocupa o mesmo espaço horizontal que pode facilitar a edição de estruturas avançadas de Markdown, como tabelas e trechos de código.
|
||||
You can enable a fixed-width font in every comment field on {% data variables.product.product_name %}. Each character in a fixed-width, or monospace, font occupies the same horizontal space which can make it easier to edit advanced Markdown structures such as tables and code snippets.
|
||||
|
||||
|
||||
|
||||
|
||||
{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.appearance-settings %}
|
||||
1. Em "Preferência de fonte do editor Markdown", selecione **Usar uma fonte de largura fixa (com espaçamento uniforme) ao editar Markdown**.
|
||||
|
||||
{% data reusables.user-settings.access_settings %}
|
||||
{% data reusables.user-settings.appearance-settings %}
|
||||
1. Under "Markdown editor font preference", select **Use a fixed-width (monospace) font when editing Markdown**.
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Leitura adicional
|
||||
## Further reading
|
||||
|
||||
- [Especificações do {% data variables.product.prodname_dotcom %} Flavored Markdown](https://github.github.com/gfm/)
|
||||
- "[Sintaxe básica de escrita e formatação](/articles/basic-writing-and-formatting-syntax)"
|
||||
- "[Como trabalhar com formatação avançada](/articles/working-with-advanced-formatting)"
|
||||
- [{% data variables.product.prodname_dotcom %} Flavored Markdown Spec](https://github.github.com/gfm/)
|
||||
- "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)"
|
||||
- "[Working with advanced formatting](/articles/working-with-advanced-formatting)"
|
||||
- "[Quickstart for writing on {% data variables.product.prodname_dotcom %}](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)"
|
||||
|
|
|
|||
|
|
@ -179,13 +179,7 @@ You can specify the theme an image is displayed for in Markdown by using the HTM
|
|||
|
||||
For example, the following code displays a sun image for light themes and a moon for dark themes:
|
||||
|
||||
```HTML
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/25423296/163456776-7f95b81a-f1ed-45f7-b7ab-8fa810d529fa.png">
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
|
||||
<img alt="Shows an illustrated sun in light color mode and a moon with stars in dark color mode." src="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
|
||||
</picture>
|
||||
```
|
||||
{% data reusables.getting-started.picture-element-example %}
|
||||
|
||||
The old method of specifying images based on the theme, by using a fragment appended to the URL (`#gh-dark-mode-only` or `#gh-light-mode-only`), is deprecated and will be removed in favor of the new method described above.
|
||||
{% endif %}
|
||||
|
|
@ -216,7 +210,7 @@ To order your list, precede each line with a number.
|
|||
|
||||
You can create a nested list by indenting one or more list items below another item.
|
||||
|
||||
To create a nested list using the web editor on {% data variables.product.product_name %} or a text editor that uses a monospaced font, like [Atom](https://atom.io/), you can align your list visually. Type space characters in front of your nested list item, until the list marker character (<kbd>-</kbd> or <kbd>*</kbd>) lies directly below the first character of the text in the item above it.
|
||||
To create a nested list using the web editor on {% data variables.product.product_name %} or a text editor that uses a monospaced font, like [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/), you can align your list visually. Type space characters in front of your nested list item, until the list marker character (<kbd>-</kbd> or <kbd>*</kbd>) lies directly below the first character of the text in the item above it.
|
||||
|
||||
```markdown
|
||||
1. First list item
|
||||
|
|
@ -394,3 +388,4 @@ For more information, see Daring Fireball's "[Markdown Syntax](https://daringfir
|
|||
- [{% data variables.product.prodname_dotcom %} Flavored Markdown Spec](https://github.github.com/gfm/)
|
||||
- "[About writing and formatting on GitHub](/articles/about-writing-and-formatting-on-github)"
|
||||
- "[Working with advanced formatting](/articles/working-with-advanced-formatting)"
|
||||
- "[Quickstart for writing on {% data variables.product.prodname_dotcom %}](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)"
|
||||
|
|
|
|||
|
|
@ -12,6 +12,7 @@ versions:
|
|||
ghae: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /quickstart-for-writing-on-github
|
||||
- /about-writing-and-formatting-on-github
|
||||
- /basic-writing-and-formatting-syntax
|
||||
shortTitle: Start writing on GitHub
|
||||
|
|
|
|||
|
|
@ -70,8 +70,8 @@ You can find the node ID of an organization project if you know the organization
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"query{organization(login: \"<em>ORGANIZATION</em>\") {projectV2(number: <em>NUMBER</em>){id}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"query{organization(login: \"ORGANIZATION\") {projectV2(number: NUMBER){id}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -79,8 +79,8 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
organization(login: "<em>ORGANIZATION</em>"){
|
||||
projectV2(number: <em>NUMBER</em>) {
|
||||
organization(login: "ORGANIZATION"){
|
||||
projectV2(number: NUMBER) {
|
||||
id
|
||||
}
|
||||
}
|
||||
|
|
@ -94,8 +94,8 @@ You can also find the node ID of all projects in your organization. The followin
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"{organization(login: \"<em>ORGANIZATION</em>\") {projectsV2(first: 20) {nodes {id title}}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"{organization(login: \"ORGANIZATION") {projectsV2(first: 20) {nodes {id title}}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -103,7 +103,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
organization(login: "<em>ORGANIZATION</em>") {
|
||||
organization(login: "ORGANIZATION") {
|
||||
projectsV2(first: 20) {
|
||||
nodes {
|
||||
id
|
||||
|
|
@ -125,8 +125,8 @@ You can find the node ID of a user project if you know the project number. Repla
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"query{user(login: \"<em>USER</em>\") {projectV2(number: <em>NUMBER</em>){id}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"query{user(login: \"USER\") {projectV2(number: NUMBER){id}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -134,8 +134,8 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
user(login: "<em>USER</em>"){
|
||||
projectV2(number: <em>NUMBER</em>) {
|
||||
user(login: "USER"){
|
||||
projectV2(number: NUMBER) {
|
||||
id
|
||||
}
|
||||
}
|
||||
|
|
@ -149,8 +149,8 @@ You can also find the node ID for all of your projects. The following example wi
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"{user(login: \"<em>USER</em>\") {projectsV2(first: 20) {nodes {id title}}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"{user(login: \"USER\") {projectsV2(first: 20) {nodes {id title}}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -158,7 +158,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
user(login: "<em>USER</em>") {
|
||||
user(login: "USER") {
|
||||
projectsV2(first: 20) {
|
||||
nodes {
|
||||
id
|
||||
|
|
@ -180,8 +180,8 @@ The following example will return the ID, name, settings, and configuration for
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"query{ node(id: \"<em>PROJECT_ID</em>\") { ... on ProjectV2 { fields(first: 20) { nodes { ... on ProjectV2Field { id name } ... on ProjectV2IterationField { id name configuration { iterations { startDate id }}} ... on ProjectV2SingleSelectField { id name options { id name }}}}}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"query{ node(id: \"PROJECT_ID\") { ... on ProjectV2 { fields(first: 20) { nodes { ... on ProjectV2Field { id name } ... on ProjectV2IterationField { id name configuration { iterations { startDate id }}} ... on ProjectV2SingleSelectField { id name options { id name }}}}}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -189,7 +189,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
node(id: "<em>PROJECT_ID</em>") {
|
||||
node(id: "PROJECT_ID") {
|
||||
... on ProjectV2 {
|
||||
fields(first: 20) {
|
||||
nodes {
|
||||
|
|
@ -284,8 +284,8 @@ If you just need the name and ID of a field, and do not need information about i
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"query{ node(id: \"<em>PROJECT_ID</em>\") { ... on ProjectV2 { fields(first: 20) { nodes { ... on ProjectV2FieldCommon { id name }}}}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"query{ node(id: \"PROJECT_ID\") { ... on ProjectV2 { fields(first: 20) { nodes { ... on ProjectV2FieldCommon { id name }}}}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -293,7 +293,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
node(id: "<em>PROJECT_ID</em>") {
|
||||
node(id: "PROJECT_ID") {
|
||||
... on ProjectV2 {
|
||||
fields(first: 20) {
|
||||
nodes {
|
||||
|
|
@ -354,8 +354,8 @@ The following example will return the first 20 issues, pull requests, and draft
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"query{ node(id: \"<em>PROJECT_ID</em>\") { ... on ProjectV2 { items(first: 20) { nodes{ id fieldValues(first: 8) { nodes{ ... on ProjectV2ItemFieldTextValue { text field { ... on ProjectV2FieldCommon { name }}} ... on ProjectV2ItemFieldDateValue { date field { ... on ProjectV2FieldCommon { name } } } ... on ProjectV2ItemFieldSingleSelectValue { name field { ... on ProjectV2FieldCommon { name }}}}} content{ ... on DraftIssue { title body } ...on Issue { title assignees(first: 10) { nodes{ login }}} ...on PullRequest { title assignees(first: 10) { nodes{ login }}}}}}}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"query{ node(id: \"PROJECT_ID\") { ... on ProjectV2 { items(first: 20) { nodes{ id fieldValues(first: 8) { nodes{ ... on ProjectV2ItemFieldTextValue { text field { ... on ProjectV2FieldCommon { name }}} ... on ProjectV2ItemFieldDateValue { date field { ... on ProjectV2FieldCommon { name } } } ... on ProjectV2ItemFieldSingleSelectValue { name field { ... on ProjectV2FieldCommon { name }}}}} content{ ... on DraftIssue { title body } ...on Issue { title assignees(first: 10) { nodes{ login }}} ...on PullRequest { title assignees(first: 10) { nodes{ login }}}}}}}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -363,7 +363,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
query{
|
||||
node(id: "<em>PROJECT_ID</em>") {
|
||||
node(id: "PROJECT_ID") {
|
||||
... on ProjectV2 {
|
||||
items(first: 20) {
|
||||
nodes{
|
||||
|
|
@ -446,8 +446,8 @@ The following example will add an issue or pull request to your project. Replace
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {addProjectV2ItemById(input: {projectId: \"<em>PROJECT_ID</em>\" contentId: \"<em>CONTENT_ID</em>\"}) {item {id}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {addProjectV2ItemById(input: {projectId: \"PROJECT_ID\" contentId: \"CONTENT_ID\"}) {item {id}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -455,7 +455,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
mutation {
|
||||
addProjectV2ItemById(input: {projectId: "<em>PROJECT_ID</em>" contentId: "<em>CONTENT_ID</em>"}) {
|
||||
addProjectV2ItemById(input: {projectId: "PROJECT_ID" contentId: "CONTENT_ID"}) {
|
||||
item {
|
||||
id
|
||||
}
|
||||
|
|
@ -488,8 +488,8 @@ The following example will add a draft issue to your project. Replace `PROJECT_I
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {addProjectV2DraftIssue(input: {projectId: "<em>PROJECT_ID</em>" title: "<em>TITLE</em>" body: "<em>BODY</em>"}) {projectItem {id}}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {addProjectV2DraftIssue(input: {projectId: "PROJECT_ID" title: "TITLE" body: "BODY"}) {projectItem {id}}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -497,7 +497,7 @@ curl --request POST \
|
|||
```shell
|
||||
gh api graphql -f query='
|
||||
mutation {
|
||||
addProjectV2DraftIssue(input: {projectId: "<em>PROJECT_ID</em>" title: "<em>TITLE</em>" body: "<em>BODY</em>"}) {
|
||||
addProjectV2DraftIssue(input: {projectId: "PROJECT_ID" title: "TITLE" body: "BODY"}) {
|
||||
projectItem {
|
||||
id
|
||||
}
|
||||
|
|
@ -528,8 +528,8 @@ The following example will update your project's settings. Replace `PROJECT_ID`
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation { updateProjectV2(input: { projectId: \"<em>PROJECT_ID</em>\", title: \"Project title\", public: false, readme: \"# Project README\n\nA long description\", shortDescription: \"A short description\"}) { projectV2 { id, title, readme, shortDescription }}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation { updateProjectV2(input: { projectId: \"PROJECT_ID\", title: \"Project title\", public: false, readme: \"# Project README\n\nA long description\", shortDescription: \"A short description\"}) { projectV2 { id, title, readme, shortDescription }}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -539,7 +539,7 @@ gh api graphql -f query='
|
|||
mutation {
|
||||
updateProjectV2(
|
||||
input: {
|
||||
projectId: "<em>PROJECT_ID</em>",
|
||||
projectId: "PROJECT_ID",
|
||||
title: "Project title",
|
||||
public: false,
|
||||
readme: "# Project README\n\nA long description",
|
||||
|
|
@ -565,8 +565,8 @@ The following example will update the value of a text field for an item. Replace
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "<em>PROJECT_ID</em>" itemId: "<em>ITEM_ID</em>" fieldId: "<em>FIELD_ID</em>" value: { text: "Updated text" }}) { projectV2Item { id }}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "PROJECT_ID" itemId: "ITEM_ID" fieldId: "FIELD_ID" value: { text: "Updated text" }}) { projectV2Item { id }}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -576,9 +576,9 @@ gh api graphql -f query='
|
|||
mutation {
|
||||
updateProjectV2ItemFieldValue(
|
||||
input: {
|
||||
projectId: "<em>PROJECT_ID</em>"
|
||||
itemId: "<em>ITEM_ID</em>"
|
||||
fieldId: "<em>FIELD_ID</em>"
|
||||
projectId: "PROJECT_ID"
|
||||
itemId: "ITEM_ID"
|
||||
fieldId: "FIELD_ID"
|
||||
value: {
|
||||
text: "Updated text"
|
||||
}
|
||||
|
|
@ -619,8 +619,8 @@ The following example will update the value of a single select field for an item
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "<em>PROJECT_ID</em>" itemId: "<em>ITEM_ID</em>" fieldId: "<em>FIELD_ID</em>" value: { singleSelectOptionId: "<em>OPTION_ID</em>" }}) { projectV2Item { id }}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "PROJECT_ID" itemId: "ITEM_ID" fieldId: "FIELD_ID" value: { singleSelectOptionId: "OPTION_ID" }}) { projectV2Item { id }}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -630,11 +630,11 @@ gh api graphql -f query='
|
|||
mutation {
|
||||
updateProjectV2ItemFieldValue(
|
||||
input: {
|
||||
projectId: "<em>PROJECT_ID</em>"
|
||||
itemId: "<em>ITEM_ID</em>"
|
||||
fieldId: "<em>FIELD_ID</em>"
|
||||
projectId: "PROJECT_ID"
|
||||
itemId: "ITEM_ID"
|
||||
fieldId: "FIELD_ID"
|
||||
value: {
|
||||
singleSelectOptionId: "<em>OPTION_ID</em>"
|
||||
singleSelectOptionId: "OPTION_ID"
|
||||
}
|
||||
}
|
||||
) {
|
||||
|
|
@ -659,8 +659,8 @@ The following example will update the value of an iteration field for an item.
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "<em>PROJECT_ID</em>" itemId: "<em>ITEM_ID</em>" fieldId: "<em>FIELD_ID</em>" value: { singleSelectOptionId: "<em>OPTION_ID</em>" }}) { projectV2Item { id }}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: "PROJECT_ID" itemId: "ITEM_ID" fieldId: "FIELD_ID" value: { singleSelectOptionId: "OPTION_ID" }}) { projectV2Item { id }}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -670,11 +670,11 @@ gh api graphql -f query='
|
|||
mutation {
|
||||
updateProjectV2ItemFieldValue(
|
||||
input: {
|
||||
projectId: "<em>PROJECT_ID</em>"
|
||||
itemId: "<em>ITEM_ID</em>"
|
||||
fieldId: "<em>FIELD_ID</em>"
|
||||
projectId: "PROJECT_ID"
|
||||
itemId: "ITEM_ID"
|
||||
fieldId: "FIELD_ID"
|
||||
value: {
|
||||
iterationId: "<em>ITERATION_ID</em>"
|
||||
iterationId: "ITERATION_ID"
|
||||
}
|
||||
}
|
||||
) {
|
||||
|
|
@ -694,8 +694,8 @@ The following example will delete an item from a project. Replace `PROJECT_ID` w
|
|||
```shell
|
||||
curl --request POST \
|
||||
--url https://api.github.com/graphql \
|
||||
--header 'Authorization: Bearer <em>TOKEN</em>' \
|
||||
--data '{"query":"mutation {deleteProjectV2Item(input: {projectId: \"<em>PROJECT_ID</em>\" itemId: \"<em>ITEM_ID</em>\"}) {deletedItemId}}"}'
|
||||
--header 'Authorization: Bearer TOKEN' \
|
||||
--data '{"query":"mutation {deleteProjectV2Item(input: {projectId: \"PROJECT_ID\" itemId: \"ITEM_ID\"}) {deletedItemId}}"}'
|
||||
```
|
||||
{% endcurl %}
|
||||
|
||||
|
|
@ -705,8 +705,8 @@ gh api graphql -f query='
|
|||
mutation {
|
||||
deleteProjectV2Item(
|
||||
input: {
|
||||
projectId: "<em>PROJECT_ID</em>"
|
||||
itemId: "<em>ITEM_ID</em>"
|
||||
projectId: "PROJECT_ID"
|
||||
itemId: "ITEM_ID"
|
||||
}
|
||||
) {
|
||||
deletedItemId
|
||||
|
|
|
|||
|
|
@ -192,7 +192,7 @@ For pull requests, you can also use search to:
|
|||
- Filter pull requests by [reviewer](/articles/about-pull-request-reviews/): `state:open type:pr reviewed-by:octocat`
|
||||
- Filter pull requests by the specific user [requested for review](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review): `state:open type:pr review-requested:octocat`{% ifversion fpt or ghae or ghes > 3.2 or ghec %}
|
||||
- Filter pull requests that someone has asked you directly to review: `state:open type:pr user-review-requested:@me`{% endif %}
|
||||
- Filter pull requests by the team requested for review: `state:open type:pr team-review-requested:github/atom`
|
||||
- Filter pull requests by the team requested for review: `state:open type:pr team-review-requested:github/docs`
|
||||
- Filter for pull requests that are linked to an issue that the pull request may close: `linked:issue`
|
||||
|
||||
## Sorting issues and pull requests
|
||||
|
|
|
|||
|
|
@ -62,11 +62,11 @@ For more information on Punycodes, see [Internationalized domain name](https://e
|
|||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _WWW.EXAMPLE.COM_ with your subdomain.
|
||||
```shell
|
||||
$ dig <em>WWW.EXAMPLE.COM</em> +nostats +nocomments +nocmd
|
||||
> ;<em>WWW.EXAMPLE.COM.</em> IN A
|
||||
> <em>WWW.EXAMPLE.COM.</em> 3592 IN CNAME <em>YOUR-USERNAME</em>.github.io.
|
||||
> <em>YOUR-USERNAME</em>.github.io. 43192 IN CNAME <em> GITHUB-PAGES-SERVER </em>.
|
||||
> <em> GITHUB-PAGES-SERVER </em>. 22 IN A 192.0.2.1
|
||||
$ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
|
||||
> ;WWW.EXAMPLE.COM. IN A
|
||||
> WWW.EXAMPLE.COM. 3592 IN CNAME YOUR-USERNAME.github.io.
|
||||
> YOUR-USERNAME.github.io. 43192 IN CNAME GITHUB-PAGES-SERVER .
|
||||
> GITHUB-PAGES-SERVER . 22 IN A 192.0.2.1
|
||||
```
|
||||
{% data reusables.pages.build-locally-download-cname %}
|
||||
{% data reusables.pages.enforce-https-custom-domain %}
|
||||
|
|
@ -104,19 +104,19 @@ To set up an apex domain, such as `example.com`, you must configure a custom dom
|
|||
6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _EXAMPLE.COM_ with your apex domain. Confirm that the results match the IP addresses for {% data variables.product.prodname_pages %} above.
|
||||
- For `A` records.
|
||||
```shell
|
||||
$ dig <em>EXAMPLE.COM</em> +noall +answer -t A
|
||||
> <em>EXAMPLE.COM</em> 3600 IN A 185.199.108.153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN A 185.199.109.153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN A 185.199.110.153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN A 185.199.111.153
|
||||
$ dig EXAMPLE.COM +noall +answer -t A
|
||||
> EXAMPLE.COM 3600 IN A 185.199.108.153
|
||||
> EXAMPLE.COM 3600 IN A 185.199.109.153
|
||||
> EXAMPLE.COM 3600 IN A 185.199.110.153
|
||||
> EXAMPLE.COM 3600 IN A 185.199.111.153
|
||||
```
|
||||
- For `AAAA` records.
|
||||
```shell
|
||||
$ dig <em>EXAMPLE.COM</em> +noall +answer -t AAAA
|
||||
> <em>EXAMPLE.COM</em> 3600 IN AAAA 2606:50c0:8000::153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN AAAA 2606:50c0:8001::153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN AAAA 2606:50c0:8002::153
|
||||
> <em>EXAMPLE.COM</em> 3600 IN AAAA 2606:50c0:8003::153
|
||||
$ dig EXAMPLE.COM +noall +answer -t AAAA
|
||||
> EXAMPLE.COM 3600 IN AAAA 2606:50c0:8000::153
|
||||
> EXAMPLE.COM 3600 IN AAAA 2606:50c0:8001::153
|
||||
> EXAMPLE.COM 3600 IN AAAA 2606:50c0:8002::153
|
||||
> EXAMPLE.COM 3600 IN AAAA 2606:50c0:8003::153
|
||||
```
|
||||
{% data reusables.pages.build-locally-download-cname %}
|
||||
{% data reusables.pages.enforce-https-custom-domain %}
|
||||
|
|
@ -132,11 +132,11 @@ After you configure the apex domain, you must configure a CNAME record with your
|
|||
1. Navigate to your DNS provider and create a `CNAME` record that points `www.example.com` to the default domain for your site: `<user>.github.io` or `<organization>.github.io`. Do not include the repository name. {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %}
|
||||
2. To confirm that your DNS record configured correctly, use the `dig` command, replacing _WWW.EXAMPLE.COM_ with your `www` subdomain variant.
|
||||
```shell
|
||||
$ dig <em>WWW.EXAMPLE.COM</em> +nostats +nocomments +nocmd
|
||||
> ;<em>WWW.EXAMPLE.COM.</em> IN A
|
||||
> <em>WWW.EXAMPLE.COM.</em> 3592 IN CNAME <em>YOUR-USERNAME</em>.github.io.
|
||||
> <em>YOUR-USERNAME</em>.github.io. 43192 IN CNAME <em> GITHUB-PAGES-SERVER </em>.
|
||||
> <em> GITHUB-PAGES-SERVER </em>. 22 IN A 192.0.2.1
|
||||
$ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
|
||||
> ;WWW.EXAMPLE.COM IN A
|
||||
> WWW.EXAMPLE.COM. 3592 IN CNAME YOUR-USERNAME.github.io.
|
||||
> YOUR-USERNAME.github.io. 43192 IN CNAME GITHUB-PAGES-SERVER.
|
||||
> GITHUB-PAGES-SERVER. 22 IN A 192.0.2.1
|
||||
```
|
||||
## Removing a custom domain
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Resolver um conflito de merge usando a linha de comando
|
||||
intro: Você pode resolver conflitos de merge usando a linha de comando e um editor de texto.
|
||||
title: Resolving a merge conflict using the command line
|
||||
intro: You can resolve merge conflicts using the command line and a text editor.
|
||||
redirect_from:
|
||||
- /github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line
|
||||
- /articles/resolving-a-merge-conflict-from-the-command-line
|
||||
|
|
@ -15,33 +15,27 @@ versions:
|
|||
topics:
|
||||
- Pull requests
|
||||
shortTitle: Resolve merge conflicts in Git
|
||||
ms.openlocfilehash: 1d4ff97c2a93d3e5a7aebaa8752810e284203bc1
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147883454'
|
||||
---
|
||||
Os conflitos de merge ocorrem quando alterações concorrentes são feitas na mesma linha de um arquivo ou quando uma pessoa edita um arquivo e outra pessoa exclui o mesmo arquivo. Para obter mais informações, confira "[Sobre os conflitos de mesclagem](/articles/about-merge-conflicts/)".
|
||||
Merge conflicts occur when competing changes are made to the same line of a file, or when one person edits a file and another person deletes the same file. For more information, see "[About merge conflicts](/articles/about-merge-conflicts/)."
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Dica:** use o editor de conflitos do {% data variables.product.product_name %} para resolver conflitos de mesclagem de alterações de linha concorrentes entre branches que fazem parte de uma solicitação de pull. Para obter mais informações, confira "[Como resolver um conflito de mesclagem no GitHub](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github)".
|
||||
**Tip:** You can use the conflict editor on {% data variables.product.product_name %} to resolve competing line change merge conflicts between branches that are part of a pull request. For more information, see "[Resolving a merge conflict on GitHub](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Conflitos de merge de alterações diferentes na linha
|
||||
## Competing line change merge conflicts
|
||||
|
||||
Para resolver um conflito de merge causado por alterações diferentes na linha, você deve escolher quais alterações dos diferentes branches incorporar em um novo commit.
|
||||
To resolve a merge conflict caused by competing line changes, you must choose which changes to incorporate from the different branches in a new commit.
|
||||
|
||||
Por exemplo, se você e outra pessoa editarem o arquivo _styleguide.md_ nas mesmas linhas em branches diferentes do mesmo repositório Git, você receberá um erro de conflito de mesclagem ao tentar mesclar esses branches. Você deve resolver esse conflito de merge com um novo commit antes de fazer merge desses branches.
|
||||
For example, if you and another person both edited the file _styleguide.md_ on the same lines in different branches of the same Git repository, you'll get a merge conflict error when you try to merge these branches. You must resolve this merge conflict with a new commit before you can merge these branches.
|
||||
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
2. Navegue até o repositório Git local que tem o conflito de merge.
|
||||
2. Navigate into the local Git repository that has the merge conflict.
|
||||
```shell
|
||||
cd <em>REPOSITORY-NAME</em>
|
||||
cd REPOSITORY-NAME
|
||||
```
|
||||
3. Gere uma lista dos arquivos afetados pelo conflito de merge. Neste exemplo, o arquivo *styleguide.md* tem um conflito de mesclagem.
|
||||
3. Generate a list of the files affected by the merge conflict. In this example, the file *styleguide.md* has a merge conflict.
|
||||
```shell
|
||||
$ git status
|
||||
> # On branch branch-b
|
||||
|
|
@ -55,8 +49,8 @@ Por exemplo, se você e outra pessoa editarem o arquivo _styleguide.md_ nas mesm
|
|||
> #
|
||||
> no changes added to commit (use "git add" and/or "git commit -a")
|
||||
```
|
||||
4. Abra seu editor de texto favorito, como o [Atom](https://atom.io/), e procure o arquivo que contém conflitos de mesclagem.
|
||||
5. Para ver o início do conflito de mesclagem no arquivo, pesquise o marcador de conflito `<<<<<<<` no arquivo. Ao abrir o arquivo no editor de texto, você verá as alterações do branch HEAD ou base após a linha `<<<<<<< HEAD`. Em seguida, você verá `=======`, o que divide as alterações das alterações no outro branch, seguido de `>>>>>>> BRANCH-NAME`. Neste exemplo, uma pessoa escreveu "abra um problema" no branch HEAD ou base e outra pessoa escreveu "faça sua pergunta no IRC" no branch de comparação ou `branch-a`.
|
||||
4. Open your favorite text editor, such as [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/), and navigate to the file that has merge conflicts.
|
||||
5. To see the beginning of the merge conflict in your file, search the file for the conflict marker `<<<<<<<`. When you open the file in your text editor, you'll see the changes from the HEAD or base branch after the line `<<<<<<< HEAD`. Next, you'll see `=======`, which divides your changes from the changes in the other branch, followed by `>>>>>>> BRANCH-NAME`. In this example, one person wrote "open an issue" in the base or HEAD branch and another person wrote "ask your question in IRC" in the compare branch or `branch-a`.
|
||||
|
||||
```
|
||||
If you have questions, please
|
||||
|
|
@ -66,34 +60,34 @@ Por exemplo, se você e outra pessoa editarem o arquivo _styleguide.md_ nas mesm
|
|||
ask your question in IRC.
|
||||
>>>>>>> branch-a
|
||||
```
|
||||
{% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} Neste exemplo, as duas alterações são incorporadas ao merge final:
|
||||
{% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} In this example, both changes are incorporated into the final merge:
|
||||
|
||||
```shell
|
||||
If you have questions, please open an issue or ask in our IRC channel if it's more urgent.
|
||||
```
|
||||
7. Adicione ou faça stage das alterações.
|
||||
7. Add or stage your changes.
|
||||
```shell
|
||||
$ git add .
|
||||
```
|
||||
8. Faça o commit das suas alterações com um comentário.
|
||||
8. Commit your changes with a comment.
|
||||
```shell
|
||||
$ git commit -m "Resolved merge conflict by incorporating both suggestions."
|
||||
```
|
||||
|
||||
Agora você pode mesclar os branches na linha de comando ou [efetuar push das alterações para o repositório remoto](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) no {% data variables.product.product_name %} e [mesclar as alterações](/articles/merging-a-pull-request/) em uma solicitação de pull.
|
||||
You can now merge the branches on the command line or [push your changes to your remote repository](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) on {% data variables.product.product_name %} and [merge your changes](/articles/merging-a-pull-request/) in a pull request.
|
||||
|
||||
## Conflitos de merge de arquivo removido
|
||||
## Removed file merge conflicts
|
||||
|
||||
Para resolver um conflito de merge causado por alterações concorrentes em um arquivo, quando uma pessoa exclui um arquivo em um branch e outra pessoa edita o mesmo arquivo, você deve escolher se deseja excluir ou manter o arquivo removido em um novo commit.
|
||||
To resolve a merge conflict caused by competing changes to a file, where a person deletes a file in one branch and another person edits the same file, you must choose whether to delete or keep the removed file in a new commit.
|
||||
|
||||
Por exemplo, se você editar um arquivo, como *LEIAME.md*, e outra pessoa remover o mesmo arquivo em outro branch no mesmo repositório Git, você receberá um erro de conflito de mesclagem ao tentar mesclar esses branches. Você deve resolver esse conflito de merge com um novo commit antes de fazer merge desses branches.
|
||||
For example, if you edited a file, such as *README.md*, and another person removed the same file in another branch in the same Git repository, you'll get a merge conflict error when you try to merge these branches. You must resolve this merge conflict with a new commit before you can merge these branches.
|
||||
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
2. Navegue até o repositório Git local que tem o conflito de merge.
|
||||
2. Navigate into the local Git repository that has the merge conflict.
|
||||
```shell
|
||||
cd <em>REPOSITORY-NAME</em>
|
||||
cd REPOSITORY-NAME
|
||||
```
|
||||
2. Gere uma lista dos arquivos afetados pelo conflito de merge. Neste exemplo, o arquivo *LEIAME.md* tem um conflito de mesclagem.
|
||||
2. Generate a list of the files affected by the merge conflict. In this example, the file *README.md* has a merge conflict.
|
||||
```shell
|
||||
$ git status
|
||||
> # On branch main
|
||||
|
|
@ -106,32 +100,32 @@ Por exemplo, se você editar um arquivo, como *LEIAME.md*, e outra pessoa remove
|
|||
> # Unmerged paths:
|
||||
> # (use "git add/rm <file>..." as appropriate to mark resolution)
|
||||
> #
|
||||
> # deleted by us: README.md
|
||||
> # deleted by us: README.md
|
||||
> #
|
||||
> # no changes added to commit (use "git add" and/or "git commit -a")
|
||||
```
|
||||
3. Abra seu editor de texto favorito, como o [Atom](https://atom.io/), e procure o arquivo que contém conflitos de mesclagem.
|
||||
6. Decida se você deseja manter o arquivo removido. Você pode ver as alterações mais recentes feitas no arquivo removido no editor de texto.
|
||||
3. Open your favorite text editor, such as [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/), and navigate to the file that has merge conflicts.
|
||||
6. Decide if you want keep the removed file. You may want to view the latest changes made to the removed file in your text editor.
|
||||
|
||||
Para adicionar o arquivo removido de volta ao repositório:
|
||||
To add the removed file back to your repository:
|
||||
```shell
|
||||
$ git add README.md
|
||||
```
|
||||
Para remover o arquivo do seu repositório:
|
||||
To remove this file from your repository:
|
||||
```shell
|
||||
$ git rm README.md
|
||||
> README.md: needs merge
|
||||
> rm 'README.md'
|
||||
```
|
||||
7. Faça o commit das suas alterações com um comentário.
|
||||
7. Commit your changes with a comment.
|
||||
```shell
|
||||
$ git commit -m "Resolved merge conflict by keeping README.md file."
|
||||
> [branch-d 6f89e49] Merge branch 'branch-c' into branch-d
|
||||
```
|
||||
|
||||
Agora você pode mesclar os branches na linha de comando ou [efetuar push das alterações para o repositório remoto](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) no {% data variables.product.product_name %} e [mesclar as alterações](/articles/merging-a-pull-request/) em uma solicitação de pull.
|
||||
You can now merge the branches on the command line or [push your changes to your remote repository](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) on {% data variables.product.product_name %} and [merge your changes](/articles/merging-a-pull-request/) in a pull request.
|
||||
|
||||
## Leitura adicional
|
||||
## Further reading
|
||||
|
||||
- "[Sobre os conflitos de mesclagem](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts)"
|
||||
- "[Como fazer check-out local de solicitações de pull](/articles/checking-out-pull-requests-locally/)"
|
||||
- "[About merge conflicts](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts)"
|
||||
- "[Checking out pull requests locally](/articles/checking-out-pull-requests-locally/)"
|
||||
|
|
|
|||
|
|
@ -83,7 +83,7 @@ If you decide you don't want the changes in a topic branch to be merged to the u
|
|||
To merge a pull request, use the `gh pr merge` subcommand. Replace `pull-request` with the number, URL, or head branch of the pull request.
|
||||
|
||||
```shell
|
||||
gh pr merge <em>pull-request</em>
|
||||
gh pr merge PULL-REQUEST
|
||||
```
|
||||
|
||||
Follow the interactive prompts to complete the merge. For more information about the merge methods that you can choose, see "[About pull request merges](/github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges)."
|
||||
|
|
|
|||
|
|
@ -90,7 +90,7 @@ You can choose whether {% data variables.large_files.product_name_long %} ({% da
|
|||
1. To create a release, use the `gh release create` subcommand. Replace `tag` with the desired tag for the release.
|
||||
|
||||
```shell
|
||||
gh release create <em>tag</em>
|
||||
gh release create TAG
|
||||
```
|
||||
|
||||
2. Follow the interactive prompts. Alternatively, you can specify arguments to skip these prompts. For more information about possible arguments, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_release_create). For example, this command creates a prerelease with the specified title and notes.
|
||||
|
|
@ -153,7 +153,7 @@ Releases cannot currently be edited with {% data variables.product.prodname_cli
|
|||
1. To delete a release, use the `gh release delete` subcommand. Replace `tag` with the tag of the release to delete. Use the `-y` flag to skip confirmation.
|
||||
|
||||
```shell
|
||||
gh release delete <em>tag</em> -y
|
||||
gh release delete TAG -y
|
||||
```
|
||||
|
||||
{% endcli %}
|
||||
|
|
|
|||
|
|
@ -340,7 +340,7 @@ To view a fully interactive version of your Jupyter Notebook, you can set up a n
|
|||
If you're having trouble rendering Jupyter Notebook files in static HTML, you can convert the file locally on the command line by using the [`nbconvert` command](https://github.com/jupyter/nbconvert):
|
||||
|
||||
```shell
|
||||
$ jupyter nbconvert --to html <em>NOTEBOOK-NAME.ipynb</em>
|
||||
$ jupyter nbconvert --to html NOTEBOOK-NAME.ipynb
|
||||
```
|
||||
|
||||
### Further reading
|
||||
|
|
|
|||
|
|
@ -163,7 +163,7 @@ With cURL, you will send an `Authorization` header with your token. Replace `YOU
|
|||
```shell
|
||||
curl --request GET \
|
||||
--url "https://api.github.com/octocat" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
|
@ -326,7 +326,7 @@ To send a header with cURL, use the `--header` or `-H` flag followed by the head
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/octocat" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% endcurl %}
|
||||
|
|
@ -390,7 +390,7 @@ To get issues from the `octocat/Spoon-Knife` repository, replace `{owner}` with
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% endcurl %}
|
||||
|
|
@ -443,7 +443,7 @@ For cURL, add a `?` to the end of the path, then append your query parameter nam
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2&sort=updated&direction=asc" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% endcurl %}
|
||||
|
|
@ -495,7 +495,7 @@ For cURL, use the `--data` flag to pass the body parameters in a JSON object.
|
|||
curl --request POST \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>" \
|
||||
--header "Authorization: Bearer YOUR-TOKEN" \
|
||||
--data '{
|
||||
"title": "Created with the REST API",
|
||||
"body": "This is a test issue created by the REST API"
|
||||
|
|
@ -593,7 +593,7 @@ For example, this request:
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>" \
|
||||
--header "Authorization: Bearer YOUR-TOKEN" \
|
||||
--include
|
||||
```
|
||||
|
||||
|
|
@ -661,7 +661,7 @@ await octokit.request("GET /repos/{owner}/{repo}/issues", {
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% endcurl %}
|
||||
|
|
@ -730,7 +730,7 @@ For example, you can use `>` to redirect the response to a file:
|
|||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>" > data.json
|
||||
--header "Authorization: Bearer YOUR-TOKEN" > data.json
|
||||
```
|
||||
|
||||
Then you can use jq to get the title and author ID of each issue:
|
||||
|
|
|
|||
|
|
@ -45,7 +45,7 @@ response. The solution is to manually craft the `Authorization` header.
|
|||
We recommend you use OAuth tokens to authenticate to the GitHub API. OAuth tokens include [personal access tokens][personal-access-tokens] and enable the user to revoke access at any time.
|
||||
|
||||
```shell
|
||||
$ curl -u <em>username</em>:<em>token</em> {% data variables.product.api_url_pre %}/user
|
||||
$ curl -u USERNAME:TOKEN {% data variables.product.api_url_pre %}/user
|
||||
```
|
||||
|
||||
This approach is useful if your tools only support Basic Authentication but you want to take advantage of OAuth access token security features.
|
||||
|
|
@ -71,7 +71,7 @@ would authenticate you if you replace `<username>` with your {% data variables.p
|
|||
(cURL will prompt you to enter the password.)
|
||||
|
||||
```shell
|
||||
$ curl -u <em>username</em> {% data variables.product.api_url_pre %}/user
|
||||
$ curl -u USERNAME {% data variables.product.api_url_pre %}/user
|
||||
```
|
||||
If you have two-factor authentication enabled, make sure you understand how to [work with two-factor authentication](/rest/overview/other-authentication-methods#working-with-two-factor-authentication).
|
||||
|
||||
|
|
@ -95,7 +95,7 @@ If you have two-factor authentication enabled, make sure you understand how to [
|
|||
If you're using the API to access an organization that enforces [SAML SSO][saml-sso] for authentication, you'll need to create a personal access token (PAT) and [authorize the token][allowlist] for that organization. Visit the URL specified in `X-GitHub-SSO` to authorize the token for the organization.
|
||||
|
||||
```shell
|
||||
$ curl -v -H "Authorization: Bearer <em>TOKEN</em>" {% data variables.product.api_url_pre %}/repos/octodocs-test/test
|
||||
$ curl -v -H "Authorization: Bearer TOKEN" {% data variables.product.api_url_pre %}/repos/octodocs-test/test
|
||||
|
||||
> X-GitHub-SSO: required; url=https://github.com/orgs/octodocs-test/sso?authorization_request=AZSCKtL4U8yX1H3sCQIVnVgmjmon5fWxks5YrqhJgah0b2tlbl9pZM4EuMz4
|
||||
{
|
||||
|
|
@ -107,7 +107,7 @@ $ curl -v -H "Authorization: Bearer <em>TOKEN</em>" {% data variables.product.ap
|
|||
When requesting data that could come from multiple organizations (for example, [requesting a list of issues created by the user][user-issues]), the `X-GitHub-SSO` header indicates which organizations require you to authorize your personal access token:
|
||||
|
||||
```shell
|
||||
$ curl -v -H "Authorization: Bearer <em>TOKEN</em>" {% data variables.product.api_url_pre %}/user/issues
|
||||
$ curl -v -H "Authorization: Bearer TOKEN" {% data variables.product.api_url_pre %}/user/issues
|
||||
|
||||
> X-GitHub-SSO: partial-results; organizations=21955855,20582480
|
||||
```
|
||||
|
|
@ -136,9 +136,9 @@ This header tells you how your account receives its two-factor authentication co
|
|||
```shell
|
||||
$ curl --request POST \
|
||||
--url https://api.github.com/authorizations \
|
||||
--header 'authorization: Basic <em>PASSWORD</em>' \
|
||||
--header 'authorization: Basic PASSWORD' \
|
||||
--header 'content-type: application/json' \
|
||||
--header 'x-github-otp: <em>OTP</em>' \
|
||||
--header 'x-github-otp: OTP' \
|
||||
--data '{"scopes": ["public_repo"], "note": "test"}'
|
||||
```
|
||||
{% endif %}
|
||||
|
|
|
|||
|
|
@ -91,7 +91,7 @@ $ curl -u "username" {% data variables.product.api_url_pre %}
|
|||
### OAuth2 token (sent in a header)
|
||||
|
||||
```shell
|
||||
$ curl -H "Authorization: Bearer <em>OAUTH-TOKEN</em>" {% data variables.product.api_url_pre %}
|
||||
$ curl -H "Authorization: Bearer OAUTH-TOKEN" {% data variables.product.api_url_pre %}
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
|
@ -150,7 +150,7 @@ the API will temporarily reject all authentication attempts for that user
|
|||
|
||||
```shell
|
||||
$ curl -i {% data variables.product.api_url_pre %} -u {% ifversion fpt or ghae or ghec %}
|
||||
-u <em>valid_username</em>:<em>valid_token</em> {% endif %}{% ifversion ghes %}-u <em>valid_username</em>:<em>valid_password</em> {% endif %}
|
||||
-u VALID_USERNAME:VALID_TOKEN {% endif %}{% ifversion ghes %}-u VALID_USERNAME:VALID_PASSWORD {% endif %}
|
||||
> HTTP/2 403
|
||||
> {
|
||||
> "message": "Maximum number of login attempts exceeded. Please try again later.",
|
||||
|
|
@ -185,7 +185,7 @@ You can issue a `GET` request to the root endpoint to get all the endpoint categ
|
|||
|
||||
```shell
|
||||
$ curl {% ifversion fpt or ghae or ghec %}
|
||||
-u <em>username</em>:<em>token</em> {% endif %}{% ifversion ghes %}-u <em>username</em>:<em>password</em> {% endif %}{% data variables.product.api_url_pre %}
|
||||
-u USERNAME:TOKEN {% endif %}{% ifversion ghes %}-u USERNAME:PASSWORD {% endif %}{% data variables.product.api_url_pre %}
|
||||
```
|
||||
|
||||
## GraphQL global node IDs
|
||||
|
|
|
|||
|
|
@ -268,7 +268,7 @@ You can filter pull requests based on their [review status](/pull-requests/colla
|
|||
| <code>reviewed-by:<em>USERNAME</em></code> | [**type:pr reviewed-by:gjtorikian**](https://github.com/search?utf8=%E2%9C%93&q=type%3Apr+reviewed-by%3Agjtorikian&type=Issues) matches pull requests reviewed by a particular person.
|
||||
| <code>review-requested:<em>USERNAME</em></code> | [**type:pr review-requested:benbalter**](https://github.com/search?utf8=%E2%9C%93&q=type%3Apr+review-requested%3Abenbalter&type=Issues) matches pull requests where a specific person is requested for review. Requested reviewers are no longer listed in the search results after they review a pull request. If the requested person is on a team that is requested for review, then review requests for that team will also appear in the search results.{% ifversion fpt or ghae or ghes > 3.2 or ghec %}
|
||||
| <code>user-review-requested:@me</code> | [**type:pr user-review-requested:@me**](https://github.com/search?q=is%3Apr+user-review-requested%3A%40me+) matches pull requests that you have directly been asked to review.{% endif %}
|
||||
| <code>team-review-requested:<em>TEAMNAME</em></code> | [**type:pr team-review-requested:atom/design**](https://github.com/search?q=type%3Apr+team-review-requested%3Aatom%2Fdesign&type=Issues) matches pull requests that have review requests from the team `atom/design`. Requested reviewers are no longer listed in the search results after they review a pull request.
|
||||
| <code>team-review-requested:<em>TEAMNAME</em></code> | [**type:pr team-review-requested:github/docs**](https://github.com/search?q=type%3Apr+team-review-requested%3Agithub%2Fdocs&type=pullrequests) matches pull requests that have review requests from the team `github/docs`. Requested reviewers are no longer listed in the search results after they review a pull request.
|
||||
|
||||
## Search by when an issue or pull request was created or last updated
|
||||
|
||||
|
|
|
|||
|
|
@ -1,9 +0,0 @@
|
|||
---
|
||||
ms.openlocfilehash: ad73c4455042d29d72d3f76dbbdc512487c9303a
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: "146139462"
|
||||
---
|
||||
Para obter exemplos que demonstram recursos mais complexos do {% data variables.product.prodname_actions %}, confira " [Exemplos](/actions/examples)". Você pode ver exemplos detalhados que explicam como testar seu código em um executor, acessar a CLI do {% data variables.product.prodname_dotcom %} e usar recursos avançados, como simultaneidade e matrizes de teste.
|
||||
|
|
@ -15,6 +15,8 @@ After you connect your account on {% data variables.product.product_location %}
|
|||
|
||||
|
||||
|
||||
If codespaces are billable for the repository you choose, a message will be displayed in subsequent prompts telling you who will pay for the codespace.
|
||||
|
||||
4. Click the branch you want to develop on.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,27 +1,22 @@
|
|||
---
|
||||
ms.openlocfilehash: 5120f840aab87ca243eed66c5bb6256e80aefeea
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: "147064175"
|
||||
---
|
||||
{% ifversion fpt or ghec %}Por padrão, você receberá notificações:{% endif %}{% ifversion ghes or ghae %}Por padrão, se o proprietário da empresa tiver configurado um email para notificações na sua instância, você receberá {% data variables.product.prodname_dependabot_alerts %}:{% endif %}
|
||||
{% ifversion fpt or ghec %}By default, you will receive notifications:{% endif %}{% ifversion ghes or ghae %}By default, if your enterprise owner has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %}:{% endif %}
|
||||
|
||||
- por email, um email é enviado quando o {% data variables.product.prodname_dependabot %} está habilitado em um repositório, quando é feito commit de um novo arquivo de manifesto no repositório e quando uma nova vulnerabilidade com uma severidade crítica ou alta é encontrada (opção **Enviar um email sempre que uma vulnerabilidade for encontrada**).
|
||||
- na interface do usuário, um aviso será mostrado nas exibições de arquivo e de código do repositório se houver dependências não seguras (opção **Alertas da interface do usuário**).
|
||||
- na linha de comando, são exibidos avisos como retornos de chamada quando você efetua push para repositórios com dependências não seguras (opção **Linha de Comando**).
|
||||
- na caixa de entrada, como notificações da Web. Uma notificação da Web é enviada quando o {% data variables.product.prodname_dependabot %} está habilitado em um repositório, quando é feito commit de um novo arquivo de manifesto e quando uma nova vulnerabilidade com uma severidade crítica ou alta é encontrada (opção **Web**).{% ifversion not ghae %}
|
||||
- em {% data variables.product.prodname_mobile %}, como notificações da web. Para obter mais informações, confira "[Como habilitar notificações por push com o GitHub Mobile](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-mobile)".{% endif %}
|
||||
- by email, an email is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**Email each time a vulnerability is found** option).
|
||||
- in the user interface, a warning is shown in your repository's file and code views if there are any insecure dependencies (**UI alerts** option).
|
||||
- on the command line, warnings are displayed as callbacks when you push to repositories with any insecure dependencies (**Command Line** option).
|
||||
- in your inbox, as web notifications. A web notification is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**Web** option).{% ifversion not ghae %}
|
||||
- on {% data variables.product.prodname_mobile %}, as web notifications. For more information, see "[Enabling push notifications with GitHub Mobile](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-mobile)."{% endif %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** as notificações por email e da Web{% ifversion not ghae %}/do {% data variables.product.prodname_mobile %}{% endif %} são:
|
||||
**Note:** The email and web{% ifversion not ghae %}/{% data variables.product.prodname_mobile %}{% endif %} notifications are:
|
||||
|
||||
- _por repositório_, quando o {% data variables.product.prodname_dependabot %} está habilitado no repositório ou quando é feito commit de um novo arquivo de manifesto no repositório.
|
||||
- _per repository_ when {% data variables.product.prodname_dependabot %} is enabled on the repository, or when a new manifest file is committed to the repository.
|
||||
|
||||
- _por organização_, quando uma nova vulnerabilidade é descoberta.
|
||||
- _per organization_ when a new vulnerability is discovered.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Você pode personalizar a maneira como recebe notificações sobre os {% data variables.product.prodname_dependabot_alerts %}. Por exemplo, você pode receber um email de resumo semanal de alertas para até dez dos seus repositórios usando as opções **Enviar um email de resumo das vulnerabilidades** e **Resumo de email de segurança semanal**.
|
||||
{% ifversion update-notification-settings-22 %}
|
||||
You can customize the way you are notified about {% data variables.product.prodname_dependabot_alerts %}. For example, you can receive a daily or weekly digest email summarizing alerts for up to 10 of your repositories using the **Email weekly digest** option.
|
||||
{% else %}
|
||||
You can customize the way you are notified about {% data variables.product.prodname_dependabot_alerts %}. For example, you can receive a weekly digest email summarizing alerts for up to 10 of your repositories using the **Email a digest summary of vulnerabilities** and **Weekly security email digest** options.{% endif %}
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче