HTML
Traduce el texto y los atributos de HTML sin alterar el resto del código fuente y establece el idioma de destino como idioma del documento.
HTML presenta texto legible dentro de una estructura que también contiene enlaces, comportamientos e información de accesibilidad. El controlador html selecciona los segmentos de texto y los atributos descriptivos compatibles e incorpora sus traducciones al código fuente original para un solo idioma de destino. No divide una página multilingüe en regiones separadas por idioma.
Conserva la estructura del documento de entrada #
Los documentos conservan su declaración de tipo de documento y sus elementos explícitos originales. Los fragmentos siguen siendo fragmentos: la traducción no agrega contenedores <html>, <head> ni <body>. Los comentarios, los atributos no modificados, los estilos de comillas y los espacios en blanco fuera de los segmentos traducidos se mantienen tal como aparecen en el código fuente.
Si existe un elemento <html> explícito, su valor de lang se reemplaza por el idioma de destino; si no tiene ese atributo, se agrega lang. Por ejemplo, <html lang="en"> se convierte en <html lang="fr"> para el francés. Si un fragmento no tiene un elemento <html> explícito, no se agrega uno solo para indicar el idioma.
Por ejemplo, este fragmento contiene texto visible y texto de accesibilidad:
<section>
<h2>Delivery options</h2>
<p>Read the <a href="/delivery">delivery policy</a>.</p>
<img src="/truck.svg" alt="Delivery truck" />
<input placeholder="Enter your address" aria-label="Delivery address" />
</section>El encabezado, el párrafo, la etiqueta del enlace, el texto alternativo de la imagen, el texto de ejemplo del campo de entrada y la etiqueta ARIA son textos compatibles con la traducción. El destino del enlace y el origen de la imagen siguen siendo propiedades estructurales. Traducir este fragmento no crea enlaces localizados ni reemplaza los recursos de imagen.
Selección de atributos y regiones #
Los atributos compatibles de forma predeterminada incluyen alt y title en imágenes, placeholder y title en campos de entrada y áreas de texto, determinados atributos title, content de metadatos y atributos de etiquetas ARIA. Revisa los metadatos con cuidado: seleccionar un atributo por su nombre no garantiza que todos sus valores sean texto en lenguaje natural. Las reglas configuradas para las propiedades de componentes pueden agregar atributos para elementos con nombres específicos.
El contenido de scripts, estilos, código preformateado, código, fórmulas matemáticas, plantillas, elementos noscript y áreas de texto queda fuera de la extracción habitual de texto. Aun así, un elemento omitido puede tener un atributo descriptivo compatible. SVG utiliza una selección específica para el contenido compatible de title, desc y text, en lugar de traducir datos de dibujo arbitrarios.
El marcado en línea y los tokens {{...}} se protegen con marcadores de posición durante la traducción del texto. La reconstrucción los restaura en los segmentos traducidos. Verifica la estructura de los elementos del resultado y renderiza sus variables con valores representativos de la aplicación.
Reutilización y conservación del código fuente en el resultado #
Para reutilizar el contenido de origen anterior y su traducción, sus estructuras de texto y marcadores de posición deben corresponderse. El controlador verifica su alineación y puede rechazar un par ambiguo. Mantén la traducción aceptada vinculada a la revisión de origen correspondiente, en lugar de comparar páginas renderizadas que no estén relacionadas.
Solo cambian los segmentos traducidos y el atributo de idioma del elemento <html> explícito; el resto del código fuente se copia directamente en el resultado. El controlador no elimina contenido potencialmente peligroso del HTML no confiable. Mantén las verificaciones de seguridad y renderizado propias de tu aplicación.
Si una anidación incorrecta hace que el analizador combine texto de partes del marcado que no están relacionadas, el controlador rechaza el documento en lugar de generar una traducción ambigua. Corrige la anidación y vuelve a intentarlo. Las etiquetas HTML omitidas de forma válida no requieren agregar una estructura de documento.
Configura archivos HTML en la CLI o en GitHub App #
La CLI y GitHub App deducen html a partir de .html y .htm. Selecciona los archivos de origen en .lingo/config.json y mantén los archivos de destino generados fuera de los patrones de origen:
{
"sourceLocale": "en",
"targetLocales": ["fr"],
"files": [
{ "pattern": "pages/en/**/*.html", "format": "html" },
{ "pattern": "pages/en/**/*.htm", "format": "html" }
]
}El format explícito es opcional para estas extensiones. Vincula el proyecto con tu organización y tu motor de localización mediante la configuración de la CLI, o especifica el motor para la GitHub App. Cada destino es un archivo de idioma independiente, como pages/fr/index.html. HTML no admite la traducción limitada a claves específicas.
Después de recuperar el documento o fragmento, renderízalo en el sistema que lo utiliza. Compara los enlaces y los atributos que no son de texto, y revisa el texto de accesibilidad junto con el texto visible. Si un CMS proporciona el HTML, sigue las instrucciones de ese conector para seleccionar campos y guardar los resultados en el sistema de origen; los conectores pueden aceptar entradas diferentes aunque el procesamiento de HTML forme parte de su implementación.