sync 3.14 with 3.15: fill lost translations, sync tooling

Author: sba72

.github/workflows/po-check.yml

@@ -14,12 +14,12 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.x"
 
@@ -33,7 +33,7 @@ jobs:
           find . -name "*.po" -exec powrap --quiet {} +
 
       - name: Commit & Push formatted PO files
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           commit_message: "Auto-format PO files to 80 chars [skip ci]"
           file_pattern: "*.po"

.github/workflows/po-lint.yml

@@ -1,5 +1,5 @@
 name: Linting Workflow
-
+# changed to 3.14, 3.15
 on:
   schedule:
     - cron: '0 0 * * *'
@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        version: [ '3.14' ]
+        version: [ '3.15' ]     # version: [ '3.15', '3.14' ]
     continue-on-error: true
     steps:
       - uses: actions/setup-python@master

.github/workflows/test-build.yml

@@ -35,7 +35,7 @@ jobs:
       - run: git pull
         working-directory: ./Doc/locales/de/LC_MESSAGES
       - uses: sphinx-doc/github-problem-matcher@v1.1
-      - run: make -e SPHINXOPTS="--color -D language='de' -D suppress_warnings=i18n.inconsistent_references -W --keep-going" ${{ matrix.format }}
+      - run: make -e SPHINXOPTS="--color -D language='de' -W --keep-going" ${{ matrix.format }}
         working-directory: ./Doc
       - uses: actions/upload-artifact@master
         if: success() || failure()

.gitignore

@@ -1,12 +1,19 @@
+# Editor- und Systemdateien
 *.po~
-# Editor und Betriebssystem
 .DS_Store
-/.idea/
-*.po~
 
-# Claude-Agent
-/.claude/
+# IDE
+.idea/
 
-# Python-Umgebung
-/.venv/
+# Python
 __pycache__/
+*.py[cod]
+.venv/
+
+# Kompilierte Kataloge (werden beim Build erzeugt)
+*.mo
+
+# Lokale Berichte unserer Werkzeuge
+markup_bericht.md
+branch_diff.md
+branch_diff.csv

CLAUDE.md

