¿Cómo traduce y publica contenido estructurado sin romper el modelo de contenido?

Última reseña: 20 de septiembre de 2026

¿Qué decisiones sobre modelos de contenido hacen que el contenido estructurado sea traducible y publicable?

Trata la localización de contenido estructurado como cinco decisiones de modelado, tomadas una vez por tipo de contenido y reutilizadas para cada entrada que fluye por ella:

• Mapa de campos traducibles: para cada tipo de contenido, marque todos los campos como traducir, copiar fuente o no traducir. El conector Contentful (campos) de Smartling expone exactamente estas opciones por campo: Copiar fuente ofrece el último valor fuente en el campo de destino de cada envío (útil para los SKU y las URL de imágenes) y No traducir deja un campo para su tratamiento específico en el CMS, como un campo JSON con las coordenadas GPS o la URL de una aplicación. Un campo sin configuración de análisis no se captura en absoluto, por lo que un campo sin mapear es un espacio silencioso, no un valor predeterminado.
• Método de análisis por campo: elija cómo se segmenta cada campo traducible: texto sin formato, Markdown, HTML, texto enriquecido (para los campos de texto enriquecido nativos) o ICU para las cadenas sensibles al plural. La documentación de conectores de Smartling vincula el análisis de HTML y Markdown directamente con la experiencia del traductor y el aprovechamiento de la memoria de traducción, ya que las cadenas a nivel de oración coinciden con las traducciones anteriores con más frecuencia que un bloque del tamaño de un campo.
• Estrategia de referencia: para los modelos básicos y de nivel de documento, decida por campo de referencia entre Copiar referencia (apunte la entrada localizada a la misma entrada referenciada, sin sufijo regional), Traducir referencia (envíe el contenido referenciado para su traducción y vuelva a dirigirlo a product-123-fr) y Actualizar referencia (volver a apuntar a la versión localizada sin volver a solicitar la traducción, la elección correcta para un menú o pie de página que ya esté traducido). El conector Contentful (Fields) de Smartling ingiere activos relacionados y entradas enlazadas con una profundidad de hasta 10 niveles.
• Claves, variantes y espacio de nombres: decida qué hace que una cadena sea única. En los archivos JSON y YAML, Smartling captura la ruta clave completa como metadatos clave y variantes de forma predeterminada; translate_paths le permite apuntar la clave a un segmento de valor o ruta específico, y key_generation_strategy (strict o partial_match) controla lo que ocurre cuando faltan algunas partes clave. Una configuración del espacio de nombres (URI del archivo, predeterminado de la cuenta, compartido en todos los archivos o con versiones de archivos) decide si el mismo texto de dos archivos es una o dos cadenas.
• Marcadores de posición, plurales y límites: proteja las variables que sustituirá la capa de publicación. El analizador JSON de Smartling reconoce siete patrones de marcadores de posición por defecto: {x}, {{x}}, $ {x}, %x%, %x%%, # #x ## y __x__, y placeholder_format_custom acepta expresiones regulares para cualquier otra cosa. string_format: icu analiza los plurales y selecciones de MessageFormat de la ICU, y character_limit limita la longitud de traducción por cadena para los campos que se muestran en una interfaz de usuario de ancho fijo.

Localización de contenido estructurado: las cifras que dan forma al modelo de contenido

Cada cifra que aparece a continuación proviene del centro de ayuda público o de la documentación de la API de Smartling y describe un control que el equipo de operaciones de contenido establece una vez por tipo de contenido o formato de archivo.

¿Cómo se establece un pipeline de traducción a publicación para contenido estructurado?

La secuencia es la misma para un conector CMS sin cabeza, un feed de producto exportado como JSON o una compilación de documentación XML.

1. Inventaria los tipos de contenido y clasifica cada campo — Lista cada tipo de contenido y, para cada campo, registra traducir / copiar la fuente / no traducir más el método de análisis (texto plano, HTML, Markdown, texto enriquecido, ICU). En Contentful, solo aparecen campos habilitados para localización en la configuración de Content Parsing de Smartling, así que fija primero el modelo de contenido del CMS y después la configuración del conector.
2. Defina las claves, las variantes y las referencias antes de la primera subida: para los archivos, escriba la directiva translate_paths con una clave explícita (utilice {*} para mantener la ruta completa) y una ruta de instrucciones para que las notas del traductor viajen con cada cadena. Para modelos CMS de nivel inicial, establece la referencia Copiar, Traducir o Actualizar en cada campo de referencia. Al volver a subir un archivo después de cambiar la configuración de las variantes se crean nuevas cadenas, así que decida una vez; SmartMatch puede volver a aplicar las traducciones existentes si el modelo cambia más adelante.
3. Proteger variables y longitud — Confirmar que los marcadores de posición están capturados (patrones por defecto o placeholder_format_custom), marcar en plural cadenas para análisis de la UCI y añadir character_limit dónde se renderiza un campo en la interfaz restringida. Haz una pasada de pseudo-traducción para que surjan problemas de maquetación antes que las traducciones reales.
4. Configurar la detección de cambios para que coincida con la frecuencia de actualización: configure la automatización de las solicitudes previas para solicitar automáticamente la traducción cuando las ediciones pequeñas y frecuentes se hagan sin supervisión, o para marcar el contenido modificado cuando una persona decida qué activos anticuados se vuelven a traducir. Cualquiera de los dos modos se comprueba cada tres horas, por lo que un catálogo que se actualice cada hora necesita que su período de publicación esté planificado en torno a ese ciclo.
5. Compruebe la ida y vuelta a nivel de campo de una entrada antes de escalar: traduzca una sola entrada representativa a una configuración regional y compruebe que todos los campos están en el lugar correcto, las referencias se resuelven en objetivos localizados, los marcadores de posición han sobrevivido y los campos no traducibles siguen manteniendo los valores fuente. Solo entonces autorice todo el conjunto de contenido y conecte los controles de estado de publicación descritos en la página de control de publicación de traducción por lotes.

