Flujo de trabajo de la aplicación
Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →
Si bien nuestra guía de Instalación te ayuda a comenzar, este documento te muestra cómo podría ser tu flujo diario de traducción.
Existen dos tipos de herramientas y servicios de traducción:
-
Herramientas que funcionan localmente en tu computadora, como tu IDE.
-
Servicios de traducción en la nube que requieren cargar tus archivos de traducción. Estos necesitan un flujo de trabajo complejo con canalización de traducción.
Esta guía te mostrará cómo trabajar con ambos tipos de herramientas.
Flujo de trabajo simple con herramienta de traducción local
projectRoot
|-- src
| |-- App.js
|-- extracted
| |-- en.json
|-- lang
| |-- fr.json
| |-- de.json
|-- package.json
|-- .eslintrc.js
Los archivos de traducción extraídos residen en la carpeta extracted porque tienen estructura interna diferente (ej. contienen información adicional como comentarios). Los archivos traducidos se almacenan en la carpeta lang.
El flujo de trabajo
El proceso es el siguiente:
-
Extracción: Agrupa todos los
defaultMessageen un archivo JSON condescription, listo para traducción. -
Edición: Modifica las traducciones y guarda cuando termines.
-
Los cambios aparecen inmediatamente en tu compilación.
Flujo de trabajo complejo con servicio de traducción en la nube
Estructura del proyecto
Un proyecto mínimo compatible con i18n puede tener esta estructura:
projectRoot
|-- src
| |-- App.js
|-- lang
| |-- en-US.json
| |-- fr.json
|-- package.json
|-- .eslintrc.js
donde la carpeta lang almacena los archivos de cadenas traducidas. La integración con proveedores de traducción consume en-US.json y genera fr.json u otros archivos de localización.
Canalización
Una canalización de traducción típica se ve así:
-
Extracción: Agrupa todos los
defaultMessageen un archivo JSON condescription, listo para traducción. -
Carga de mensajes: Sube el archivo JSON a tu proveedor de traducción.
-
Descarga de traducciones: Consulta periódicamente o integra con tu proveedor para descargar traducciones en los idiomas configurados.
-
Confirmación: Integra las traducciones en tu base de código.
Dónde encaja FormatJS
El objetivo no es resolver toda la canalización, sino mejorar la Experiencia del Desarrollador con herramientas y buenas prácticas para crear conciencia i18n, incluyendo:
-
Declaración de mensajes compatibles con i18n
-
Linter que aplica estos mensajes
-
CLI para extracción y compilación
-
Polyfills para entornos de ejecución i18n estables
-
Plugin de bundler para compilar TypeScript/JavaScript