Skip to content

CLAUDE.md

Latest commit

 

History

History
43 lines (38 loc) · 1.96 KB

CLAUDE.md

File metadata and controls

43 lines (38 loc) · 1.96 KB
Raw

Übersetzungsregeln für python-docs-de

Dieses Repository enthält die deutsche Übersetzung der Python-Dokumentation als Gettext-Dateien (.po). Übersetzt wird ausschließlich der msgstr.

Sprache und Terminologie

  • Durchgehend „Du"-Form, niemals „Sie"
  • „Built-in" → „integriert"
  • „dictionary" → „Dictionary" (nicht „Wörterbuch")
  • „string" → „Zeichenkette" (nicht „String" oder „Zeichenfolge")
  • „iterable" → „iterierbares Objekt"
  • Funktionsbeschreibungen in der 3. Person: „Gibt … zurück"
  • Deutsche Anführungszeichen „…“, nie um Rollen oder Code herum
  • „unraisable exception" → „nicht weiterleitbare Ausnahme (unraisable exception)" beim ersten Vorkommen, danach kurz
  • „free-threaded build" → „Build mit freien Threads" (laut Glossar)
  • Bei Fachbegriffen ist glossary.po maßgeblich. Im Zweifel dort nachschlagen, bevor ein Begriff neu übersetzt wird.

reST- und PO-Syntax

  • msgid NIEMALS ändern, auch nicht bei Tippfehlern im Original
  • Rollen (:func:, :class:, :ref:, :term:, :meth:, :exc:) exakt übernehmen; Anzahl und Reihenfolge müssen msgid und msgstr entsprechen
  • Bei :term: und :ref: mit deutschem Anzeigetext immer das Ziel angeben: :term:Sequenz ``
  • Parameternamen zwischen Sternchen bleiben englisch: maxsplit
  • Nach ` oder * nie direkt ein Buchstabe oder Bindestrich (kein *m*s, kein :class:X-Instanz)
  • Vor einer Rolle immer ein Leerzeichen
  • Code-Literale, Programmausgaben und :: am Zeilenende unverändert
  • #, fuzzy nach dem Übersetzen entfernen

Prüfungen nach jedem Abschnitt

powrap <datei>
msgfmt --check -o /dev/null <datei>
sphinx-lint <datei>
python3 check_roles.py <datei>

Gemeldete Fehler beheben und die Prüfungen erneut ausführen – höchstens drei Versuche. Bleiben danach Fehler bestehen: nicht committen, sondern die betroffenen Einträge und die Fehlermeldungen auflisten und auf Rückmeldung warten.