@@ -1,50 +1,43 @@
-# Übersetzungsregeln python-docs-de 
-
-## Sprache
-- Konsequent "Du"-Form
-- msgid (Englisch) NIE verändern, nur msgstr bearbeiten
-
-## Sphinx/reST-Syntax
-- `:ref:`Anzeigetext <ziel>`` → nur Anzeigetext übersetzen, Ziel bleibt Englisch
-- `:class:`/:func:`/:meth:`/:attr:`/:mod:`/:exc:`/:const:`/:keyword:`/:program:`/:pep:`/:kbd:`X`` ohne <...> → X bleibt unverändert
-- `~`-Präfix (z.B. `:meth:`~object.__lt__``) → kompletter Ausdruck inkl. ~ unverändert
-- `!`-Präfix (z.B. `:mod:`!string``) → nur Verlinkung unterdrückt, Bezeichner unverändert
-- Backticks sauber schließen, kein Leerzeichen davor
-- `::` am Satzende (leitet Codeblock ein) bleibt stehen
-- Zitierte Originaltitel aus externen Standards (z.B. Unicode Standard "Default Case Folding") bleiben unübersetzt in Anführungszeichen
-- Platzhalter/Makros (%s, {0}, <TRANSLATION_REPO_>) unverändert
-
-## Code-/REPL-Beispiele
-- Reiner Code, Ausgaben, Tracebacks: unverändert
-- NUR `#`-Kommentare darin übersetzen
-- msgstr immer identisch zu msgid befüllen, NIE leer lassen (auch bei reinem Code)
-
-## Fuzzy-Flags
-- Nach Prüfung/Übersetzung entfernen
-- Datei-Header-fuzzy (über leerem msgid "") ist reine Altlast, ohne Prüfung löschbar
-
-## Terminologie (unübersetzt lassen)
-Dictionary, Tuple, List Comprehension, Sentinel, Lazy Import, Property,
-Slice, Type Hints, f-string/f-String, t-string/T-String, Whitespace (Singular),
-Subclassing, API, Repository, Wheel
-
-## Terminologie (feste Übersetzung)
-- frozen... → unveränderlich (NICHT "eingefroren")
-- picklable → picklebar
-- I/O (NICHT E/A)
-- locale → Ländereinstellung
-- presentation type → Darstellungstyp
-- String (als Datentyp) → Zeichenkette
-- Debug/Conversion/Format specifier → Debug-/Konvertierungs-/Formatbezeichner
-- rich comparisons → erweiterte Vergleichsoperationen
-- generic over → "Typparameter" bei mehreren festen Parametern (z.B. dict: zwei),
-  "hinsichtlich des Typs" bei genau einem Parameter (list/set/frozenset/memoryview),
-  Plural "Typen" bei variabler Anzahl (tuple)
-
-## PO-Datei-Struktur
-- Genau ein leerer msgid ""-Header mit charset=UTF-8 pro Datei
-- Zeilenlänge ~80 Zeichen (powrap via CI erledigt das automatisch bei Push)
-- Vor Push immer lokal prüfen: find . -name "*.po" -not -path "./c-api/*" -exec msgfmt --check {} -o /dev/null \;
-
-## Core-Dateien (Pflicht für Sprachschalter-Aufnahme)
-Nur: bugs.po, library/functions.po, tutorial/*.po
+# Ü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 <sequence>``
+- 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.

TRANSIFEX-TRANSLATION.md

@@ -101,3 +101,7 @@ msgstr ""
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 ```
 
+Die Zeilen `msgid ""` und `msgstr ""` gehören zwingend dazu – fehlen sie,
+bricht `msgcat` mit einem Syntaxfehler ab. Und es darf genau **einen** solchen
+Kopfblock pro Datei geben; das PyCharm-Gettext-Plugin hat schon mehrfach
+weitere ans Dateiende angehängt.

check_roles.py

@@ -9,7 +9,6 @@
 import re
 import sys
 from pathlib import Path
-from collections import Counter
 
 ROLE_RE = re.compile(r":([a-zA-Z][\w-]*):`([^`]+)`")
 
@@ -88,23 +87,15 @@ def check_file(path: Path) -> list[str]:
             continue
         orig_roles = extract_roles(msgid)
         trans_roles = extract_roles(msgstr)
-        anzahl_quelle = Counter(orig_roles)
-        anzahl_ziel = Counter(trans_roles)
-        if anzahl_quelle != anzahl_ziel:
+        if orig_roles != trans_roles:
+            missing = [r for r in orig_roles if r not in trans_roles]
+            extra = [r for r in trans_roles if r not in orig_roles]
             parts = []
-            for rolle in anzahl_quelle:
-                if anzahl_quelle[rolle] > anzahl_ziel[rolle]:
-                    parts.append(
-                        f"fehlt: {rolle} "
-                        f"({anzahl_quelle[rolle]}x im msgid, {anzahl_ziel[rolle]}x im msgstr)"
-                    )
-            for rolle in anzahl_ziel:
-                if anzahl_ziel[rolle] > anzahl_quelle[rolle]:
-                    parts.append(
-                        f"zusätzlich/falsch: {rolle} "
-                        f"({anzahl_ziel[rolle]}x im msgstr, {anzahl_quelle[rolle]}x im msgid)"
-                    )
-            findings.append(f"  Zeile ~{lineno}: " + "; ".join(parts))
+            if missing:
+                parts.append(f"fehlt: {missing}")
+            if extra:
+                parts.append(f"zusätzlich/falsch: {extra}")
+            findings.append(f"  Zeile ~{lineno}: {', '.join(parts)}")
     return findings