Cómo los marcadores protegidos preservan la estructura en línea
Los marcadores protegidos permiten que un traductor cambie la redacción de una oración completa sin reescribir el HTML de origen que hay dentro de ella. POM Translate los usa para elementos en línea admitidos, como enlaces, énfasis, spans, código, superíndice, imágenes y texto marcado.
Un marcador representa marcado controlado por el código fuente
Supón que el código fuente contiene:
Read our <a href="/menu/"><strong>seasonal menu</strong></a>.El traductor necesita la oración completa para que la frase del enlace pueda moverse con naturalidad. POM Translate representa temporalmente los elementos en línea de apertura y cierre con marcadores numerados, mientras guarda los nombres de etiqueta y los atributos originales en un mapa protegido.
Por lo tanto, la interfaz de traducción puede mostrar un valor conceptualmente parecido a:
Read our %1%%2%seasonal menu%/2%%/1%.Las palabras pueden cambiar de orden. Los marcadores deben permanecer emparejados y equilibrados para que el enlace y el énfasis puedan restaurarse.
Qué pueden cambiar los traductores
Los editores pueden:
- traducir el texto entre marcadores;
- mover un par completo de marcador de apertura/cierre junto con su frase;
- cambiar el orden de la oración alrededor de los elementos protegidos;
- dejar el valor vacío para usar la alternativa de origen.
Los editores no deben:
- eliminar un marcador obligatorio;
- inventar un número de marcador nuevo;
- duplicar un par de marcadores;
- convertir un marcador de apertura en uno de cierre;
- romper el anidamiento entre dos elementos en línea;
- traducir ni editar los propios caracteres del marcador.
El código fuente controla el nombre de la etiqueta y los atributos guardados. La localización de enlaces se produce más adelante mediante el sistema de URLs; el traductor no sustituye un href editando un marcador protegido.
Los elementos vacíos usan un único marcador
Los elementos sin etiqueta de cierre, como las imágenes en línea admitidas, usan un único marcador protegido. Sus atributos estructurales permanecen en el mapa de origen, mientras que los atributos orientados a las personas admitidos por separado, como el texto alternativo, pueden tener su propia fila de traducción.
Esta distinción evita que el marcado de una imagen se reconstruya a partir de una oración traducida, al tiempo que permite localizar su texto accesible.
La validación se ejecuta antes del almacenamiento y del renderizado
POM Translate compara los marcadores traducidos con las expectativas del código fuente. La validación comprueba los identificadores obligatorios, los recuentos de apertura y cierre, el equilibrio, el anidamiento y el texto mal formado parecido a un token.
La interfaz de traducción informa de los problemas de marcadores antes de aceptar un valor manual no válido. Las respuestas de traducción automática y las escrituras de la API de traducción también se comprueban.
En el momento del renderizado, POM Translate vuelve a validar. Si un valor de destino almacenado tiene marcadores no válidos, el plugin registra el problema de validación para el diagnóstico y usa la unidad de origen original en lugar de restaurar un marcado inseguro o incompleto.
Los marcadores no preservan la página completa
Los marcadores protegidos operan dentro de una única unidad de traducción. El esqueleto de contenido tiene una responsabilidad distinta:
- el esqueleto preserva el orden de los párrafos, encabezados, atributos y valores de shortcode;
- el mapa de marcadores preserva los elementos en línea dentro de uno de esos valores.
No uses un mecanismo para razonar sobre el otro. Un marcador de enlace correctamente emparejado no puede mover su párrafo a otra parte de la página.
Corrige un error de marcador
Cuando una fila informe de marcadores que faltan, sobran o están desequilibrados:
- compara el campo de destino con Original Text;
- identifica cada marcador numerado de apertura, cierre e independiente;
- restaura el conjunto obligatorio exacto;
- mueve solo pares completos;
- guarda de nuevo la traducción;
- recarga la fila y confirma que la advertencia ha desaparecido;
- inspecciona los enlaces, el énfasis, las imágenes y los estilos en línea de la página de destino.
Si el propio marcado de origen es incorrecto, repáralo en la publicación canónica y vuelve a guardarla. No compenses un HTML de origen roto construyendo un patrón de marcadores diferente en la traducción de destino.
Un ejemplo práctico de verificación
Usa un párrafo que contenga una frase enlazada dentro de un énfasis y una imagen en línea:
- guarda la publicación de origen y abre sus filas de traducción;
- traduce la oración sin tocar los ID de los marcadores;
- mueve la frase enlazada a una posición natural en el idioma de destino;
- guarda e inspecciona el HTML público;
- confirma que la estructura del enlace, el énfasis y la imagen coinciden con el código fuente;
- elimina deliberadamente un marcador en una copia de pruebas;
- confirma que la interfaz rechaza o marca el valor y que el renderizador público no muestra marcado dañado.
Los marcadores protegidos son un contrato estructural. Trátalos como puntuación proporcionada por el sistema, no como palabras a la espera de traducción.