Documentazione Universally

Guide passo-passo, suggerimenti SEO multilingue e best practice per aiutarti a tradurre e scalare il tuo sito WordPress.

Corrispondenza di pattern

Un pattern è una regola che copre una famiglia di termini. Invece di elencare cinquemila codici prodotto, ne descrivi la forma una sola volta: STK{n:3} significa le lettere STK seguite da esattamente tre cifre, il che copre STK110 e STK002 e ogni altro codice di quella forma.

Imposta Corrispondenza su Pattern nel pannello delle regole e Termine diventa un pattern invece di testo letterale. Questa pagina è il riferimento completo per ciò che puoi scrivere lì.

L'idea

Un pattern è testo fisso più uno o più slot. Il testo fisso deve apparire esattamente. Uno slot rappresenta la parte che varia.

STK{n:3}
^^^  ^^^^
|    a slot: exactly three digits
fixed text

Tutto ciò che è al di fuori delle parentesi graffe è letterale, e nient'altro è speciale. R#{n} corrisponde a R#11223, e il # non necessita di escape. Solo { e } sono riservati.

L'anteprima live

Mentre digiti un pattern, il pannello mostra tre cose: cosa significa il pattern in linguaggio semplice, tre esempi generati che lo corrispondono e una casella per incollare una stringa reale e vedere se corrisponde.

Usa la casella. Esegue lo stesso motore di corrispondenza che esegue il traduttore, quindi una stringa che corrisponde lì corrisponderà nelle tue pagine, e una che non corrisponde, non corrisponderà. È più veloce che ragionare sulla sintassi.

Slot

Slot Corrisponde
{n} cifre
{a} lettere
{w} lettere o cifre
{h} caratteri esadecimali, 0 a 9 e a a f
{s} lettere, cifre, trattini e underscore

Uno slot vuoto significa un carattere o più.

Scegliere tra {w} e {s}

{w} si ferma a lettere e cifre. {s} consente anche trattini e underscore, che sono ciò di cui hai bisogno quando la parte variabile è un singolo slug:

#{w}   matches #springsale        not #spring_sale or #spring-sale
#{s}   matches #spring_sale, #spring-sale, and #springsale

{w} è deliberatamente privo di punteggiatura, perché la punteggiatura ha un secondo lavoro. Due slot aperti necessitano di un separatore che nessuno dei due può eguagliare, e tenere - fuori da {w} è ciò che rende possibile SKU-{w}-{w}.

Lo stesso compromesso si applica a {s}. Poiché {s} contiene -, un pattern come {s}-{s} viene rifiutato e useresti {w} tra i trattini invece.

Limiti

Aggiungi una lunghezza per bloccare uno slot:

Scritto Significa
{n:3} esattamente tre cifre
{n:2-4} da due a quattro cifre
{n} una o più cifre

La lunghezza massima che puoi richiedere è 40.

I limiti valgono la pena di essere digitati. STK{n:3} corrisponde a STK110 e ignora STK1234; STK{n} corrisponde a entrambi. Se i tuoi codici hanno una larghezza fissa, dillo.

Slot numerati per le traduzioni

Un pattern associato a una traduzione necessita di slot numerati su entrambi i lati, in modo che i valori catturati atterrino nei posti giusti:

Term         Page {n1} of {n2}
Translation  Seite {n1} von {n2}

I numeri contano perché le lingue riordinano. Questo è ugualmente valido e mette il secondo valore per primo:

Term         Page {n1} of {n2}
Translation  {n2} sayfadan {n1}. sayfa

Entrambi i lati devono avere lo stesso set di numeri. Pagina {n1} di {n2} associato a Pagina {n1} viene rifiutato al salvataggio, perché il secondo valore non avrebbe dove andare.

Gli slot non numerati vanno bene per una regola Mantieni così com'è, dove nulla viene sostituito.

Dove un pattern corrisponde

Un pattern corrisponde a una parola intera, non a una parte di essa. Più precisamente: il testo viene diviso in base agli spazi, la punteggiatura ai bordi viene rimossa da ogni pezzo e il pattern deve corrispondere a un pezzo dall'inizio alla fine.

rule:  Keep as is, pattern "#{w}"

