From 2fdcf73ba5a86febf1073db037f598c8417362a0 Mon Sep 17 00:00:00 2001 From: XORandom <40043238+XORandom@users.noreply.github.com> Date: Tue, 5 Nov 2024 22:14:51 +0300 Subject: [PATCH] Add Russian readme (#3138) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Update README.rst * Create README.ru.rst Added a translation to Russian. * Update README.es.rst Добавлены ссылки на ru.rst * Update README.ru.rst * Update README.ja.rst Added links to ru. rst * Added links to en README * Added links to ru. rst * Added links to ru. rst * Added links to ru. rst * Update README.zh-cn.rst * Update README.fr.rst * Update README.fa.rst * Update README.es.rst * Fixed non-clickable links Fixed non-clickable links to English README and incorrect paths to other README's * Update README.ru.rst * fix incorrect links to other readme's * fix formatting * Corrected the sentence to make it sound better. * Removed extra newline * Update README.ru.rst add `Italiano` * Update README.it.rst * Fix formatting --------- Co-authored-by: Dan Lawrence Co-authored-by: Ankith --- README.rst | 3 +- docs/readmes/README.es.rst | 4 +- docs/readmes/README.fa.rst | 4 +- docs/readmes/README.fr.rst | 4 +- docs/readmes/README.it.rst | 3 +- docs/readmes/README.ja.rst | 13 +- docs/readmes/README.ru.rst | 226 ++++++++++++++++++++++++++++++++++ docs/readmes/README.zh-cn.rst | 4 +- 8 files changed, 250 insertions(+), 11 deletions(-) create mode 100644 docs/readmes/README.ru.rst diff --git a/README.rst b/README.rst index e9c952c6a4..72b6cea133 100644 --- a/README.rst +++ b/README.rst @@ -8,7 +8,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -**English** `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ +**English** `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ --------------------------------------------------------------------------------------------------- Pygame_ is a free and open-source cross-platform library @@ -221,3 +221,4 @@ See docs/licenses for licenses of dependencies. .. _Español: ./docs/readmes/README.es.rst .. _日本語: ./docs/readmes/README.ja.rst .. _Italiano: ./docs/readmes/README.it.rst +.. _Русский: ./docs/readmes/README.ru.rst diff --git a/docs/readmes/README.es.rst b/docs/readmes/README.es.rst index 9c78006fe2..69d55ea896 100644 --- a/docs/readmes/README.es.rst +++ b/docs/readmes/README.es.rst @@ -7,7 +7,8 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ **Español** `日本語`_ `Italiano`_ +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ **Español** `日本語`_ `Italiano`_ `Русский`_ + --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ es una biblioteca multiplataforma, gratuita y de código abierto @@ -171,3 +172,4 @@ Consulta docs/licenses para ver las licencias de dependencia. .. _Français: README.fr.rst .. _日本語: README.ja.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst diff --git a/docs/readmes/README.fa.rst b/docs/readmes/README.fa.rst index e41ebb3ea8..bb83cd0733 100644 --- a/docs/readmes/README.fa.rst +++ b/docs/readmes/README.fa.rst @@ -7,7 +7,8 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ `Français`_ **فارسی** `Español`_ `日本語`_ `Italiano`_ +`English`_ `简体中文`_ `繁體中文`_ `Français`_ **فارسی** `Español`_ `日本語`_ `Italiano`_ `Русский`_ + --------------------------------------------------------------------------------------------------- کتابخانه Pygame_ @@ -257,3 +258,4 @@ LGPL-2.1-or-later **شناسه مجوز:** .. _Español: README.es.rst .. _日本語: README.ja.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst diff --git a/docs/readmes/README.fr.rst b/docs/readmes/README.fr.rst index e546df1afe..72155e294b 100644 --- a/docs/readmes/README.fr.rst +++ b/docs/readmes/README.fr.rst @@ -7,7 +7,8 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ **Français** `فارسی`_ `Español`_ `日本語`_ `Italiano`_ +`English`_ `简体中文`_ `繁體中文`_ **Français** `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ + --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ est une bibliothèque multi-plateforme, libre et open-source @@ -211,3 +212,4 @@ Voir les docs/licences pour les licences des dépendances. .. _Español: README.es.rst .. _日本語: README.ja.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst diff --git a/docs/readmes/README.it.rst b/docs/readmes/README.it.rst index df7dcddb58..0a7f366297 100644 --- a/docs/readmes/README.it.rst +++ b/docs/readmes/README.it.rst @@ -8,7 +8,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ **Italiano** +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ **Italiano** `Русский`_ --------------------------------------------------------------------------------------------------- Pygame_ è una libreria open source gratuita e multipiattaforma @@ -226,3 +226,4 @@ Controlla docs/licenses per le licenze dei requisiti. .. _Español: README.es.rst .. _日本語: README.ja.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst diff --git a/docs/readmes/README.ja.rst b/docs/readmes/README.ja.rst index 7774b97a1d..bc4c0e63ab 100644 --- a/docs/readmes/README.ja.rst +++ b/docs/readmes/README.ja.rst @@ -8,7 +8,8 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English` `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ **日本語** `Italiano`_ +`English` `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ **日本語** `Italiano`_ `Русский`_ + --------------------------------------------------------------------------------------------------- Pygame_ は、Pythonを使ってビデオゲームのようなマルチメディアアプリケーションを @@ -232,9 +233,11 @@ gfxdraw には SDL_gfx の埋め込みバージョンが含まれています。 .. _Pygame Community Discord Server: https://discord.gg/pygame .. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki -.. _简体中文: ./docs/readmes/README.zh-cn.rst +.. _English: ./../../README.rst +.. _简体中文: README.zh-cn.rst .. _繁體中文: README.zh-tw.rst -.. _Français: ./docs/readmes/README.fr.rst -.. _فارسی: ./docs/readmes/README.fa.rst -.. _Español: ./docs/readmes/README.es.rst +.. _Français: README.fr.rst +.. _فارسی: README.fa.rst +.. _Español: README.es.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst diff --git a/docs/readmes/README.ru.rst b/docs/readmes/README.ru.rst new file mode 100644 index 0000000000..e6e099775f --- /dev/null +++ b/docs/readmes/README.ru.rst @@ -0,0 +1,226 @@ +.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg + :width: 800 + :alt: pygame + :target: https://pyga.me/ + + +|DocsStatus| +|PyPiVersion| |PyPiLicense| +|Python3| |GithubCommits| |BlackFormatBadge| + +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ **Русский** +--------------------------------------------------------------------------------------------------- + +Pygame_ - бесплатная кроссплатформенная библиотека с открытым исходным кодом +для разработки мультимедийных приложений, таких как видеоигры, с использованием Python. +Он использует `Simple DirectMedia Layer library`_ и несколько других популярных библиотек +для абстрагирования наиболее распространенных функций, +что делает написание этих программ более интуитивно понятной задачей. + + +Этот дистрибутив называется **'pygame - Community Edition'** (сокращённо 'pygame-ce'). + +Это ответвление исходного проекта pygame от его бывших главных разработчиков и было создано после того, как непреодолимые +трудности помешали им продолжить разработку исходного проекта. +Новый дистрибутив призван предлагать более частые выпуски, постоянные исправления и усовершенствования, +а также более демократичную модель управления. + +Новые участники приветствуются! + + +Установка +------------ + +:: + + pip install pygame-ce + + +Справка +---- + +Если вы только начинаете работать с pygame, вы сможете приступить к работе довольно быстро. +Pygame поставляется с множеством руководств и введений. +Также имеется полная справочная документация по всей библиотеке. +Просмотрите документацию на страниц `docs page`_. +Вы также можете просмотреть документацию локально, запустив +``python -m pygame.docs`` в Вашем терминале. Если документы не найдены +локально, вместо этого будет запущен онлайн-сайт. + +Интерактивная документация соответствует версии pygame для разработки на github. +Она может быть немного новее, чем версия pygame, которую вы используете. +Чтобы перейти на последнюю выпущенную версию, запустите +``pip install pygame-ce --upgrade`` в Вашем терминале. + +Лучше всего то, что в каталоге examples есть множество воспроизводимых небольших программ, +которые помогут вам сразу начать работу с кодом. + + +Сборка из исходного кода +-------------------- + +Если вы хотите использовать функции, которые в настоящее время находятся в разработке, +или вы хотите внести свой вклад в pygame-ce, +вам нужно будет создать pygame-ce локально из его исходного кода, а не устанавливать его pip. + +Установка из исходного кода довольно автоматизирована. +Основная работа будет включать компиляцию и установку всех зависимостей pygame. +Как только это будет сделано, запустите сценарий ``setup.py``, +который попытается автоматически настроить, собрать и установить pygame. + +Гораздо больше информации об установке и компиляции доступно +на `Compilation wiki page`_. + + +Заслуги +------- + +Спасибо всем, кто помог внести свой вклад в эту библиотеку. +Также уместна особая благодарность. + +* Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer +* Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes +* Brian Fisher for svn auto builder, bug tracker and many contributions +* Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer +* Phil Hassey for his work on the pygame.org website +* DR0ID for his work on the sprite module +* Richard Goedeken for his smoothscale function +* Ulf Ekström for his pixel perfect collision detection code +* Pete Shinners: original author +* David Clark for filling the right-hand-man position +* Ed Boraas and Francis Irving: Debian packages +* Maxim Sobolev: FreeBSD packaging +* Bob Ippolito: macOS and OS X porting (much work!) +* Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas +* Nat Pryce for starting our unit tests +* Dan Richter for documentation work +* TheCorruptor for his incredible logos and graphics +* Nicholas Dudfield: many test improvements +* Alex Folkner for pygame-ctypes + +Спасибо тем, кто присылает патчи и исправления: Niki Spahiev, Gordon +Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman, +Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier, +James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias +Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, +Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, +Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan, +Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine, +Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske, +Cambell Barton. + +И наши охотники за багами выше всяких похвал: Angus, Guillaume Proux, Frank +Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, +Michael Benfield, David Lau + +Есть еще много людей, которые предоставили полезные идеи, +поддержали этот проект и, по сути, упростили нам жизнь. Спасибо! + +Большое спасибо людям, которые комментируют документацию и добавляют в +`pygame documentation`_ и `pygame-ce documentation`_. + +Также большое спасибо за людей, создающих игры и размещающих их на веб-сайте +pygame.org, чтобы другие могли учиться и получать удовольствие. + +Огромное спасибо James Paige за хостинг pygame bugzilla. + +Также большое спасибо Roger Dingledine и команде SEUL.ORG за наш +отличный хостинг. + + +Зависимости +------------ + +Pygame, очевидно, сильно зависит от SDL и Python. Он также +ссылается на несколько других библиотек меньшего размера и встраивает их. Модуль font +использует SDL_ttf, который зависит от freetype. Модули mixer +(и mixer.music) зависят от SDL_mixer. Модуль image +зависит от SDL_image. Transform.rotozoom имеет встроенную версию +SDL_rotozoom, а gfxdraw имеет встроенную версию SDL_gfx. +Версии зависимостей: + + ++----------+------------------------+ +| CPython | >= 3.8 (Or use PyPy3) | ++----------+------------------------+ +| SDL | >= 2.0.10 | ++----------+------------------------+ +| SDL_mixer| >= 2.0.4 | ++----------+------------------------+ +| SDL_image| >= 2.0.4 | ++----------+------------------------+ +| SDL_ttf | >= 2.0.15 | ++----------+------------------------+ + +Как внести свой вклад +----------------- +Прежде всего, спасибо, что согласились внести свой вклад в pygame-ce! Именно такие люди, как вы, делают pygame-ce отличной библиотекой. Пожалуйста, выполните следующие действия, чтобы начать: + +1. Read the `Contribution Guidelines`_ and the `Many Ways to Contribute`_ wiki pages. +2. Read the documentataion on `Opening A Pull Request`_ and `Opening a Great Pull Request`_. +3. Read how to `label and link reported issues`_. +4. Check the `issue tracker`_ for open issues that interest you or open a new issue to start a discussion about your idea. + +There are many more resources throughout the `wiki pages`_ that can help you get started. + +If you have any questions, please feel free to ask in the `Pygame Community Discord Server`_ or open an issue. + +License +------- +**License Identifier:** LGPL-2.1-or-later + +Эта библиотека распространяется под лицензией `GNU LGPL version 2.1`_, которую можно +найти в файле ``docs/LGPL.txt``. Мы оставляем за собой право размещать +будущие версии этой библиотеки под другой лицензией. + +По сути, это означает, что вы можете использовать pygame в любом проекте, который захотите, +но если вы вносите какие-либо изменения или дополнения в саму pygame, они +должны быть выпущены с совместимой лицензией (preferably submitted +back to the pygame-ce project). Игры с закрытым исходным кодом и коммерческие игры - это нормально. + +Программы в подкаталоге ``examples`` находятся в открытом доступе. + +Смотрите docs/licenses, чтобы узнать лицензии на зависимости. + + +.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 + :target: https://pypi.python.org/pypi/pygame-ce + +.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 + :target: https://pypi.python.org/pypi/pygame-ce + +.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 + +.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.4.1.svg + :target: https://github.com/pygame-community/pygame-ce/compare/2.4.1...main + +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F + :target: https://pyga.me/docs/ + +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg + :target: https://github.com/psf/black + +.. _Pygame: https://pyga.me +.. _pygame-ce documentation: https://pyga.me/docs/ +.. _pygame documentation: https://www.pygame.org/docs/ +.. _Simple DirectMedia Layer library: https://www.libsdl.org +.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling +.. _docs page: https://pyga.me/docs +.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html +.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines +.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute +.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request +.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request +.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues +.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues +.. _Pygame Community Discord Server: https://discord.gg/pygame +.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki + +.. _English: ./../../README.rst +.. _简体中文: README.zh-cn.rst +.. _繁體中文: README.zh-tw.rst +.. _Français: README.fr.rst +.. _فارسی: README.fa.rst +.. _Español: README.es.rst +.. _日本語: README.ja.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.zh-cn.rst b/docs/readmes/README.zh-cn.rst index 7816284e70..6a21668243 100644 --- a/docs/readmes/README.zh-cn.rst +++ b/docs/readmes/README.zh-cn.rst @@ -7,7 +7,8 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ **简体中文** `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ +`English`_ **简体中文** `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ + ---- Pygame_ 是一款自由且开源的跨平台库，用于开发电子游戏等多媒体应用。Pygame基于 `Simple DirectMedia Layer library`_ 以及其他几个广受欢迎的库，汲取其中最常见的函数，让编写游戏成为更加符合直觉的事情。 @@ -161,3 +162,4 @@ pygame显然依赖于SDL和Python。此外pygame还嵌入了几个较小的库 .. _Español: README.es.rst .. _日本語: README.ja.rst .. _Italiano: README.it.rst +.. _Русский: README.ru.rst