Zum Inhalt springen

Die Python-Dokumentation gibt es jetzt auf Deutsch

Die Python-Dokumentation hat jetzt eine deutsche Ausgabe unter docs.python.org/de/3/. Die Kernseiten sind zu 100 % übersetzt, die gesamte Dokumentation zu 9,17 %.

Von Tech AI Wire Team

3 Min. Lesezeit

XLinkedIn
The German start page of the Python documentation at docs.python.org, headed Python 3.14.7 Dokumentation, with a version list down the left side.

Die Zahlen

of the core documentation set translated
100%
of the full documentation translated
9.17%
active Python docs translation projects
27

Die offizielle Python-Dokumentation hat jetzt eine deutsche Ausgabe. Das Python-Projekt gab das am 26. September 2026 bekannt, die Seiten liegen unter docs.python.org/de/3/. Das ist wichtig, weil Deutschsprachige die Sprache jetzt aus ihrer eigenen Referenz lernen können, nicht aus Büchern oder Blogbeiträgen Dritter.

Die Ankündigung kam von Stan Ulbrych im Python-Insider-Blog. "Wir freuen uns, bekannt zu geben, dass die Python-Dokumentation jetzt auf Deutsch verfügbar ist!", schrieb er. Er würdigte die Freiwilligen aus der Community, die die Übersetzungsarbeit geleistet haben.

Was bisher übersetzt ist

Die deutsche Ausgabe ist dort vollständig, wo es zuerst zählt, und überall sonst noch dünn. Das Übersetzungs-Dashboard des Projekts unter translations.python.org erfasst für jede Sprache zwei Werte.

KennzahlFortschritt Deutsch
Kerndokumentation100 %
Kernfortschritt in den letzten 30 Tagen23,79 %
Gesamte Dokumentation9,17 %
Gesamtfortschritt in den letzten 30 Tagen5,87 %

Rund ein Viertel des Kernbestands wurde also im letzten Monat vor dem Start fertig. Die gesamte Dokumentation ist ein weit größerer Textkörper. Dazu gehört die Referenz der Standardbibliothek, die jedes eingebaute Modul ausführlich beschreibt.

Die deutsche Seite bietet mehrere Python-Versionen an. Ihr Versionsmenü führt Python 3.14.7 als aktuelle stabile Version. Außerdem gibt es 3.15, das sich im Pre-Release befindet, und 3.16, das noch in Entwicklung ist.

Warum eine Sprache erst erscheint, wenn ihr Kern fertig ist

Pythons Regeln für Übersetzungen stammen aus PEP 545, einem Python Enhancement Proposal. Ein PEP ist das formale Designdokument, mit dem das Projekt festlegt, wie Dinge funktionieren.

PEP 545 setzt eine Hürde, bevor eine Sprache im Sprachmenü der Dokumentation erscheint. Drei Teile müssen zu 100 % übersetzt sein: die Seite zum Melden von Fehlern, das Tutorial und die Referenz der eingebauten Funktionen. Deshalb kann eine neue Sprache live gehen, obwohl die meisten ihrer Seiten noch auf Englisch sind. Die Teile, die Einsteiger zuerst lesen, sind fertig. Der lange Rest folgt später.

Derselbe PEP legt das Muster der Webadresse fest, docs.python.org/LANGUAGE/VERSION/. Er verlangt außerdem einen namentlich benannten Koordinator pro Sprache. Für Deutsch nennt der Python Developer's Guide Swen Bachmann als diesen Koordinator. Die Übersetzungsdateien liegen in seinem GitHub-Repository python-docs-de, das 361 Commits zeigt.

Wie die Übersetzungspipeline funktioniert

Übersetzer bearbeiten die Dokumentationsseiten nie direkt. Laut dem Developer's Guide arbeiten sie in gettext-PO-Dateien. Gettext ist ein verbreitetes Werkzeug zum Übersetzen von Software. Eine PO-Datei führt jeden englischen Satz neben einem Platz für seine Übersetzung auf.

Sphinx, das Werkzeug, das Pythons Dokumentation baut, erzeugt diese Dateien aus der englischen Quelle. Wenn die Übersetzer fertig sind, holen Build-Skripte die Dateien ab und veröffentlichen sie automatisch auf docs.python.org. Das deutsche Team verwaltet seine Arbeit über Transifex, eine Webplattform für Übersetzungsprojekte.

Mitwirkende müssen zuerst eine Beitragsvereinbarung für die Dokumentation akzeptieren. Nach PEP 545 stellt diese ihre Arbeit unter die CC0-Lizenz, eine Widmung an die Gemeinfreiheit. Deutsch reiht sich in 27 aktive Übersetzungsprojekte ein, darunter Französisch, Spanisch, Japanisch, Russisch, Ungarisch und beide Formen des Chinesischen.

Was das für Entwickler bedeutet

Wenn Sie Deutschsprachigen Python beibringen, verweisen Sie sie für das Tutorial und die Referenz der eingebauten Funktionen jetzt auf docs.python.org/de/3/. Diese Teile sind vollständig übersetzt. Bei der Referenz der Standardbibliothek sind die meisten Seiten noch auf Englisch, da die gesamte Dokumentation bei 9,17 % steht.

Prüfen Sie die Version in jedem Link, den Sie teilen. Die deutsche Seite bietet mehrere Versionen an, von 2.6 bis zur Entwicklungsdokumentation von 3.16. Ein Link auf /de/3/ folgt der aktuellen stabilen Version, ein Link mit Versionsnummer bleibt fest. Nutzen Sie die feste Form in Kursmaterial, das Sie nicht aktualisieren wollen.

Wenn Sie Deutsch schreiben und Python kennen, ist das einer der einfacheren Wege, zum Projekt beizutragen. Sie übersetzen PO-Einträge über Transifex, und der Developer's Guide erklärt die Einrichtung. Der Wert von 9,17 % zeigt, wie viel der Bibliotheksreferenz noch Hilfe braucht.

Halten Sie Ihre Begriffe einheitlich. Der Developer's Guide bittet Übersetzer, technische Bezeichnungen zu respektieren, daher bleiben Namen wie dict oder asyncio unverändert. Nur der Fließtext um sie herum ändert sich.

Und schließlich: Behalten Sie das Dashboard im Blick, wenn Ihr Team in einer anderen Sprache arbeitet. Dieselbe 100-%-Kernregel entscheidet, wann diese Ausgabe im Sprachmenü erscheint.

Quellen

  1. The Python documentation is now available in German - Python Insider
  2. Python documentation translations dashboard - Python translations dashboard
  3. PEP 545 - Python Documentation Translations - Python Enhancement Proposals
  4. Translating - Python Developer's Guide - Python Developer's Guide
pythonopen-sourcedocumentation

Ähnliche Artikel