Traduce la documentación de Docusaurus a otro idioma sin tocar MDX ni código
Comprime tu carpeta docs en un archivo ZIP, súbela y recibe los mismos archivos traducidos, listos para colocar en i18n/<locale>/docusaurus-plugin-content-docs/current. Las líneas de import, los componentes como Tabs, las etiquetas de avisos, los bloques de código y los enlaces se quedan como están; se traducen los títulos, las etiquetas de la barra lateral, las descripciones y el texto. La primera parte es gratis sin registro; hasta 1,000,000 caracteres de texto por $5 en un pago único.
- Líneas de import y export y componentes JSX copiados tal cual
- Etiquetas de avisos (:::note, :::tip) conservadas; el texto del interior se traduce
- Front matter: title, description y sidebar_label traducidos; id, slug y sidebar_position conservados
- Anclas de encabezados como {#install} conservadas para que los enlaces sigan funcionando
- Misma estructura de carpetas en un .zip; imágenes copiadas sin cambios
Docusaurus i18n sin copiar y pegar
Docusaurus espera una copia traducida de cada documento en la carpeta de idioma, con los mismos nombres de archivo. Hacerlo a mano o archivo por archivo con un chatbot es lento, y con MDX los errores salen caros: un nombre de import traducido o una prop modificada rompen la compilación. Esta herramienta traduce únicamente lo que ven los lectores y copia todo lo demás de tus archivos.
El código en línea, los destinos de enlaces, las rutas de imágenes y las {expresiones} MDX se reemplazan por marcadores antes de traducir y se restauran después, de modo que el modelo nunca los ve. Las líneas que son solo JSX, como <Tabs> o <TabItem value="mac">, se omiten. Los bloques de código se omiten por completo, incluidos sus comentarios.
Después de la descarga
- Descomprime y copia el contenido de la carpeta docs-<locale> en i18n/<locale>/docusaurus-plugin-content-docs/current
- Ejecuta docusaurus write-translations para las etiquetas del tema y los nombres de categorías de la barra lateral, que se guardan en archivos JSON
- Inicia el sitio con --locale <locale> y navega para comprobarlo
- Corrige los párrafos indicados en el archivo de advertencias, si lo hubiera
No incluido
Las etiquetas de categorías de la barra lateral y los textos de la barra de navegación y del pie de página están en archivos JSON generados por write-translations; puedes traducirlos con la herramienta para traducir archivos de localización. Las entradas del blog funcionan igual que la documentación: comprime la carpeta del blog en un ZIP y súbela como un segundo trabajo, o junto con docs en un único archivo .zip.
Cómo funciona la herramienta, cuánto cuesta y cómo se tratan tus archivos está en la página de Traducir documentación Markdown; los precios de todas las herramientas están en la página de precios.
Última actualización:
Preguntas y respuestas
¿Seguirá compilando sin errores?
Los imports, componentes, props, código y destinos de enlaces se copian directamente de tus archivos, que es donde suelen fallar las compilaciones de MDX. Compila una vez después de copiar y revisa el archivo de advertencias.
¿Se traducen los avisos (admonitions)?
Las líneas con :::note y ::: se conservan tal cual; el texto entre ellas sí se traduce.
¿Cuánto cabe en un solo trabajo?
Hasta 1,000,000 caracteres de texto (unas 300 páginas) por $5. El código y las claves del front matter no cuentan.
¿Puedo probar primero con algunos archivos?
Sí. La primera parte se traduce gratis y se muestra en pantalla; un trabajo de hasta 40 párrafos es completamente gratis.