La documentation Python est désormais disponible en allemand

La documentation officielle de Python dispose désormais d'une édition allemande. Le projet Python l'a annoncé le 26 septembre 2026, et les pages sont en ligne sur docs.python.org/de/3/. C'est important, car les germanophones peuvent désormais apprendre le langage avec sa propre référence, et non avec des livres ou des billets de blog de tiers.

L'annonce est venue de Stan Ulbrych sur le blog Python Insider. "Nous sommes ravis d'annoncer que la documentation Python est désormais disponible en allemand (Deutsch) !", a-t-il écrit. Il a salué les bénévoles de la communauté qui ont réalisé le travail de traduction.

Ce qui est traduit pour l'instant

L'édition allemande est complète là où cela compte en premier, et mince partout ailleurs. Le tableau de bord de traduction du projet, sur translations.python.org, suit deux chiffres pour chaque langue.

Mesure	Progression de l'allemand
Documentation essentielle	100 %
Progression essentielle sur les 30 derniers jours	23,79 %
Documentation complète	9,17 %
Progression complète sur les 30 derniers jours	5,87 %

Environ un quart de l'ensemble essentiel a donc été terminé au cours du dernier mois avant le lancement. La documentation complète représente un volume de texte bien plus important. Elle comprend la référence de la bibliothèque standard, qui décrit en détail chaque module intégré.

Le site allemand propose plusieurs versions de Python. Son menu de versions indique Python 3.14.7 comme version stable actuelle. Il propose aussi 3.15, en pré-version, et 3.16, encore en développement.

Pourquoi une langue n'apparaît qu'une fois son noyau terminé

Les règles de Python pour les traductions viennent de la PEP 545, une Python Enhancement Proposal. Une PEP est le document de conception formel que le projet utilise pour décider du fonctionnement des choses.

La PEP 545 fixe un seuil avant qu'une langue apparaisse dans le menu des langues de la documentation. Trois parties doivent être traduites à 100 % : la page sur le signalement des bogues, le tutoriel et la référence des fonctions intégrées. C'est pourquoi une nouvelle langue peut être mise en ligne alors que la plupart de ses pages sont encore en anglais. Les parties qu'un débutant lit en premier sont terminées. Le reste suit plus tard.

La même PEP fixe le modèle d'adresse web, docs.python.org/LANGUAGE/VERSION/. Elle exige aussi un coordinateur nommément désigné par langue. Pour l'allemand, le Python Developer's Guide désigne Swen Bachmann comme coordinateur. Les fichiers de traduction se trouvent dans son dépôt GitHub, python-docs-de, qui affiche 361 commits.

Comment fonctionne la chaîne de traduction

Les traducteurs ne modifient jamais directement les pages de la documentation. Selon le Developer's Guide, ils travaillent dans des fichiers PO gettext. Gettext est une boîte à outils courante pour traduire des logiciels. Un fichier PO liste chaque phrase anglaise à côté d'un emplacement pour sa traduction.

Sphinx, l'outil qui génère la documentation de Python, produit ces fichiers à partir de la source anglaise. Quand les traducteurs ont terminé, des scripts de build récupèrent les fichiers et les publient automatiquement sur docs.python.org. L'équipe allemande gère son travail via Transifex, une plateforme web pour les projets de traduction.

Les contributeurs doivent d'abord accepter un accord de contribution à la documentation. Selon la PEP 545, celui-ci place leur travail sous licence CC0, une dédicace au domaine public. L'allemand rejoint 27 projets de traduction actifs, dont le français, l'espagnol, le japonais, le russe, le hongrois et les deux formes du chinois.

Ce que cela signifie pour les développeurs

Si vous enseignez Python à des germanophones, orientez-les dès maintenant vers docs.python.org/de/3/ pour le tutoriel et la référence des fonctions intégrées. Ces parties sont entièrement traduites. Pour la référence de la bibliothèque standard, attendez-vous à ce que la plupart des pages soient encore en anglais, puisque l'ensemble complet en est à 9,17 %.

Vérifiez la version de chaque lien que vous partagez. Le site allemand propose plusieurs versions, de la 2.6 jusqu'à la documentation de développement de la 3.16. Un lien vers /de/3/ suit la version stable actuelle, tandis qu'un lien avec un numéro de version reste fixe. Utilisez la forme fixe dans les supports de cours que vous ne comptez pas mettre à jour.

Si vous écrivez en allemand et connaissez Python, c'est l'une des façons les plus simples de contribuer au projet. Vous traduisez des entrées PO via Transifex, et le Developer's Guide explique la configuration. Le chiffre de 9,17 % montre combien de la référence de la bibliothèque a encore besoin de bras.

Gardez une terminologie cohérente. Le Developer's Guide demande aux traducteurs de respecter les noms techniques, donc des noms comme dict ou asyncio restent tels quels. Seule la prose qui les entoure change.

Enfin, surveillez le tableau de bord si votre équipe travaille dans une autre langue. La même règle des 100 % pour le noyau décide du moment où cette édition apparaît dans le menu des langues.