Документация Python на русском: официальный перевод на docs.python.org

22 августа 2026 года блог Python Insider объявил: официальная документация языка Python доступна на русском. Адрес тот же, что у английской версии, только с языковым префиксом: docs.python.org/ru/3.14/. Это не сторонний самоучитель и не «перевод от энтузиаста на своём домене». Это сборка на инфраструктуре python.org по правилам PEP 545.

OpenNET в тот же день, в 22:52 MSK, коротко зафиксировал новость: на русском выложили руководство (tutorial) и первые главы справочника по языку. Ниже проверка по живым страницам и дашборду переводов: что реально читать по-русски, что всё ещё английское, и чем это отличается от привычных docs-python.ru и pythonworld.ru.

Что произошло 22 августа 2026

Автор поста в Python Insider: Stan Ulbrych. Формулировка короткая: документация теперь доступна на русском (русский), спасибо волонтёрам. Отдельный технический отчёт по процентам в блоге не публиковали. Цифры нужно смотреть на translations.python.org.

На дашборде на 23 августа 2026, 07:00 UTC, у русского перевода:

• core: 100,00% (за период +5,37 процентных пункта);
• overall: 3,94% (плюс 0,52);
• сборка включена (built: true);
• рабочая ветка репозитория: 3.15;
• координатор в Python Developer’s Guide: Daniil Kolesnikov (MLGRussianXP/python-docs-ru).

Опубликованная русская документация на момент проверки: Python 3.14.7. Страницы помечены «Последнее обновление авг. 22, 2026 (09:02 UTC)». Расхождение «ветка 3.15 / сайт 3.14.7» нормальное: команды обычно переводят свежую не-альфа ветку, а на docs.python.org отдают стабильный выпуск.

Почему это не «весь Python на русском»

PEP 545 описывает, когда перевод можно показать в языковом переключателе на docs.python.org. Порог такой:

• 100% страницы bugs.html (со ссылками на трекер языковой команды);
• 100% tutorial;
• 100% раздела library/functions, то есть встроенных функций.

Это и есть «core» на дашборде. Tutorial закрыли, builtins перевели, язык появился в переключателе, блог написал «available in Russian». Overall 3,94% честно говорит: стандартная библиотека, HOWTO, C API, большая часть справочника языка ещё впереди. Непереведённые абзацы Sphinx оставляет английскими. Страница не пропадает, она просто двуязычная.

Для сравнения: упрощённый китайский на том же дашборде около 90% overall, бразильский португальский около 54%, японский около 39%. Русский только вошёл в публичный контур. Это старт официальной витрины, не финиш перевода.

Что уже читать по-русски

Руководство (tutorial)

Руководство по Python переведено целиком: оглавление из 16 глав на русском, от «Пробуждая интерес» до приложения. Это тот текст, с которого PEP 545 и рекомендует начинать публичный перевод. Оговорка в самом руководстве важная: оно для программистов, которые впервые берутся за Python, а не для человека, который вообще никогда не писал код.

Встроенные функции

Страница «Встроенные функции» тоже на русском: abs(), all(), any(), enumerate(), open() и остальной набор builtins. Это как раз второй обязательный кусок для попадания в переключатель. На той же странице уже видны английские хвосты: отдельные абзацы и ссылки на ещё не переведённые разделы stdlib. Так и должно быть при overall в четыре процента.

Справочник по языку

OpenNET прав в первой части. Справочник по языку на русском в главах 1–3: введение, лексический анализ, модель данных. Глава 4 «Execution model» и следующие в оглавлении снова на английском. Глава 7 «Простые инструкции» в меню уже по-русски, то есть работа идёт дальше первых трёх глав, но это не полный Language Reference.

Справочник специально не учебник. Он описывает синтаксис и «основную семантику». Для разбора спорного поведения import, областей видимости или грамматики он нужнее tutorial. Пока его нельзя считать закрытым.

Индекс и оболочка сайта

Главная docs.python.org/ru/ уже на русском: «Руководство», «Справочник по библиотеке», «ЧаВо», «Глоссарий». Сами страницы библиотеки в массе остаются английскими. Заголовок на русском не значит, что модуль ssl или pathlib переведён.

Зачем это тем, кто пишет ботов, Flask и скрипты на VPS

На практике порог входа в Python часто упирается не в синтаксис, а в английский справочник. Tutorial на docs.python.org/ru закрывает этот кусок официально, с той же структурой, что у оригинала, и с теми же примерами кода. Это удобно, если вы учите человека, который уже крутит Linux, но ещё не читает Language Reference с листа.

Для рабочего кода картина другая. Деплой, venv, systemd-юнит, работа с файлами, TLS, argparse, logging, pathlib: это стандартная библиотека, а она почти не переведена. Перед правкой продакшена разумнее открывать английскую страницу модуля и русскую как подсказку, а не наоборот.

