# bersetzungsregeln fr python-docs-de

Dieses Repository enthlt die deutsche bersetzung der Python-Dokumentation
als Gettext-Dateien (`.po`). bersetzt wird ausschlielich der `msgstr`.

## Sprache und Terminologie
- Durchgehend Du"-Form, niemals Sie"
- Built-in"  integriert"
- dictionary"  Dictionary" (nicht Wrterbuch")
- string"  Zeichenkette" (nicht String" oder Zeichenfolge")
- iterable"  iterierbares Objekt"
- Funktionsbeschreibungen in der 3. Person: Gibt  zurck"
- Deutsche Anfhrungszeichen , 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` mageblich. 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 mssen 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 unverndert
- `#, fuzzy` nach dem bersetzen entfernen

## Prfungen nach jedem Abschnitt
    powrap 
    msgfmt --check -o /dev/null 
    sphinx-lint 
    python3 check_roles.py 

Gemeldete Fehler beheben und die Prfungen erneut ausfhren 
hchstens drei Versuche. Bleiben danach Fehler bestehen: nicht
committen, sondern die betroffenen Eintrge und die Fehlermeldungen
auflisten und auf Rckmeldung warten.