Glossar

Das Glossar ist ein shopweites Vokabular, das die Erweiterung auf jede Übersetzung anwendet. Es enthält zwei Arten von Einträgen: Begriffe, die die Erweiterung niemals übersetzen darf, und Begriffe, die immer dieselbe Übersetzung haben müssen. Sie pflegen das Glossar einmal unter Kataloge → KI-Übersetzung → Glossar, und es gilt für jeden Anbieter.

Sie durchsuchen die Liste nach Begriff. Zusätzlich filtern Sie sie nach Modus und nach Status (Aktiv / Inaktiv). Jede Zeile zeigt den Begriff, seinen Modus, die Beachtung der Groß- und Kleinschreibung, den Aktiv-Status und das Datum der letzten Änderung.

Beibehalten und Ersetzen

Jeder Eintrag hat einen Modus, und zwei unterschiedliche Mechanismen setzen die beiden Modi durch.

Modus	Bezeichnung in der Administration	Wirkung
Beibehalten	Beibehalten (nie übersetzen)	Der Begriff bleibt exakt so stehen wie in der Quelle: Markennamen, Produktlinien, Modellbezeichnungen
Ersetzen	Ersetzen (feste Übersetzung)	Die Erweiterung übersetzt den Begriff in einen Wert, den Sie je Zielsprache festlegen

Beibehalten-Begriffe

Bevor die Erweiterung einen Text an den Anbieter schickt, ersetzt sie jedes Vorkommen eines Beibehalten-Begriffs durch ein Schutz-Token. Der Anbieter übersetzt den Text um dieses Token herum, und die Erweiterung setzt den ursprünglichen Begriff danach wieder ein. Der Begriff erreicht den Anbieter nie als übersetzbaren Text. Deshalb funktioniert der Beibehalten-Modus mit maschineller Übersetzung und mit Sprachmodellen. Sprachmodelle erhalten den Begriff zusätzlich selbst, mit der Anweisung, ihn niemals zu übersetzen.

Wenn der Anbieter ein Token löscht oder beschädigt, kann die Erweiterung den Begriff nicht wiederherstellen. Sie meldet das Feld dann als fehlgeschlagen und schreibt nichts, und die Fehlerliste des Auftrags nennt den Grund. Die übrigen Felder desselben Datensatzes bleiben unberührt.

Ersetzen-Begriffe

Die Erweiterung setzt Ersetzen-Begriffe auf zwei Wegen gleichzeitig durch:

1. Als Anweisung. Die Erweiterung schickt den Begriff und Ihren Wert als ausdrückliche Anweisung zusammen mit dem Übersetzungs-Prompt an die Anbieter mit Sprachmodellen. Das sind OpenAI, Anthropic Claude, Google Gemini, Mistral und modernice All-in-One.
2. Als Nachbearbeitung. Nach der Antwort des Anbieters ersetzt die Erweiterung jedes verbliebene Vorkommen des Quellbegriffs in der Ausgabe durch Ihren Wert. Die Schutz-Token sind zu diesem Zeitpunkt noch gesetzt, deshalb kann die Nachbearbeitung keinen Text innerhalb eines geschützten Beibehalten-Begriffs verändern.

Achtung

Die Nachbearbeitung ersetzt den Quellbegriff nur, solange er in der Ausgabe erkennbar ist. Maschinelle Übersetzer wie DeepL und Google Translate befolgen keine Anweisungen. Sie übersetzen einen Ersetzen-Begriff deshalb unter Umständen, bevor die Nachbearbeitung ihn sieht. Dann steht ein übersetztes Wort dort, wo Ihr fester Wert stehen muss. Bei Sprachmodellen und bei Begriffen, die ein Anbieter ohnehin stehen lässt, sind Ersetzen-Begriffe zuverlässig. Überall sonst sind sie eine Empfehlung. Prüfen Sie repräsentative Ergebnisse für die Anbieter und Sprachen, die Sie einsetzen.

