PTC
Registrieren Upgrade auf Pro Ihr Konto

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

Ein CSV, das sich sauber übersetzen lässt, verfügt über stabile Keys, klare Ausgangstext-Spalten und eine korrekte UTF-8-Codierung. Dieser Leitfaden behandelt jeden Vorbereitungsschritt. Sobald Ihr CSV bereit ist, können Sie es in 3 Schritten auf der PTC (Private Translation Cloud) übersetzen. Eine Übersicht über den eigenständigen CSV-Dienst finden Sie unter CSV-Dateien online mit KI übersetzen.

CSV ist das Übersetzungsformat des kleinsten gemeinsamen Nenners. Jedes Tabellenkalkulationsprogramm, jede E-Commerce-Plattform und jeder Analytics-Export spricht CSV. Diese Flexibilität ist ein zweischneidiges Schwert. Ein CSV, das in Excel „gut aussieht“, lässt sich aufgrund von Spaltenmehrdeutigkeiten, fehlenden Keys oder Codierungsproblemen möglicherweise nicht sauber übersetzen. Dieser Leitfaden behandelt, was ein CSV übersetzungsbereit macht.

Wie ein übersetzungsbereites CSV aussieht

Ein übersetzungsbereites CSV ist ein CSV, bei dem:

  • jeder übersetzbare String einen stabilen, eindeutigen Key hat.
  • die Spalte der Ausgangssprache klar identifiziert ist.
  • Zielsprachen-Spalten entweder bereits existieren (eine Spalte pro Sprache) oder ein CSV pro Zielsprache erzeugt wird.
  • Identifikator-Spalten (SKU, ID, Bild-URL, Preis) offensichtlich nicht übersetzbar sind.
  • die Datei gültiges UTF-8 ohne Codierungsmehrdeutigkeit ist.

Zwei gängige Datenlayouts:

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. Die PTC liest beide. Wählen Sie das Format, das in Ihre bestehende Pipeline passt.

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

Machen Sie die erste Zeile zur Kopfzeile. Verwenden Sie einfache, aussagekräftige Spaltennamen wie key, source_text und context. Ihr Übersetzungstool und alle menschlichen Prüfer wissen dann genau, was jede Spalte enthält.

Erforderliche Spalten. Jedes übersetzungsbereite CSV benötigt mindestens eine key-Spalte und eine Ausgangstext-Spalte.

  • Die key-Spalte enthält einen eindeutigen Identifikator für jeden String. Ihre Anwendung verwendet ihn, um zur Laufzeit die richtige Übersetzung zuzuordnen. Verwenden Sie eine einheitliche Namenskonvention – nur Kleinbuchstaben, Unterstriche und Punkte. Gängige Formate: button.submit, error.invalid_login, onboarding.welcome_message. Ändern Sie niemals einen Key, nachdem die Übersetzung begonnen hat. Das Ändern eines Keys erstellt einen neuen String und entkoppelt die bereits vorhandene Übersetzung.
  • Die Ausgangstext-Spalte enthält den Originaltext in Ihrer Basissprache.

Optional, aber nützlich: eine context-Spalte. Kurze Strings wie „Save“ oder „Back“ können unterschiedliche Bedeutungen haben, je nachdem, wo sie in Ihrer Benutzeroberfläche erscheinen. Eine kurze Notiz teilt dem Übersetzer (oder der KI) mit, 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 Ihnen eine namespace- oder group-Spalte, Strings nach Funktion oder Bereich zu organisieren.

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

Verwenden Sie Schlüssel mit Punktnotation für Hierarchien. cart.items.one und cart.items.other lassen sich natürlich gruppieren. Vermeiden Sie Leerzeichen in Keys.

Halten Sie Identifikator-Spalten getrennt. Wenn Ihr CSV ein Produktkatalog ist, sollten die Spalten sku, handle, price und image_url schon allein durch ihre Namen offensichtlich nicht übersetzbar sein. Verstecken Sie sie nicht in einer generischen metadata-Spalte.

Ein CSV pro logischem Inhaltsbereich. Mischen Sie keine Admin-UI-Strings mit Marketingtexten in derselben Datei. Unterschiedliche Inhaltsbereiche haben unterschiedliche Tonalitäten. Die Markenstimme der PTC funktioniert besser, wenn jedes Projekt ein kohärentes Set von Strings abdeckt.

Markieren Sie Platzhalter, damit die PTC sie über Sprachen hinweg beibehält

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

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

Konventionen, die die PTC ohne zusätzliche Konfiguration 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 (<strong>, <br>, <a href="">) enthält, behandeln Sie diese genauso wie Platzhalter. Die PTC erkennt und bewahrt sie über alle Formate hinweg, an der richtigen Position in jeder Zielsprache. Übersetzen Sie das Tag selbst niemals.

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

Codieren 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.

Codieren Sie Pluralformen 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

Die 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 mit Schrägstrichen oder Klammern zu einem einzigen String, wie "You have {count} item(s) in your cart.". Dieser Ansatz ist nicht übersetzbar und zerstört die Grammatik der meisten Sprachen.

Escapen Sie Sonderzeichen, damit der CSV-Parser keine Zeilen fehlerhaft umbricht

