PTC
Registrieren Upgrade auf Pro Ihr Konto

So bereiten Sie eine CSV-Datei für die Übersetzung vor

Eine CSV-Datei, die sich sauber übersetzen lässt, verfügt über stabile Keys, klare Spalten für den Ausgangstext und eine korrekte UTF-8-Kodierung. Dieser Leitfaden deckt jeden Vorbereitungsschritt ab. Sobald Ihre CSV-Datei bereit ist, können Sie diese in 3 Schritten mit PTC (Private Translation Cloud) übersetzen. Eine Übersicht über den eigenständigen CSV-Service finden Sie unter CSV-Dateien online mit KI übersetzen.

CSV ist das Format für Übersetzungen mit dem kleinsten gemeinsamen Nenner. Jedes Tabellenkalkulationsprogramm, jede E-Commerce-Plattform und jeder Analyse-Export beherrscht CSV. Diese Flexibilität ist zweischneidig. Eine CSV-Datei, die in Excel „gut aussieht“, kann aufgrund von Spaltenmehrdeutigkeiten, fehlenden Keys oder Kodierungsproblemen unmöglich sauber zu übersetzen sein. Dieser Leitfaden zeigt auf, was eine CSV-Datei bereit für die Übersetzung macht.

Wie eine übersetzungsbereite CSV-Datei aussieht

Eine übersetzungsbereite CSV-Datei erfüllt folgende Kriterien:

  • Jeder zu übersetzende String einen stabilen, eindeutigen Key hat.
  • Die Spalte für die Ausgangssprache klar identifiziert ist.
  • Spalten für Zielsprachen entweder bereits existieren (eine Spalte pro Sprache) oder eine CSV-Datei pro Zielsprache erstellt wird.
  • Identifikationsspalten (SKU, ID, Bild-URL, Preis) offensichtlich nicht zu übersetzen sind.
  • Die Datei gültiges UTF-8 ohne Kodierungsmehrdeutigkeiten verwendet.

Zwei gängige Formate:

Breitformat (eine Spalte pro Sprache):

key,en,es,fr,de
welcome,Welcome,,,
cart.empty,Your cart is empty,,,
cart.items_one,"You have %{count} item",,,

Langformat (eine Zeile pro String, eine Datei pro Sprache):

key,source
welcome,Welcome
cart.empty,Your cart is empty
cart.items_one,"You have %{count} item"

Beide funktionieren. PTC liest beide Formate. Wählen Sie dasjenige, das am besten in Ihre bestehende Pipeline passt.

Wählen Sie Spalten, die Übersetzer und PTC lesen können

Nutzen Sie die erste Zeile als Header. Verwenden Sie einfache, beschreibende Spaltennamen wie key, source_text und context. Ihr Übersetzungstool und alle menschlichen Prüfer wissen dann genau, was jede Spalte enthält.

Erforderliche Spalten. Jede übersetzungsbereite CSV-Datei benötigt mindestens eine key-Spalte und eine Spalte für den Ausgangstext.

  • Die key-Spalte enthält eine eindeutige Kennung für jeden String. Ihre Anwendung verwendet diese, um zur Laufzeit die richtige Übersetzung zuzuordnen. Verwenden Sie eine konsistente Namenskonvention – nur Kleinbuchstaben, Unterstriche und Punkte. Gängige Formate: button.submit, error.invalid_login, onboarding.welcome_message. Ändern Sie einen Key niemals, nachdem die Übersetzung begonnen hat. Das Ändern eines Keys erzeugt einen neuen String und lässt die bestehende Übersetzung verwaisen.
  • Die Spalte für den Ausgangstext enthält den Originaltext in Ihrer Basissprache.

Optional, aber nützlich: eine context-Spalte. Kurze Strings wie „Speichern“ oder „Zurück“ können je nach Einsatzort in Ihrer Benutzeroberfläche unterschiedliche Bedeutungen haben. Ein kurzer Hinweis sagt dem Übersetzer (oder der KI), wofür der String gedacht ist:

key,source_text,context
button.save,Save,Document editor toolbar
checkout.button.save,Save,Checkout address form

Bei großen Dateien hilft eine namespace- oder group-Spalte dabei, Strings nach Funktionen oder Abschnitten zu organisieren.

Sprachspalten. Wenn Ihr Workflow Ausgangs- und Zieltexte in derselben Datei hält, fügen Sie pro Zielsprache eine Spalte hinzu und verwenden Sie Locale-Codes als Header. Verwenden Sie es_ES für Spanisch (Spanien), fr_FR für Französisch (Frankreich), pt_BR für Portugiesisch (Brasilien).

