# Configurar os redirecionamentos

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.

## Sobre os redirecionamentos

Se 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.

Os redirecionamentos podem ser configurados local ou externamente.

## Configurar os redirecionamentos locais

No GitHub Docs, você pode redirecionar de um arquivo para outro ou de uma versão para outra.

### Redirecionamentos entre arquivos

Se 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).

No 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.

```yaml
title: Creating your first commit
redirect_from:
  - /content/get-started/all-about-commits
```

Veja [`redirect_from`](https://github.com/github/docs/blob/main/content/README.md#redirect_from) no arquivo README do GitHub Docs para mais detalhes.

### Redirecionamentos automáticos para URLs que não incluem uma versão

Se 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 -->

A 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 é:

1. GitHub Free, GitHub Pro ou GitHub Team (`fpt`)
2. GitHub Enterprise Cloud (`ghec`)
3. GitHub Enterprise Server (`ghes`)

Se 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 -->

Se `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 -->

### Redirecionamentos entre versões

Se 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`.

Por 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.

Cada 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).

```text
/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
  - /enterprise-server@3.3/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
  - /enterprise-server@3.4/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
  - /enterprise-server@3.5/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
```

## Configurar os redirecionamentos externos

Raramente, 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`.

Cada 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.

```json
  "/github-status": "https://www.githubstatus.com/",
  "/articles/github-security": "https://github.com/security",
```