HTML

Traduce el texto y los atributos HTML, conserva intactas las partes del código fuente que no se traducen y establece el idioma de destino como idioma del documento.

HTML integra texto legible en una estructura que también contiene enlaces, comportamientos e información de accesibilidad. El procesador html selecciona los segmentos de texto y los atributos descriptivos compatibles y después incorpora sus traducciones al código fuente original para un único idioma de destino. No divide las páginas multilingües en regiones independientes por idioma.

Conserva la estructura del documento de entrada #

Los documentos conservan su declaración doctype original y sus elementos explícitos. Los fragmentos siguen siendo fragmentos: la traducción no añade contenedores <html>, <head> ni <body>. Los comentarios, los atributos que no se modifican, 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 lang se sustituye por el idioma de destino, o se le añade un atributo lang si no lo tiene. Por ejemplo, <html lang="en"> pasa a ser <html lang="fr"> para el francés. Si un fragmento no contiene un elemento <html> explícito, no se le añade uno solo para indicar el idioma.

Por ejemplo, este fragmento contiene texto visible y texto de accesibilidad:

html
<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. El destino del enlace y el origen de la imagen siguen siendo propiedades estructurales. La traducción de este fragmento no crea enlaces localizados ni sustituye los archivos de imagen.

Selección de atributos y regiones #

Entre los atributos integrados compatibles se incluyen alt y title en imágenes, placeholder y title en campos de entrada y áreas de texto, determinados atributos title, content de meta y atributos de etiqueta ARIA. Revisa los metadatos con atención: seleccionar un atributo por su nombre no garantiza que todos sus valores sean texto en lenguaje natural. Las reglas configuradas para las propiedades de los componentes permiten añadir atributos para elementos identificados por su nombre.

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 de texto habitual. Un elemento excluido puede seguir teniendo un atributo descriptivo compatible. En SVG se aplica una selección específica al 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. Comprueba la estructura de elementos del resultado y renderiza sus variables con valores representativos de la aplicación.

Reutilización y salida que conserva el código fuente #

Para poder reutilizarlos, el original y la traducción anteriores deben tener estructuras de texto y marcadores de posición que se correspondan. El procesador comprueba su alineación y puede rechazar un par ambiguo. Mantén la traducción aceptada vinculada a la revisión de su original, en lugar de comparar páginas renderizadas sin relación entre sí.

Solo cambian los segmentos traducidos y el atributo de idioma del elemento <html> explícito; el código fuente que no se modifica se copia directamente en el resultado. El procesador no elimina el contenido potencialmente peligroso del HTML que no es de confianza. Mantén las comprobaciones de seguridad y renderizado propias de tu aplicación.

Si un anidamiento incorrecto hace que el analizador combine texto de partes del marcado que no están relacionadas, el procesador rechaza el documento en lugar de generar una traducción ambigua. Corrige el anidamiento y vuelve a intentarlo. Cuando la omisión de etiquetas HTML es válida, no hace falta añadir una estructura de documento.

Configura archivos HTML en la CLI o en la GitHub App #

La CLI y la GitHub App deducen html a partir de .html y .htm. Selecciona los archivos de origen en .lingo/config.json y deja los archivos de destino generados fuera de los patrones de origen:

json
{
  "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 a tu organización y a tu motor de localización mediante la configuración de la CLI, o indica el motor para la GitHub App. Cada traducción se guarda en un archivo independiente por idioma, como pages/fr/index.html. HTML no admite la traducción limitada a claves específicas.

Tras recuperar el documento o fragmento, renderízalo en el sistema que lo utiliza. Compara los enlaces y los atributos no textuales, y revisa el texto de accesibilidad junto con el texto visible. Si el HTML procede de un CMS, sigue las instrucciones de selección de campos y escritura de resultados de ese conector; los conectores pueden aceptar entradas distintas aunque el procesamiento de HTML forme parte de su implementación.