Ein Ersetzen-Eintrag ohne Wert für die Zielsprache des aktuellen Laufs trägt zu diesem Lauf nichts bei. Der Anbieter erhält keine Anweisung dazu, und die Nachbearbeitung überspringt ihn. Nutzen Sie den Beibehalten-Modus, wenn ein Begriff in jeder Sprache geschützt sein muss.

Trefferregeln

• Wortgrenzen. Ein Begriff greift nur als ganzes Wort. Die Erkennung der Wortgrenzen ist Unicode-fähig und geht über die übliche Wortzeichen-Regel hinaus, deshalb greifen auch Begriffe mit Satzzeichen am Rand: C++, .NET, 100%.
• Groß- und Kleinschreibung. Mit ausgeschaltetem Groß-/Kleinschreibung beachten (die Voreinstellung) greift der Begriff in jeder Schreibweise. Schalten Sie die Option für die Begriffe ein, die nur in einer exakten Schreibweise greifen dürfen.
• Längster Begriff zuerst. Die Erweiterung wendet die längsten Einträge zuerst an, deshalb gewinnt ein mehrteiliger Begriff gegen einen kürzeren Begriff in ihm.
• Aktiv. Die Erweiterung lädt nur die Einträge mit eingeschaltetem Aktiv. Ein deaktivierter Eintrag bleibt in der Liste und im CSV-Export, aber die Erweiterung wendet ihn nicht mehr an.

Feste Übersetzung je Sprache

Der Editor zeigt ein Feld je Zielsprache, also für jede Sprache Ihres Shops außer der Systemstandardsprache. Jedes Feld enthält den Wert, den dieser Begriff in dieser Sprache haben muss. In einem Shop ohne weitere Sprachen zeigt der Editor den Hinweis In diesem Shop sind noch keine weiteren Sprachen vorhanden.

Lassen Sie ein Feld leer, um für diese Sprache die Übersetzung des Anbieters zu behalten. Der Editor zeigt dieselbe Regel als Hinweis: Feste Übersetzung je Sprache. Lassen Sie ein Feld leer, um für diese Sprache die Anbieterübersetzung zu verwenden. Beibehalten-Begriffe brauchen keine Werte, denn die Erweiterung schützt sie in jeder Sprache.

Das Glossar für einen Lauf aktivieren

Die Erweiterung wendet das Glossar standardmäßig an. Zwei Schalter entscheiden, ob ein Lauf es verwendet:

Wo	Steuerung	Voreinstellung
Einstellungen → Erweitert → Übersetzungsverhalten	Glossar anwenden	An
Assistent, Schritt Anbieter & Optionen	Glossar anwenden	An

Der Schalter je Auftrag wirkt nur, solange die globale Einstellung an ist. Wenn Sie Glossar anwenden in den Einstellungen ausschalten, ist das Glossar für jeden Lauf aus, einschließlich Automatisierung, Schnellübersetzungen und CLI. Schnellübersetzungen an einem Produkt oder einer Kategorie fordern das Glossar immer an und folgen deshalb der globalen Einstellung.

Automatisierungsaufträge und CLI-Aufträge nutzen immer die Voreinstellungen, denn sie haben keinen Dialog zum Abschalten. Die Einstellungsreferenz beschreibt die Einstellung, der Übersetzungsassistent die Option je Auftrag.

Hinweis

Die Erweiterung wendet das Glossar auf Entitätsinhalte an: Produkte, Kategorien, Erlebniswelten, E-Mail-Vorlagen, Zusatzfelder und alles Weitere aus der Inhaltsliste. Storefront-Textbausteine übersetzt sie ohne Glossar. Textbausteinwerte erhalten weder den Beibehalten-Schutz noch die Ersetzen-Nachbearbeitung. Die Platzhalter in Textbausteinen schützt die Erweiterung weiterhin. Siehe Unterstützte Inhalte.

