Cómo se extraen los valores traducibles

POM Translate convierte el contenido fuente admitido en unidades de traducción enfocadas cuando se guarda el objeto de origen. La extracción decide qué textos pueden traducir los editores y qué marcado circundante o datos técnicos deben permanecer controlados por WordPress.

La extracción comienza con la configuración

Una entrada debe usar un tipo de contenido habilitado. Dentro de ese tipo de contenido, el sitio puede habilitar de forma independiente el título, el contenido, el extracto y los metadatos admitidos en Settings → POM Translate → Content types.

Si la traducción del cuerpo está deshabilitada, POM Translate no conserva ningún esqueleto de cuerpo utilizable para ese tipo de contenido. Habilitar solo Title no hace que el extracto, el cuerpo ni ningún campo personalizado sean traducibles.

El texto del cuerpo se convierte en unidades con sentido

El analizador de HTML reconoce contenedores de texto habituales, entre ellos:

• párrafos y encabezados;
• elementos de lista;
• leyendas y pies de figura;
• botones y etiquetas;
• celdas y encabezados de tabla;
• citas en bloque, resúmenes, definiciones y direcciones.

Cada contenedor apto puede convertirse en una fila de traducción mientras su posición queda representada en el esqueleto de contenido. El texto que se encuentra fuera de un contenedor reconocido puede recogerse igualmente como una unidad estable de texto suelto cuando contiene contenido con sentido.

Por lo tanto, la interfaz no muestra necesariamente una fila por bloque de Gutenberg ni una fila para el documento HTML completo. Muestra las unidades de origen que el analizador puede sustituir de forma segura.

Los atributos seleccionados son cadenas independientes

Los atributos HTML orientados a personas pueden requerir una traducción distinta del texto visible del cuerpo. POM Translate extrae atributos admitidos como:

• alt;
• title;
• aria-label y aria-description;
• placeholder;
• value;
• atributos admitidos de accesibilidad o de etiqueta data-*.

Se guardan de forma independiente y se escapan como atributos al restaurarse. Traducir un párrafo no traduce automáticamente el texto alternativo de su imagen ni el marcador de posición del formulario.

Los elementos en línea permanecen dentro de su frase

Los enlaces, el énfasis, los elementos span, el código, los superíndices, los subíndices, el texto marcado, las imágenes y otros elementos en línea admitidos no se extraen como palabras desconectadas. POM Translate congela su marcado como marcadores protegidos dentro de la unidad de traducción que los contiene.

Por ejemplo, una frase con una expresión enlazada sigue siendo una sola unidad lingüística, lo que permite al traductor cambiar el orden de las palabras conservando la estructura del enlace. Los marcadores protegidos se explican en Cómo los marcadores protegidos preservan la estructura en línea.

Los shortcodes usan reglas de extracción admitidas

POM Translate puede extraer atributos seleccionados de shortcodes y el texto interno admitido. Los nombres de los shortcodes, la sintaxis estructural, los ID, las clases, los ajustes numéricos y los atributos técnicos arbitrarios no se tratan automáticamente como prosa.

Algunas familias conocidas de shortcodes tienen mapas de atributos dedicados, y los desarrolladores pueden ampliar el comportamiento admitido del analizador mediante los filtros públicos. Prueba siempre un shortcode representativo después de guardarlo; la similitud visual no demuestra que los nombres internos de sus atributos sigan un contrato admitido.

Los elementos técnicos se omiten

El analizador estándar excluye el contenido dentro de elementos estructurales o ejecutables como scripts, estilos, iframes, objetos incrustados, fuentes de audio/vídeo, lienzos (canvas), SVG, imágenes (picture), pistas y plantillas. Traducir su contenido sin procesar como prosa normal podría dañar el comportamiento o duplicar una superficie de localización especializada.

Los campos personalizados también son opcionales. Solo las claves admitidas registradas como traducibles deben entrar en el flujo de traducción. Los ID, los diseños serializados, los precios, las coordenadas, los datos de API y otros valores técnicos deben permanecer fuera de él.

Los cambios en la fuente actualizan el conjunto

Después de guardar, POM Translate compara las unidades descubiertas con el conjunto de origen almacenado:

• las unidades sin cambios conservan su asociación estable;
• las unidades modificadas reciben datos de origen actualizados y requieren revisión de la traducción;
• las unidades eliminadas se limpian de ese asunto;
• un texto de origen normalizado idéntico puede reutilizar una traducción existente no vacía de coincidencia exacta;
• los valores de destino recién descubiertos permanecen pendientes hasta que se traducen.

Los autoguardados y las revisiones no activan el flujo de extracción normal. Los guardados programáticos, las importaciones, las actualizaciones programadas y los cambios desde la línea de comandos sí pueden activarlo después de que WordPress haya persistido un objeto apto.

Verifica lo que se ha extraído

1. Habilita únicamente los campos necesarios para un tipo de contenido.
2. Crea una entrada con un encabezado, un párrafo, un enlace con formato, texto alternativo de imagen y un shortcode admitido.
3. Guarda la entrada con normalidad.
4. Abre Translations → Translate contents y filtra por esa entrada.
5. Confirma que la prosa visible y los atributos orientados a personas aparecen por separado donde se espera.
6. Confirma que las clases, los ID, la sintaxis de los shortcodes y los elementos técnicos omitidos no están presentes.
7. Elimina un párrafo de origen, guarda de nuevo y confirma que su fila obsoleta ya no pertenece a la entrada.

Si falta un valor esperado, comprueba primero los ajustes de campos del tipo de contenido y si el objeto de origen se ha guardado. No añadas campos técnicos a la lista de permitidos de traducibles solo para que la tabla parezca más completa.