|
| 1 | +.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg |
| 2 | + :width: 800 |
| 3 | + :alt: pygame |
| 4 | + :target: https://pyga.me/ |
| 5 | + |
| 6 | + |
| 7 | +|DocsStatus| |
| 8 | +|PyPiVersion| |PyPiLicense| |
| 9 | +|Python3| |GithubCommits| |BlackFormatBadge| |
| 10 | + |
| 11 | +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ **Русский** |
| 12 | +--------------------------------------------------------------------------------------------------- |
| 13 | + |
| 14 | +Pygame_ - бесплатная кроссплатформенная библиотека с открытым исходным кодом |
| 15 | +для разработки мультимедийных приложений, таких как видеоигры, с использованием Python. |
| 16 | +Он использует `Simple DirectMedia Layer library`_ и несколько других популярных библиотек |
| 17 | +для абстрагирования наиболее распространенных функций, |
| 18 | +что делает написание этих программ более интуитивно понятной задачей. |
| 19 | + |
| 20 | + |
| 21 | +Этот дистрибутив называется **'pygame - Community Edition'** (сокращённо 'pygame-ce'). |
| 22 | + |
| 23 | +Это ответвление исходного проекта pygame от его бывших главных разработчиков и было создано после того, как непреодолимые |
| 24 | +трудности помешали им продолжить разработку исходного проекта. |
| 25 | +Новый дистрибутив призван предлагать более частые выпуски, постоянные исправления и усовершенствования, |
| 26 | +а также более демократичную модель управления. |
| 27 | + |
| 28 | +Новые участники приветствуются! |
| 29 | + |
| 30 | + |
| 31 | +Установка |
| 32 | +------------ |
| 33 | + |
| 34 | +:: |
| 35 | + |
| 36 | + pip install pygame-ce |
| 37 | + |
| 38 | + |
| 39 | +Справка |
| 40 | +---- |
| 41 | + |
| 42 | +Если вы только начинаете работать с pygame, вы сможете приступить к работе довольно быстро. |
| 43 | +Pygame поставляется с множеством руководств и введений. |
| 44 | +Также имеется полная справочная документация по всей библиотеке. |
| 45 | +Просмотрите документацию на страниц `docs page`_. |
| 46 | +Вы также можете просмотреть документацию локально, запустив |
| 47 | +``python -m pygame.docs`` в Вашем терминале. Если документы не найдены |
| 48 | +локально, вместо этого будет запущен онлайн-сайт. |
| 49 | + |
| 50 | +Интерактивная документация соответствует версии pygame для разработки на github. |
| 51 | +Она может быть немного новее, чем версия pygame, которую вы используете. |
| 52 | +Чтобы перейти на последнюю выпущенную версию, запустите |
| 53 | +``pip install pygame-ce --upgrade`` в Вашем терминале. |
| 54 | + |
| 55 | +Лучше всего то, что в каталоге examples есть множество воспроизводимых небольших программ, |
| 56 | +которые помогут вам сразу начать работу с кодом. |
| 57 | + |
| 58 | + |
| 59 | +Сборка из исходного кода |
| 60 | +-------------------- |
| 61 | + |
| 62 | +Если вы хотите использовать функции, которые в настоящее время находятся в разработке, |
| 63 | +или вы хотите внести свой вклад в pygame-ce, |
| 64 | +вам нужно будет создать pygame-ce локально из его исходного кода, а не устанавливать его pip. |
| 65 | + |
| 66 | +Установка из исходного кода довольно автоматизирована. |
| 67 | +Основная работа будет включать компиляцию и установку всех зависимостей pygame. |
| 68 | +Как только это будет сделано, запустите сценарий ``setup.py``, |
| 69 | +который попытается автоматически настроить, собрать и установить pygame. |
| 70 | + |
| 71 | +Гораздо больше информации об установке и компиляции доступно |
| 72 | +на `Compilation wiki page`_. |
| 73 | + |
| 74 | + |
| 75 | +Заслуги |
| 76 | +------- |
| 77 | + |
| 78 | +Спасибо всем, кто помог внести свой вклад в эту библиотеку. |
| 79 | +Также уместна особая благодарность. |
| 80 | + |
| 81 | +* Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer |
| 82 | +* Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes |
| 83 | +* Brian Fisher for svn auto builder, bug tracker and many contributions |
| 84 | +* Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer |
| 85 | +* Phil Hassey for his work on the pygame.org website |
| 86 | +* DR0ID for his work on the sprite module |
| 87 | +* Richard Goedeken for his smoothscale function |
| 88 | +* Ulf Ekström for his pixel perfect collision detection code |
| 89 | +* Pete Shinners: original author |
| 90 | +* David Clark for filling the right-hand-man position |
| 91 | +* Ed Boraas and Francis Irving: Debian packages |
| 92 | +* Maxim Sobolev: FreeBSD packaging |
| 93 | +* Bob Ippolito: macOS and OS X porting (much work!) |
| 94 | +* Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas |
| 95 | +* Nat Pryce for starting our unit tests |
| 96 | +* Dan Richter for documentation work |
| 97 | +* TheCorruptor for his incredible logos and graphics |
| 98 | +* Nicholas Dudfield: many test improvements |
| 99 | +* Alex Folkner for pygame-ctypes |
| 100 | + |
| 101 | +Спасибо тем, кто присылает патчи и исправления: Niki Spahiev, Gordon |
| 102 | +Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman, |
| 103 | +Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier, |
| 104 | +James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias |
| 105 | +Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, |
| 106 | +Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, |
| 107 | +Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan, |
| 108 | +Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine, |
| 109 | +Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske, |
| 110 | +Cambell Barton. |
| 111 | + |
| 112 | +И наши охотники за багами выше всяких похвал: Angus, Guillaume Proux, Frank |
| 113 | +Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, |
| 114 | +Michael Benfield, David Lau |
| 115 | + |
| 116 | +Есть еще много людей, которые предоставили полезные идеи, |
| 117 | +поддержали этот проект и, по сути, упростили нам жизнь. Спасибо! |
| 118 | + |
| 119 | +Большое спасибо людям, которые комментируют документацию и добавляют в |
| 120 | +`pygame documentation`_ и `pygame-ce documentation`_. |
| 121 | + |
| 122 | +Также большое спасибо за людей, создающих игры и размещающих их на веб-сайте |
| 123 | +pygame.org, чтобы другие могли учиться и получать удовольствие. |
| 124 | + |
| 125 | +Огромное спасибо James Paige за хостинг pygame bugzilla. |
| 126 | + |
| 127 | +Также большое спасибо Roger Dingledine и команде SEUL.ORG за наш |
| 128 | +отличный хостинг. |
| 129 | + |
| 130 | + |
| 131 | +Зависимости |
| 132 | +------------ |
| 133 | + |
| 134 | +Pygame, очевидно, сильно зависит от SDL и Python. Он также |
| 135 | +ссылается на несколько других библиотек меньшего размера и встраивает их. Модуль font |
| 136 | +использует SDL_ttf, который зависит от freetype. Модули mixer |
| 137 | +(и mixer.music) зависят от SDL_mixer. Модуль image |
| 138 | +зависит от SDL_image. Transform.rotozoom имеет встроенную версию |
| 139 | +SDL_rotozoom, а gfxdraw имеет встроенную версию SDL_gfx. |
| 140 | +Версии зависимостей: |
| 141 | + |
| 142 | + |
| 143 | ++----------+------------------------+ |
| 144 | +| CPython | >= 3.8 (Or use PyPy3) | |
| 145 | ++----------+------------------------+ |
| 146 | +| SDL | >= 2.0.10 | |
| 147 | ++----------+------------------------+ |
| 148 | +| SDL_mixer| >= 2.0.4 | |
| 149 | ++----------+------------------------+ |
| 150 | +| SDL_image| >= 2.0.4 | |
| 151 | ++----------+------------------------+ |
| 152 | +| SDL_ttf | >= 2.0.15 | |
| 153 | ++----------+------------------------+ |
| 154 | + |
| 155 | +Как внести свой вклад |
| 156 | +----------------- |
| 157 | +Прежде всего, спасибо, что согласились внести свой вклад в pygame-ce! Именно такие люди, как вы, делают pygame-ce отличной библиотекой. Пожалуйста, выполните следующие действия, чтобы начать: |
| 158 | + |
| 159 | +1. Read the `Contribution Guidelines`_ and the `Many Ways to Contribute`_ wiki pages. |
| 160 | +2. Read the documentataion on `Opening A Pull Request`_ and `Opening a Great Pull Request`_. |
| 161 | +3. Read how to `label and link reported issues`_. |
| 162 | +4. Check the `issue tracker`_ for open issues that interest you or open a new issue to start a discussion about your idea. |
| 163 | + |
| 164 | +There are many more resources throughout the `wiki pages`_ that can help you get started. |
| 165 | + |
| 166 | +If you have any questions, please feel free to ask in the `Pygame Community Discord Server`_ or open an issue. |
| 167 | + |
| 168 | +License |
| 169 | +------- |
| 170 | +**License Identifier:** LGPL-2.1-or-later |
| 171 | + |
| 172 | +Эта библиотека распространяется под лицензией `GNU LGPL version 2.1`_, которую можно |
| 173 | +найти в файле ``docs/LGPL.txt``. Мы оставляем за собой право размещать |
| 174 | +будущие версии этой библиотеки под другой лицензией. |
| 175 | + |
| 176 | +По сути, это означает, что вы можете использовать pygame в любом проекте, который захотите, |
| 177 | +но если вы вносите какие-либо изменения или дополнения в саму pygame, они |
| 178 | +должны быть выпущены с совместимой лицензией (preferably submitted |
| 179 | +back to the pygame-ce project). Игры с закрытым исходным кодом и коммерческие игры - это нормально. |
| 180 | + |
| 181 | +Программы в подкаталоге ``examples`` находятся в открытом доступе. |
| 182 | + |
| 183 | +Смотрите docs/licenses, чтобы узнать лицензии на зависимости. |
| 184 | + |
| 185 | + |
| 186 | +.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 |
| 187 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 188 | + |
| 189 | +.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 |
| 190 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 191 | + |
| 192 | +.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 |
| 193 | + |
| 194 | +.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.4.1.svg |
| 195 | + :target: https://github.com/pygame-community/pygame-ce/compare/2.4.1...main |
| 196 | + |
| 197 | +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F |
| 198 | + :target: https://pyga.me/docs/ |
| 199 | + |
| 200 | +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| 201 | + :target: https://github.com/psf/black |
| 202 | + |
| 203 | +.. _Pygame: https://pyga.me |
| 204 | +.. _pygame-ce documentation: https://pyga.me/docs/ |
| 205 | +.. _pygame documentation: https://www.pygame.org/docs/ |
| 206 | +.. _Simple DirectMedia Layer library: https://www.libsdl.org |
| 207 | +.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling |
| 208 | +.. _docs page: https://pyga.me/docs |
| 209 | +.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html |
| 210 | +.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines |
| 211 | +.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute |
| 212 | +.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request |
| 213 | +.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request |
| 214 | +.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues |
| 215 | +.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues |
| 216 | +.. _Pygame Community Discord Server: https://discord.gg/pygame |
| 217 | +.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki |
| 218 | + |
| 219 | +.. _English: ./../../README.rst |
| 220 | +.. _简体中文: README.zh-cn.rst |
| 221 | +.. _繁體中文: README.zh-tw.rst |
| 222 | +.. _Français: README.fr.rst |
| 223 | +.. _فارسی: README.fa.rst |
| 224 | +.. _Español: README.es.rst |
| 225 | +.. _日本語: README.ja.rst |
| 226 | +.. _Italiano: README.it.rst |
0 commit comments