PTC
Registrarse Pasar a Pro Su cuenta

Cómo preparar un archivo CSV para su traducción

Un CSV que se traduce sin problemas tiene claves estables, columnas de texto de origen claras y una codificación UTF-8 correcta. Esta guía cubre cada paso de la preparación. Una vez que su CSV esté listo, puede traducirlo en 3 pasos en PTC (Private Translation Cloud). Para obtener una visión general del servicio de CSV independiente, consulte traducir archivos CSV online con IA.

El formato CSV es el mínimo común denominador en traducción. Todas las herramientas de hojas de cálculo, plataformas de comercio electrónico y exportaciones de analítica admiten CSV. Esa flexibilidad es un arma de doble filo. Un CSV que “se ve bien” en Excel puede ser imposible de traducir limpiamente debido a la ambigüedad de las columnas, la falta de claves o problemas de codificación. Esta guía explica qué hace que un CSV esté listo para producción.

Cómo es un CSV listo para traducción

Un CSV listo para traducción es aquel donde:

  • Cada cadena traducible tiene una clave única y estable.
  • La columna del idioma de origen está claramente identificada.
  • Las columnas del idioma de destino ya existen (una columna por idioma) o se genera un CSV por cada idioma de destino.
  • Las columnas de identificación (SKU, ID, URL de imagen, precio) son obviamente no traducibles.
  • El archivo es un UTF-8 válido sin ambigüedad de codificación.

Dos estructuras comunes:

Formato ancho (una columna por idioma):

key,en,es,fr,de
welcome,Welcome,,,
cart.empty,Your cart is empty,,,
cart.items_one,"You have %{count} item",,,

Formato largo (una fila por cadena, un archivo por idioma):

key,source
welcome,Welcome
cart.empty,Your cart is empty
cart.items_one,"You have %{count} item"

Ambos funcionan. PTC lee cualquiera de los dos. Elija el que mejor se adapte a su flujo de trabajo actual.

Elija columnas que los traductores y PTC puedan leer

Haga que la primera fila sea el encabezado. Use nombres de columna descriptivos y sencillos como key, source_text y context. Así, su herramienta de traducción y cualquier revisor humano sabrán exactamente qué contiene cada columna.

Columnas obligatorias. Todo CSV listo para traducción necesita, como mínimo, una columna key y una columna de texto de origen.

  • La columna key contiene un identificador único para cada cadena. Su aplicación lo utiliza para encontrar la traducción correcta en tiempo de ejecución. Use una convención de nomenclatura coherente: solo letras minúsculas, guiones bajos y puntos. Formatos comunes: button.submit, error.invalid_login, onboarding.welcome_message. Nunca cambie una clave después de haber comenzado la traducción. Cambiar una clave crea una cadena nueva y deja huérfana la traducción existente.
  • La columna de texto de origen contiene el texto original en su idioma base.

Opcional pero útil: una columna context. Las cadenas cortas como “Guardar” o “Atrás” pueden significar cosas diferentes según el lugar de la interfaz donde aparezcan. Una nota breve indica al traductor (o a la IA) para qué sirve la cadena:

key,source_text,context
button.save,Save,Document editor toolbar
checkout.button.save,Save,Checkout address form

Para archivos grandes, una columna namespace o group le ayuda a organizar las cadenas por funcionalidad o sección.

Columnas de idioma. Si su flujo de trabajo mantiene el origen y el destino en el mismo archivo, añada una columna por idioma de destino usando códigos de local (locale) como encabezado. Use es_ES para español (España), fr_FR para francés (Francia), pt_BR para portugués (Brasil).

Use claves con puntos para la jerarquía. cart.items.one y cart.items.other se agrupan de forma natural. Evite los espacios en las claves.

Mantenga separadas las columnas de identificación. Si su CSV es un catálogo de productos, las columnas sku, handle, price e image_url deberían ser obviamente no traducibles solo por sus nombres. No las oculte en una columna genérica de metadata.

Un CSV por cada ámbito lógico. No mezcle cadenas de la interfaz de administración con textos de marketing en el mismo archivo. Los diferentes ámbitos tienen tonos distintos. La voz de marca de PTC funciona mejor cuando cada proyecto cubre un conjunto coherente de cadenas.

Marque los marcadores de posición para que PTC los preserve en todos los idiomas

Los marcadores de posición son tokens dentro de una cadena que se sustituyen en tiempo de ejecución: %s, %d, {name}, {{count}}, %{currency}. PTC preserva los marcadores de posición íntegramente y nunca traduce el token en sí.

key,source_text
greeting,"Hello, %{name}!"
cart.total,"Total: %{currency}%{amount}"
notification,"You have %{count} new messages"

Convenciones que PTC reconoce desde el primer momento:

  • %s, %d, %f, %1$s, %2$d: estilo printf (gettext, Rails, Java).
  • {name}, {count}, {0}: str.format de Python, .NET, sintaxis de índice ICU.
  • {{name}}, {{count}}: i18next, Mustache, Handlebars.
  • %{name}, %{count}: Rails I18n, Ruby.

