Documentação Universally

Guias passo a passo, dicas de SEO multilíngue e melhores práticas para ajudar você a traduzir e escalar seu site WordPress.

Correspondência de padrões

Um padrão é uma regra que abrange uma família de termos. Em vez de listar cinco mil códigos de produto, você descreve o formato deles uma vez: STK{n:3} significa as letras STK seguidas por exatamente três dígitos, o que abrange STK110 e STK002 e qualquer outro código desse formato.

Defina Correspondência para Padrão na gaveta de regras e Termo se torna um padrão em vez de texto literal. Esta página é a referência completa para o que você pode escrever lá.

A ideia

Um padrão é texto fixo mais um ou mais espaços. O texto fixo deve aparecer exatamente. Um espaço representa a parte que varia.

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

Tudo fora das chaves é literal, e nada mais é especial. R#{n} corresponde a R#11223, e o # não precisa de escape. Apenas { e } são reservados.

A pré-visualização ao vivo

Conforme você digita um padrão, a gaveta mostra três coisas: o que o padrão significa em linguagem simples, três exemplos gerados que correspondem a ele e uma caixa para colar uma string real e ver se ela corresponde.

Use a caixa. Ela executa o mesmo correspondente que o tradutor executa, então uma string que corresponde lá corresponderá em suas páginas, e uma que não corresponde, não corresponderá. É mais rápido do que raciocinar sobre a sintaxe.

Espaços

Espaço Corresponde
{n} dígitos
{a} letras
{w} letras ou dígitos
{h} caracteres hexadecimais, 0 a 9 e a a f
{s} letras, dígitos, hifens e underscores

Um espaço sem especificador significa um ou mais caracteres.

Escolhendo entre {w} e {s}

{w} para em letras e dígitos. {s} também permite hifens e underscores, que é o que você precisa quando a parte variável é um único slug:

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

{w} é deliberadamente sem pontuação, porque a pontuação tem uma segunda função. Dois espaços de extremidade aberta precisam de um separador que nenhum deles possa corresponder, e manter - fora de {w} é o que torna SKU-{w}-{w} possível.

A mesma troca se aplica a {s}. Como {s} contém -, um padrão como {s}-{s} é recusado, e você usaria {w} entre os hifens em vez disso.

Limites

Adicione um comprimento para fixar um espaço:

Escrito Significa
{n:3} exatamente três dígitos
{n:2-4} dois a quatro dígitos
{n} um ou mais dígitos

O maior comprimento que você pode solicitar é 40.

Limites valem a pena as digitações. STK{n:3} corresponde a STK110 e ignora STK1234; STK{n} corresponde a ambos. Se seus códigos tiverem uma largura fixa, diga isso.

Espaços numerados para traduções

Um padrão associado a uma tradução precisa de espaços numerados em ambos os lados, para que os valores capturados caiam nos lugares certos:

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

Os números importam porque as línguas reordenam. Isto é igualmente válido e coloca o segundo valor primeiro:

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

Ambos os lados devem conter o mesmo conjunto de números. Página {n1} de {n2} associado a Seite {n1} é recusado quando você salva, porque o segundo valor não teria para onde ir.

Espaços não numerados são aceitáveis para uma regra de Manter como está, onde nada é substituído.

Onde um padrão corresponde

Um padrão corresponde a uma palavra inteira, não a parte de uma. Mais precisamente: o texto é dividido por espaços em branco, a pontuação das bordas é removida de cada pedaço, e o padrão deve corresponder a um pedaço de início a fim.

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

A pontuação removida das bordas é exatamente . , ; : ! ? ( ) ' ". Hífens, underscores, barras e hashes não são removidos, porque espaços e texto fixo os contêm legitimamente. É por isso que ref:STK110 não corresponde a STK{n}: o dois-pontos fica dentro da palavra em vez de em sua borda.

Diferenças de espaçamento dentro de um padrão de várias palavras são toleradas. Número do Pedido {n} corresponde a texto onde essas duas palavras são separadas por uma quebra de linha ou um espaço duplo.

Padrões de várias palavras

Um padrão pode abranger até quatro palavras:

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

O que um padrão não aceitará

Padrões são deliberadamente estreitos. Uma regra que corresponde a muito para silenciosamente de traduzir frases reais, o que é mais difícil de notar do que uma regra que nunca dispara. Estes são recusados quando você salva, cada um com uma mensagem nomeando a correção.

Texto fixo insuficiente. {n} sozinho corresponderia a todos os números na página, e a{w} corresponderia a todas as palavras que começam com a. Adicione texto fixo, como STK{n}.

Um caractere é suficiente quando uma palavra comum não pode contê-lo, então #{w} e /{n} são aceitos. Hífens, apóstrofos, pontos e underscores não contam, porque palavras os contêm: {w}-{w} corresponderia a “well-known”.

Mais de quatro espaços, ou mais de quatro palavras.

Um espaço desconhecido. {num} não é um espaço. Os cinco na tabela acima são o conjunto completo.

Um comprimento que não faz sentido, como {n:9-2}, ou um acima de 40.

Dois espaços abertos sem nada entre eles. {w}{w} não tem ponto de divisão definido. Nem 0{n}0{n}, porque o 0 entre os espaços é em si um dígito que qualquer um dos espaços poderia corresponder. Coloque algo entre eles que nenhum espaço corresponda, como REF-{w}-{w}.

Um número repetido, como Página {n1} de {n1}.

Chaves são reservadas no modo Padrão. Se o seu termo contiver genuinamente { ou }, use Termo exato, onde nada é interpretado.

Exemplos

Padrão Corresponde Não corresponde
STK{n:3} STK110, STK002, códigos de produto de largura fixa STK1234, STK oferta especial
STK{n} STK1, STK110, STK1234 STK sozinho
R#{n} R#11223, uma referência interna R# pendente de revisão
#{h:6} #3faf21, uma cor hexadecimal em documentos de design #zzz
#{s} #spring_sale, #spring-sale, hashtags de campanha #spring sale, duas palavras
SKU-{a:2}-{n} SKU-AB-4471 SKU-A-4471, falta uma letra
v{n}.{n}.{n} v2.10.4, uma versão de lançamento v2.10
Página {n1} de {n2} Página 12 de 34 Página um de dois

Custo

Um padrão que corresponde a uma string inteira é resolvido sem chamar o tradutor, portanto, não custa palavras e não armazena nenhuma tradução. Uma página de códigos de produto coberta por uma regra STK{n:3} é a coisa mais barata que o glossário faz.

Um padrão encontrado dentro de uma frase mais longa ainda envia essa frase para o tradutor, com o texto correspondente passado como uma instrução. Veja Como as regras são aplicadas.

As regras de padrão são limitadas a 50 por espaço de trabalho, dentro do limite geral de 500, porque cada uma custa mais para avaliar em cada visualização de página do que um termo exato.

Isso foi útil?