Jamdesk Documentation logo

Tradução com IA

O Jamdesk traduz sua documentação para os idiomas escolhidos após cada build e envia as páginas ao seu repositório do GitHub automaticamente.

O Jamdesk pode traduzir sua documentação para você. Escolha os idiomas nas configurações do projeto. Depois de cada build, o Jamdesk traduz suas páginas em inglês e envia os resultados ao seu repositório do GitHub, em diretórios com prefixo de idioma. As traduções são suas. Elas ficam no seu repositório e no seu histórico do Git. Edite-as como qualquer outro arquivo.

As capturas de tela mostram a interface em inglês.

Para a navegação por idioma e o seletor de idiomas, consulte Suporte a múltiplos idiomas. Essa configuração vale independentemente de as traduções virem do Jamdesk, de tradutores próprios ou de outra ferramenta.

Pré-requisitos

  • Um repositório do GitHub conectado ao projeto. As páginas traduzidas são enviadas de volta ao seu repositório. Um projeto implantado pela CLI ou por um tarball não pode usar este recurso.
  • Acesso de escrita para o GitHub App do Jamdesk, para fazer esse envio. O painel de Traduções sinaliza a falta de acesso e vincula um administrador do GitHub para concedê-lo. É uma etapa única por conta do GitHub.

Todos os planos incluem tradução automática, inclusive os períodos de teste. Não há cobrança por palavra nem créditos para comprar.

Ativar

1
Abra o painel de Traduções

Acesse seu projeto no painel do Jamdesk, abra Settings e role até Translations.

2
Escolha seus idiomas

Ative Translate my documentation e marque os idiomas desejados. Cada um aparece pelo nome nativo, com o nome em inglês ao lado.

O painel de Traduções nas configurações do projeto. Um botão Translate my documentation está ativado, acima de uma lista de duas colunas com caixas de seleção. Chinês simplificado, português, alemão e italiano estão selecionados. Cada idioma aparece pelo nome nativo, com o nome em inglês ao lado.
3
Faça o build

A tradução é executada após a conclusão de um build. A primeira execução traduz todas as páginas e envia os arquivos ao seu repositório. Revise-os como qualquer outro commit.

Limites

Os limites são por projeto:

LimiteValor
Idiomas por projetoAté 5
Páginas traduzidas por mês10.000

Somente o que mudou

A primeira execução traduz tudo. As execuções seguintes retraduzem apenas as páginas cujo original em inglês mudou. Corrigir um erro de digitação em uma página consome o uso de uma página, não do site inteiro. Um site estável usa uma pequena fração da cota mensal.

Traduções que o Jamdesk deixa intactas

O Jamdesk trata dois tipos de tradução como escritas por você. Ele nunca as substitui por conta própria:

  • Traduções que você já tinha. Ao ativar o recurso, o Jamdesk adota as páginas traduzidas que já estão no seu repositório. Ele não as sobrescreve. O trabalho que você escreveu ou pagou a um fornecedor permanece como está.
  • Traduções que você edita. O Jamdesk detecta quando você altera manualmente uma página traduzida. Sua redação é mantida em todas as execuções seguintes.

Essas páginas ficam em espera permanente. Nunca são traduzidas novamente automaticamente, mesmo depois que o original em inglês muda. Elas aparecem no painel de Traduções sob Edited by hand quando o original em inglês muda.

Cada página listada ali tem um botão Replace with AI translation. Ele devolve a página à IA. Sua versão é descartada. A página é traduzida novamente no próximo build, e não no momento em que você clica. Esse botão é a única forma de encerrar a espera.

"Apenas o que mudou" não se aplica a essas páginas. Uma página que o Jamdesk traduziu é atualizada quando seu original em inglês muda. Uma página que você escreveu ou editou aguarda até que você peça.

Os títulos traduzidos recebem âncoras próprias, então /de/setup/languages#… usa o título em alemão. O Jamdesk mantém essas âncoras estáveis:

  • Uma página retraduzida mantém a redação dos títulos que você não alterou. Se você adicionar ou renomear um título em inglês, apenas esse título é traduzido de novo. Os links de outras páginas para o restante da página continuam apontando para o mesmo lugar.
  • Páginas que você escreveu ou editou têm suas âncoras quebradas corrigidas. Se uma dessas páginas linkar para um título cuja âncora mudou, o Jamdesk atualiza a parte do link após o #. Nada mais na sua página é alterado.

Desativar um idioma

Desmarque um idioma para parar de traduzir para ele. Nada é apagado. As páginas já enviadas permanecem inalteradas no seu repositório.

O que vem a seguir?

Suporte a múltiplos idiomas

Navegação por idioma, seletor de idiomas e estilos RTL

Conectar o GitHub

Instale o GitHub App e conceda o acesso necessário para a tradução