El copy de producto está listo para localizar cuando antes se ha unificado en una única fuente. El copy repartido por los componentes como literales no se puede dejar listo para localizar reescribiéndolo, porque no hay una fuente acordada que traducir. El trabajo de claridad, los glosarios y las guías de estilo importan, pero solo rinden cuando las cadenas viven en un único catálogo. Esta página es la secuencia, en el orden que funciona.
La mayoría de los consejos sobre este tema empiezan por el paso dos. Te dicen que escribas en lenguaje llano, que evites modismos y que des contexto a quien traduce. Todo es buen consejo y nada de eso se puede aplicar mientras el mismo mensaje exista en cinco formas ligeramente distintas repartidas por tus componentes. El trasfondo conceptual, y el argumento de por qué el codebase debería ser la fuente de verdad del copy de producto, están en copy de producto nativo del código. Esta página es el orden práctico de las operaciones.
¿Qué significa «listo para localizar»?
Significa que puedes pasarle tu copy a un traductor, o a una herramienta de traducción, y obtener una versión fiel sin que tenga que adivinar nada. Eso exige tres condiciones: que cada cadena exista en un único lugar acordado, que cada cadena diga una sola cosa con claridad y que quien la traduce sepa dónde y cómo se usa.
Las tres no son igual de fáciles de arreglar a posteriori. La redacción clara se puede mejorar cadena a cadena. El contexto se puede añadir como notas. Pero «un único lugar acordado» es estructural. Si falta, las otras dos no tienen nada estable a lo que engancharse: no puedes mejorar una cadena cuyo gemelo vive en otro archivo, ni anotar un mensaje que no tiene una dirección única.
¿Por qué el original limita la calidad de la traducción?
Porque la traducción es un trabajo derivado, y el trabajo derivado hereda todos los defectos de aquello de lo que deriva. Una traducción lleva la ambigüedad del original a cada idioma de destino, y la incoherencia también. Si el original dice «Sign in» en una pantalla, «Log in» en otra y «Login» en una tercera, ahora tienes tres términos en cada idioma, traducidos de forma independiente, sin forma de saber cuál es el pretendido.
Por eso mismo la solución habitual, pulir las traducciones, ataca el extremo equivocado. Cada idioma que añades multiplica el coste de un original sin arreglar. Arreglar el original una vez lo arregla en todas partes, incluidos los idiomas que aún no has añadido.
Hay un nombre para el fallo de fondo. El copy drift es el texto visible para el usuario que se desvía de su fuente aprobada entre superficies y con el paso del tiempo, sin una única fuente de verdad. Qué es el copy drift explica las causas. La localización es donde se vuelve caro, porque el drift se copia en cada idioma.
¿Por qué no se puede dejar listo para localizar un copy disperso?
Porque no hay nada que entregar. Un literal dentro de un componente no es una unidad que el paso de traducción pueda recoger. Está mezclado con markup y lógica, puede estar montado a partir de fragmentos, y la misma frase puede existir en varios archivos con pequeñas diferencias que nadie eligió.
Reescribir esos literales donde están no cambia eso. Puedes dejar cada uno más claro y seguir sin catálogo, sin una lista acordada de lo que dice el producto y sin forma de saber si los has encontrado todos. El resultado es un texto más ordenado en los mismos lugares dispersos.
Por tanto, el primer paso no es un trabajo de edición. Es un trabajo de recopilación: llevar todas las cadenas visibles para el usuario a un único catálogo, en un único idioma original, dentro del repositorio y referenciadas por clave desde los componentes. Hazlo sin cambiar la redacción. El objetivo de esta pasada es establecer qué dice hoy el producto, incluidas las partes que se contradicen entre sí.
¿Cómo recopilas las cadenas?
Muévelas primero a un catálogo y mejóralas después. Hay dos razones para ese orden. Una pasada mixta, en la que reescribes mientras mueves, oculta lo que ha cambiado tanto a quien revisa como a ti. Y cuando todo está en un único archivo, los duplicados y casi duplicados dejan de ser invisibles: quedan unos junto a otros y la limpieza se reduce a leer un archivo.
En la práctica:
- Elige un catálogo por idioma original, en el repo. Una copia de referencia que puedan leer tanto personas como herramientas. Cómo organizarlo y nombrar las claves se explica en cómo mantener el copy de la UI consistente en un codebase; es el mismo catálogo, así que esa página es la referencia de estructura y esta no la repite.
- Sustituye los literales por referencias a claves. Todas las cadenas que un usuario pueda leer, incluidas las etiquetas de botones, los mensajes de error, los estados vacíos, los tooltips y los textos de accesibilidad, que suelen ser los rezagados.
- Mantén las frases enteras. Si un mensaje se construye uniendo fragmentos, conviértelo en una sola entrada con variables, de modo que la unidad que ve quien traduce sea la unidad que lee el usuario. El orden de las palabras cambia entre idiomas, y una frase ensamblada en el código no puede adaptarse a él.
- No reescribas todavía. Resístete. Encontrarás cadenas torpes: anótalas y sigue.
Si esa lista te parece un mes de trabajo minucioso en un codebase grande, ese es el coste real del paso y la razón por la que es donde se atasca la mayoría de los equipos.
¿Qué haces cuando las cadenas ya están en un único catálogo?
Ahora el consejo de siempre por fin tiene algo sobre lo que actuar. Con un único catálogo, cada uno de estos puntos pasa de ser una búsqueda a ser una sola pasada:
- Elimina duplicados y casi duplicados. Elige la redacción aprobada de cada mensaje y haz que todos los usos apunten a ella.
- Fija los términos que nunca deben variar. Nombres de funcionalidades, los verbos de las acciones principales, las palabras que has decidido no usar. Escríbelos una sola vez. Ese es tu glosario, y es corto.
- Escribe con claridad. Voz activa, sin modismos, sin chistes que dependan del juego de palabras de un solo idioma, con las siglas desarrolladas donde puedan malinterpretarse. Cada cadena dice una sola cosa.
- Da contexto a quien traduce. Una nota sobre dónde aparece la cadena y qué representa una variable. Las cadenas cortas como «Post» u «Order» son la trampa clásica: ¿sustantivo o verbo? El idioma de destino puede necesitar una palabra distinta para cada uno.
- Deja margen de longitud. El texto traducido suele ser más largo que el original, así que diseña layouts que no se rompan cuando una etiqueta crece. Trátalo como una restricción de diseño, no como una cifra con la que planificar.
Cada paso es rápido porque el catálogo es el único lugar donde ocurre. Sin catálogo, esos mismos cinco pasos son cinco cazas del tesoro por el codebase, y nunca sabes cuándo has terminado.
¿Qué debes decidir antes de elegir proveedor o herramienta de traducción?
El original y el flujo de revisión. Un proveedor o una herramienta traduce lo que le des. Dale un catálogo limpio y un glosario corto y podrá hacer un buen trabajo. Dale literales dispersos y pagarás por traducir las incoherencias y luego volverás a pagar por corregirlas en cada idioma.
Decide primero tres cosas. Qué archivo es la fuente de verdad. Quién aprueba un cambio de redacción. Y cómo llega a traducción una cadena nueva o modificada: a mano, con un script o mediante una pull request que llega con las traducciones incluidas. Lo último es lo que evita que las traducciones se queden atrás respecto al original, el problema que se describe en por qué los archivos de traducción se desincronizan.
¿Qué cambia cuando el copy ya vive en el repositorio?
La localización deja de ser un proyecto aparte. Cuando el catálogo está en el repo, una cadena nueva o modificada aparece como una línea en un diff, sus traducciones se pueden generar y revisar con el mismo flujo de pull request que el código, y nadie tiene que exportar una hoja de cálculo y confiar en que vuelva en orden.
Por eso, en un codebase, mantener el copy consistente y mantenerlo listo para localizar son la misma operación. Ambas dependen de una única fuente acordada. Haces el trabajo una vez y obtienes las dos cosas. Los equipos que construyen con herramientas de programación con IA lo notan antes, porque un agente reescribirá sin avisar o reintroducirá un literal salvo que se lo impidan el catálogo y una regla de lint; cómo evitar que los agentes de programación con IA reescriban el copy de tu UI cubre ese caso.
Dónde encaja globalize.now
globalize.now es un sistema de gestión de copy nativo del código con la localización integrada, y el paso de unificación en una única fuente descrito arriba es la parte que hace por ti. Conectas un repositorio de GitHub o GitLab en la app. Un escaneo detecta lo que hay. Si las cadenas son literales dentro de componentes, una conversión única las mueve a claves en un catálogo y añade la configuración de i18n si no la hay; si ya usas una biblioteca como next-intl, react-i18next, i18next o Lingui, trabaja con lo que tienes. El resultado llega como una pull request en su propia branch, de modo que el primer catálogo pasa exactamente por la revisión descrita arriba. A partir de ahí, las cadenas nuevas del original que añadas se traducen mediante push jobs que abren una pull request con el resultado. El repositorio sigue siendo la única fuente de verdad, y la guía para proyectos con i18n existente explica qué encuentra el escaneo cuando ya hay una configuración.
Trabajamos para que esa misma disciplina se mantenga en la web de marketing, la landing page y el producto desde una única fuente. Es hacia donde vamos, no algo que puedas contratar hoy. Los precios están en la página de precios.
El orden, en resumen
- Reúne todas las cadenas visibles para el usuario en un único catálogo dentro del repositorio. No reescribas.
- Mantén las frases enteras y referencia cada cadena por clave.
- Elimina duplicados y elige la redacción aprobada una sola vez.
- Escribe el glosario corto de los términos que nunca varían.
- Edita para que el lenguaje sea llano y añade notas de contexto para quien traduce.
- Decide quién aprueba la redacción y cómo llegan a traducción las cadenas modificadas.
- Solo entonces elige, o cambia, el proveedor o la herramienta de traducción.
Si el primer paso es el que parece un mes de trabajo, conecta un repositorio, lee el plan que propone y revisa la pull request que abre.
globalize.now convierte el texto codificado de tu app en archivos de traducción listos para localizar y los mantiene actualizados en cada despliegue.
Prueba globalize.now gratis