Buenas pr\u00e1cticas para la traducci\u00f3n de CSV<\/a><\/li>\n<\/ul>\n<\/div><\/div>\n\n\u00bfQu\u00e9 es un archivo CSV para traducci\u00f3n?<\/h2>\n\n
CSV (valores separados por comas) es un formato de texto sin formato que organiza los datos en filas y columnas, con cada valor separado por una coma. Es uno de los formatos m\u00e1s utilizados para la localizaci\u00f3n de software porque es ligero, f\u00e1cil de editar y compatible con la mayor\u00eda de frameworks de desarrollo, plataformas de comercio electr\u00f3nico y herramientas de traducci\u00f3n. <\/p>\n\n
C\u00f3mo estructurar un archivo CSV para traducci\u00f3n<\/h2>\n\n
Para preparar un archivo CSV para traducci\u00f3n, necesita una fila de encabezado clara, claves de identificador \u00fanicas y una columna de texto de origen. Hacer esto bien antes de subir el archivo a una herramienta de traducci\u00f3n evita errores de importaci\u00f3n, cadenas ausentes y resultados defectuosos. <\/p>\n\n
Haga que la primera fila del archivo contenga nombres de columna, no contenido. Use etiquetas sencillas y descriptivas como key<\/code>, source_text<\/code> y context<\/code>. Estas indican a su herramienta de traducci\u00f3n y a cualquier revisor humano exactamente qu\u00e9 contiene cada columna. <\/p>\n\nColumnas obligatorias<\/h3>\n\n
Todo CSV listo para traducir necesita, como m\u00ednimo, una columna de clave y una columna de texto de origen.<\/p>\n\n
La columna key<\/code> contiene un identificador \u00fanico para cada cadena. Su aplicaci\u00f3n lo utiliza para asignar la traducci\u00f3n correcta en tiempo de ejecuci\u00f3n. Use una convenci\u00f3n de nombres coherente y lim\u00edtese a letras min\u00fasculas, guiones bajos y puntos. Esta columna no se traduce. Los formatos habituales incluyen button.submit<\/code>, error.invalid_login<\/code> y onboarding.welcome_message<\/code>. <\/p>\n\nLa columna source_text<\/code> contiene el texto original en su idioma base, listo para traducir.<\/p>\n\n\n
\n\n| clave<\/th> | texto_origen<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.submit<\/td>\n | Enviar<\/td>\n<\/tr>\n |
\n| error.invalid_login<\/td>\n | Nombre de usuario o contrase\u00f1a no v\u00e1lidos.<\/td>\n<\/tr>\n |
\n| onboarding.welcome_message<\/td>\n | \u00a1Bienvenido a nuestra aplicaci\u00f3n!<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n No cambie nunca una clave despu\u00e9s de que haya comenzado la traducci\u00f3n. Si lo hace, se crea una nueva cadena y la traducci\u00f3n existente queda hu\u00e9rfana. <\/p>\n\n Columnas opcionales<\/h3>\n\nIncluya una columna context<\/code> o description<\/code> siempre que sea posible. Las cadenas cortas como \u201cGuardar\u201d o \u201cAtr\u00e1s\u201d pueden significar cosas diferentes seg\u00fan el lugar de la interfaz donde aparezcan. Una breve nota le permite saber d\u00f3nde aparece cada cadena. <\/p>\n\nEn archivos grandes, una columna namespace<\/code> o group<\/code> le ayuda a organizar las cadenas por funcionalidad o secci\u00f3n, lo que hace que el archivo sea mucho m\u00e1s f\u00e1cil de gestionar y revisar.<\/p>\n\n\n \n\n| clave<\/th> | texto_origen<\/th> | contexto<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.save<\/td>\n | Guardar<\/td>\n | Barra de herramientas del editor de documentos<\/td>\n<\/tr>\n | \n| checkout.button.save<\/td>\n | Guardar<\/td>\n | Formulario de direcci\u00f3n de pago<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Columnas de idioma<\/h3>\n\nSi su flujo de trabajo requiere mantener los idiomas de origen y destino en el mismo archivo, a\u00f1ada una columna para cada idioma de destino usando c\u00f3digos de idioma BCP-47 como encabezado. Por ejemplo, use es_ES<\/code> para espa\u00f1ol (Espa\u00f1a) o fr_FR<\/code> para franc\u00e9s. <\/p>\n\nC\u00f3mo gestionar placeholders y variables en la traducci\u00f3n de CSV<\/h2>\n\nCada framework utiliza una sintaxis de placeholder diferente. Aseg\u00farese de saber qu\u00e9 formato espera su aplicaci\u00f3n y \u00faselo de forma coherente en todo el archivo: <\/p>\n\n \n \n\n| Formato<\/th> | Ejemplo<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n{variable}<\/code><\/td>\n| Hola, {username}.<\/td>\n<\/tr>\n | \n%s<\/code><\/td>\n| Hola, %s.<\/td>\n<\/tr>\n | \n{0}<\/code><\/td>\n| Tiene {0} mensajes nuevos.<\/td>\n<\/tr>\n | \n%1$s<\/code><\/td>\n%1$s le ha a\u00f1adido como contacto.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Si su texto de origen incluye etiquetas HTML como <strong><\/code>, <br><\/code> o <a href=\"\"><\/code>, tr\u00e1telas igual que los placeholders. <\/p>\n\nNo traduzca nunca los placeholders ni las etiquetas HTML. PTC detecta y conserva autom\u00e1ticamente los placeholders y las etiquetas HTML en todos los formatos compatibles. Nunca los traduce ni los modifica, y los mantiene en la posici\u00f3n correcta en cada idioma de destino. <\/p>\n\n Para gestionar correctamente los plurales entre idiomas, debe almacenar las formas singular y plural en filas separadas con claves distintas. Si combina las formas plurales en una sola cadena, las traducciones no se adaptar\u00e1n a las reglas gramaticales de otros idiomas. <\/p>\n\n Por ejemplo:<\/p>\n\n | | | | | | |
![\"\"](\"https:\/\/ptc.wpml.org\/wp-content\/uploads\/2025\/04\/Border-min-1024x2.png\" "\\"Border-min\\"")
<\/figure><\/div>\n\n\n\n