Adicionar idiomas a um site de documentação
Publique um site de documentação em mais de um idioma: escolha os idiomas do site e o idioma padrão, traduza artigos, páginas do site, títulos e rótulos de menu, e veja o que os leitores encontram quando uma página ainda não foi traduzida.
Um site de documentação pode ser publicado em vários idiomas. Cada artigo e página do site tem sua própria cópia por idioma, os leitores alternam o idioma no cabeçalho do site, e uma página que ainda não foi traduzida é exibida no seu idioma padrão. O plano Free oferece 2 idiomas por site, o Starter 5, e o Pro ou superior, quantos você quiser.
Antes de começar
- Proprietários, administradores e editores podem alterar os idiomas de um site.
- Você pode escolher entre 74 idiomas, incluindo variantes regionais como Inglês (Reino Unido) e Espanhol (América Latina).
| Plano | Idiomas por site |
|---|---|
| Free | 2 |
| Starter | 5 |
| Pro, Business, Custom | Ilimitado |
Adicionar um idioma
Abra as configurações do site
Abra seu site de documentação e vá para Configurações → Geral.
Adicionar idiomas
Em idiomas, adicione os idiomas que desejar. "Os artigos existem por idioma; os leitores alternam no cabeçalho." Um contador mostra quantos o seu plano permite.

A configuração de Idiomas em Configurações, Geral Verifique o idioma padrão
Idioma padrão é "O idioma em que você escreve as palavras do site. O endereço dele não possui prefixo de idioma." É o idioma para o qual os leitores são redirecionados e aquele a partir do qual as traduções começam.
Salvar e publicar
Clique em Salvar, traduza suas páginas (veja abaixo) e, em seguida, publique o site.
Como funcionam os endereços
O idioma padrão reside na raiz do site; todos os outros idiomas recebem um prefixo criado a partir de seu código.
| Idioma | Exemplo de endereço |
|---|---|
| Inglês (padrão) | help.example.com/getting-started |
| Alemão | help.example.com/de-de/getting-started |
| Japonês | help.example.com/ja-jp/getting-started |
Por causa disso, nenhuma página ou seção pode usar um código de idioma como seu endereço. Se uma usar, ao adicionar esse idioma, aparecerá: "Uma página ou seção já usa o endereço /de-de. Altere seu slug antes de adicionar este idioma."
Traduza seu conteúdo
Adicionar um idioma não traduz nada por si só. Cada tipo de conteúdo tem sua própria forma de entrada, e apenas a tradução por IA de páginas completas utiliza créditos.
| O que | Como traduzir | Custo |
|---|---|---|
| artigos | Abra a página em Páginas, escolha o menu Idioma na barra superior e, em seguida, Traduzir…. Cada idioma é uma cópia separada que você pode editar. Veja Editar um artigo. | Créditos, como qualquer tradução de artigo |
| Páginas do site | ⋯ → Traduzir para todos os idiomas… na barra superior da página. Veja Criar páginas do site. | Créditos, exibidos como IA para artigos |
| Títulos de página, títulos de menu e resumos | Detalhes → idiomas: escolha o idioma para editar ou clique em Traduzir do inglês | Gratuito |
| Títulos de seção | Traduzir título da seção ou Traduzir título… no menu da seção em Páginas | Gratuito |
| Rótulos de menu | Traduzir todos os rótulos em Navegação. Veja Configurar a navegação do site de documentação. | Gratuito |
| Título e subtítulo da página inicial | Outros idiomas → Traduzir para todos os idiomas sob cada campo em Aparência | Gratuito |
| Entradas do changelog | A própria ação de tradução da entrada. Veja Publicar um changelog do site de documentação. | Créditos |
As traduções gratuitas são limitadas a 60 solicitações por workspace por hora. Depois disso: "Você traduziu muito na última hora. Tente novamente em breve." O texto que você deixar vazio em um idioma exibirá o texto do idioma padrão: "Os vazios exibem o texto em inglês."
Nas configurações da página, cada idioma mostra o progresso, como "Em 2 de 3", com uma bandeira por idioma; uma bandeira cinza significa "não traduzido, os leitores veem em inglês".
Revisar traduções de IA de páginas do site
As traduções de IA de páginas do site são salvas como rascunhos até que alguém as marque como prontas, para que nada não verificado seja publicado. Para pular essa revisão, ative Publicar traduções de IA sem revisão em Configurações → Publicando. "Desativado: páginas do site traduzidas aguardam como rascunhos até que alguém as marque como prontas." Está desativado por padrão.
O que os leitores veem
- O cabeçalho tem um seletor de Idioma com todos os idiomas publicados.
- A mesma página em outro idioma abre no endereço correspondente, para que os leitores permaneçam na página que estavam lendo.
- Se uma página não tiver uma cópia no idioma do leitor, eles verão a versão no idioma padrão com "Esta página ainda não está disponível no seu idioma, por isso é exibida em inglês."
- Idiomas escritos da direita para a esquerda, como árabe e hebraico, são lidos da direita para a esquerda.
Se o seu plano mudar
Se o seu workspace mudar para um plano com menos idiomas, nada será excluído. Os idiomas que excederem o limite permanecerão nas suas configurações com seus artigos, mas não serão publicados: "Não publicado no seu plano: Italiano, Holandês. Eles permanecem aqui com seus artigos." Você não pode adicionar outro idioma até que esteja abaixo do limite ou faça um upgrade.
Solução de problemas
| Você vê | O que fazer |
|---|---|
| "Seu plano publica até 2 idiomas por site. O Starter inclui 5 idiomas." | Remova um idioma ou faça um upgrade. |
| "O idioma padrão deve ser um dos idiomas do site." | Adicione o idioma a idiomas antes de torná-lo o padrão. |
| "Uma página ou seção já usa o endereço /fr-fr. Altere seu slug antes de adicionar este idioma." | Renomeie o endereço dessa página ou seção primeiro. |
| "Nenhum artigo neste idioma ainda." | O artigo não tem cópia no idioma para o qual você mudou. Use Traduzir… no menu Idioma. |
| "Seu plano não publica este idioma. Faça um upgrade para traduzir para ele." | O idioma está acima do limite do seu plano. Faça um upgrade ou remova outro idioma. |
| "Escreva a página em inglês primeiro, depois traduza-a." | Uma página do site precisa de texto no idioma padrão antes de poder ser traduzida. |
| "Nenhuma tradução retornou. Tente novamente." | A tradução gratuita não retornou nada. Tente novamente em um momento. |