Traduzir Markdown é fácil até você ter duzentas páginas. Aí, as palavras não são o problema. O desafio está em tudo ao redor: o código que não pode mudar, os links que precisam continuar funcionando e a próxima versão, que acrescenta mais dez páginas.
Este guia é para sites de documentação, READMEs, changelogs e pastas de blog escritos em Markdown ou MDX.
Qual opção você deve usar?
| Ideal para | Limitações | |
|---|---|---|
| AI Glot | Uma pasta de documentação, vários idiomas, um glossário que precisa ser respeitado e cada nova versão | Não é necessário para um parágrafo curto de README |
| Uma plataforma de gerenciamento de traduções (Crowdin, Lokalise, Phrase) | Uma equipe com fluxo de trabalho contínuo, revisores e conexão com um repositório | É preciso configurar um projeto e conectar o repositório antes de traduzir a primeira página |
| DeepL | Os documentos listados: Word, PowerPoint, Excel, PDF, HTML, texto e outros | Markdown não está na lista, então você precisa colar o texto ou converter o arquivo antes |
| ChatGPT, Claude ou outro assistente | Uma página curta | Você cola cada página e leva seu glossário para cada conversa. É preciso verificar se o código ou os links mudaram em cada página, e uma pasta de documentação extensa consome seu limite de uso |
| Um freelancer ou uma agência | A landing page e a página de preços | O processo é lento, o preço é por palavra e você ainda precisa preparar os arquivos |
Peça a uma pessoa para ler a página que vende o produto. Traduza a documentação de referência com um mecanismo, porque é nela que está o volume.
Por que o AI Glot é ideal para uma pasta de documentação
- O conteúdo entra; a estrutura fica intacta. Títulos, parágrafos, itens de lista e células de tabela são texto. O código, os destinos dos links, os blocos HTML e os separadores de tabela são mantidos como estão.
- A formatação acompanha as palavras. Negrito, itálico e texto dos links acompanham as palavras a que pertencem.
- Um glossário para todo o site de documentação. Os nomes dos produtos e os termos da API ficam consistentes em todas as páginas e na próxima versão.
- Um plano antes de qualquer gasto. Ele lista o que foi encontrado e o que será traduzido.
- Uma pasta em uma única tarefa. Coloque os arquivos em um ZIP e a estrutura será reconstruída.
O fluxo de um arquivo
- 1UploadUm arquivo .md ou .mdx, ou um ZIPAté 4 MB cada
- 2Diga o que você precisaUma frase simplesGrátis
- 3Leia o planoO que foi encontrado, idiomas, custoGrátis
- 4AprovarA única etapa com custoConsome créditos
- 5BaixarMarkdown traduzidoÉ só enviar
O que muda em uma página
Só o texto é alterado. O código, o link e as chaves do front matter permanecem iguais.
---title: Install the CLItitle: Installer la CLIslug: install---Run `npm install -g tool` and read the [guide](/pt/docs/setup).Lancez `npm install -g tool` et lisez le [guide](/pt/docs/setup).O que conferir no MDX
Imports, tags de componentes e expressões permanecem intactos. Assim, a página continua sendo compilada. O ponto de atenção é o texto passado a um componente como prop, por exemplo, um título enviado a um card. Ele pertence ao componente, não ao texto corrido. Por isso, confira essas poucas strings depois.
Âncoras de títulos. Se o seu site cria uma âncora com base no texto do título, um título traduzido gera uma nova âncora. Confira os links que apontam para um título, como a seção de instalação.
Como fazer, passo a passo
1. Experimente um arquivo grátis. O tradutor de Markdown não exige conta e aceita arquivos de até 2 MB e 5,000 palavras.
2. Envie o arquivo ou um ZIP da pasta no app.
3. Diga em uma frase o que você precisa.
Translate this folder into French.
Translate the prose and the front matter title and description.
Leave every other front matter field as it is.A frase define o que será traduzido em toda a pasta. Uma regra de redação, como “mantenha os nomes de produtos e termos de API em inglês”, deve ser incluída no segundo campo durante a aprovação, porque ela se aplica a cada parágrafo conforme ele é escrito.
4. Adicione um glossário com nomes de produtos, termos de API e palavras que você sempre usa da mesma forma. Veja como criar um.
5. Confira o plano e escolha um nível de qualidade.
Lite oferece cerca de três vezes mais palavras por crédito e é mais rápido: ideal para atualizar em lote a documentação de referência. Standard é indicado para a landing page. Um crédito equivale a uma palavra no Standard.
6. Aprove e baixe.
Uma pasta de documentação, vários idiomas
Os números são um exemplo. Um arquivo Markdown contém um idioma, então cada idioma corresponde a uma cópia traduzida da pasta.
Três maneiras de usar
Pela linha de comando é a melhor opção para um repositório de documentação, porque as mesmas quatro etapas podem ser executadas em um script ou no CI sempre que o inglês mudar:
id=$(aiglot batches create docs.zip \
--instruction "Translate into French. Translate the prose and the front matter title and description." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep product names and API terms in English."
aiglot batches download "$id" --output docs_fr.zipCom seu agente de IA: conecte o AI Glot como um servidor MCP. O agente pode ler seu repositório, sugerir os termos que encontrar para o glossário, executar o trabalho e devolver os arquivos ao lugar.
No aplicativo: envie, clique, baixe. Ideal para uma única página.
Para integrar via API, consulte a documentação da API.
Confira o resultado
Gere o site de documentação em um idioma traduzido e abra três páginas: uma com código, uma com uma tabela e outra com um link para outra página. Execute seu verificador de links habitual, porque é aí que uma alteração de âncora aparece. Mantenha os arquivos em inglês até que alguém que leia o idioma tenha conferido as páginas mais importantes.
Preços mostra quanto custa um volume maior, e uma conta gratuita vem com créditos para você executar uma pasta de verdade.
Os limites informados aqui são os que estavam em vigor quando este texto foi escrito: 4 MB por arquivo Markdown, 200 arquivos e 20 MB por ZIP, além de 2 MB e 5,000 palavras na ferramenta gratuita. A lista da DeepL vem da documentação da própria empresa. Os nomes dos arquivos e a quantidade de páginas nos diagramas são exemplos. Seu plano mostra os valores reais para seus arquivos, e a consulta é gratuita.