Pular para o conteúdo
Central de Ajuda Clevera

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.

Atualizado 6 min de leitura

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

  1. Abra as configurações do site

    Abra seu site de documentação e vá para Configurações → Geral.

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

    Configurações, Geral: nome do site, endereço, idiomas Inglês (EUA) padrão e Espanhol, idioma padrão e fuso horário
    A configuração de Idiomas em Configurações, Geral
  3. 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.

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