Tradução com IA
Ative os idiomas desejados e faça com que o Jamdesk traduza sua documentação após cada build, enviando as páginas traduzidas ao seu próprio repositório GitHub.
O Jamdesk pode traduzir sua documentação para você. Escolha os idiomas desejados nas configurações do projeto e, após cada build, o Jamdesk traduz suas páginas em inglês e envia os resultados ao seu próprio repositório GitHub, em diretórios com prefixo de idioma. As traduções são suas: ficam no seu repositório e no seu histórico do Git, e você pode editá-las como qualquer outro arquivo.
As capturas de tela mostram a interface em inglês.
Esta página é para quem quer que sua documentação seja lida em mais de um idioma sem contratar um serviço de tradução ou executar um script próprio. Para saber como funcionam a navegação por localidade e o seletor de idioma, consulte Suporte a vários idiomas — essa configuração se aplica independentemente de as traduções virem do Jamdesk, dos seus próprios tradutores ou de outra ferramenta.
Pré-requisitos
- Um repositório GitHub conectado ao projeto. As páginas traduzidas são enviadas de volta ao seu repositório, portanto um projeto implantado pela CLI ou a partir de um tarball não pode usar esse recurso.
- Acesso de gravação para o GitHub App do Jamdesk, para que ele possa criar esse commit. Se o acesso estiver faltando, o painel Translations informa isso e inclui um link para que um administrador do GitHub conceda a permissão. Essa é uma etapa única por conta do GitHub.
A tradução automática está incluída em todos os planos, inclusive nos períodos de avaliação. Não há cobrança por palavra nem créditos para comprar.
Ativar
Acesse seu projeto no dashboard do Jamdesk, abra Settings e role até Translations.
Ative Translate my documentation e marque os idiomas desejados. Cada um é listado pelo nome nativo, com o nome em inglês ao lado.
A tradução é executada depois que um build termina. Na primeira execução, todas as páginas são traduzidas e os arquivos traduzidos são enviados ao seu repositório, onde você pode revisá-los como qualquer outro commit.
Limites
Aplicam-se dois limites, ambos por projeto:
| Limite | Valor |
|---|---|
| Idiomas por projeto | Até 5 |
| Páginas traduzidas por mês | 10.000 |
Como somente as páginas alteradas são traduzidas novamente após a primeira execução, um site estável usa apenas uma pequena fração da cota mensal.
Somente o que mudou
Na primeira execução, tudo é traduzido. Depois disso, o Jamdesk traduz novamente apenas as páginas cuja fonte em inglês realmente mudou; assim, corrigir um erro de digitação em uma página custa uma página, e não o site inteiro.
Traduções que o Jamdesk não altera
Dois tipos de tradução são considerados escritos por você, e o Jamdesk nunca substitui nenhum deles por conta própria:
- Traduções que você já tinha. Se o seu repositório já contiver páginas traduzidas quando você ativar o recurso, o Jamdesk as adotará em vez de sobrescrevê-las. O trabalho que você fez ou contratou de um serviço de tradução é mantido exatamente como está.
- Traduções que você edita. Altere uma página traduzida manualmente e o Jamdesk perceberá, para que seu texto seja preservado em todas as execuções posteriores.
Ambas são registradas da mesma forma, e isso cria um bloqueio permanente: essas páginas nunca mais são traduzidas automaticamente, nem mesmo depois que a fonte em inglês mudar. Quando o inglês muda, elas aparecem no painel Translations em Edited by hand.
Cada página listada ali tem um botão Replace with AI translation. Ele devolve a página à IA — sua versão é descartada e a página é traduzida novamente no próximo build, portanto nada muda no momento em que você clica. Esse botão é a única forma de remover o bloqueio.
É por isso que "Somente o que mudou" não se aplica a essas páginas. Uma página traduzida pelo Jamdesk é atualizada quando sua fonte em inglês muda; uma página escrita ou editada por você espera que você solicite a atualização.
Desativar um idioma
Desmarcar um idioma impede que o Jamdesk faça traduções para ele. Nada é excluído: as páginas já enviadas permanecem no seu repositório, exatamente como estavam.