Platzhalter-Erkennung und Anpassung in PTC

Platzhalter speichern dynamische Werte wie Namen und Daten in Software. Erfahren Sie, wie PTC gängige Platzhalter-Formate während der Übersetzung erkennt und wie Sie benutzerdefinierte Formate hinzufügen können.

PTC erkennt Platzhalter in Strings und lässt diese während der Übersetzung unverändert. Da verschiedene Ressourcendateiformate ihre eigene Platzhalter-Syntax haben, führt PTC folgende Schritte aus:

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

Hier sind Beispiele für häufig verwendete, unterstützte Platzhalter-Formate zusammen mit den regulären Ausdrücken (Regex), die zu deren Erkennung verwendet werden:

Platzhalter-Beispiel

%service%

%{service}

:service:

${service}

$service$

''service''

[service]

@[service]

{{service}}, {{service_name}}

{service}, {service_name}

Regulärer Ausdruck (Regex)

\%\w+\%

\%\{\w+\}

\:\w+\:

\$\{\w+\}

\$\w+\$

\'\'\w+\'\'

\[\w+\]

\@\[\w+\]

\{\{[\w_-]+\}\}

\{[\w_-]+\}

Benutzerdefinierte Platzhalter hinzufügen

Ihre Ressourcendateien enthalten möglicherweise nicht standardisierte Platzhalter oder solche, die PTC nicht automatisch erkennt. Sie können benutzerdefinierte Platzhalter hinzufügen, um sicherzustellen, dass PTC diese während der Übersetzung erkennt und beibehält.

Auf der Seite Settings → String Placeholders listet PTC vordefinierte Platzhalter auf, basierend auf der erkannten Projektstruktur und den Typen der Ressourcendateien in Ihrem Projekt.

Hier können Sie:

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

Speichern Sie Ihre Einstellungen nach jeder Änderung, um die Aktualisierungen zu übernehmen.

Best Practices für benutzerdefinierte Platzhalter

Befolgen Sie beim Hinzufügen benutzerdefinierter Platzhalter diese Best Practices, um Übersetzungsprobleme zu vermeiden:

Platzhalter einfach halten

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

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

Eindeutige Formate verwenden

Wenn zwei Platzhalter eine ähnliche Struktur aufweisen, können Übersetzungstools diese oft nicht voneinander unterscheiden. Betrachten Sie zum Beispiel diese zwei Platzhalter – einen komplexen und einen einfachen –, die sich unbeabsichtigt überschneiden:

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

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

Wörter zwischen Platzhaltern für den Kontext nutzen

Umgebende Wörter liefern Kontext, der PTC hilft zu verstehen, wie Platzhalter in einen Satz passen. Verlassen Sie sich nicht auf Anmerkungen für Übersetzer, um Platzhalter zu klären, da PTC diese nicht verarbeitet. Machen Sie stattdessen die Bedeutung der Platzhalter aus dem String heraus deutlich.

• Bevorzugt: "Hallo, <name>! Ihre Bestellnummer lautet <order_number>."
• Nicht empfohlen: "<name> <order_number>"

Was passiert, wenn PTC Probleme mit Ihren Platzhaltern feststellt?

PTC markiert Strings, die aus verschiedenen Gründen unklar sind, wie zum Beispiel:

• Zu viele Platzhalter mit zu wenig Kontext
• Mehrdeutiger Text
• Strings, die nur aus einem einzelnen Wort bestehen

In diesem Fall sehen Sie in Ihrem PTC Dashboard eine Handlungsempfehlung, die Sie auffordert, unklare Strings zu überprüfen. Um Probleme mit unklaren Platzhaltern zu beheben, können Sie:

• Den String direkt in Ihrem Projekt aktualisieren — zum Beispiel, indem Sie die Platzhalter-Formate vereinfachen oder umstrukturieren.
• Den Anweisungen von PTC folgen, um weitere Informationen zum Zweck der Platzhalter bereitzustellen.