|
| 1 | +# Übersetzungsregeln für python-docs-de |
| 2 | + |
| 3 | +Dieses Repository enthält die deutsche Übersetzung der Python-Dokumentation |
| 4 | +als Gettext-Dateien (`.po`). Übersetzt wird ausschließlich der `msgstr`. |
| 5 | + |
| 6 | +## Sprache und Terminologie |
| 7 | +- Durchgehend „Du"-Form, niemals „Sie" |
| 8 | +- „Built-in" → „integriert" |
| 9 | +- „dictionary" → „Dictionary" (nicht „Wörterbuch") |
| 10 | +- „string" → „Zeichenkette" (nicht „String" oder „Zeichenfolge") |
| 11 | +- „iterable" → „iterierbares Objekt" |
| 12 | +- Funktionsbeschreibungen in der 3. Person: „Gibt … zurück" |
| 13 | +- Deutsche Anführungszeichen „…", nie um Rollen oder Code herum |
| 14 | + |
| 15 | +## reST- und PO-Syntax |
| 16 | +- `msgid` NIEMALS ändern, auch nicht bei Tippfehlern im Original |
| 17 | +- Rollen (`:func:`, `:class:`, `:ref:`, `:term:`, `:meth:`, `:exc:`) |
| 18 | + exakt übernehmen; Anzahl und Reihenfolge müssen msgid und msgstr |
| 19 | + entsprechen |
| 20 | +- Bei `:term:` und `:ref:` mit deutschem Anzeigetext immer das Ziel |
| 21 | + angeben: `:term:`Sequenz <sequence>`` |
| 22 | +- Parameternamen zwischen Sternchen bleiben englisch: *maxsplit* |
| 23 | +- Nach `` ` `` oder `*` nie direkt ein Buchstabe oder Bindestrich |
| 24 | + (kein `*m*s`, kein `:class:`X`-Instanz`) |
| 25 | +- Vor einer Rolle immer ein Leerzeichen |
| 26 | +- Code-Literale, Programmausgaben und `::` am Zeilenende unverändert |
| 27 | +- `#, fuzzy` nach dem Übersetzen entfernen |
| 28 | + |
| 29 | +## Prüfungen nach jedem Abschnitt |
| 30 | + powrap <datei> |
| 31 | + msgfmt --check -o /dev/null <datei> |
| 32 | + sphinx-lint <datei> |
| 33 | + python3 check_roles.py <datei> |
| 34 | + |
| 35 | +Gemeldete Fehler beheben und die Prüfungen erneut ausführen – |
| 36 | +höchstens drei Versuche. Bleiben danach Fehler bestehen: nicht |
| 37 | +committen, sondern die betroffenen Einträge und die Fehlermeldungen |
| 38 | +auflisten und auf Rückmeldung warten. |
0 commit comments