Русскоязычные разработчики получили официальный перевод документации по языку программирования Python. Об этом сообщил Стен Ульбрих (Stan Ulbrych) в блоге Python Insider. Локализованная версия материалов уже опубликована и доступна на официальном сайте проекта.
Переводчики подготовили локализацию для стабильного релиза Python 3.14.7. На портале можно переключаться между версиями, а также скачивать архивы документов для работы в офлайн-режиме. Такой масштабный проект стал возможен благодаря совместной работе волонтеров и участников open-source сообщества.
Что вошло в русскоязычную версию
На данный момент команда переводчиков локализовала базовые разделы, необходимые для начала работы с языком. Тем, кто только начинает знакомство с Python, поможет Руководство, объясняющее основной синтаксис, структуры данных, функции и другие теоретические блоки, необходимые для начального погружения.
Помимо этого на русский язык переведены первые три (если быть точнее — две с половиной), а также седьмая главы Справочника по языку Python.
Остальные блоки документации — справочники по библиотеке и работе с API, гайд по установке и настройке, тематические руководства, описание устаревшей функциональности и ответы на часто задаваемые вопросы — пока что остаются на английском языке.
30+ бесплатных курсов на ИТ‑темы в Академии Selectel
Для начинающих и опытных специалистов.
Изучить →
Технические детали и лицензирование
Для сборки локализованной версии разработчики использовали генератор документации Sphinx 8.2.3. Тексты справочников вышли под некоммерческой лицензией Python Software Foundation License версии 2. Однако для примеров кода, рецептов и программных фрагментов действует свободная лицензия Zero Clause BSD (0BSD). Это решение позволяет разработчикам свободно использовать примеры из документации в коммерческих и личных проектах без обязательного указания авторства.
Как поддержать проект и поучаствовать в переводе
Команда Python поблагодарила всех добровольцев, которые уделили время этой задаче. Русский язык вошел в число официальных локализаций наряду с французским, испанским, португальским, японским и другими языками.
Поскольку Python постоянно развивается, перевод необходимо регулярно обновлять и адаптировать под новые релизы. Сообщество приглашает новых участников помочь в развитии проекта. Для этого необходимо изучить руководство по переводу в Python Developer’s Guide и интерактивную панель (Translation Dashboard).
Забавная деталь анонса
В качестве интересного отступления авторы анонса добавили небольшую заметку о русском алфавите для зарубежных читателей. Разработчики отметили, что буквы «ь» (мягкий знак) и «ъ» (твердый знак) сами по себе не передают отдельных звуков, а служат для изменения произношения соседних согласных или разделения звуков в словах.
Источник: habr.com