Si su texto de origen incluye etiquetas HTML (<strong>, <br>, <a href="">), trátelas de la misma manera que los marcadores de posición. PTC las detecta y las preserva en todos los formatos, en la posición correcta en cada idioma de destino. Nunca traduzca la etiqueta en sí.

Si utiliza una convención personalizada (por ejemplo, [[token]]), declárela en el glosario del proyecto de PTC y PTC la respetará en cada fila.

Codifique las formas plurales como filas separadas para que cada idioma reciba las formas correctas

La mayoría de los idiomas tienen más de dos formas plurales. Muchos tienen reglas que ningún angloparlante podría predecir. El polaco tiene one / few / many / other. El árabe tiene seis formas. El japonés tiene una (no distingue plurales). Una herramienta de traducción que solo almacene singular y plural producirá resultados incorrectos para estos idiomas.

Codifique los plurales como filas separadas con una convención de sufijos:

key,source_text,context
cart.items.zero,Your cart is empty,Zero state
cart.items.one,"You have {count} item in your cart.",Singular: count = 1
cart.items.other,"You have {count} items in your cart.",Plural: count > 1

PTC lee los sufijos .zero, .one, .few, .many y .other (categorías de plural de CLDR) y genera las categorías de plural adecuadas para cada idioma de destino.

No combine formas plurales en una sola cadena con barras o paréntesis, como "Tiene {count} artículo(s) en su carrito.". Ese enfoque no es traducible y rompe la gramática de la mayoría de los idiomas.

Escape los caracteres especiales para que el procesador de CSV no rompa las filas

Reglas de escape de CSV (RFC 4180):

  • Comas dentro de un campo: envuelva el campo entre comillas dobles; de lo contrario, el procesador dividirá su cadena en varias celdas.
key,source_text
intro,"Welcome to our store, where every product matters"
  • Comillas dobles literales: escápelas duplicándolas.
key,source_text
quote,"He said ""hello"" and waved"
  • Saltos de línea dentro de un campo: están permitidos si el campo está entre comillas.
