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