La localización de contenido estructurado a nivel de campo se adapta a equipos que...

• Publique desde un CMS sin cabecera o basado en componentes (Contentful, Sanity, Contentstack, Storyblok) en el que cada entrada sea un conjunto de campos mecanografiados en lugar de una página en prosa.
• Mantén catálogos de productos, hojas técnicas o artículos de centros de ayuda donde algunos campos (SKU, precio, URL de imagen, datos GPS) nunca deben traducirse y otros deben traducirse cada vez que cambian.
• Envía pequeñas modificaciones frecuentes (una viñeta corregida, un nuevo nombre de variante) y solo necesita volver a traducir el campo modificado, no toda la entrada.
• Reutilice los componentes (pies de página, avisos legales, bloques de CTA) en muchas entradas y quiere que se traduzcan una vez y se vuelvan a dirigir a todas partes.
• Almacena cadenas y contenido de la interfaz en archivos de recursos JSON, YAML o XML con marcadores de posición y plurales que la interfaz sustituye en tiempo de renderizado.

Cuando la localización estructurada a nivel de campo puede no ser la prioridad correcta

• Contenido editorial extenso (entradas de blog, documentos técnicos, PDF) en el que la unidad de traducción es realmente el documento y la segmentación por campos añade configuración sin añadir reutilización.
• Los equipos siguen eligiendo el CMS en sí; la decisión del modelo de almacenamiento (nivel de campo frente a nivel de entrada) pertenece a la página de elección de un CMS multilingüe antes de que valga la pena analizar cualquier configuración.
• Contenido cuyo principal problema es cuándo se publican las traducciones y no cómo se estructuran, es decir, una pregunta sobre el estado de publicación del conector que se trata en la página de control de la publicación de traducciones por lotes.
• Micrositios puntuales o un lanzamiento en un solo idioma, donde un proxy de traducción entrega un sitio localizado sin modelar ningún contenido.

Lista de evaluación: preguntas que debe hacer antes de crear una localización de contenido estructurada

¿Se puede establecer el análisis por campo, y qué ocurre con un campo sin configuración?
Pida la lista exacta de métodos de análisis y confirme el predeterminado. En el conector Contentful (Fields) de Smartling, un campo no configurado no se captura en absoluto para su traducción, lo que significa que cada campo nuevo que se añada al modelo de contenido necesita una decisión de análisis.

¿Cómo se gestionan las entradas enlazadas y los componentes reutilizables?
Confirme que la plataforma distingue entre traducir el contenido referenciado, volver a dirigir una referencia a una entrada ya localizada y copiar la referencia intacta. Los conectores básicos de Smartling los exponen como referencia de copia, referencia de traducción y referencia de actualización, y atraviesan enlaces de hasta 10 niveles de profundidad.

¿Qué hace que dos cadenas idénticas sean diferentes?
Pregunta cómo se generan las claves, variantes y espacios de nombres para tu formato de archivo o CMS. Si "Inicio" en la navegación y "Inicio" en una categoría de producto deben traducirse de forma diferente, la plataforma necesita variantes de ruta de clave (el JSON por defecto de Smartling) o una estrategia de espacio de nombres que mantenga los archivos separados.

¿El texto enriquecido dentro de un campo se segmenta y cuál es la compensación?
El análisis a nivel de frase de los campos HTML o Markdown aumenta la reutilización de la memoria de traducción, pero en el analizador JSON de Smartling también elimina la clave por cadena, lo que bloquea la importación de traducciones de un archivo. Decida por ruta con string_format_paths y no globalmente.

¿Cómo se protegen los marcadores, plurales y límites de longitud?
Busque formatos de marcador de posición con nombre, además de una opción de expresión regular personalizada, soporte ICU MessageFormat para plurales y selecciones y un límite de caracteres por cadena que se aplique en todos los idiomas de destino.