CSV-Import und -Export

CSV importieren und CSV exportieren liegen beide in der Smart Bar der Glossarseite. Ein Hinweis auf der Seite beschreibt das Verhalten: Der CSV-Import legt neue Begriffe an und aktualisiert vorhandene Begriffe mit demselben Namen. Der Export enthält immer das vollständige Glossar.

Dateiformat

Eigenschaft	Wert
Trennzeichen	;
Kopfzeile	Erforderlich
Kopfspalten	term;mode;caseSensitive;<localeCode>;<localeCode>;…
Kodierung	UTF-8; der Import akzeptiert ein Byte Order Mark, der Export schreibt eines
Dateiname des Exports	nice-translate-glossary.csv

Die Erweiterung erkennt die ersten drei Spaltennamen ohne Rücksicht auf die Groß- und Kleinschreibung. Jede weitere Spalte ist ein Locale-Code, und dieser Code muss zu einer Sprache gehören, die Ihr Shop enthält, zum Beispiel de-DE oder fr-FR. Wenn die Kopfzeile einen Locale-Code enthält, den keine Sprache des Shops verwendet, lehnt die Erweiterung die gesamte Datei ab und schreibt nichts.

Spaltenwerte

Spalte	Zulässige Werte	Leer bedeutet
term	Der Begriff selbst	Die Erweiterung überspringt die Zeile als ungültig
mode	keep oder replace	keep; jeder andere Wert überspringt die Zeile
caseSensitive	1, true oder yes für an (ohne Rücksicht auf die Groß- und Kleinschreibung)	Aus; jeder andere Wert bedeutet ebenfalls aus
<localeCode>	Die feste Übersetzung für diese Sprache	Keine feste Übersetzung für diese Sprache

Beispiel

term;mode;caseSensitive;de-DE;fr-FR
AcmePhone;keep;1;;
checkout;replace;0;Kasse;caisse

Die Erweiterung schützt AcmePhone in jeder Sprache, und dieser Begriff braucht keine Werte. checkout ersetzt sie im Deutschen durch Kasse und im Französischen durch caisse, in jeder Schreibweise.

Was ein Import verändert

Die Erweiterung gleicht die Zeilen über den Begriff mit den vorhandenen Einträgen ab und ignoriert dabei die Groß- und Kleinschreibung:

• Einen Begriff, den es noch nicht gibt, legt sie an und setzt ihn auf aktiv.
• Einen Begriff, den es schon gibt, aktualisiert sie: Die Datei ersetzt den Modus, die Groß-/Kleinschreibung und die festen Übersetzungen. Eine Zeile mit leeren Sprachspalten löscht deshalb die festen Übersetzungen dieses Begriffs. Ein Import verändert das Kennzeichen Aktiv eines vorhandenen Begriffs nie.
• Mehrere Zeilen für denselben Begriff innerhalb einer Datei ergeben einen Eintrag, und die letzte Zeile gewinnt.

Nach dem Import fasst eine Benachrichtigung das Ergebnis zusammen: CSV-Import abgeschlossen: {created} neu, {updated} aktualisiert, {skipped} ungültige Zeilen übersprungen.

Export

CSV exportieren lädt immer das vollständige Glossar herunter, nach Begriff sortiert, mit den aktiven und den inaktiven Einträgen. Die Datei enthält eine Locale-Spalte je Sprache Ihres Shops. Der Export schreibt die Groß-/Kleinschreibung als 1 oder 0. Sie können die Datei bearbeiten und erneut importieren, um die passenden Begriffe zu aktualisieren. Export, Bearbeiten und Import ist deshalb der praktische Weg, ein großes Glossar außerhalb der Administration zu pflegen.

Berechtigungen

Zum Lesen des Glossars brauchen Sie nice_translate.viewer. Zum Anlegen, Bearbeiten und Importieren brauchen Sie nice_translate.editor. Siehe Berechtigungen (ACL).