Erkennung und Anpassung von Platzhaltern in PTC

Platzhalter speichern dynamische Werte in Software, wie Namen und Datumsangaben. Erfahren Sie, wie PTC gängige Platzhalterformate bei der Übersetzung erkennt und wie Sie benutzerdefinierte Platzhalter hinzufügen können.

PTC erkennt Platzhalter in Strings und belässt sie während der Übersetzung unverändert. Da verschiedene Ressourcendateiformate ihre eigene Platzhaltersyntax aufweisen, führt PTC Folgendes aus:

• Erkennt gängige Platzhalterformate anhand vordefinierter Regex-Muster
• Wendet formatspezifische Regeln an, um Platzhalter korrekt zu identifizieren und zu verarbeiten

Hier sind Beispiele für häufig verwendete, unterstützte Platzhalterformate sowie die regulären Ausdrücke (Regex), die zu ihrer 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_-]+\}

Hinzufügen benutzerdefinierter Platzhalter

Ihre Ressourcendateien enthalten möglicherweise nicht standardmäßige Platzhalter oder solche, die von PTC nicht erkannt werden. Sie können benutzerdefinierte Platzhalter hinzufügen, um sicherzustellen, dass PTC diese bei der Übersetzung erkennt und beibehält.

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

Hier können Sie:

• Vorhandene Platzhalter für das gesamte Projekt oder für einen bestimmten Ressourcendateityp bearbeiten oder entfernen.
• Neue Platzhalterformate hinzufügen, wenn Ihr Projekt oder Ihre Ressourcendateien eine spezielle Struktur verwenden, die standardmäßig nicht erkannt wird.

Nachdem Sie Änderungen vorgenommen haben, speichern Sie Ihre Einstellungen, um die Aktualisierungen anzuwenden.

Best Practices für benutzerdefinierte Platzhalter

Wenn Sie benutzerdefinierte Platzhalter hinzufügen, befolgen Sie diese Best Practices, um Übersetzungsfehler zu vermeiden:

Platzhalter einfach halten

Zu komplexe Platzhalterformate sind für Systeme schwerer zu erkennen und korrekt zu interpretieren. Zum Beispiel:

• Bevorzugt: <name>
• Zu komplex: <user-name&role-123>

Eindeutige Formate verwenden

Wenn zwei Platzhalter Teile ihrer Struktur gemeinsam haben, können Übersetzungstools sie oft nicht voneinander unterscheiden. Sehen Sie sich zum Beispiel diese beiden Platzhalter an – 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} Teil des komplexen Platzhalters ist.

Wörter zwischen Platzhaltern für mehr Kontext verwenden

Umgebende Wörter bieten Kontext, der PTC hilft zu verstehen, wie sich Platzhalter in einen Satz einfügen. Verlassen Sie sich nicht auf menschliche Notizen zur Klärung von Platzhaltern, da PTC diese nicht verarbeitet. Machen Sie Platzhalter stattdessen durch den String selbst eindeutig.

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

Was passiert, wenn PTC auf Fehler bei Ihren Platzhaltern stößt?

PTC kennzeichnet Strings, die aus verschiedenen Gründen unklar sind, beispielsweise aufgrund von:

• Zu vielen Platzhaltern mit unzureichendem Kontext
• Mehrdeutigem Text
• Strings, die nur aus einem Wort bestehen

In diesem Fall sehen Sie in Ihrem PTC-Dashboard eine Empfohlene Aktion, die Sie dazu auffordert, unklare Strings zu überprüfen. Um Strings mit unklaren Platzhaltern zu bearbeiten, können Sie:

• Den String direkt in Ihrem Projekt aktualisieren – zum Beispiel, indem Sie die Platzhalterformate vereinfachen oder neu anordnen.
• Den Aufforderungen von PTC folgen, um weitere Informationen zum Zweck der Platzhalter bereitzustellen.