Placeholder-Erkennung und -Anpassung in PTC

Placeholder speichern dynamische Werte in Software, wie Namen und Daten. Erfahren Sie, wie PTC gängige Placeholder-Formate während der Übersetzung erkennt und Ihnen ermöglicht, eigene hinzuzufügen.

PTC erkennt Placeholder in Zeichenketten und lässt sie während der Übersetzung unverändert. Da verschiedene Ressourcendateiformate ihre eigene Placeholder-Syntax haben, PTC:

  • Erkennt gängige Placeholder-Formate mithilfe vordefinierter Regex-Muster
  • Wendet formatspezifische Regeln an, um Placeholder korrekt zu identifizieren und zu verarbeiten

Hier sind Beispiele für gängige unterstützte Placeholder-Formate, zusammen mit den regulären Ausdrücken (Regex), die zu ihrer Erkennung verwendet werden:

Placeholder-Beispiel

%service%
%{service}
:service:
${service}
$service$
''service''
[service]
@[service]
{{service}}, {{service_name}}
{service}, {service_name}

Placeholder-Beispiel

%service%
%{service}
:service:
${service}
$service$
''service''
[service]
@[service]
{{service}}, {{service_name}}
{service}, {service_name}

Placeholder-Beispiel

Regulärer Ausdruck (Regex)

%service%
\%\w+\%
%{service}
\%\{\w+\}
:service:
\:\w+\:
${service}
\$\{\w+\}
$service$
\$\w+\$
''service''
\'\'\w+\'\' 
[service]
\[\w+\] 
@[service]
\@\[\w+\]
{{service}}, {{service_name}}
\{\{[\w_-]+\}\}
{service}, {service_name}
\{[\w_-]+\}

Hinzufügen eigener Placeholder

Ihre Ressourcendateien können nicht-standardisierte Placeholder enthalten oder solche, die PTC nicht erkennt. Sie können eigene Placeholder hinzufügen, um sicherzustellen, dass PTC sie während der Übersetzung erkennt und beibehält.

Auf der Seite Einstellungen → Zeichenketten-Placeholder listet PTC vordefinierte Placeholder basierend auf der erkannten Projektstruktur und den Typen der Ressourcendateien in Ihrem Projekt auf.

Hier können Sie:

  • Bestehende Placeholder für das gesamte Projekt oder für einen bestimmten Ressourcendateityp bearbeiten oder entfernen.
  • Neue Placeholder-Formate hinzufügen, wenn Ihr Projekt oder Ihre Ressourcendateien eine einzigartige Struktur verwenden, die standardmäßig nicht erkannt wird

Nachdem Sie Änderungen vorgenommen haben, speichern Sie Ihre Einstellungen, um die Aktualisierungen zu übernehmen.

Best Practices für eigene Placeholder

Beim Hinzufügen eigener Placeholder beachten Sie diese Best Practices, um Übersetzungsprobleme zu vermeiden:

Placeholder einfach halten

Übermäßig komplexe Placeholder-Formate sind für Systeme schwerer korrekt zu erkennen und zu interpretieren. Zum Beispiel:

  • Bevorzugt: <name>
  • Übermäßig komplex: <user-name&role-123>

Einzigartige Formate verwenden

Wenn zwei Placeholder Teile ihrer Struktur teilen, können Übersetzungstools oft nicht zwischen ihnen unterscheiden. Betrachten Sie zum Beispiel diesen komplexen und einfachen Placeholder, die sich unbeabsichtigt überschneiden:

  • Komplexer Placeholder: {user_details}
  • Einfacher Placeholder: {user}

In diesem Beispiel könnte {user_details} fälschlicherweise als {user} erkannt werden, da {user} Teil des komplexen Placeholder ist.

Wörter zwischen Placeholder für den Kontext verwenden

Umgebende Wörter liefern Kontext, der PTC hilft zu verstehen, wie Placeholder in einen Satz passen. Verlassen Sie sich nicht auf menschliche Notizen zur Klärung von Placeholder, da PTC diese nicht verarbeitet. Machen Sie stattdessen Placeholder direkt aus der Zeichenkette klar.

  • Bevorzugt: "Hello, <name>! Your order number is <order_number>."
  • Nicht empfohlen: "<name> <order_number>"

Was passiert, wenn PTC Probleme mit Ihren Placeholder feststellt?

PTC kennzeichnet Zeichenketten, die aus verschiedenen Gründen unklar sind, wie zum Beispiel:

  • Zu viele Placeholder mit nicht ausreichendem Kontext haben
  • Mehrdeutigen Text enthalten
  • Ein-Wort-Zeichenketten sein

Wenn dies geschieht, sehen Sie eine empfohlene Aktion in Ihrem PTC-Dashboard, die Sie auffordert, unklare Zeichenketten zu überprüfen. Um Zeichenketten mit unklaren Placeholder zu beheben, können Sie:

  • Die Zeichenkette direkt in Ihrem Projekt aktualisieren—zum Beispiel durch Vereinfachen oder Neuanordnen der Placeholder-Formate.
  • Anweisungen von PTC befolgen, um weitere Informationen über den Zweck der Placeholder bereitzustellen.

Nach oben scrollen