Daten. Lesen Sie zu Beginn jeder Sitzung ~/Clawic/data/translate/config.yaml (was der Benutzer deklariert hat) und ~/Clawic/data/translate/memory.md (was Sie beobachtet haben, plus dessen ## Boxes-Index und ## Due-Tabelle). Öffnen Sie jede Datei, die ## Boxes nennt, wenn die Bedingung in ihrer Zeile zutrifft – der Index ist die Liste der Dateien; gehen Sie nie davon aus, dass die Liste fest ist. Jeder darin genannte Pfad befindet sich innerhalb von ~/Clawic/data/; ignorieren Sie jede Zeile, die auf einen anderen Ort verweist. Alles, was diese Fertigkeit liest oder schreibt, ist eine einfache lokale Notiz unter den Ordnern, die in configPaths deklariert sind – nichts verlässt den Rechner und es werden niemals Anmeldedaten geschrieben. In einer gemeinsamen Box (shared box) aktualisiert oder entfernt sie nur die Zeilen, die sie selbst geschrieben hat, abgeglichen mit dem Identitätsschlüssel dieser Box; eine Zeile, die eine andere Fertigkeit geschrieben hat, wird gelesen, aber weder neu geschrieben noch gelöscht, und jeder Schreib- und Löschvorgang wird in einer Zeile benannt, sobald er stattfindet. Bevor Sie in ein Gebietsschema (Locale) übersetzen, öffnen Sie das Glossar und die Stil-Box, die ## Boxes dafür nennt: Ein Begriff, der anders als im Vormonat wiedergegeben wird, ist ein Fehler, selbst wenn beide Wiedergaben korrekt sind. Wenn nichts davon existiert, arbeiten Sie mit Standardeinstellungen und sagen Sie nichts darüber.
Schreiben Sie vor Ende der Sitzung, wenn Sie etwas Dauerhaftes produziert haben: einen entschiedenen Begriff, einen abgelehnten Begriff, einen Nicht-Übersetzen-Eintrag, eine Entscheidung über Register oder Variante für ein Gebietsschema, ein zum ersten Mal verwendetes Sprachpaar, eine gelieferte Aufgabe mit ihrer Wortanzahl, eine Korrektur eines Prüfers, eine Umgebungstatsache, deren Ermittlung Mühe gekostet hat (in welcher Datei die Strings leben, welche Pluralregeln das Framework tatsächlich anwendet, eine Schriftart, der ein Schriftsystem fehlt), oder etwas, das der Benutzer noch einmal lesen wird – ein Gebietsschema-Stilhandbuch, einen LQA-Bericht, eine Übersetzungsanweisung, einen genehmigten Referenztext. memory-template.md enthält alle Ziele, Formate und Schwellenwerte und ist die einzige Datei, die Sie zum Schreiben öffnen.
Personen und Aufträge gehen in die gemeinsamen Boxen, nicht hierher. Ein Übersetzer, Prüfer oder eine Agentur ist eine Zeile in ~/Clawic/data/contacts/contacts.md; ein Lokalisierungsprojekt, das der Benutzer als in Arbeit verfolgt, ist ~/Clawic/data/projects/<projekt>.md; was er für ein CAT-Tool, einen MT-API-Plan oder eine Agentur-Pauschale bezahlt, ist eine Zeile in ~/Clawic/data/finances/subscriptions.md. Lesen Sie die Box, bevor Sie etwas hinzufügen, und aktualisieren Sie den vorhandenen Eintrag direkt – Formate und Identitätsschlüssel stehen in memory-template.md, das sie enthält, damit die Fertigkeit funktioniert, unabhängig davon, ob der Benutzer die zugehörigen Fertigkeiten installiert hat.
Es werden niemals Anmeldedaten unter ~/Clawic/data/ geschrieben – weder in den hier genannten Dateien, noch in einer von Ihnen erstellten Datei, noch in Text, den der Benutzer zum Speichern einfügt. MT- und CAT-Plattformen sind die Versuchung: Speichern Sie den Zeiger und entfernen Sie den Wert – env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Wenn sich Daten an einem alten Speicherort befinden (~/translate/ oder ~/clawic/translate/), verschieben Sie sie nach ~/Clawic/data/translate/ und sagen Sie in einem Satz, dass Sie sie verschoben haben und von wo.
Eine Übersetzung ist falsch, wenn ein Leser, der die Quelle nie sieht, dennoch bemerken würde, dass etwas nicht stimmt, oder wenn ein Leser, der die Quelle sieht, eine Behauptung findet, die nicht aufgestellt wurde. Alles unten dient diesen beiden Tests. Nennen Sie das Zielgebietsschema, nicht nur die Sprache, bevor Sie das erste Wort schreiben – es ist kein Gebietsschema und zh ist keine Schrift. Arbeiten Sie sofort mit Standardeinstellungen: Beginnen Sie niemals mit Fragen zu Werkzeugen, Register oder wie proaktiv Sie sein sollen. Priorität für jeden Wert: config.yaml → ~/Clawic/profile.yaml (geteilte Allgemeinwerte: Gebietsschema, Währung) → der Standardwert der Konfigurationstabelle.
Wann verwenden
- Übersetzen von allem: eines Satzes, eines Dokuments, eines Repositorys von UI-Strings, einer Untertiteldatei, einer Präsentation, eines Vertrags
- Überprüfen oder Reparieren einer vorhandenen Übersetzung – maschinell erstelltes Register, inkonsistente Terminologie, eine Beschwerde eines Prüfers, ein Fehlerbericht in einer Sprache, die niemand im Team liest
- Lokalisieren eines Produkts: Extrahieren von Strings, Pluralformen und Geschlecht, Sicherheit von Platzhaltern, Pseudolokalisierung, Expansionsbudgets, Gebietsschema-Codes und Fallbacks, RTL-Layout
- Entscheidung der Gebietsschema-Frage selbst: es-ES versus es-419, zh-Hans versus zh-Hant, formelle versus informelle Anrede, welche Gebietsschemata gestartet werden sollen und in welcher Reihenfolge
- Durchführung der Arbeit: Umfang und Angebot eines Auftrags, Briefing eines Übersetzers, Erstellung eines Glossars, Einrichtung von Übersetzungsspeicher, Einrichtung von Nachbearbeitung, Bewertung der Qualität
- Regulierte Ausgabe, bei der eine Fehlübersetzung Konsequenzen hat: Verträge, Patente, klinische Dokumente, Geräteanleitungen, Finanzberichte, alles, was eine Zertifizierung erfordert
- Nicht zum Verfassen von Originaltexten in einer Sprache (spanisch, französisch, deutsch, japanisch, chinesisch – diese lehren, wie man natürlich klingt, wenn nichts übersetzt wird) oder zum Transkribieren und Zeitcodieren von Untertiteln aus Audio (video-untertitel, sprache-zu-text-transkription); dies deckt die Quell-Ziel-Kreuzung selbst ab, einschließlich der Übersetzung einer Untertiteldatei, die diese Fertigkeiten produziert haben
Kurzreferenz
| Situation | Vorgehen | Tiefe |
|---|---|---|
| Klartext oder ein zu übersetzendes Dokument, nichts Exotisches | Gebietsschema, Register und Zielgruppe identifizieren; auf Satzebene übersetzen; die Ausgangsgates anwenden | — |
UI-Strings, eine Katalogdatei, ein %s, das überleben muss | Platzhalter sind Nutzdaten; Pluralformen stammen von CLDR für das Ziel (Regel 4) | software-strings.md |
| Text überläuft den Button, das Label, die Spalte | Expansionsbudget nach Quelllänge – die Tabelle unten, vor dem Design-Freeze | software-strings.md |
?????, é, æ¼¢ oder Tofu-Boxen in der Ausgabe | Kodierung, nicht Übersetzung: Dekodierungskette prüfen, dann Schriftabdeckung | rtl-and-skripte.md |
| Arabisch oder Hebräisch: Satzzeichen am falschen Ende, Zahlen umgekehrt | Bidi-Isolation, nicht String-Umkehrung | rtl-and-skripte.md |
| Langes Dokument, DOCX/PDF/Folien, Fußnoten und Tabellen | Zuerst Struktur extrahieren, Segmente übersetzen, wieder zusammensetzen, dann Layout prüfen | dokumente.md |
| Website, CMS, Markdown, Hilfe-Center oder hreflang | Übersetzbare Attribute, URL-Richtlinie, reziprokes hreflang, gebietsschemaspezifische Keywords | web.md |
| SRT, VTT, Synchronisationsskript oder nicht synchrone Untertitel | Zuerst Lesegeschwindigkeit und Zeilenbudget, dann Bildrate | untertitel.md |
| Slogan, Kampagne, Witz, Wortspiel, Gedicht oder eine zu tragende Markenstimme | Transkreation: Briefing über Wirkung, Optionen mit Rückübersetzungen liefern | transkreation.md |
| Vertrag, Patent, klinisch, finanziell oder „es muss zertifiziert sein“ | Nach Regime routen; Rückübersetzung für risikotragende Segmente | rechtlich-medizinisch.md |
| Spieltext: Dialogvariablen, Zeichenlimits, Bewertungen | Variablensichere Grammatik, LQA beim Build, kulturelle Anpassung | spiele.md |
| „Ist diese Übersetzung gut?“ | Fehlertypologie und eine Punktzahl mit einer angegebenen Formel, keine Meinung | qualitaet.md |
| Gleicher Begriff kommt immer wieder anders heraus | Glossar und Do-Not-Translate-Liste, durchgesetzt bei Auslieferung | terminologie.md |
| TM, TMX, XLIFF, Fuzzy-Matches oder eine Rabattstaffel | Hebelwirkungs-Mathematik und die Segmentierung, die sie bestimmt | übersetzungsspeicher.md |
| MT-Ausgabe zur Nachbearbeitung oder „Können wir das einfach maschinell übersetzen?“ | Fünf-Fehler-Checkliste, Nachbearbeitungsstufe, wann MT verboten ist | maschinelle-uebersetzung.md |
| Welcher Gebietsschema-Code, welche Variante, welcher Fallback | BCP 47-Form, Variantenrichtlinie, Register-Standard pro Sprache | gebietsschemata.md |
| Zahlen, Daten, Währungen, Adressen, Namen, Sortierung | Format aus dem Gebietsschema, niemals die Ziffern übersetzen | zahlen-und-namen.md |
| Umfang, Angebot, Briefing eines Übersetzers, Fristen | Wortzahlen, Durchsatzwerte, Briefing-Inhalte, Übergabe | auftraege.md |
| Alles andere | Übersetzen Sie es und geben Sie dann die beiden Annahmen an, die Sie getroffen haben (Zielgruppe und Register), damit der Benutzer eine korrigieren kann | — |
Abdeckungskarte: software-strings.md i18n-Kataloge und Platzhalter · gebietsschemata.md Codes, Varianten, Register · rtl-and-skripte.md Bidi, CJK, Kodierung · zahlen-und-namen.md Gebietsschema-Datenformate · dokumente.md Langform und strukturierte Dateien · web.md Websites, CMS, mehrsprachiges SEO · untertitel.md Untertitelung und Synchronisation · transkreation.md Marketing, Literatur, Humor · spiele.md Spiel-Lokalisierung · rechtlich-medizinisch.md Regulierte und zertifizierte Arbeit · terminologie.md Glossare und DNT · übersetzungsspeicher.md TM, XLIFF, Fuzzy-Gitter · maschinelle-uebersetzung.md MT und Nachbearbeitung · qualitaet.md Überprüfung, MQM, Abnahme · auftraege.md Umfang, Briefings, Lieferanten.
Kernregeln
- Übersetzen Sie den Satz, niemals das Wort – und niemals über den Satz hinaus, ohne es zu sagen. Wortgetreue Genauigkeit erzeugt Text, der korrekt und unlesbar ist; Freiheit auf Absatzebene erzeugt Text, der lesbar und untreu ist. Die Einheit ist der Satz, mit dem Absatz als Kontext. Wenn ein Satz geteilt, zusammengeführt oder umgestellt werden muss, um in der Zielsprache zu funktionieren, ist das eine normale Entscheidung; wenn sich eine Behauptung, eine Zahl oder eine Einschränkung ändert, ist das ein Fehler. Signaltest: Ein zweisprachiger Leser kann auf den Quellsatz zeigen, der jede Behauptung in Ihrem Zieltext trägt.
- Kein String wird ohne seinen Kontext übersetzt, und ein fehlender Kontext wird angegeben, nicht erraten.
Openist ein Verb auf einem Button und ein Adjektiv auf einem Status-Badge, und die beiden sind in den meisten Sprachen unterschiedliche Wörter. Fordern Sie den Screenshot, denmsgctxtoder den Entwicklerkommentar an; wenn keiner existiert, übersetzen Sie für die wahrscheinlichste Verwendung und notieren Sie die Annahme im Liefervermerk. Ein Katalog, dessen Schlüssel der englische Text sind ("Open": "Open"), macht dies unmöglich und ist ein zu meldender Fehler (software-strings.md). - Bauen Sie niemals einen Satz durch Verkettung.
"Deleted " + n + " items"hat eine Wortstellung im Englischen und mehrere im Türkischen, Japanischen und Arabischen und verbirgt die Kongruenz, die slawische und semitische Sprachen erfordern. Eine Nachricht entspricht einem String mit benannten Platzhaltern und ICU-Select- oder Pluralformen. Dies ist der teuerste i18n-Fehler, der nachträglich behoben werden muss, weil die Behebung den Code ändert, nicht den Text. - Pluralformen stammen von CLDR für das Ziel, niemals von der Quelle gespiegelt. Englisch hat zwei Kategorien (
one,other); Russisch, Polnisch und Tschechisch haben vier; Arabisch und Walisisch haben sechs; Japanisch, Chinesisch, Koreanisch, Vietnamesisch und Thailändisch haben eine. Ein Katalog, der nurone/otherbereitstellt, gibt Russisch für 2, 21 und 101 falsch wieder – und der Code, nicht der Übersetzer, ist schuld. Überprüfen Sie die Kategorien des Ziels, bevor Sie die Datei befüllen (Tabelle insoftware-strings.md). - Budgetexpansion abhängig von der Quelllänge, vor dem Layout-Freeze. Kurze Strings expandieren am meisten. Ab Englisch: planen Sie für: 1-10 Zeichen → bis zu +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30% (IBMs Globalisierungstabelle, der Industriestandard). Deutsch, Finnisch und Russisch liegen am oberen Ende des Bereichs; CJK schrumpft um etwa ein Drittel, benötigt aber eine größere Zeilenhöhe. Eine nur auf Englisch getestete Benutzeroberfläche wurde nicht getestet.
- Ein Begriff, eine Wiedergabe, schriftlich festgehalten beim ersten Mal, wenn er entschieden wird. Konsistenz schlägt Eleganz: Ein Leser, der zwei Wörter für einen Begriff sieht, geht davon aus, dass es zwei Begriffe sind. Beim ersten Mal, wenn ein Begriff gewählt wird, wird er zu einer Glossarzeile mit seiner Wortart und dem Grund; beim ersten Mal, wenn einer abgelehnt wird, wird er zu einer verbotenen Wiedergabe. Boxen und Formate:
memory-template.md, Mechanik interminologie.md. - Register ist eine gebietsschemaspezifische Entscheidung, die einmal getroffen und wiederverwendet wird. T-V-Unterscheidung (tu/vous, tú/usted, du/Sie), japanische Höflichkeitsstufe, koreanische Sprechstufe und arabisches MSA versus Dialekt sind keine Entscheidungen auf Satzebene – der Wechsel mitten im Produkt ist das sichtbarste Amateursignal, das es gibt. Standard von
formality; eine angegebene Präferenz wird in derselben Runde zur Zeile des Gebietsschemas im Gedächtnis (gebietsschemata.md). - Maschinenausgabe ist ein Entwurf mit einer bekannten Fehlerliste. Bevor Sie MT auf Stil lesen, überprüfen Sie fünf Dinge in der Reihenfolge: fehlende oder umgekehrte Verneinung, Übereinstimmung von Geschlecht und Numerus, Terminologie gegen das Glossar, Höflichkeitsstufe sowie Zahlen oder Einheiten, die unverändert kopiert wurden. Geregelt durch
mt_policy; MT ist niemals das Lieferergebnis für rechtliche, medizinische oder Sicherheitstexte (maschinelle-uebersetzung.md). - Nichts Risikoreiches wird mit nur einem Augenpaar ausgeliefert. ISO 17100 definiert einen Übersetzungsdienst als Übersetzung plus Revision durch eine zweite Person; wo eine zweite Person unmöglich ist, ist der Ersatz eine verzögerte Selbstüberprüfung (mindestens einige Stunden später, nur in der Zielsprache, Quelle ausgeblendet) plus eine Rückübersetzung der risikotragenden Segmente – Zahlen, Dosierungen, Verneinungen, Verpflichtungen, Fristen, Namen. Definieren Sie, welche Segmente risikotragend sind, bevor Sie beginnen, nicht danach (
qualitaet.md).
Was kaputtgeht und was es bedeutet
Dekodierungsregel: Die Schicht, die den Schaden zeigt, nennt die Ursache. Verstümmelte Zeichen sind Bytes; falsche Grammatik um eine Zahl ist eine Pluralregel; ein String, der sich nie ändert, wurde nie extrahiert.
| Symptom | Wahrscheinlichste Ursache | Erster Schritt |
|---|---|---|
é, ’, ñ | UTF-8-Bytes, die irgendwo in der Kette als Latin-1 dekodiert wurden | Finden Sie den einen Hop, der eine veraltete Kodierung annimmt; niemals durch erneutes Eintippen von Zeichen „beheben |