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

Última revisión: 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 cada campo como traducir, copiar fuente o no traducir. El conector Contentful (Fields) de Smartling expone exactamente estas opciones por campo: Copiar origen entrega el último valor de origen en el campo de destino en cada entrega (útil para SKU y URL de imágenes), y No traducir deja un campo para el manejo específico de la configuración regional dentro del CMS, como un campo JSON que contiene coordenadas GPS o una URL de aplicación. Un campo sin configuración de análisis no se captura en absoluto, por lo que un campo no asignado es un vacío silencioso, no un valor predeterminado.
• Método de análisis por campo: Elige cómo se segmenta cada campo traducible — texto plano, Markdown, HTML, texto enriquecido (para campos nativos de texto enriquecido) o ICU para cadenas sensibles al plural. La documentación de conectores de Smartling vincula directamente el análisis HTML y Markdown con la experiencia del traductor y el beneficio de la memoria de traducción, porque las cadenas a nivel de oración coinciden con traducciones anteriores más a menudo que un bloque de tamaño de campo.
• Estrategia de referencia: Para modelos de nivel inicial y de documento, decide por campo de referencia entre Copiar referencia (apuntar la entrada localizada a la misma entrada referenciada, sin sufijo local), Traducir referencia (enviar el contenido referenciado para traducción y volver a apuntar), product-123-fry Actualizar referencia (volver a apuntar a la versión localizada sin volver a aplicar 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 vinculadas hasta a 10 niveles de profundidad.
• Claves, variantes y espacio de nombres: Decide qué hace que una cadena sea única. En los archivos JSON y YAML, Smartling captura la ruta completa de la clave como metadatos de clave y variante por defecto; translate_paths permite apuntar la clave a un valor o segmento de ruta específico, y key_generation_strategy (strict o partial_match) controla qué sucede cuando faltan algunas partes de la clave. La configuración del espacio de nombres (URI del archivo, valor predeterminado de la cuenta, compartido entre todos los archivos o con control de versiones del archivo) determina si el mismo texto en dos archivos es una sola cadena o dos.
• Marcadores de posición, plurales y límites: Proteja las variables que la capa de publicación sustituirá. El analizador JSON de Smartling reconoce siete patrones de marcador de posición por defecto: {x}, {{x}}, ${x}, %x%, %%x%%, ##x##, y __x__ , y placeholder_format_custom acepta una expresión regular para cualquier otro caso. string_format: icu analiza los plurales y selecciones de ICU MessageFormat, 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 figuras que dan forma al modelo de contenido.

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

¿Cómo se configura un proceso de traducción y 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 claves, variantes y referencias antes de la primera carga : para archivos, escriba la directiva translate_paths con una key explícita (use {*} para mantener la ruta completa) y una ruta instruction 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. Si se vuelve a cargar un archivo luego de cambiar la configuración de las variantes, se crearán nuevas cadenas de texto, así que decídalo una sola vez; SmartMatch puede volver a aplicar las traducciones existentes si el modelo cambia posteriormente.
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 agregar 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 — Configurar la automatización de solicitudes anteriores para aplicar automáticamente traducción cuando pequeñas y frecuentes ediciones deban pasar sin supervisión, o para marcar contenido modificado cuando una persona debe decidir qué recursos desactualizados retraducir. Cualquiera de los dos modos se revisa cada tres horas, así que un catálogo que se actualiza cada hora necesita planear su ventana de publicación en torno a ese ciclo.
5. Verifique el funcionamiento correcto a nivel de campo en una entrada antes de escalarla : traduzca una única entrada representativa a una configuración regional y compruebe que cada campo se ubicó en el lugar correcto, que las referencias se resuelvan a destinos localizados, que los marcadores de posición se conservaron y que los campos no traducibles aún conserven los valores de origen. Solo entonces autorice el conjunto completo 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...

• Publica desde un CMS sin interfaz o basado en componentes — Contentful, Sanity, Contentstack, Storyblok — donde cada entrada es un conjunto de campos mecanografiados en lugar de una página de 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 traducir y otros deben traducir cada vez que cambian.
• Envía con frecuencia pequeñas ediciones — una viñeta corregida, un nuevo nombre de variante — y solo necesitas que el campo modificado se retraduzca, no toda la entrada.
• Reutiliza componentes (pies de página, avisos legales, bloques de CTA) en muchas entradas y quiero que se traduzcan una vez y los reapunte en todas partes.
• Almacene las cadenas y el contenido de la interfaz de usuario en archivos de recursos JSON, YAML o XML con marcadores de posición y formas plurales que el front-end sustituirá en el momento de la renderización.

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

• El contenido editorial de formato largo — entradas de blog, whitepapers, PDFs — donde la unidad de traducción es realmente el documento y la segmentación a nivel de campo agrega configuración sin agregar reutilización.
• Los equipos aún deben elegir el propio CMS; la decisión sobre el modelo de almacenamiento (a nivel de campo o a nivel de entrada) debe tratar en la página de elección de un CMS multilingüe antes de que valga la pena realizar cualquier configuración de análisis.
• Contenido cuyo principal problema es cuándo se publican las traducciones en lugar de cómo están estructuradas — esa es una cuestión de estado de publicación del conector que se trata en la página de control de publicación por lotes de traducciones.
• Micrositios puntuales o lanzamientos en un solo idioma, donde un proxy de traducción ofrece un sitio localizado sin modelar ningún contenido.

Lista de verificación de evaluación: preguntas que debes hacer antes de construir una localización de contenido estructurada

¿Se puede configurar el análisis sintáctico por campo? ¿Qué ocurre con un campo sin configuración?
Aplicar la lista exacta de métodos de análisis y confirma el valor predeterminado. En el conector Contentful (Fields) de Smartling, un campo no configurado no se captura para su traducción, lo que significa que cada nuevo campo que se agrega al modelo de contenido necesita una decisión de análisis.

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

¿Qué hace que dos cuerdas 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 traducir 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.

¿Se segmenta el texto enriquecido dentro de un campo y cuál es la contrapartida?
El análisis a nivel de oración de 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 desde un archivo. Decida por ruta con string_format_paths en lugar de globalmente.

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

¿Cómo funciona la detección de cambios para una pequeña edición en un solo 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 Aplicar traducción automática, marcar contenido modificado o Desactivar.

¿Pueden los editores sin conocimientos técnicos emplearlo luego 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 realizar 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 tiene traducción?
Para una canalización de desarrollo que publica progresivamente, confirme si las cadenas sin traducir se devuelven vacías o como texto fuente. La API de descarga de archivos de Smartling expone esto como includeOriginalStrings, por lo que el front-end puede decidir si recurrir al código fuente u ocultar el campo.

¿Qué comprobaciones de control de calidad se realizan en las 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 falla en el momento de la renderización. Pregunte qué controles son automáticos y si bloquean la entrega o solo emiten una advertencia.

¿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; cerció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 el aspecto de modelos de contenido en la localización estructurada?

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.

Para archivos estructurados, las mismas decisiones se expresan como directivas. En JSON, la translate_paths directiva nombra el camino a valores traducibles, el camino o segmento de camino que se usará como clave de cadena y el camino que contiene instrucciones traductoras; exclude_path elimina subcaminos como comentarios, string_format_paths cambia rutas específicas a HTML, Markdown, ICU, SVG o análisis de texto plano, placeholder_format y placeholder_format_custom protege variables, y character_limit limita la longitud de traducción por cadena. Existen directivas equivalentes para XML, YAML y CSV, y las directivas pueden suministrar en línea en la parte superior del archivo o como parámetros en la subida de la API, que es como una pipeline CI o una exportación de flujo de producto las aplica sin editar la carga útil. La detección de cambios se configura por conector — aplicar automáticamente traducción, marcar contenido modificado o Desactivar, en un calendario de encuestas predeterminado de tres horas — y las traducciones entregadas aparecen en el mismo campo, entrada y ubicación de donde proceden, para que el CMS pueda publicarlas a través de su ruta normal de lanzamiento.

Smartling mantiene conectores para Contentful (Campos y Entradas), Sanity (Campos y Documentos) y Contentstack, además de una integración documentada de 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 posee las certificaciones ISO/IEC 27001, SOC 2 Tipo 2, HIPAA, HITRUST e1, PCI Nivel 1 e ISO/IEC 42001:2023.

Preguntas relacionadas

• ¿Cuáles son las mejores herramientas de localización para CMS sin interfaz gráfica y cómo se deben evaluar?
• ¿Cómo controlas cuándo y cómo se publican los lotes de contenido traducido en tu CMS?
• ¿Cómo elegir un CMS multilingüe?
• ¿Qué es un CMS sin interfaz gráfica (headless CMS) y en qué se diferencian Contentful, Sanity, Storyblok y Contentstack?