"#hashtag"                  match
"This is #hashtag here!"    match, the trailing ! is trimmed
"(#hashtag)"                match, the brackets are trimmed
"#hashtag, #other"          both match

"This is#hashtag here"      no match, the word does not start with #
"a#hashtag"                 no match, same reason
"##hashtag"                 no match, the second # is not a letter or digit
"This is # hashtag"         no match, the space splits it into two words

La punteggiatura rimossa dai bordi è esattamente . , ; : ! ? ( ) ' ". Trattini, underscore, barre e cancelletti non vengono rimossi, perché slot e testo fisso li contengono legittimamente. Ecco perché ref:STK110 non corrisponde a STK{n}: i due punti si trovano all'interno della parola piuttosto che al suo bordo.

Le differenze di spaziatura all'interno di un pattern multi-parola sono tollerate. Numero Ordine {n} corrisponde a testo in cui quelle due parole sono separate da un a capo o da uno spazio doppio.

Pattern multi-parola

Un pattern può estendersi fino a quattro parole:

RTX {n:4}              matches "The RTX 4090 is fast"
{a:2}{n:2} {n}{a:2}    matches "Ship to AB12 3CD please", a UK postcode

Cosa un pattern non accetterà

I pattern sono deliberatamente stretti. Una regola che corrisponde troppo silenziosamente smette di tradurre frasi reali, il che è più difficile da notare di una regola che non viene mai attivata. Questi vengono rifiutati al salvataggio, ognuno con un messaggio che indica la correzione.

Testo fisso insufficiente. {n} da solo corrisponderebbe a ogni numero nella pagina e a{w} corrisponderebbe a ogni parola che inizia con a. Aggiungi testo fisso, come STK{n}.

Un carattere è sufficiente quando una parola ordinaria non può contenerlo, quindi #{w} e /{n} sono accettati. Trattini, apostrofi, punti e underscore non contano, perché le parole li contengono: {w}-{w} corrisponderebbe a “well-known”.

Più di quattro slot, o più di quattro parole.

Uno slot sconosciuto. {num} non è uno slot. I cinque nella tabella sopra sono l'intero set.

Una lunghezza che non ha senso, come {n:9-2}, o una superiore a 40.

Due slot aperti senza nulla in mezzo. {w}{w} non ha un punto di divisione definito. Né lo ha 0{n}0{n}, perché lo 0 tra gli slot è esso stesso una cifra che uno slot potrebbe corrispondere. Metti qualcosa tra di loro che nessuno slot corrisponde, come REF-{w}-{w}.

Un numero ripetuto, come Pagina {n1} di {n1}.

Le parentesi graffe sono riservate in modalità Pattern. Se il tuo termine contiene genuinamente { o }, usa Termine esatto, dove nulla viene interpretato.

Esempi

Pattern Corrisponde Non corrisponde
STK{n:3} STK110, STK002, codici prodotto a larghezza fissa STK1234, STK offerta speciale
STK{n} STK1, STK110, STK1234 STK da solo
R#{n} R#11223, un riferimento interno R# in attesa di revisione
#{h:6} #3faf21, un colore esadecimale nei documenti di progettazione #zzz
#{s} #spring_sale, #spring-sale, hashtag di campagna #spring sale, due parole
SKU-{a:2}-{n} SKU-AB-4471 SKU-A-4471, una lettera in meno
v{n}.{n}.{n} v2.10.4, una versione di rilascio v2.10
Pagina {n1} di {n2} Pagina 12 di 34 Pagina uno di due

Costo

Un modello che corrisponde a un'intera stringa viene risolto senza chiamare il traduttore, quindi non costa parole e non memorizza alcuna traduzione. Una pagina di codici prodotto coperta da una regola STK{n:3} è la cosa più economica che il glossario fa.

Un modello trovato all'interno di una frase più lunga invia comunque quella frase al traduttore, con il testo corrispondente passato come istruzione. Vedere Come vengono applicate le regole.

Le regole dei modelli sono limitate a 50 per area di lavoro, all'interno del limite complessivo di 500, poiché ognuna costa di più da valutare a ogni visualizzazione di pagina rispetto a un termine esatto.

È stato utile?