Verwenden Sie punktierte Keys für Hierarchien. cart.items.one und cart.items.other gruppieren sich natürlich. Vermeiden Sie Leerzeichen in Keys.

Halten Sie Identifikationsspalten getrennt. Wenn Ihre CSV-Datei ein Produktkatalog ist, sollten die Spalten sku, handle, price und image_url allein durch ihre Namen als nicht zu übersetzen erkennbar sein. Vergraben Sie diese nicht in einer generischen metadata-Spalte.

Eine CSV-Datei pro logischem Bereich. Mischen Sie keine Admin-UI-Strings mit Marketing-Texten in derselben Datei. Verschiedene Bereiche haben unterschiedliche Tonalitäten. Die Markenstimme von PTC funktioniert besser, wenn jedes Projekt einen kohärenten Satz von Strings abdeckt.

Markieren Sie Platzhalter, damit PTC sie sprachübergreifend beibehält

Platzhalter sind Token innerhalb eines Strings, die zur Laufzeit ersetzt werden. %s, %d, {name}, {{count}}, %{currency}. PTC behält Platzhalter wortwörtlich bei und übersetzt die Token selbst niemals.

key,source_text
greeting,"Hello, %{name}!"
cart.total,"Total: %{currency}%{amount}"
notification,"You have %{count} new messages"

Konventionen, die PTC sofort erkennt:

  • %s, %d, %f, %1$s, %2$d – printf-Stil (gettext, Rails, Java).
  • {name}, {count}, {0} – Python str.format, .NET, ICU-Index-Syntax.
  • {{name}}, {{count}} – i18next, Mustache, Handlebars.
  • %{name}, %{count} – Rails I18n, Ruby.

Wenn Ihr Ausgangstext HTML-Tags enthält (<strong>, <br>, <a href="">), behandeln Sie diese genauso wie Platzhalter. PTC erkennt und bewahrt sie in allen Formaten an der korrekten Position in jeder Zielsprache. Übersetzen Sie niemals den Tag selbst.

Wenn Sie eine eigene Konvention verwenden (z. B. [[token]]), deklarieren Sie diese im PTC-Projekt-Glossar, und PTC wird sie in jeder Zeile berücksichtigen.

Kodieren Sie Pluralformen als separate Zeilen, damit jede Sprache die richtigen Formen erhält

Die meisten Sprachen haben mehr als zwei Pluralformen. Viele haben Regeln, die kein englischer Muttersprachler vorhersehen würde. Polnisch hat one / few / many / other. Arabisch hat sechs Formen. Japanisch hat eine (keine Pluralunterscheidung). Ein Übersetzungstool, das nur Singular und Plural speichert, wird für diese Sprachen fehlerhafte Ergebnisse liefern.

Kodieren Sie Plurale als separate Zeilen mit einer Suffix-Konvention:

key,source_text,context
cart.items.zero,Your cart is empty,Zero state
cart.items.one,"You have {count} item in your cart.",Singular: count = 1
cart.items.other,"You have {count} items in your cart.",Plural: count > 1

PTC liest die Suffixe .zero, .one, .few, .many und .other (CLDR-Pluralkategorien) und generiert die richtigen Pluralkategorien für jede Zielsprache.

Kombinieren Sie Pluralformen nicht in einem einzigen String mit Schrägstrichen oder Klammern, wie "Sie haben {count} Artikel im Warenkorb.". Dieser Ansatz ist nicht übersetzbar und bricht die Grammatik der meisten Sprachen.

Maskieren Sie Sonderzeichen, damit der CSV-Parser keine Zeilen umbricht

CSV-Maskierungsregeln (RFC 4180):

  • Kommas innerhalb eines Feldes: Schließen Sie das Feld in doppelte Anführungszeichen ein, da der Parser Ihren String sonst auf mehrere Zellen aufteilt.
key,source_text
intro,"Welcome to our store, where every product matters"
  • Wörtliche doppelte Anführungszeichen: Maskieren Sie diese, indem Sie sie verdoppeln.
key,source_text
quote,"He said ""hello"" and waved"
  • Zeilenumbrüche innerhalb eines Feldes: In Ordnung, wenn das Feld in Anführungszeichen gesetzt ist.
