Universally traduce el texto visible de una página además de los metadatos que leen los motores de búsqueda y las plataformas sociales. No configuras nada de esto. Sucede en cada solicitud, y esta página es la lista exacta para que sepas qué esperar antes de empezar a excluir cosas.
Contenido visible
Todo el texto que un visitante puede leer: encabezados, párrafos, listas, enlaces, botones, celdas de tabla y etiquetas.
Atributos
Texto que no es visible como contenido de la página pero se lee en voz alta, se muestra al pasar el cursor o se muestra cuando algo no se carga:
| Atributo | Dónde aparece |
|---|---|
alt |
texto alternativo de la imagen, leído por lectores de pantalla y mostrado cuando una imagen falla |
título |
texto de la información sobre herramientas al pasar el cursor |
marcador de posición |
la indicación gris dentro de un campo de entrada vacío |
etiqueta aria |
el nombre accesible de un control sin texto visible |
valor |
el texto en los botones input como submit y reset, y en cualquier elemento que también lleve un atributo title |
Traducir alt y aria-label es la razón por la que una página traducida sigue siendo utilizable con un lector de pantalla, en lugar de cambiar de idioma visualmente pero no para la tecnología de asistencia.
La regla value captura un caso que vale la pena conocer: una entrada que lleva un atributo title también traduce su value, incluso una oculta. Si un valor prellenado es datos en lugar de texto, elimina el atributo title o agrega class="notranslate" a esa entrada.
Metadatos de la página
El elemento <title>, más estas metaetiquetas:
| Etiqueta | Usado por |
|---|---|
descripción |
el fragmento debajo de tu resultado en la búsqueda |
og:title, og:description, og:image:alt, og:site_name |
Facebook, LinkedIn, Slack y cualquier cosa que lea Open Graph |
twitter:title, twitter:description, twitter:image:alt |
X y otros lectores de tarjetas de Twitter |
Por lo tanto, un enlace compartido se previsualiza en el idioma del visitante, no en el idioma de origen.
Datos estructurados
El texto dentro de <script type="application/ld+json"> se traduce campo por campo, para que los resultados enriquecidos permanezcan en el idioma correcto. Los campos cubiertos son name, description, headline, alternativeHeadline, articleBody, caption, text, abstract, award, slogan, alternateName y disambiguatingDescription.
Los valores que no son texto legible por humanos, como URL, fechas, precios e identificadores, se dejan exactamente como están.
Formato y enlaces dentro de una oración
Una oración se traduce como una sola pieza, incluido el marcado dentro de ella. Negrita, cursiva, código en línea, un enlace, un <span>: estos permanecen donde pertenecen en lugar de ser extraídos y reensamblados, por lo que la traducción mantiene el énfasis que tenía el original.
Toma esto:
<p>Read the <strong>setup guide</strong> or see <a href="/pricing/">pricing</a>.</p>
Esa es una cadena, no tres. El traductor ve la oración con sus etiquetas en su lugar y la devuelve con el texto traducido y las etiquetas intactas.
Los destinos de los enlaces nunca se cambian con la traducción. Un href se reserva mientras se traduce la oración y se vuelve a colocar después, por lo que ni la IA ni nadie que edite la cadena en el panel de control pueden alterar a dónde apunta un enlace. Los enlaces se localizan luego en un paso separado, que es lo que convierte /pricing/ en /es/pricing/ en la página en español. Vea Excluir localización de enlaces para las rutas que ese paso deja solas.
En el editor de traducciones, ese marcado reservado aparece como un marcador de posición. Mantenga cada uno exactamente una vez o se rechazará el guardado. Vea Estados de traducción.
Qué nunca se traduce
Algunos contenidos se omiten a propósito, y ninguna configuración lo activa:
| Omitido | Por qué |
|---|---|
<script> y <style> |
traducir código rompería la página |
<pre> |
las muestras de código preformateadas deben permanecer literales |
<noscript> |
marcado de respaldo, no texto visible para el usuario |
| Un solo bloque de texto de más de 5.000 caracteres | demasiado grande para traducir como una unidad, por lo que se deja en el idioma de origen |
Tres cosas se asumen comúnmente en esa lista y no lo están:
- El
<code>por sí solo se traduce. Solo<pre>está protegido. El<code>utilizado dentro de una oración se traduce con la oración que lo rodea, así que agregueclass="notranslate"a cualquier cosa que deba permanecer literal. - El texto dentro de un
<svg>en línea se traduce cuando el<svg>contiene un elemento<text>. El marcado, las rutas y los atributos no se tocan, pero las palabras visibles en un SVG se tratan como cualquier otro texto. - El contenido prellenado de
<textarea>se traduce. Exclúyalo si contiene datos en lugar de texto.
Una URL, una dirección de correo electrónico o un número se omiten cuando constituyen toda la cadena. Dentro de una oración, se traducen junto con el resto de la oración: los enlaces conservan su atributo href intacto, pero el formato de números y fechas en una oración puede adaptarse al idioma de destino.
Cambiar lo que se traduce
Cuatro controles, todos en la pantalla Reglas de traducción del proyecto. Consulte Reglas de traducción para saber cómo usarlos.
| Control | Efecto |
|---|---|
| Incluir selectores CSS | sin efecto: todo lo que contiene texto ya está traducido |
| Excluir selectores CSS | omitir elementos que nombres |
| Excluir páginas | omitir URLs completas |
| Excluir localización de enlaces | evitar que se agreguen códigos de idioma a rutas específicas |
Las reglas del glosario manejan palabras y frases individuales que siempre o nunca quieres traducir, lo cual es una tarea diferente a excluir una región de la página. Consulte Reglas del glosario.