Detecção e personalização de placeholders na PTC
Os placeholders armazenam valores dinâmicos em softwares, como nomes e datas. Aprenda como a PTC detecta formatos comuns de placeholders durante a tradução e permite que você adicione formatos personalizados.
A PTC detecta placeholders em strings e os mantém inalterados durante a tradução. Como diferentes formatos de arquivos de recursos têm sua própria sintaxe de placeholder, a PTC:
- Reconhece formatos comuns de placeholders usando padrões regex predefinidos
- Aplica regras específicas de formato para identificar e lidar corretamente com os placeholders
Aqui estão exemplos de formatos de placeholders suportados e comumente usados, junto com as expressões regulares (regex) usadas para detectá-los:
Exemplo de placeholder
%service%
%{service}
:service:
${service}
$service$
''service''
[service]
@[service]
{{service}}, {{service_name}}
{service}, {service_name}
Expressão regular (Regex)
\%\w+\%
\%\{\w+\}
\:\w+\:
\$\{\w+\}
\$\w+\$
\'\'\w+\'\'
\[\w+\]
\@\[\w+\]
\{\{[\w_-]+\}\}
\{[\w_-]+\}
Adicionando placeholders personalizados
Seus arquivos de recursos podem ter placeholders fora do padrão ou que a PTC não reconhece. Você pode adicionar placeholders personalizados para garantir que a PTC os detecte e preserve durante a tradução.
Na página Settings → String Placeholders, a PTC lista placeholders predefinidos com base na estrutura detectada do projeto e nos tipos de arquivos de recursos no seu projeto.
Aqui, você pode:
- Editar ou remover placeholders existentes para todo o projeto ou para um tipo específico de arquivo de recursos.
- Adicionar novos formatos de placeholders se o seu projeto ou arquivos de recursos usarem uma estrutura única que não é reconhecida por padrão.
Após fazer qualquer alteração, salve suas configurações para aplicar as atualizações.
Melhores práticas para placeholders personalizados
Ao adicionar placeholders personalizados, siga estas melhores práticas para evitar problemas de tradução:
Mantenha os placeholders simples
Formatos de placeholders excessivamente complexos são mais difíceis de serem reconhecidos e interpretados corretamente pelos sistemas. Por exemplo:
- Preferencial:
<name> - Excessivamente complexo:
<user-name&role-123>
Use formatos únicos
Quando dois placeholders compartilham partes de sua estrutura, as ferramentas de tradução frequentemente não conseguem distingui-los. Por exemplo, dê uma olhada nestes dois placeholders - um complexo, um simples - que se sobrepõem acidentalmente:
- Placeholder complexo:
{user_details} - Placeholder simples:
{user}
Neste exemplo, {user_details} pode ser detectado erroneamente como {user} porque {user} faz parte do placeholder complexo.
Use palavras entre os placeholders para dar contexto
As palavras ao redor fornecem contexto que ajuda a PTC a entender como os placeholders se encaixam em uma frase. Não dependa de notas humanas para esclarecer os placeholders, pois a PTC não as processa. Em vez disso, torne os placeholders claros a partir da string.
- Preferencial:
"Hello, <name>! Your order number is <order_number>." - Não recomendado:
"<name> <order_number>"
O que acontece se a PTC encontrar problemas com seus placeholders?
A PTC sinaliza strings que não são claras por diferentes motivos, como:
- Ter muitos placeholders sem contexto suficiente
- Conter texto ambíguo
- Serem strings de uma única palavra
Se isso acontecer, você verá uma ação recomendada no seu painel da PTC solicitando que você revise as strings não claras. Para resolver strings com placeholders não claros, você pode:
- Atualizar a string diretamente no seu projeto — por exemplo, simplificando ou reordenando os formatos de placeholders.
- Seguir os prompts da PTC para fornecer mais informações sobre o propósito dos placeholders.