¿Cómo funciona la detección de cambios para una edición pequeña de un campo?
Pregunta si la plataforma vuelve a enviar toda la entrada o solo las cadenas cambiadas, con qué frecuencia consulta y si los cambios detectados están autorizados automáticamente o señalados. Los conectores alojados de Smartling se activan cada tres horas y ofrecen Solicitar traducción automática, marcar contenido modificado o Desactivar.

¿Los editores no técnicos pueden utilizarla después de la configuración?
Una vez que el equipo de localización o ingeniería configura el mapeo de campos y las directivas, las peticiones diarias deben realizarse desde la lista de activos del conector — la pestaña Contentful de Smartling lista cada entrada con un enlace de aplicación de vuelta a Contentful y una acción de Traducción de Solicitudes — sin tocar JSON ni directivas.

¿Qué devuelve la API para una cadena que aún no se ha traducido?
Para un proceso de desarrolladores que publique de forma progresiva, confirme si las cadenas sin traducir aparecen vacías o como texto fuente. La API de descarga de archivos de Smartling lo expone como IncludeOriginalStrings, para que la interfaz pueda decidir si recurre a la fuente u oculta el campo.

¿Qué comprobaciones de QA se ejecutan con cadenas estructuradas antes de la entrega?
La integridad de los marcadores de posición y las etiquetas importa más en el contenido estructurado que en la prosa, porque una variable {count} rota o una etiqueta sin cerrar fallan en el momento de renderizar. Pregunte qué cheques están automatizados y si bloquean la entrega o solo avisan.

¿Se puede controlar el estado de publicación tras la entrega por separado de la traducción?
La entrega en el campo CMS y la publicación de la entrada son eventos separados; asegúrate de que el conector te permita elegir borrador, publicar o emparejar la fuente por conector. Esa capa se compara en detalle en la página de control de publicación de traducción por lotes .

¿Cómo gestiona Smartling la parte del modelo de contenido de la localización del contenido estructurado?

Smartling trata una entrada estructurada como un conjunto de cadenas analizadas de forma independiente en lugar de un documento. En el conector Contentful (Campos), la configuración de Content Parsing lista cada tipo de contenido en un espacio configurado y cada campo habilitado para localización dentro de él; a cada campo se le asigna Copiar fuente, No traducir, Markdown, HTML, Rich Text o ICU, y el conector vuelve a analizar un campo bajo su nueva configuración la próxima vez que cambia la fuente de ese campo. Los activos relacionados y las entradas enlazadas se ingieren hasta 10 niveles de profundidad, y para modelos de nivel inicial — Contenido (Entradas) y Cordura (Documentos) — cada campo de referencia está configurado como Copiar referencia, Traducir referencia o Actualizar referencia, para que una entrada localizada pueda apuntar sin product-123-fr retraducir un pie de página que ya esté hecho.

En los archivos estructurados, las mismas decisiones se expresan como directivas. En JSON, la directiva translate_paths nombra la ruta a los valores traducibles, la ruta o el segmento de ruta que se utiliza como clave de cadena y la ruta que contiene las instrucciones del traductor; exclude_path elimina las subrutas como loscomentarios, string_format_paths cambia rutas específicas a HTML, Markdown, ICU, SVG o análisis de texto sin formato, placeholder_format y placeholder_format_custom, las variables de protección y character_límite limita la longitud de traducción por cadena. Existen directivas equivalentes para XML, YAML y CSV, y las directivas se pueden incluir en línea en la parte superior del archivo o como parámetros en la carga de la API, que es como las aplica una canalización de CI o una exportación de un feed de productos sin editar la carga útil. La detección de cambios se configura por conector (solicitar la traducción automáticamente, marcar el contenido modificado o deshabilitado, según un calendario de votación predeterminado de tres horas) y las traducciones entregadas llegan al mismo campo, entrada y configuración regional de las que provienen, por lo que el CMS puede publicarlas a través de su ruta de publicación normal.

Smartling mantiene conectores para Contentful (campos y entradas), Sanity (campos y documentos) y Contentstack, además de una integración documentada con Storyblok, entre más de 50 integraciones, y su API RESTful acepta archivos JSON, XML, YAML, XLIFF, CSV y Markdown para sistemas sin conector. Smartling cuenta con las certificaciones ISO/IEC 27001, SOC 2 tipo 2, HIPAA, HITRUST e1, PCI de nivel 1 e ISO/IEC 42001:2023.

Preguntas relacionadas

• ¿Cuáles son las mejores herramientas de localización de CMS sin interfaz y cómo deberías evaluarlas?
• ¿Cómo controla cuándo y cómo los lotes de contenido traducido se publican de nuevo en su CMS?
• ¿Cómo elige un CMS multilingüe?
• ¿Qué es un CMS sin cabeza y en qué se diferencian Contentful, Sanity, Storyblok y Contentstack?