Universally traduce il testo visibile su una pagina più i metadati che motori di ricerca e piattaforme social leggono. Non configuri nulla di tutto ciò. Succede ad ogni richiesta, e questa pagina è l'elenco esatto in modo da sapere cosa aspettarsi prima di iniziare a escludere elementi.
Contenuto visibile
Tutto il testo che un visitatore può leggere: titoli, paragrafi, elenchi, collegamenti, pulsanti, celle di tabelle ed etichette.
Attributi
Testo non visibile come contenuto della pagina ma letto ad alta voce, mostrato al passaggio del mouse o visualizzato quando qualcosa non viene caricato:
| Attributo | Dove appare |
|---|---|
alt |
testo alternativo dell'immagine, letto dagli screen reader e mostrato quando un'immagine non viene caricata |
title |
testo del tooltip al passaggio del mouse |
placeholder |
l'indizio grigio all'interno di un campo di inserimento vuoto |
etichetta aria |
il nome accessibile di un controllo senza testo visibile |
valore |
il testo sui pulsanti input come submit e reset, e su qualsiasi elemento che porti anche un attributo title |
La traduzione di alt e aria-label è il motivo per cui una pagina tradotta rimane utilizzabile con uno screen reader, invece di cambiare lingua visivamente ma non per la tecnologia assistiva.
La regola value coglie un caso che vale la pena conoscere: un input che porta un attributo title traduce anche il suo value, anche se nascosto. Se un valore precompilato è dati piuttosto che testo (un nome, un riferimento, un importo), rimuovi l'attributo title o aggiungi class="notranslate" a quell'input.
Metadati della pagina
L'elemento <title>, più questi meta tag:
| Tag | Usato da |
|---|---|
descrizione |
lo snippet sotto il tuo risultato nella ricerca |
og:title, og:description, og:image:alt, og:site_name |
Facebook, LinkedIn, Slack e chiunque legga Open Graph |
twitter:title, twitter:description, twitter:image:alt |
X e altri lettori di schede Twitter |
Un link condiviso quindi mostra un'anteprima nella lingua del visitatore, non nella lingua di origine.
Dati strutturati
Il testo all'interno di <script type="application/ld+json"> viene tradotto campo per campo, in modo che i rich snippet rimangano nella lingua corretta. I campi coperti sono name, description, headline, alternativeHeadline, articleBody, caption, text, abstract, award, slogan, alternateName e disambiguatingDescription.
I valori che non sono testo leggibile dall'uomo, come URL, date, prezzi e identificatori, vengono lasciati esattamente come sono.
Formattazione e link all'interno di una frase
Una frase viene tradotta come un unico blocco, inclusi i markup al suo interno. Grassetto, corsivo, codice inline, un link, uno <span>: questi elementi rimangono al loro posto anziché essere estratti e riassemblati, in modo che la traduzione mantenga l'enfasi che aveva l'originale.
Prendi questo:
<p>Read the <strong>setup guide</strong> or see <a href="/pricing/">pricing</a>.</p>
Quella è una stringa, non tre. Il traduttore vede la frase con i suoi tag al posto giusto e la restituisce con il testo tradotto e i tag intatti.
I target dei link non vengono mai modificati dalla traduzione. Un href viene messo da parte mentre la frase viene tradotta e reinserito in seguito, in modo che né l'IA né chiunque modifichi la stringa nella dashboard possano alterare la destinazione di un link. I link vengono quindi localizzati in un passaggio separato, che è ciò che trasforma /pricing/ in /es/pricing/ nella pagina spagnola. Vedi Escludi localizzazione link per i percorsi che questo passaggio lascia invariati.
Nell'editor Traduzioni, quel markup messo da parte appare come un segnaposto. Mantieni ciascuno esattamente una volta o il salvataggio verrà rifiutato. Vedi Stati di traduzione.
Cosa non viene mai tradotto
Alcuni contenuti vengono saltati per progettazione e nessuna impostazione li attiva:
| Saltato | Perché |
|---|---|
<script> e <style> |
tradurre il codice romperebbe la pagina |
<pre> |
i campioni di codice preformattato devono rimanere verbatim |
<noscript> |
markup di fallback, non testo rivolto all'utente |
| Un singolo blocco di testo più lungo di 5.000 caratteri | troppo grande per essere tradotto come un'unica unità, quindi viene lasciato nella lingua di origine |
Tre cose sono comunemente considerate in quella lista e non lo sono:
- Il
<code>da solo viene tradotto. Solo<pre>è protetto. Il<code>utilizzato all'interno di una frase viene tradotto con la frase circostante, quindi aggiungiclass="notranslate"a qualsiasi cosa debba rimanere verbatim. - Il testo all'interno di un
<svg>inline viene tradotto quando l'<svg>contiene un elemento<text>. Il markup, i percorsi e gli attributi rimangono intatti, ma le parole visibili in un SVG vengono trattate come qualsiasi altro testo. - Il contenuto precompilato di
<textarea>viene tradotto. Escludilo se contiene dati anziché testo.
Un URL, un indirizzo email o un numero vengono saltati se costituiscono l'intera stringa. All'interno di una frase, vengono tradotti con il resto della frase: i link mantengono il loro href invariato, ma la formattazione di numeri e date in una frase può essere adattata alla lingua di destinazione.
Modifica di ciò che viene tradotto
Quattro controlli, tutti nella schermata Regole di traduzione del progetto. Vedere Regole di traduzione per sapere come usarli.
| Controllo | Effetto |
|---|---|
| Includi selettori CSS | nessun effetto: tutto ciò che contiene testo è già stato tradotto |
| Escludi selettori CSS | salta gli elementi che nomini |
| Escludi pagine | salta URL interi |
| Escludi localizzazione link | impedisci l'aggiunta di codici lingua a percorsi specifici |
Le regole del glossario gestiscono parole singole e frasi che vuoi sempre o mai tradurre, il che è un lavoro diverso dall'escludere una regione della pagina. Vedere Regole del glossario.