Conservar el formato durante la traducción

POM AI no entrega el marcado de tu maquetador de páginas a un traductor y espera lo mejor. Extrae las cadenas traducibles, las sustituye por marcadores de posición, traduce las cadenas y las vuelve a colocar. Esta página explica qué protege ese proceso y dónde se detiene.

Cómo se divide el contenido

Antes de traducir, POM AI recorre el contenido de la entrada en busca de shortcodes. Para cada uno que encuentra, extrae solo los atributos que el propio shortcode declara como traducibles, dejando todo lo demás —los nombres de los shortcodes, los atributos de diseño, los identificadores, el anidamiento— intacto.

El texto que no está dentro de un shortcode se trata como su propio bloque traducible. Los shortcodes anidados se procesan de forma recursiva, de modo que se alcanza el contenido que hay dentro de una columna dentro de una fila.

Los bloques de HTML sin procesar se decodifican antes de la traducción y se vuelven a codificar después. Los grupos de parámetros declarados, incluidos los elementos de POM Timeline, exponen campos de texto individuales. Su configuración JSON se reconstruye con la codificación requerida, de modo que las comillas y los saltos de línea no rompen el grupo. Se aceptan tanto la codificación de espacio %20 como la +. Los atributos de shortcode de texto enriquecido conservan el delimitador de comillas original, manteniendo intactos los atributos HTML.

Cada cadena extraída se sustituye por un marcador de posición numerado y, tras la traducción, las cadenas traducidas se escriben de nuevo en las mismas posiciones. POM AI exige todos los campos de título, contenido y metadatos solicitados antes de guardar una entrada traducida. Una respuesta incompleta produce un error y deja sin cambios una traducción existente. Comprueba tu saldo de créditos antes de reintentarlo, ya que la solicitud al proveedor puede haber consumido créditos. Los escapes de shortcode y el JSON de bloques se conservan cuando se guarda la entrada.

Qué protege esto

• Nombres y estructura de los shortcodes.
• Atributos de diseño: anchos, alineaciones, colores, espaciados, clases CSS.
• Identificadores y anclas de elementos.
• Anidamiento y orden de las secciones del maquetador.
• Atributos no traducibles de cualquier tipo.
• HTML dentro de los bloques sin procesar.

El resultado práctico es que una página construida con un maquetador visual vuelve con el mismo diseño y el texto traducido dentro.

Qué depende del maquetador

POM Theme suministra una declaración compartida a través de pom_shortcode_translation_schema, con independencia de la interfaz de WPBakery. Cubre encabezados, etiquetas de botones, texto accesible, etiquetas de formularios y del buscador, mensajes de listado y texto de Timeline. POM AI lee esta declaración durante su solicitud de traducción directa sin cargar la interfaz del maquetador. POM Translate lee la misma declaración para su propia extracción de cadenas; sus trabajos en segundo plano son independientes de la traducción de entradas de POM AI.

Los shortcodes de terceros pueden usar la misma declaración. Cuando no existe ninguna, POM AI utiliza los indicadores translatable de WPBakery disponibles del shortcode. Los atributos no declarados permanecen sin cambios. Los cuerpos de código y de script declarados como contenido técnico se conservan. Los elementos HTML ordinarios de script/style y los elementos marcados con data-pom-translate="skip" también se conservan, incluidos los shortcodes que hay dentro de ellos. Consulta el filtro de shortcode compartido para obtener detalles de integración.

Después de ampliar una declaración, vuelve a traducir una página de origen representativa y revísala. Las traducciones creadas anteriormente no se modifican automáticamente. Si queda texto sin traducir, comprueba que su declaración esté registrada durante la solicitud de traducción y que su valor esté guardado en la página, en lugar de ser suministrado por una plantilla o una opción global.

Enlaces internos

Los enlaces del contenido traducido se examinan: cuando un enlace apunta a una entrada o página de este sitio y ese elemento tiene una traducción en el idioma de destino, el enlace se reescribe para apuntar a la versión traducida.

Los enlaces que no pueden resolverse de esta manera se dejan exactamente como están. Eso incluye:

• enlaces a elementos que aún no tienen traducción;
• enlaces a sitios externos;
• enlaces escritos como texto sin formato en lugar de anclas;
• enlaces dentro de atributos que el maquetador no expone.

Este es un buen argumento para traducir en orden de dependencia: traduce las páginas a las que se enlaza antes que las páginas que enlazan con ellas, y la reescritura funcionará en más de ellas. Si traduces en el orden contrario, vuelve a comprobar los enlaces después.

Qué se copia en lugar de traducirse

El extracto. Se traslada desde el origen sin cambios. Si tu tema, tus feeds o tus resultados de búsqueda usan extractos, tradúcelos a mano o con el asistente de párrafos.

Medios. Los adjuntos no se traducen ni se duplican. La entrada traducida referencia las mismas imágenes, con el mismo texto alternativo, en el idioma de origen. Traducir el texto alternativo es una tarea manual aparte; la herramienta de metadatos de imágenes puede regenerarlo según los términos del sitio traducido.

Propiedades estructurales. El autor, las fechas, el estado, el elemento superior, el orden del menú, los ajustes de comentarios y la contraseña se copian deliberadamente, para que la traducción se comporte como el original.

Campos personalizados que el tema no marca como traducibles. Esos se copian tal cual.

El slug

El slug de la entrada traducida se deriva del título traducido, no se copia del origen. Para el contenido jerárquico, la traducción se adjunta al elemento superior traducido cuando existe uno.

Comprueba los slugs en todo lo que tenga valor SEO; un slug derivado rara vez es el que habrías elegido.

Qué verificar después de traducir

Incluso con la protección por marcadores de posición, comprueba:

• El diseño se muestra correctamente en el front-end, no solo en el editor.
• Los botones y encabezados dentro de los elementos del maquetador realmente cambiaron de idioma.
• Los enlaces apuntan donde deben, especialmente en elementos anidados.
• La expansión del texto no ha roto nada. Las traducciones al alemán o al español suelen ser un 15–30 % más largas que el inglés, lo que desborda secciones de altura fija, botones y navegación.
• Los caracteres especiales y las comillas se muestran correctamente.
• Todo lo que parecía un marcador de posición en el origen ha sobrevivido.

POM AI elige marcadores de posición que no aparecen en el origen. El texto literal parecido a un marcador de posición en etiquetas, enlaces, identificadores y configuración de grupos se conserva.

Reducir el riesgo en un sitio complejo

• Traduce una página representativa de cada plantilla antes de lanzar un lote.
• Visualiza cada plantilla traducida en el front-end, en escritorio y en móvil.
• Prefiere traducir una página cuyos destinos enlazados ya existan.
• Anota cualquier atributo del maquetador que nunca se traduzca, para que tus revisores sepan corregirlo manualmente cada vez.