key,source_text
address,"123 Main Street
Springfield, IL 62701"
  • Comillas tipográficas: use siempre comillas rectas (") en lugar de comillas tipográficas o rizadas (“ ”). Los procesadores de CSV no reconocen las comillas tipográficas y darán errores de formato.
  • Espacios finales: elimínelos de todas las celdas antes de enviar el archivo. Son invisibles en la mayoría de los editores de hojas de cálculo, pero provocan fallos de coincidencia de cadenas en su aplicación.

Para HTML o marcado dentro de una celda, ponga el campo entre comillas y deje que PTC traduzca solo el texto:

key,source_text
disclaimer,"<p>By signing up, you agree to our <a href=""/terms"">terms</a>.</p>"

PTC analiza el HTML, traduce solo el texto legible por humanos y preserva cada etiqueta, atributo y URL.

Guarde como UTF-8 para evitar caracteres acentuados dañados

La codificación es la causa más común de problemas en la traducción de CSV. Sin UTF-8, los caracteres que no pertenecen al alfabeto latino básico pueden mostrarse como ???, cuadros vacíos o texto ininteligible en su aplicación.

  • Guarde su CSV como UTF-8 (con o sin BOM). La mayoría de las herramientas modernas lo hacen por defecto. Históricamente, Excel en Windows no lo hacía.
  • No use codificación Windows-1252, ISO-8859-1 o “ANSI”. Los caracteres acentuados en los idiomas de destino se corromperán.
  • Si no está seguro, abra el CSV en un editor de texto como VS Code o Notepad++ y compruebe el indicador de codificación. Vuelva a guardarlo como UTF-8 si es necesario.

Guía específica para Excel:

  • Excel para Mac usa UTF-8 por defecto. No es necesario realizar ninguna acción.
  • Excel para Windows: elija Archivo > Guardar como y seleccione CSV UTF-8 (delimitado por comas) (*.csv) en el desplegable de formato. No elija simplemente “CSV (delimitado por comas)”.
  • Google Sheets: Archivo > Descargar > Valores separados por comas (.csv). Es UTF-8 por defecto.

Para archivos CSV de origen que ya tengan una codificación incorrecta, conviértalos con iconv:

iconv -f WINDOWS-1252 -t UTF-8 source.csv > source-utf8.csv

Ejemplo práctico: un CSV de comercio electrónico completo que PTC traduce sin preparación previa

Un CSV completo y bien preparado para un sitio de comercio electrónico:

key,source_text,context
header.welcome,"Welcome to {{shopName}}",Top of page
header.cart.zero,"Your cart is empty",Cart icon - zero state
header.cart.one,"{count} item in cart",Cart icon - singular
header.cart.other,"{count} items in cart",Cart icon - plural
product.add_to_cart,"Add to Cart",Product page CTA
product.out_of_stock,"Out of Stock",Product availability badge
product.price,"{currency}{amount}",Price display
checkout.shipping,"Shipping address",Checkout step heading
checkout.payment,"Payment method",Checkout step heading
checkout.confirm,"Place Order",Final checkout button
errors.email.required,"Email is required",Form validation
errors.email.invalid,"Please enter a valid email address",Form validation
errors.card.declined,"Your card was declined. Please try a different payment method.",Checkout error
promo.tagline,"Sale ends Sunday, grab your deal!",Promo banner - contains comma
tooltip.save,"Click ""Save"" to keep your changes.",Tooltip - contains quotes
disclaimer,"<p>By placing this order, you agree to our <a href=""/terms"">terms and conditions</a>.</p>",Footer legal

Este archivo:

  • Tiene columnas key, source_text y context claras.
  • Utiliza claves jerárquicas con puntos.
  • Gestiona marcadores de posición ({{shopName}}, {count}, {currency}, {amount}).
  • Gestiona plurales con sufijos .zero / .one / .other.
  • Escapa el HTML y las comillas correctamente.
  • Está guardado como UTF-8.

PTC traduce esto directamente. Sin más preparación que la mostrada.

Lista de mejores prácticas para la traducción de CSV

  • Use una herramienta de traducción dedicada. Evite traducir archivos CSV manualmente en un editor de texto o en una hoja de cálculo. Las herramientas dedicadas como PTC preservan la estructura de su archivo, gestionan correctamente los marcadores de posición y mantienen sus claves intactas.
  • Use comas estándar como delimitador. Algunas herramientas usan puntos y coma por defecto. Las comas son las más compatibles y las que menos probabilidades tienen de causar errores de importación.
  • Mantenga una cadena por fila. Combinar varias cadenas en una sola fila hace que las traducciones sean inmanejables y rompe la mayoría de las herramientas de traducción.
  • Aísle las columnas traducibles. Mantenga las columnas que necesitan traducción separadas de las columnas que deben permanecer sin cambios (ID numéricos, SKU, parámetros técnicos). Esto reduce el riesgo de que una herramienta o un traductor modifiquen accidentalmente datos que deben permanecer intactos.
  • Evite las celdas combinadas y el formato de hoja de cálculo. El CSV es texto plano. Cualquier formato aplicado a través de un software de hojas de cálculo se elimina cuando se procesa el archivo.
  • Elimine las columnas y metadatos innecesarios. Incluya solo las columnas que su herramienta de traducción necesite.
  • Pruebe primero con una muestra pequeña. Antes de pasar un archivo grande por el proceso de traducción, pruebe con una muestra pequeña para detectar a tiempo problemas estructurales o de codificación.
  • Valide su archivo antes de subirlo. Compruebe que cada fila tenga una clave única sin duplicados, que ninguna clave contenga espacios o caracteres especiales y que no haya filas rotas.
  • Mantenga una copia de seguridad. Guarde siempre una copia de su CSV original antes de enviarlo a traducir.

Revisión visual de la traducción del catálogo o aplicación renderizados

Una vez que PTC traduce el CSV, las cadenas se renderizan en cualquier sistema que consuma dicho CSV. Esto incluye su tienda, su aplicación y su panel de control. El título de un producto traducido que encaja bien en el archivo puede causar un desbordamiento en el diseño de una tarjeta. Un botón de pago en francés puede usar una palabra incorrecta para “Realizar pedido”. Una dirección larga en alemán puede romper una columna de ancho fijo en una factura impresa.

AI Visual QA de PTC detecta estos problemas. Para tiendas y paneles de control (basados en navegador), instale la extensión de navegador de PTC y grabe un recorrido por su tienda. PTC lo reproduce en cada idioma de destino y corrige automáticamente los problemas de diseño y contexto en el CSV. Para aplicaciones nativas que consumen el CSV, suba capturas de pantalla de las pantallas correspondientes en su lugar.

Traduzca anuncios de lanzamiento de productos y correos electrónicos a proveedores

Los anuncios de lanzamiento de productos y los correos electrónicos a clientes sobre actualizaciones del catálogo viven fuera del CSV. La función Pegar para traducir de PTC gestiona esos textos en el mismo proyecto, utilizando el mismo glosario y voz de marca que las traducciones de su catálogo.

Traduzca importaciones masivas a medida que llegan los datos con la API de PTC

Las importaciones masivas de catálogos que necesitan traducción al llegar pueden enviarse a través de la API REST de PTC con autenticación mediante token Bearer, utilizando el mismo glosario y voz de marca que las traducciones de sus archivos CSV.

Ahora traduzca su CSV con PTC

Una vez que su CSV esté preparado, tradúzcalo en 3 pasos:

  1. Suba su CSV y elija los idiomas de destino.
  2. PTC traduce mientras preserva cada columna, clave y marcador de posición.
  3. Descargue los archivos CSV traducidos e impórtelos donde corresponda.

Comience su prueba de 30 días: 20.000 palabras en 2 idiomas, sin tarjeta de crédito.