本文へスキップ

Pythonドキュメントのドイツ語版が公開

Pythonのdocumentation(ドキュメント)にドイツ語版がdocs.python.org/de/3/で登場した。コアページは100%翻訳済みで、全体では9.17%にとどまる。

著者 Tech AI Wire Team

3 分で読めます

docs.python.orgにあるPythonドキュメントのドイツ語版トップページ。見出しは「Python 3.14.7 Dokumentation」で、左側にバージョン一覧が並ぶ。

数字で見る

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

Pythonの公式ドキュメントにドイツ語版ができた。Pythonプロジェクトが2026年9月26日に発表し、ページはdocs.python.org/de/3/で公開されている。ドイツ語話者が、サードパーティーの書籍やブログ記事ではなく、言語そのもののリファレンスで学べるようになった。そこに意味がある。

発表したのはStan Ulbrych氏で、Python Insiderブログに掲載された。「Pythonドキュメントがドイツ語(Deutsch)で利用可能になったことを発表でき、うれしく思います!」と同氏は書いた。同氏は翻訳作業を担ったコミュニティのボランティアに謝意を示した。

これまでに翻訳された範囲

ドイツ語版は、まず重要な部分では完成しており、それ以外はまだ手薄だ。translations.python.orgにあるプロジェクトの翻訳ダッシュボードは、言語ごとに2つの数値を追跡している。

指標ドイツ語の進捗
コアドキュメント100%
直近30日間のコアの進捗23.79%
ドキュメント全体9.17%
直近30日間の全体の進捗5.87%

つまり、コアのおよそ4分の1は公開前の最後の1か月で仕上がった。ドキュメント全体ははるかに大きな文章量を持つ。そこには標準ライブラリのリファレンスが含まれ、すべての組み込みモジュールを詳しく説明している。

ドイツ語サイトは複数のPythonバージョンを提供している。バージョンメニューでは、Python 3.14.7が現行の安定版として表示される。プレリリース段階の3.15と、まだ開発中の3.16も用意されている。

コアが完成して初めて言語が公開される理由

Pythonの翻訳に関するルールは、Python Enhancement ProposalであるPEP 545に由来する。PEPは、プロジェクトが物事の仕組みを決めるために使う正式な設計文書だ。

PEP 545は、ある言語がドキュメントの言語メニューに表示される前の基準を定めている。3つの部分が100%翻訳されていなければならない。バグ報告のページ、チュートリアル、そして組み込み関数のリファレンスだ。そのため、新しい言語は大半のページがまだ英語のままでも公開できる。初心者が最初に読む部分は完成している。残りの長い部分は後から続く。

同じPEPは、Webアドレスの形式をdocs.python.org/LANGUAGE/VERSION/と定めている。さらに、言語ごとに名前の明示されたコーディネーターを1人置くことも求めている。ドイツ語については、Python Developer's GuideがSwen Bachmann氏をそのコーディネーターとして挙げている。翻訳ファイルは同氏のGitHubリポジトリpython-docs-deにあり、361件のコミットが記録されている。

翻訳パイプラインの仕組み

翻訳者がドキュメントのページを直接編集することはない。Developer's Guideによれば、翻訳者はgettextのPOファイルで作業する。gettextはソフトウェア翻訳のための一般的なツールキットだ。POファイルには、英語の各文と、その翻訳を入れる欄が並んでいる。

Pythonのドキュメントをビルドするツール、Sphinxが、英語のソースからこれらのファイルを生成する。翻訳者の作業が終わると、ビルドスクリプトがファイルを取り込み、docs.python.orgへ自動的に公開する。ドイツ語チームは、翻訳プロジェクト向けのWebプラットフォームTransifexで作業を管理している。

貢献者はまず、ドキュメントの貢献契約に同意する必要がある。PEP 545のもとでは、これにより作業成果はCC0ライセンス、つまりパブリックドメインへの献呈として提供される。ドイツ語は27の活動中の翻訳プロジェクトに加わる。その中にはフランス語、スペイン語、日本語、ロシア語、ハンガリー語、そして2種類の中国語が含まれる。

開発者にとっての意味

ドイツ語話者にPythonを教えているなら、チュートリアルと組み込み関数のリファレンスについては、今すぐdocs.python.org/de/3/を案内するとよい。これらの部分は完全に翻訳されている。標準ライブラリのリファレンスについては、全体が9.17%なので、大半のページはまだ英語だと考えておきたい。

共有するリンクのバージョンを確認しよう。ドイツ語サイトは、2.6から3.16の開発版ドキュメントまで複数のバージョンを提供している。/de/3/へのリンクは現行の安定版に追従し、バージョン番号付きのリンクは固定される。更新する予定のない教材では、固定の形式を使うとよい。

ドイツ語が書けてPythonを知っているなら、これはプロジェクトに貢献する比較的簡単な方法の1つだ。Transifexを通じてPOのエントリーを翻訳し、設定方法はDeveloper's Guideに説明がある。9.17%という数字は、ライブラリリファレンスにまだどれだけ人手が要るかを示している。

用語は一貫させよう。Developer's Guideは翻訳者に技術的な名称を尊重するよう求めている。そのためdictやasyncioのような名前はそのまま残る。変わるのは、その周りの文章だけだ。

最後に、チームが別の言語で作業しているなら、ダッシュボードを見守っておこう。同じ100%のコア基準が、その言語版がいつ言語メニューに表示されるかを決める。

出典

  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

関連記事