{"meta":{"title":"Configurar os redirecionamentos","intro":"Se o título, a versão ou o local de um artigo forem alterados, você poderá criar um redirecionamento para o conteúdo atual.","product":"Contribuir com o GitHub Docs","breadcrumbs":[{"href":"/pt/contributing","title":"Contribuir com o GitHub Docs"},{"href":"/pt/contributing/writing-for-github-docs","title":"Escrevendo para GitHub Docs"},{"href":"/pt/contributing/writing-for-github-docs/configuring-redirects","title":"Configurar redirecionamentos"}],"documentType":"article"},"body":"# Configurar os redirecionamentos\n\nSe o título, a versão ou o local de um artigo forem alterados, você poderá criar um redirecionamento para o conteúdo atual.\n\n## Sobre os redirecionamentos\n\nSe uma alteração for feita em um artigo que afete a capacidade das pessoas de encontrá-lo, criaremos um redirecionamento de quaisquer versões desatualizadas para o conteúdo atual. Talvez seja necessário fazer isso se o título de um artigo for alterado, uma nova versão for adicionada ou o local do arquivo for alterado.\n\nOs redirecionamentos podem ser configurados local ou externamente.\n\n## Configurar os redirecionamentos locais\n\nNo GitHub Docs, você pode redirecionar de um arquivo para outro ou de uma versão para outra.\n\n### Redirecionamentos entre arquivos\n\nSe você alterar o nome de um artigo e quiser que a URL antiga redirecione para a nova URL em todas as versões, use o front matter `redirect_from` com o caminho para o nome antigo do artigo. Se você alterar o nome de um artigo e quiser que versões diferentes redirecionem para URLs diferentes, siga as etapas na seção [Redirecionamentos entre versões](#redirects-across-versions).\n\nNo exemplo a seguir, o artigo “Tudo sobre compromissos” foi renomeado para “Criar seu primeiro compromisso”. O front matter `redirect_from` redireciona qualquer pessoa que navegue para a URL do artigo antigo para a URL do novo artigo.\n\n```yaml\ntitle: Creating your first commit\nredirect_from:\n  - /content/get-started/all-about-commits\n```\n\nVeja [`redirect_from`](https://github.com/github/docs/blob/main/content/README.md#redirect_from) no arquivo README do GitHub Docs para mais detalhes.\n\n### Redirecionamentos automáticos para URLs que não incluem uma versão\n\nSe um URL para uma página for inserido sem uma versão (`https://docs.github.com/ARTICLE` em vez de `https://docs.github.com/VERSION/ARTICLE`), o site vai redirecioná-lo automaticamente para a primeira versão disponível da página.<!-- markdownlint-disable-line search-replace -->\n\nA ordem de precedência é especificada em [`lib/all-versions.ts`](https://github.com/github/docs/blob/main/src/versions/lib/all-versions.ts). A ordem de precedência atual é:\n\n1. GitHub Free, GitHub Pro ou GitHub Team (`fpt`)\n2. GitHub Enterprise Cloud (`ghec`)\n3. GitHub Enterprise Server (`ghes`)\n\nSe uma página intitulada `ARTICLE` estiver disponível apenas em GitHub Enterprise Cloud e GitHub Enterprise Server, o link `https://docs.github.com/ARTICLE` será redirecionado automaticamente para `https://docs.github.com/enterprise-cloud@latest/ARTICLE` porque GitHub Enterprise Cloud tem precedência sobre GitHub Enterprise Server.<!-- markdownlint-disable-line search-replace -->\n\nSe `ARTICLE` estiver disponível em Free, Pro ou Team, nenhum redirecionamento ocorrerá porque as páginas `fpt` não têm um segmento de versão, portanto, o conteúdo `fpt` em `https://docs.github.com/ARTICLE` será renderizado.<!-- markdownlint-disable-line search-replace -->\n\n### Redirecionamentos entre versões\n\nSe quiser que a URL de uma versão de um artigo redirecione para uma URL de outra versão ou para outra URL, atualize o arquivo [redirect-exceptions.txt](https://github.com/github/docs/blob/main/src/redirects/lib/static/redirect-exceptions.txt) no diretório `src/redirects`.\n\nPor exemplo, se você remover a versão Free, Pro ou Team (`fpt`) de um artigo, a URL será redirecionada automaticamente para a próxima versão disponível da página. Se você quiser que redirecione para uma versão inferior na ordem de precedência ou para uma página totalmente diferente, especifique uma exceção.\n\nCada entrada no arquivo `redirect-exceptions` deve começar com o caminho *para* o qual você deseja redirecionar, incluindo a versão, seguido por uma lista desordenada dos caminhos *de onde* você deseja redirecionar. No exemplo a seguir, os caminhos na lista não ordenada redirecionarão para a versão GitHub Enterprise Cloud de [Exportando as informações de integrante para a sua organização](/pt/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization).\n\n```text\n/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization\n  - /enterprise-server@3.3/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization\n  - /enterprise-server@3.4/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization\n  - /enterprise-server@3.5/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization\n```\n\n## Configurar os redirecionamentos externos\n\nRaramente, o conteúdo será movido para fora do site do GitHub Docs. Para esses tipos de redirecionamentos, atualize o arquivo [`external-sites.json`](https://github.com/github/docs/blob/main/src/redirects/lib/external-sites.json) no diretório `src/redirects`.\n\nCada entrada no arquivo `external-sites.json` é um par chave-valor em que a chave é o caminho para onde o conteúdo estava e o valor é o caminho para onde ele deve redirecionar.\n\n```json\n  \"/github-status\": \"https://www.githubstatus.com/\",\n  \"/articles/github-security\": \"https://github.com/security\",\n```"}