PTC
Registrarse Actualizar a Pro Su cuenta

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

Un archivo 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 ver el resumen del servicio de CSV independiente, consulte traducir archivos CSV en línea con IA.

El CSV es el formato de traducción más universal. Todas las herramientas de hojas de cálculo, todas las plataformas de comercio electrónico y todas las exportaciones de análisis admiten CSV. Esa flexibilidad es un arma de doble filo. Un archivo 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 archivo CSV esté listo para traducir.

Qué aspecto tiene un archivo CSV listo para traducir

Un archivo CSV listo para traducir es aquel en el que:

  • Cada cadena traducible tiene una clave única y estable.
  • La columna del idioma de origen está claramente identificada.
  • Las columnas de los idiomas de destino ya existen (una columna por idioma) o se genera un CSV por cada idioma de destino.
  • Las columnas de identificadores (SKU, ID, URL de imagen, precio) son evidentemente 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 pipeline actual.

Elija columnas que los traductores y PTC puedan leer

Convierta la primera fila en el encabezado. Utilice nombres de columna sencillos y descriptivos como key, source_text y context. De este modo, su herramienta de traducción y cualquier revisor humano sabrán exactamente qué contiene cada columna.

Columnas obligatorias. Todo archivo CSV listo para traducir 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 emparejar la traducción correcta en tiempo de ejecución. Utilice 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 una vez iniciada la traducción. Cambiar una clave crea una nueva cadena y desvincula la traducción preexistente.
  • La columna de texto de origen contiene el texto original en su idioma base.

Opcional, pero útil: una columna context. Las cadenas cortas como “Save” o “Back” pueden significar cosas distintas según el lugar de la interfaz en el que aparezcan. Una breve nota 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

En el caso de archivos grandes, una columna namespace o group le ayuda a organizar las cadenas por función 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 utilizando códigos de locale como encabezado. Utilice es_ES para español (España), fr_FR para francés (Francia) y pt_BR para portugués (Brasil).

Utilice 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 identificadores. Si su CSV es un catálogo de productos, las columnas sku, handle, price y image_url deben ser evidentemente no traducibles solo por sus nombres. No las oculte en una columna metadata genérica.

Un CSV por ámbito lógico. No mezcle las cadenas de la interfaz de administración con el texto de marketing en el mismo archivo. Los distintos ámbitos tienen tonos diferentes. 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 conserve 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 conserva los marcadores de posición literalmente 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 de serie:

  • %s, %d, %f, %1$s, %2$d: estilo printf (gettext, Rails, Java).
  • {name}, {count}, {0}: str.format de Python, .NET, sintaxis de índice de 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 conserva 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 todas las filas.

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

La mayoría de los idiomas tienen más de dos formas plurales. Muchos tienen reglas que ningún hablante de inglés 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 almacena el singular y el plural generará un resultado incorrecto 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 correctas para cada idioma de destino.

No combine formas plurales en una sola cadena con barras o paréntesis, como "You have {count} item(s) in your cart.". Ese enfoque no es traducible y rompe la gramática de la mayoría de los idiomas.

Escape los caracteres especiales para que el analizador 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 analizador 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: permitidos si el campo está entrecomillado.
key,source_text
address,"123 Main Street
Springfield, IL 62701"
  • Comillas tipográficas: utilice siempre comillas rectas (") en lugar de comillas tipográficas (“ ”). Los analizadores de CSV no reconocen las comillas tipográficas y arrojarán errores de formato.
  • Espacios finales: elimínelos de todas las celdas antes de enviarlas. 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, entrecomille el campo 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 únicamente el texto legible para humanos y conserva cada etiqueta, atributo y URL.

Guarde como UTF-8 para evitar caracteres acentuados corruptos

La codificación es la causa más común de los problemas de traducción de CSV. Sin UTF-8, los caracteres ajenos 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 de forma predeterminada. Históricamente, Excel en Windows no lo hacía.
  • No utilice la codificación Windows-1252, ISO-8859-1 ni “ANSI”. Los caracteres acentuados de 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 utiliza UTF-8 de forma predeterminada. 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 menú desplegable de formatos. No elija el formato simple “CSV (delimitado por comas)”.
  • Google Sheets: Archivo > Descargar > Valores separados por comas (.csv). Es UTF-8 de forma predeterminada.

Para los 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

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

Un archivo 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.
  • Procesa los marcadores de posición ({{shopName}}, {count}, {currency}, {amount}).
  • Procesa los plurales con los sufijos .zero / .one / .other.
  • Escapa el HTML y las comillas correctamente.
  • Está guardado como UTF-8.

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

Prácticas recomendadas de traducción de CSV en una sola lista

  • Utilice 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 conservan la estructura de su archivo, procesan los marcadores de posición correctamente y mantienen sus claves intactas.
  • Utilice comas estándar como delimitador. Algunas herramientas utilizan el punto y coma de forma predeterminada. 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 sin formato. Cualquier formato aplicado a través del software de hoja de cálculo se elimina cuando se procesa el archivo.
  • Elimine las columnas y los metadatos innecesarios. Incluya únicamente las columnas que necesita su herramienta de traducción.
  • Haga primero una prueba con una muestra pequeña. Antes de enviar a traducir un archivo grande, haga una prueba 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 tiene una clave única sin duplicados, que ninguna clave contiene espacios o caracteres especiales y que no hay filas rotas.
  • Guarde 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 la aplicación renderizados

Una vez que PTC traduce el CSV, las cadenas se renderizan en lo que sea que consuma el CSV. Eso incluye su tienda online, su aplicación y su panel de control. Un título de producto traducido que encaja en el archivo puede desbordar el diseño de una tarjeta. Un botón del proceso de pago en francés puede utilizar la palabra equivocada para “Place Order”. Una dirección larga en alemán puede romper una columna de ancho fijo en una factura impresa.

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

Traduzca los anuncios de lanzamiento de productos y los correos electrónicos para proveedores

Los anuncios de lanzamiento de productos y los correos electrónicos dirigidos al cliente sobre actualizaciones del catálogo viven fuera del CSV. La función Paste to Translate de PTC procesa ese texto en el mismo proyecto, utilizando el mismo glosario y la misma 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 fluir a través de la API REST de PTC con autenticación Bearer, utilizando el mismo glosario y la misma voz de marca que sus traducciones de 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 lo traduce mientras conserva cada columna, clave y marcador de posición.
  3. Descargue los CSV traducidos e impórtelos donde correspondan.

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