На сайте уже есть прикладные материалы на Python, например бот для APC Smart-UPS в Telegram и кейс переноса Domaintools на Python. Новый официальный tutorial как раз закрывает «как устроен язык», а не «как выкатить сервис».

Как открыть русскую документацию

Прямые адреса:

• корень русской версии: docs.python.org/ru/3/;
• зафиксированная 3.14: docs.python.org/ru/3.14/;
• tutorial: /ru/3/tutorial/;
• справочник языка: /ru/3/reference/;
• встроенные функции: /ru/3/library/functions.html.

На любой странице английской документации есть переключатель языка. Если перевод страницы не готов, вы всё равно попадёте на ту же URL-структуру, просто с английским текстом внутри.

Версию интерпретатора на машине лучше сверить отдельно. Документация сейчас 3.14.7, у вас на Debian/Ubuntu в apt может быть другая минорная линейка.

python3 --version

Локальная справка по встроенной функции не заменяет сайт, но помогает, когда сети нет:

python3 -c "help('abs')"
pydoc3 abs

help() и pydoc отдают текст той установки Python, которая запущена. Это не русская документация с docs.python.org, а docstring интерпретатора. Для точных формулировок 3.14 смотрите сайт.

Чем это не является

• Не полный перевод стандартной библиотеки. Заголовок «Справочник по библиотеке» на главной не равен переведённому asyncio или ssl.
• Не замена PEP, What’s New и C API. Эти разделы для админа и автора расширений по-прежнему английские.
• Не сторонние учебники. docs-python.ru, pythonworld.ru и курсы существуют отдельно. У них другая лицензия, другая актуальность и другой контроль качества. Официальный URL только docs.python.org/ru/.
• Не машинный перевод «налетели ночью и закрыли всё». Команда переводит gettext PO-файлы, непереведённое остаётся английским. На живых страницах встречаются огрехи разметки и смешанные абзацы. Это ожидаемо для перевода на 4% overall.

Как устроен перевод и куда идти, если хотите помочь

Схема из Developer’s Guide такая: из исходников Sphinx снимают PO-каталоги, команда переводит их (часто через Transifex), коммиты попадают в языковой репозиторий, docsbuild-scripts собирают HTML и выкладывают на docs.python.org. Сообщения без перевода падают обратно в английский оригинал. Поэтому публикация возможна до 100% всей документации.

Русская команда в таблице переводов: координатор Daniil Kolesnikov. Работа идёт в проекте python-newest на Transifex. В README репозитория советуют сначала зайти в Telegram-канал t.me/py_docs_ru. Лицензия вкладов: CC0 в пользу PSF, это стандартный Documentation Contribution Agreement.

История длиннее анонса. 10 мая 2019 года Кристина Миронова написала в Doc-SIG, что отдельного русского репозитория нет, и попросила завести RU-команду. PEP 545 к тому моменту уже существовал (2017). Семь лет ушло на то, чтобы дотянуть core до 100% и появиться в языковом переключателе.

Гайд для переводчиков прямо запрещает слепо сдавать машинный перевод. Инструмент можно использовать как черновик, результат должен вычитывать человек, который знает и английский, и русский, плюс терминологию Python. Имена функций, ролей Sphinx и целей ссылок не переводят: сломается навигация.

Где обычно путаются

• Открыли /ru/, увидели русское меню и решили, что stdlib тоже готова. Нет: смотрите язык конкретного абзаца, не только шапки.
• Сравниваете поведение 3.12 из apt с текстом 3.14.7. Перед этим сверьте python3 --version.
• Копируете формулировку из неофициального зеркала. Для цитаты в статье, тикете или внутреннем runbook берите docs.python.org.
• Ищете полный Language Reference на русском. Первые главы есть, модель исполнения, import и грамматика в основном ещё английские.
• Путаете pydoc с сайтом. Локальный help() не переключается на /ru/.

Как проверить, что вы смотрите официальный перевод

1. Домен только docs.python.org, путь начинается с /ru/.
2. В шапке версия вроде «документация Python 3.14.7», внизу дата обновления и лицензия PSF.
3. Есть переключатель языка и ссылка «Нашли ошибку» / bugs.
4. Непереведённые куски остаются английскими, страница не обрывается заглушкой.
5. Процент готовности сверяете на translations.python.org, а не по чужому скриншоту.

Коротко

22 августа 2026 Python опубликовал официальную русскую документацию на docs.python.org/ru/. Tutorial и встроенные функции дотянуты до порога PEP 545, поэтому язык появился в переключателе. Справочник языка начат, стандартная библиотека почти не тронута: overall около 4%. Для учёбы языка это уже рабочий источник. Для админских модулей, SSL, venv и сетевого стека английская страница модуля пока главный документ. Если перевод мешает или наоборот помогает в работе, его можно дописывать через Transifex и канал русской команды, а не ждать «когда astropus всё доделает сам».

Источники