CSV-Escaping-Regeln (RFC 4180):

  • Kommas innerhalb eines Feldes: Schließen Sie das Feld in doppelte Anführungszeichen ein, andernfalls teilt der Parser Ihren String auf mehrere Zellen auf.
key,source_text
intro,"Welcome to our store, where every product matters"
  • Literale doppelte Anführungszeichen: Escapen 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 Anführungszeichen (“ ”). CSV-Parser erkennen typografische Anführungszeichen nicht und geben Formatierungsfehler aus.
  • Nachgestellte Leerzeichen: Entfernen Sie diese vor dem Senden aus allen Zellen. Sie sind in den meisten Tabellenkalkulationsprogrammen unsichtbar, verursachen aber in Ihrer Anwendung Fehler beim String-Abgleich.

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

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

Die PTC parst das HTML, übersetzt nur den menschenlesbaren Text und behält jedes Tag, Attribut und jede URL bei.

Als UTF-8 speichern, um beschädigte Zeichen mit Akzent zu vermeiden

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

  • Speichern Sie Ihr CSV als UTF-8 (mit oder ohne BOM). Bei den meisten modernen Tools ist dies die Standardeinstellung. Bei Excel unter Windows war dies in der Vergangenheit nicht der Fall.
  • Verwenden Sie keine Windows-1252-, ISO-8859-1- oder „ANSI“-Codierung. Zeichen mit Akzent in Zielsprachen werden dadurch beschädigt.
  • Wenn Sie sich nicht sicher sind, öffnen Sie das CSV in einem Texteditor wie VS Code oder Notepad++ und überprüfen Sie die Codierungsanzeige. Speichern Sie es 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 Trennzeichen 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 Codierung vorliegen, konvertieren Sie mit iconv:

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

Ein Praxisbeispiel: Ein komplettes E-Commerce-CSV, das die PTC ohne Vorbereitung übersetzt

Ein komplettes, gut vorbereitetes CSV 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 key-, source_text- und context-Spalten.
  • verwendet hierarchische Schlüssel mit Punktnotation.
  • behandelt Platzhalter ({{shopName}}, {count}, {currency}, {amount}).
  • behandelt Pluralformen mit den Suffixen .zero / .one / .other.
  • escaped HTML und Anführungszeichen korrekt.
  • ist als UTF-8 gespeichert.

Die PTC übersetzt dies direkt. Keine Vorbereitung über das Gezeigte hinaus.

Best Practices für die CSV-Übersetzung in einer Liste

  • Verwenden Sie ein dediziertes Übersetzungstool. Vermeiden Sie es, CSV-Dateien manuell in einem Texteditor oder einer Tabellenkalkulation zu übersetzen. Dedizierte Tools wie die 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 führt bei den meisten Übersetzungstools zu Fehlern.
  • Isolieren Sie übersetzbare Spalten. Halten Sie Spalten, die übersetzt werden müssen, 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 unangetastet bleiben sollten.
  • Vermeiden Sie verbundene Zellen und Tabellenformatierungen. CSV ist reiner Text. Jegliche Formatierung, die durch Tabellenkalkulationssoftware angewendet wird, geht verloren, wenn die Datei verarbeitet wird.
  • Entfernen Sie unnötige Spalten und Metadaten. Schließen Sie nur Spalten ein, die Ihr Übersetzungstool benötigt.
  • Testen Sie zuerst mit einer kleinen Stichprobe. Bevor Sie eine große Datei übersetzen lassen, testen Sie mit einer kleinen Stichprobe, um strukturelle oder Codierungsprobleme frühzeitig zu erkennen.
  • Validieren Sie Ihre Datei vor dem Hochladen. Überprüfen Sie, dass jede Zeile einen eindeutigen Key ohne Duplikate hat, keine Keys Leerzeichen oder Sonderzeichen enthalten und es keine fehlerhaft umbrochenen Zeilen gibt.
  • Behalten Sie ein Backup. Behalten Sie immer eine Kopie Ihres Original-CSVs, bevor Sie es zur Übersetzung senden.

Visuelle Übersetzungsprüfung des gerenderten Katalogs oder der App

Sobald die PTC das CSV übersetzt hat, werden die Strings in dem System dargestellt, das das CSV verarbeitet. Das umfasst Ihre Storefront, Ihre App und Ihr Dashboard. Ein übersetzter Produkttitel, der in die Datei passt, kann in einem Kartenlayout überlaufen. Ein französischer Checkout-Button verwendet möglicherweise das falsche Wort für „Place Order“. Eine lange deutsche Adresse kann eine Spalte mit fester Breite in einer gedruckten Rechnung sprengen.

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

Übersetzen Sie Ankündigungen von Produkteinführungen und Lieferanten-E-Mails

Ankündigungen von Produkteinführungen und kundenorientierte E-Mails zu Katalog-Updates befinden sich außerhalb des CSVs. Der Paste to Translate der 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

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

Übersetzen Sie nun Ihr CSV mit der PTC

Sobald Ihr CSV vorbereitet ist, übersetzen Sie es in 3 Schritten:

  1. Laden Sie Ihr CSV hoch und wählen Sie die Zielsprachen aus.
  2. Die PTC übersetzt und behält dabei jede Spalte, jeden Key und jeden Platzhalter bei.
  3. Laden Sie die übersetzten CSVs herunter und importieren Sie diese dort, wo sie hingehören.

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