key,source_text
address,"123 Main Street
Springfield, IL 62701"
  • Typografische Anführungszeichen: Verwenden Sie immer gerade Anführungszeichen (") anstelle von typografischen („ “). CSV-Parser erkennen typografische Anführungszeichen nicht und verursachen Formatierungsfehler.
  • Nachfolgende Leerzeichen: Entfernen Sie diese aus allen Zellen vor dem Senden. Sie sind in den meisten Tabellenkalkulationsprogrammen unsichtbar, führen aber zu Fehlern beim String-Matching in Ihrer Anwendung.

Für HTML oder Markup innerhalb einer Zelle setzen Sie das Feld in Anführungszeichen und lassen Sie PTC nur den Text übersetzen:

key,source_text
disclaimer,"<p>By signing up, you agree to our <a href=""/terms"">terms</a>.</p>"

PTC parst das HTML, übersetzt nur den menschenlesbaren Text und bewahrt jeden Tag, jedes Attribut und jede URL.

Als UTF-8 speichern, um beschädigte Sonderzeichen zu vermeiden

Die Kodierung ist die häufigste Ursache für Probleme bei der CSV-Übersetzung. Ohne UTF-8 können Zeichen außerhalb des lateinischen Basisalphabets in Ihrer Anwendung als ???, leere Kästchen oder verstümmelter Text erscheinen.

  • Speichern Sie Ihre CSV-Datei als UTF-8 (mit oder ohne BOM). Die meisten modernen Tools tun dies standardmäßig. Excel unter Windows tat dies historisch gesehen nicht.
  • Verwenden Sie keine Windows-1252-, ISO-8859-1- oder „ANSI“-Kodierung. Akzentuierte Zeichen in den Zielsprachen werden dadurch beschädigt.
  • Wenn Sie unsicher sind, öffnen Sie die CSV-Datei in einem Texteditor wie VS Code oder Notepad++ und prüfen Sie die Kodierungsanzeige. Speichern Sie sie bei Bedarf erneut als UTF-8.

Excel-spezifische Hinweise:

  • Excel für Mac verwendet standardmäßig UTF-8. Keine Aktion erforderlich.
  • Excel für Windows: Wählen Sie Datei > Speichern unter und wählen Sie CSV UTF-8 (durch Komma getrennt) (*.csv) aus dem Format-Dropdown. Nicht das einfache „CSV (Trennzeichen-getrennt)“.
  • Google Sheets: Datei > Herunterladen > Kommagetrennte Werte (.csv). Standardmäßig UTF-8.

Für Quell-CSVs, die bereits in der falschen Kodierung vorliegen, konvertieren Sie diese mit iconv:

iconv -f WINDOWS-1252 -t UTF-8 source.csv > source-utf8.csv

Ein Praxisbeispiel: Eine vollständige E-Commerce-CSV, die PTC ohne Vorbereitung übersetzt

Eine vollständige, gut vorbereitete CSV-Datei für eine E-Commerce-Website:

key,source_text,context
header.welcome,"Welcome to {{shopName}}",Top of page
header.cart.zero,"Your cart is empty",Cart icon - zero state
header.cart.one,"{count} item in cart",Cart icon - singular
header.cart.other,"{count} items in cart",Cart icon - plural
product.add_to_cart,"Add to Cart",Product page CTA
product.out_of_stock,"Out of Stock",Product availability badge
product.price,"{currency}{amount}",Price display
checkout.shipping,"Shipping address",Checkout step heading
checkout.payment,"Payment method",Checkout step heading
checkout.confirm,"Place Order",Final checkout button
errors.email.required,"Email is required",Form validation
errors.email.invalid,"Please enter a valid email address",Form validation
errors.card.declined,"Your card was declined. Please try a different payment method.",Checkout error
promo.tagline,"Sale ends Sunday, grab your deal!",Promo banner - contains comma
tooltip.save,"Click ""Save"" to keep your changes.",Tooltip - contains quotes
disclaimer,"<p>By placing this order, you agree to our <a href=""/terms"">terms and conditions</a>.</p>",Footer legal

Diese Datei:

  • Hat klare Spalten für key, source_text und context.
  • Verwendet punktierte hierarchische Keys.
  • Behandelt Platzhalter ({{shopName}}, {count}, {currency}, {amount}).
  • Behandelt Plurale mit den Suffixen .zero / .one / .other.
  • Maskiert HTML und Anführungszeichen korrekt.
  • Ist als UTF-8 gespeichert.

PTC übersetzt dies direkt. Keine weitere Vorbereitung über das Gezeigte hinaus nötig.

Best Practices für die CSV-Übersetzung auf einen Blick

  • Verwenden Sie ein spezielles Übersetzungstool. Vermeiden Sie es, CSV-Dateien manuell in einem Texteditor oder Tabellenkalkulationsprogramm zu übersetzen. Dedizierte Tools wie PTC bewahren Ihre Dateistruktur, behandeln Platzhalter korrekt und halten Ihre Keys intakt.
  • Verwenden Sie Standard-Kommas als Trennzeichen. Einige Tools verwenden standardmäßig Semikolons. Kommas werden am weitesten unterstützt und verursachen am seltensten Importfehler.
  • Behalten Sie einen String pro Zeile bei. Das Kombinieren mehrerer Strings in einer einzigen Zeile macht Übersetzungen unüberschaubar und bricht die meisten Übersetzungstools.
  • Isolieren Sie zu übersetzende Spalten. Halten Sie Spalten, die eine Übersetzung benötigen, getrennt von Spalten, die unverändert bleiben sollen (numerische IDs, SKUs, technische Parameter). Dies verringert das Risiko, dass ein Tool oder Übersetzer versehentlich Daten ändert, die unberührt bleiben sollten.
  • Vermeiden Sie verbundene Zellen und Tabellenformatierungen. CSV ist reiner Text. Jede Formatierung, die über eine Tabellenkalkulationssoftware angewendet wird, geht bei der Verarbeitung der Datei verloren.
  • Entfernen Sie unnötige Spalten und Metadaten. Fügen Sie nur Spalten ein, die Ihr Übersetzungstool benötigt.
  • Testen Sie zuerst mit einer kleinen Stichprobe. Bevor Sie eine große Datei durch die Übersetzung laufen lassen, testen Sie mit einer kleinen Stichprobe, um Struktur- oder Kodierungsprobleme frühzeitig zu erkennen.
  • Validieren Sie Ihre Datei vor dem Hochladen. Überprüfen Sie, ob jede Zeile einen eindeutigen Key ohne Duplikate hat, keine Keys Leerzeichen oder Sonderzeichen enthalten und keine Zeilen fehlerhaft sind.
  • Behalten Sie ein Backup. Behalten Sie immer eine Kopie Ihrer ursprünglichen CSV-Datei, bevor Sie sie zur Übersetzung senden.

Visuelle Übersetzungsprüfung des gerenderten Katalogs oder der App

Sobald PTC die CSV-Datei übersetzt hat, werden die Strings in dem Programm gerendert, das die CSV-Datei nutzt. Das umfasst Ihre Storefront, Ihre App und Ihr Dashboard. Ein übersetzter Produkttitel, der in die Datei passt, kann in einem Card-Layout zu einem Überlauf führen. Ein französischer Checkout-Button verwendet vielleicht das falsche Wort für „Bestellung aufgeben“. Eine lange deutsche Adresse könnte eine Spalte mit fester Breite in einer gedruckten Rechnung sprengen.

Die AI Visual QA von PTC erkennt diese Fehler. Für Storefronts und Dashboards (browserbasiert) installieren Sie die PTC-Browser-Erweiterung und zeichnen einen Rundgang durch Ihren Shop auf. PTC spielt diesen in jeder Zielsprache ab und behebt Layout- und Kontextfehler in der CSV-Datei automatisch. Für native Apps, die die CSV-Datei nutzen, laden Sie stattdessen Screenshots der relevanten Bildschirme hoch.

Übersetzen Sie Produktankündigungen und Lieferanten-E-Mails

Produktankündigungen und kundenorientierte E-Mails über Katalogaktualisierungen befinden sich außerhalb der CSV-Datei. Die Funktion Paste to Translate von PTC verarbeitet diese Texte im selben Projekt und verwendet dabei dasselbe Glossar und dieselbe Markenstimme wie Ihre Katalogübersetzungen.

Übersetzen Sie Bulk-Importe bei Dateneingang mit der PTC API

Bulk-Katalogimporte, die bei Eingang übersetzt werden müssen, können über die PTC REST API mit Bearer-Token-Authentifizierung fließen, wobei dasselbe Glossar und dieselbe Markenstimme wie bei Ihren CSV-Übersetzungen verwendet werden.

Übersetzen Sie jetzt Ihre CSV-Datei mit PTC

Sobald Ihre CSV-Datei vorbereitet ist, übersetzen Sie diese in 3 Schritten:

  1. Laden Sie Ihre CSV-Datei hoch und wählen Sie die Zielsprachen aus.
  2. PTC übersetzt und bewahrt dabei jede Spalte, jeden Key und jeden Platzhalter.
  3. Laden Sie die übersetzten CSV-Dateien herunter und importieren Sie diese dort, wo sie benötigt werden.

Starten Sie Ihre kostenlose 30-Tage-Testphase – 20.000 Wörter in 2 Sprachen, keine Kreditkarte erforderlich.