Официальную документацию Python начали локализовать на русский язык

Русскоязычные разработчики получили официальный перевод документации по языку программирования Python. Об этом сообщил Стен Ульбрих (Stan Ulbrych) в блоге Python Insider. Локализованная версия материалов уже опубликована и доступна на официальном сайте проекта.

Переводчики подготовили локализацию для стабильного релиза Python 3.14.7. На портале можно переключаться между версиями, а также скачивать архивы документов для работы в офлайн-режиме. Такой масштабный проект стал возможен благодаря совместной работе волонтеров и участников open-source сообщества.

Что вошло в русскоязычную версию

На данный момент команда переводчиков локализовала базовые разделы, необходимые для начала работы с языком. Тем, кто только начинает знакомство с Python, поможет Руководство, объясняющее основной синтаксис, структуры данных, функции и другие теоретические блоки, необходимые для начального погружения. 

Помимо этого на русский язык переведены первые три (если быть точнее — две с половиной), а также седьмая главы Справочника по языку Python.

Остальные блоки документации — справочники по библиотеке и работе с API, гайд по установке и настройке, тематические руководства, описание устаревшей функциональности и ответы на часто задаваемые вопросы — пока что остаются на английском языке.

Технические детали и лицензирование

Для сборки локализованной версии разработчики использовали генератор документации Sphinx 8.2.3. Тексты справочников вышли под некоммерческой лицензией Python Software Foundation License версии 2. Однако для примеров кода, рецептов и программных фрагментов действует свободная лицензия Zero Clause BSD (0BSD). Это решение позволяет разработчикам свободно использовать примеры из документации в коммерческих и личных проектах без обязательного указания авторства.

Как поддержать проект и поучаствовать в переводе

Команда Python поблагодарила всех добровольцев, которые уделили время этой задаче. Русский язык вошел в число официальных локализаций наряду с французским, испанским, португальским, японским и другими языками.

Поскольку Python постоянно развивается, перевод необходимо регулярно обновлять и адаптировать под новые релизы. Сообщество приглашает новых участников помочь в развитии проекта. Для этого необходимо изучить руководство по переводу в Python Developer’s Guide и интерактивную панель (Translation Dashboard).

Забавная деталь анонса

В качестве интересного отступления авторы анонса добавили небольшую заметку о русском алфавите для зарубежных читателей. Разработчики отметили, что буквы «ь» (мягкий знак) и «ъ» (твердый знак) сами по себе не передают отдельных звуков, а служат для изменения произношения соседних согласных или разделения звуков в словах.