Los placeholders almacenan valores dinámicos en el software, como nombres y fechas. Aprenda cómo PTC detecta formatos de placeholder comunes durante la traducción y le permite añadir otros personalizados.
PTC detecta placeholders en cadenas y los mantiene sin cambios durante la traducción. Dado que los diferentes formatos de archivo de recursos tienen su propia sintaxis de placeholder, PTC:
- Reconoce formatos de placeholder comunes utilizando patrones regex predefinidos
- Aplica reglas específicas del formato para identificar y gestionar correctamente los placeholders
Aquí tiene ejemplos de formatos de placeholder admitidos de uso común, junto con las expresiones regulares (regex) utilizadas para detectarlos:
Ejemplo de placeholder
%service%
%{service}
:service:
${service}
$service$
''service''
[service]
@[service]
{{service}}, {{service_name}}
{service}, {service_name}
Expresión regular (Regex)
\%\w+\%
\%\{\w+\}
\:\w+\:
\$\{\w+\}
\$\w+\$
''\w+''
\[\w+\]
\@\[\w+\]
\{\{[\w_-]+\}\}
\{[\w_-]+\}
Añadir placeholders personalizados
Es posible que sus archivos de recursos tengan placeholders no estándar o que PTC no reconozca. Puede añadir placeholders personalizados para asegurarse de que PTC los detecta y los conserva durante la traducción.
En la página Ajustes → Placeholders de cadena, PTC muestra los placeholders predefinidos en función de la estructura del proyecto detectada y los tipos de archivos de recursos de su proyecto.
Aquí puede:
- Editar o eliminar placeholders existentes para todo el proyecto o para un tipo de archivo de recursos específico.
- Añadir nuevos formatos de placeholder si su proyecto o archivos de recursos utilizan una estructura única que no se reconoce de forma predeterminada
Después de realizar cualquier cambio, guarde los ajustes para aplicar las actualizaciones.
Prácticas recomendadas para placeholders personalizados
Al añadir placeholders personalizados, siga estas prácticas recomendadas para evitar problemas de traducción:
Mantenga los placeholders sencillos
Los formatos de placeholder excesivamente complejos son más difíciles de reconocer e interpretar correctamente para los sistemas. Por ejemplo:
- Preferido:
<name> - Excesivamente complejo:
<user-name&role-123>
Utilice formatos únicos
Cuando dos marcadores de posición comparten partes de su estructura, las herramientas de traducción a menudo no pueden distinguirlos. Por ejemplo, eche un vistazo a este marcador de posición complejo y simple que se superponen involuntariamente:
- Placeholder complejo:
{user_details} - Placeholder sencillo:
{user}
En este ejemplo, {user_details} podría detectarse erróneamente como {user} porque {user} forma parte del placeholder complejo.
Utilice palabras entre placeholders para el contexto
Las palabras circundantes proporcionan un contexto que ayuda a PTC a comprender cómo encajan los placeholders dentro de una frase. No confíe en notas humanas para aclarar los placeholders, ya que PTC no las procesa. En su lugar, haga que los placeholders queden claros a partir de la cadena.
- Preferido:
"Hello, <name>! Your order number is <order_number>." - No recomendado:
"<name> <order_number>"
¿Qué ocurre si PTC encuentra problemas con sus placeholders?
PTC marca las cadenas que no están claras por diferentes motivos, como:
- Tener demasiados placeholders sin suficiente contexto
- Contener texto ambiguo
- Ser cadenas de una sola palabra
Si esto ocurre, verá una acción recomendada en su panel de PTC que le indicará que revise las cadenas poco claras. Para abordar las cadenas con placeholders poco claros, puede:
- Actualizar la cadena directamente en su proyecto; por ejemplo, simplificando o reordenando los formatos de placeholder.
- Seguir las indicaciones de PTC para proporcionar más información sobre el propósito de los placeholders.
