Traduza a documentação do Docusaurus para outro idioma, mantendo MDX e código intactos
Compacte sua pasta de documentação em .zip, envie os arquivos e receba tudo traduzido, pronto para colocar em i18n/<locale>/docusaurus-plugin-content-docs/current. Linhas de import, Tabs e outros componentes, marcadores de avisos, blocos de código e links permanecem inalterados; títulos, rótulos da barra lateral, descrições e o texto corrido são traduzidos. A primeira parte é grátis e sem cadastro; até 1,000,000 caracteres de texto custam $5 em pagamento único.
- Linhas de import e export e componentes JSX copiados exatamente como estão
- Marcadores de aviso (:::note, :::tip) preservados; o texto interno é traduzido
- Front matter: title, description e sidebar_label traduzidos; id, slug e sidebar_position preservados
- Âncoras de cabeçalho como {#install} mantidas para os links continuarem funcionando
- A mesma estrutura de pastas de volta em .zip; imagens copiadas sem alterações
i18n no Docusaurus sem o copia e cola
O Docusaurus exige uma cópia traduzida de cada documento na pasta do idioma com os mesmos nomes de arquivo. Fazer isso manualmente ou arquivo por arquivo em um chatbot é demorado, e no MDX qualquer errinho custa caro: um nome de import traduzido ou uma propriedade alterada quebra o build. Esta ferramenta traduz apenas as partes visíveis para os leitores e copia todo o resto exatamente como está nos seus arquivos.
Códigos em linha, destinos de links, caminhos de imagens e {expressões} MDX são substituídos por marcadores antes da tradução e restaurados depois, para que o modelo nunca encoste neles. Linhas puramente em JSX, como <Tabs> ou <TabItem value="mac">, são ignoradas. Blocos de código são ignorados por completo, inclusive seus comentários.
Depois de baixar
- Descompacte o arquivo e copie o conteúdo da pasta docs-<locale> para i18n/<locale>/docusaurus-plugin-content-docs/current
- Execute docusaurus write-translations para rótulos do tema e nomes de categorias da barra lateral, que ficam em arquivos JSON
- Inicie o site com --locale <locale> e navegue pelas páginas para conferir
- Corrija os parágrafos listados no arquivo de avisos, se houver
O que não está incluso
Rótulos de categorias da barra lateral e textos do menu de navegação e rodapé ficam em arquivos JSON gerados pelo write-translations; traduza esses arquivos com a ferramenta Tradutor de arquivos de localização. Artigos de blog funcionam do mesmo jeito que a documentação: compacte a pasta blog em .zip e envie em uma segunda tarefa, ou junte com a pasta docs em um único .zip.
Como a ferramenta funciona, quanto custa e como seus arquivos são tratados está na página Traduzir documentação em Markdown; os preços de todas as ferramentas estão na página de preços.
Última atualização:
Perguntas e respostas
O build vai continuar passando?
Imports, componentes, props, código e destinos de links são copiados direto dos seus arquivos — que é onde os builds de MDX costumam quebrar. Rode o build uma vez depois de copiar e confira o arquivo de avisos.
Os avisos (admonitions) são traduzidos?
As linhas :::note e ::: são mantidas exatamente como escritas; apenas o texto entre elas é traduzido.
Qual é o limite de uma tarefa?
Até 1,000,000 caracteres de texto, cerca de 300 páginas, por $5. Códigos e chaves do front matter não contam nesse limite.
Posso testar alguns arquivos antes?
Sim. A primeira parte é traduzida de graça e exibida na tela; uma tarefa de até 40 parágrafos é totalmente grátis.