diff --git a/README.rst b/README.rst index 62e728e1b8..1d81f331ba 100644 --- a/README.rst +++ b/README.rst @@ -8,7 +8,6 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -**English** `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Pygame_ is a free and open-source cross-platform library @@ -195,15 +194,3 @@ See docs/licenses for licenses of dependencies. .. _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 - -.. _简体中文: ./docs/readmes/README.zh-cn.rst -.. _繁體中文: ./docs/readmes/README.zh-tw.rst -.. _Français: ./docs/readmes/README.fr.rst -.. _فارسی: ./docs/readmes/README.fa.rst -.. _Español: ./docs/readmes/README.es.rst -.. _日本語: ./docs/readmes/README.ja.rst -.. _Italiano: ./docs/readmes/README.it.rst -.. _Русский: ./docs/readmes/README.ru.rst -.. _Ελληνικά: ./docs/readmes/README.gr.rst -.. _Português (Brasil): ./docs/readmes/README.pt-br.rst -.. _Deutsch: ./docs/readmes/README.de.rst diff --git a/docs/readmes/README.de.rst b/docs/readmes/README.de.rst deleted file mode 100644 index 6e3ba4d70c..0000000000 --- a/docs/readmes/README.de.rst +++ /dev/null @@ -1,284 +0,0 @@ -.. 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`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ **Deutsch** -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -Pygame_ ist eine freie und quelloffene, plattformübergreifende Bibliothek -zur Entwicklung von Multimedia-Anwendungen wie Videospielen mit Python. -Sie verwendet die `Simple DirectMedia Layer library`_ sowie mehrere andere -beliebte Bibliotheken, um die gängigsten Funktionen zu abstrahieren und -das Schreiben solcher Programme einfacher und intuitiver zu machen. - -Diese Edition heißt **„pygame – Community Edition“** (kurz „pygame-ce“). - -Sie ist ein Fork (Klon) des ursprünglichen pygame-Projekts durch dessen frühere Kernentwickler -und wurde geschaffen, nachdem unüberwindbare Herausforderungen eine Weiterentwicklung -im Upstream-Projekt bzw. Originalprojekt verhinderten. -Diese Edition verfolgt das Ziel, häufigere Releases, kontinuierliche Fehlerbehebungen -und Verbesserungen sowie ein demokratischeres Governance-Modell anzubieten. - -Neue Mitwirkende sind herzlichst willkommen! - - -Installation ------------- - -Um pygame-ce zu installieren, stellen Sie zunächst sicher, dass Python (und pip) -installiert und über Ihren PATH verfügbar sind. -Führen Sie anschließend folgenden Befehl in Ihrem Terminal oder in der Eingabeaufforderung aus: - -:: - - pip install pygame-ce - -Beachten Sie, dass Sie auf manchen Plattformen wie Linux oder MacOS möglicherweise ``pip3`` anstelle von ``pip`` verwenden müssen. - -Linux-Hinweis: Fehler „Breaking System Packages“ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Auf einigen Linux-Distributionen (wie Ubuntu oder Debian) kann das Installieren -von Python-Paketen mit ``pip`` eine Fehlermeldung wie die folgende auslösen: - -:: - - error: externally-managed-environment - This environment is externally managed when system packages are installed. - -Das bedeutet, dass das Aktuelle Python im PATH vom Betriebssystem verwaltet wird und eine -globale Verwendung von ``pip3`` mit Systempaketen kollidieren könnte. - -Empfohlene Lösungen -^^^^^^^^^^^^^^^^^^^ - -1. Verwendung von ``venv`` (Virtuelle Umgebung): - - Sie können eine virtuelle Umgebung erstellen und pygame-ce darin installieren. - So nutzen Sie weiterhin das System-Python, erstellen aber eine separate Umgebung - für installierte Pakete, sodass diese keine Systempakete beeinträchtigen. - - .. code-block:: bash - - python3 -m venv venv # erstellt eine venv mit dem Namen „venv“ - source venv/bin/activate # aktiviert die venv - pip install pygame-ce # installiert Pakete in der venv - -2. Verwendung von ``pyenv`` (Python-Verwaltung auf Benutzerebene): - - `pyenv `_ ermöglicht es Ihnen, eigene Python-Versionen - zu installieren und zu verwalten, ohne das System-Python anzutasten. - Zusätzlich können mehrere Python-Versionen parallel genutzt werden. - -3. Verwendung von ``uv`` (schneller moderner Paketinstaller): - - `uv `_ ist ein moderner, schneller Paket- und Umgebungsmanager - für Python und kann als Ersatz für ``venv`` und ``pyenv`` dienen. - -Hilfe ------ - -Wenn Sie gerade erst mit pygame beginnen, sollten Sie relativ schnell einsteigen können. -Pygame bringt viele Tutorials und Einführungen mit. Außerdem gibt es eine vollständige -Referenzdokumentation für die gesamte Bibliothek. -Durchsuchen Sie die Dokumentation auf der `Docs-Seite`_. -Sie können die Dokumentation auch lokal aufrufen, indem Sie im Terminal -``python -m pygame.docs`` ausführen. Wenn die Dokumentation lokal nicht gefunden wird, -öffnet sich stattdessen die Online-Webseite. - -Die Online-Dokumentation wird stets mit der Entwicklungsversion von pygame auf GitHub -aktualisiert und kann daher etwas aktueller sein als die von Ihnen verwendete Pygame-Version. -Um auf die neueste stabile Version zu upgraden, führen Sie -``pip install pygame-ce --upgrade`` im Terminal aus. - -Besonders hilfreich ist auch das ``examples``-Verzeichnis, das viele spielbare -kleine Beispiels-Programme enthält, mit denen Sie sofort mit dem Code experimentieren können. - - -Kompilieren aus dem Quellcode ----------------------------- - -Wenn Sie Funktionen nutzen möchten, die sich aktuell in Entwicklung befinden, -oder wenn Sie zu pygame-ce beitragen möchten, müssen Sie pygame-ce lokal aus dem -Quellcode bauen, anstatt es per pip zu installieren. - -Die Installation aus dem Quellcode ist weitgehend automatisiert. -Der größte Aufwand besteht im Kompilieren und Installieren aller pygame-Abhängigkeiten. -Sobald dies erledigt ist, führen Sie das Skript ``setup.py`` aus, das versucht, -pygame automatisch zu konfigurieren, zu bauen und zu installieren. - -Weitere Informationen zum Installieren und Kompilieren finden Sie auf der -`Compilation wiki page`_. - - -Danksagungen ------------- - -Vielen Dank an alle, die zur Entwicklung dieser Bibliothek beigetragen haben. -Ein besonderer Dank gilt: - -* Marcus Von Appen: zahlreiche Änderungen und Fehlerbehebungen, FreeBSD-Maintainer ab 1.7.1+ -* Lenard Lindstrom: Windows-Maintainer ab 1.8+, viele Änderungen und Fixes -* Brian Fisher für den SVN-Autobuilder, Bugtracker und viele Beiträge -* Rene Dudfield: zahlreiche Änderungen und Fixes, Release-Manager/Maintainer ab 1.7+ -* Phil Hassey für seine Arbeit an der pygame.org-Webseite -* DR0ID für seine Arbeit am Sprite-Modul -* Richard Goedeken für die smoothscale-Funktion -* Ulf Ekström für den pixelgenauen Kollisionscode -* Pete Shinners: ursprünglicher Autor -* David Clark für die Rolle als „rechte Hand“ -* Ed Boraas und Francis Irving: Debian-Pakete -* Maxim Sobolev: FreeBSD-Paketierung -* Bob Ippolito: macOS- und OS-X-Portierung (sehr viel Arbeit!) -* Jan Ekhol, Ray Kelm und Peter Nicolai: Geduld mit frühen Designideen -* Nat Pryce für den Start der Unit-Tests -* Dan Richter für Dokumentationsarbeit -* TheCorruptor für die beeindruckenden Logos und Grafiken -* Nicholas Dudfield: zahlreiche Testverbesserungen -* Alex Folkner für pygame-ctypes - -Dank auch an alle, die Patches und Fixes eingesendet haben: 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. - -Und ein besonderer Dank an unsere außergewöhnlichen Bugfinder: Angus, -Guillaume Proux, Frank Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, -Mike Mulcheck, Michael Benfield, David Lau. - -Es gibt noch viele weitere Personen, die hilfreiche Ideen eingebracht, -das Projekt am Laufen gehalten und uns die Arbeit erleichtert haben. -Vielen Dank! - -Vielen Dank auch an alle, die Dokumentationskommentare geschrieben und zur -`pygame documentation`_ sowie zur `pygame-ce documentation`_ beigetragen haben. - -Ebenso vielen Dank an alle, die Spiele erstellt und auf der pygame.org-Webseite -veröffentlicht haben, damit andere daraus lernen und Freude daran haben können. - -Großer Dank an James Paige für das Hosting von Bugzilla. - -Ein weiterer großer Dank geht an Roger Dingledine und das Team von SEUL.ORG -für das hervorragende Hosting. - - -Abhängigkeiten --------------- - -Pygame ist selbstverständlich stark von SDL und Python abhängig. -Zusätzlich bindet es mehrere kleinere Bibliotheken ein. -Das Font-Modul basiert auf SDL_ttf, welches von freetype abhängt. -Die Module mixer (und mixer.music) hängen von SDL_mixer ab. -Das Image-Modul verwendet SDL_image. -Transform.rotozoom enthält eine eingebettete Version von SDL_rotozoom, -und gfxdraw eine eingebettete Version von SDL_gfx. -Abhängigkeitsversionen: - -+-----------+--------------------------+ -| CPython | >= 3.10 (oder PyPy3) | -+-----------+--------------------------+ -| SDL | >= 2.0.14 | -+-----------+--------------------------+ -| SDL_mixer | >= 2.0.4 | -+-----------+--------------------------+ -| SDL_image | >= 2.0.4 | -+-----------+--------------------------+ -| SDL_ttf | >= 2.0.15 | -+-----------+--------------------------+ - - -Mitwirken ---------- - -Zunächst einmal vielen Dank für Ihr Interesse daran, pygame-ce mitzugestalten! -Menschen wie Sie machen pygame-ce zu einem großartigen Projekt. -Bitte folgen Sie diesen Schritten für den Einstieg: - -1. Lesen Sie die `Contribution Guidelines`_ und die Wiki-Seite `Many Ways to Contribute`_. -2. Lesen Sie die Dokumentation zu `Opening A Pull Request`_ und `Opening a Great Pull Request`_. -3. Informieren Sie sich darüber, wie gemeldete Issues `label and link reported issues`_ korrekt werden. -4. Prüfen Sie den `issue tracker`_ auf offene Issues, die Sie interessieren, oder eröffnen Sie ein neues Issue, um eine Diskussion zu starten. - -Weitere hilfreiche Ressourcen finden Sie auf den verschiedenen `wiki pages`_. - -Bei Fragen können Sie sich gerne im `Pygame Community Discord Server`_ melden -oder ein Issue öffnen. - - -Lizenz ------- - -**Lizenzkennung:** LGPL-2.1-or-later - -Diese Bibliothek wird unter der `GNU LGPL version 2.1`_ veröffentlicht, -die in der Datei ``docs/LGPL.txt`` zu finden ist. -Wir behalten uns das Recht vor, zukünftige Versionen dieser Bibliothek -unter einer anderen Lizenz zu veröffentlichen. - -Das bedeutet im Wesentlichen, dass Sie pygame in jedem beliebigen Projekt -verwenden dürfen. Wenn Sie jedoch Änderungen oder Erweiterungen an pygame selbst -vornehmen, müssen diese unter einer kompatiblen Lizenz veröffentlicht werden -(vorzugsweise zurück an das pygame-ce-Projekt). -Closed-Source- und kommerzielle Spiele sind erlaubt. - -Die Programme im Unterverzeichnis ``examples`` sind gemeinfrei (Public Domain). - -Siehe docs/licenses für die Lizenzen der Abhängigkeiten. - - -.. |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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 - -.. _简体中文: 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 -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _English: ./../../README.rst diff --git a/docs/readmes/README.es.rst b/docs/readmes/README.es.rst deleted file mode 100644 index 9bba59a7ce..0000000000 --- a/docs/readmes/README.es.rst +++ /dev/null @@ -1,178 +0,0 @@ -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| - -`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ **Español** `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ - ---------------------------------------------------------------------------------------------------------------------------------------------------- - -`Pygame`_ es una biblioteca multiplataforma, gratuita y de código abierto -permitiéndole desarrollar aplicaciones multimedia como videojuegos, con Python. -Utiliza la biblioteca « `Simple DirectMedia Layer`_ » (SDL) y varias otras bibliotecas -popular para abstraer las funciones más comunes y hace la escritura de programas -lo más intuitivo posible. - -Esta distribución se llama **« pygame - Community Edition »** (abreviado « pygame-ce »). - - -Esta es una bifurcación del proyecto original de sus principales desarrolladores anteriores. Fue creado como resultado de muchos obstáculos que eran imposibles de superar, impidiéndoles continuar el desarrollo del proyecto inicial. Esta nueva distribución tiene como objetivo ofrecer actualizaciones más regular, mejoras y correcciones, pero también un modelo de gobernanza más democrático. - -¡Cualquier nuevo colaborador es bienvenido! - -Instalacion ------------ - -:: - - pip install pygame-ce - - -Ayuda ------ - -Si recién estás comenzando con pygame, deberías poder comenzar con él bastante rápidamente. Pygame viene con una gran cantidad de tutoriales e introducciones. Tienes también una documentación muy bien referenciada sobre toda la biblioteca. Navegas por el -documentación en `docs page`_. También puedes echarle un vistazo localmente por ejecución del comando ``python -m pygame.docs`` en tu terminal. Si la documentación -no se encuentra localmente, esto lanzará el sitio web. - - -La documentación en línea permanece actualizada con la versión actual de pygame-ce -desarrollo en GitHub. Esto puede ser un poco más nuevo que la versión de pygame-ce que usas. Para actualizar a la última versión publicada, ejecuta ``pip install pygame-ce --upgrade`` en tu terminal. - -Un punto particularmente interesante: tienes a tu disposición un archivo de ejemplos que contienen muchos pequeños programas jugables, lo que le permite -para empezar a jugar con el código de inmediato. - -Construir a partir del código fuente ------------------------------------- - -Si deseas utilizar características en desarrollo, o quieres contribuir a pygame-ce, vas a necesitar construir pygame-ce localmente a partir del código fuente, en lugar de instalarlo con pip. - -La instalación de pygame-ce desde el código fuente está bastante automatizada. La mayor parte del trabajo consistirá en compilar e instalar todas las dependencias de -pygame-ce. Una vez hecho esto, ejecute el script ``setup.py`` que intentará autoconfigurar, compilar e instalación. - -Más información sobre la instalación y compilación está disponible en `La pagina wiki de compilando`_. - -Créditos --------- - -Muchas gracias a todos los que han contribuido y siguen contribuyendo a este módulo. -Un agradecimiento especial también está en orden. - -* 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 - -Gracias a los que propusieron correcciones: 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. - -Y a nuestros cazadores de bugs: Angus, Guillaume Proux, Frank -Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, -Michael Benfield, David Lau - -Hay muchas más personas por ahí que han presentado ideas útiles, han mantenido este proyecto en marcha y, básicamente, nos han hecho la vida más fácil. ¡Gracias! - -Muchas gracias por las personas que hacen comentarios de documentación y agregan a `documentacion de pygame-ce`_. - -Muchas gracias a James Paige en particular por ser anfitrión -pygame bugzilla. - -También un gran agradecimiento a Roger Dingledine y la tripulación de SEUL.ORG por nuestro excelente alojamiento. - -Dépendances ------------- - -**note:** This section translation is out of date (September 2023) - -Pygame obviamente depende en gran medida de SDL y Python. También enlaza e incorpora varias otras bibliotecas más pequeñas. El módulo de fuentes se basa en SDL_ttf, que depende de freetype. Los módulos mixer (y mixer.music) dependen de SDL_mixer. El módulo de imagen depende de SDL_image, que también puede usar libjpeg y libpng. El módulo de transformación tiene una versión integrada de SDL_rotozoom para su propia función rotozoom. -El módulo surfarray necesita el paquete python numpy, para sus matrices numéricas multidimensionales. - -Versiones de dependencia: - -+----------+-----------------------------+ -| CPython | >= 3.10 (Ou utiliser PyPy3) | -+----------+-----------------------------+ -| SDL | >= 2.0.14 | -+----------+-----------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+-----------------------------+ -| SDL_image| >= 2.0.4 | -+----------+-----------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+-----------------------------+ - -Licencia --------- -**Identificador de licencia:** LGPL-2.1-or-later - -La biblioteca se distribuye bajo la licencia `GNU LGPL version 2.1`_, que se puede encontrar en el archivo ``docs/LGPL.txt``. Nos reservamos el derecho de licenciar versiones futuras de esta biblioteca bajo una licencia diferente. - -Esto significa que tienes derecho a usar pygame-ce en cualquier proyecto que desee, pero solo si deseas realizar cambios o adiciones a Pygame-ce en sí, entonces estarás obligado publicarlos con una licencia compatible (preferiblemente enviándolos al proyecto pygame-ce). Se permiten códigos propietarios y juegos comerciales. - -Los programas que se encuentran en el subdirectorio ``examples`` pertenecen a el dominio público. - -Consulta docs/licenses para ver las licencias de dependencia. - - -.. |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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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://www.pyga.me/ -.. _documentacion de pygame-ce: https://pyga.me/docs/ -.. _Simple DirectMedia Layer: https://www.libsdl.org -.. _La pagina wiki de compilando: 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 - -.. _简体中文: README.zh-cn.rst -.. _繁體中文: README.zh-tw.rst -.. _English: ./../../README.rst -.. _فارسی: README.fa.rst -.. _Français: README.fr.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.fa.rst b/docs/readmes/README.fa.rst deleted file mode 100644 index 3103dd4984..0000000000 --- a/docs/readmes/README.fa.rst +++ /dev/null @@ -1,264 +0,0 @@ -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| - -`English`_ `简体中文`_ `繁體中文`_ `Français`_ **فارسی** `Español`_ `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ - ---------------------------------------------------------------------------------------------------- -کتابخانه -Pygame_ -برای توسعه دادن برنامه های چند رسانه ای -مانند بازی های رایانه ای, به کار می رود. - -کتابخانه -pygame به عنوان زیرساخت های اصلی خود از کتابخانه -`Simple DirectMedia Layer library`_ -استفاده می کند. - - -همچنین از کتابخانه های پرطرفدار و متعدد زیادی برای دسترسی -به پرکاربرد ترین الگوریتم ها استفاده می کند, -که در نتیجه این مسئله, فرایند تولید و توسعه برنامه -با استفاده از کتابخانه pygame خلاقانه تر و آسان تر می شود. - - -این توزیع با نام -**'pygame - Community Edition'** ('pygame-ce' برای اختصار) -شناخته می شود. - -این توزیع یک فورک از نسخه آپ استریم (نسخه اصلی) کتابخانه pygame می باشد -که توسط مشارکت کنندگان (contributor) های سابق نسخه -آپ استریم در حال توسعه و نگهداری هست, -و بعد از رخ دادن چالش هایی حل نشدنی که همکاری در نسخه اصلی کتابخانه -را غیر ممکن می کرد, برای اولین بار ساخته شد. - -این توزیع به عنوان اهداف خود, انتشار های سریع تر و بیشتر نسخه های پروژه, رفع ادامه دار باگ ها و بهینه سازی پروژه, -و کنترل کردن فرایند توسعه پروژه به صورت دموکراتیک -را مد نظر خود دارد. - -ما به مشارکت کننده (contributor) هایی که علاقه مند به همکاری با -ما هستند خوش آمد میگوییم و از آنها به گرمی استقبال می کنیم!. - - - -روش نصب ------------- - -:: - - pip install pygame-ce - - -Help (کمک و راهنمایی) ----- -اگر به تازگی قصد یادگیری کتابخانه pygame را دارید, می توانید به سادگی -این فرایند را آغاز کنید. -آموزش ها و معرفی های زیادی از کتابخانه pygame در اینترنت موجود هست. -همچنین اسناد ارجاعی کاملی برای این کتابخانه تهیه و تدوین شده است. -می توانید با استفاده از این لینک -`docs page`_ -به اسناد ارجاعی دسترسی داشته باشید. - -همچنین اگر کتابخانه pygame را نصب کرده اید می توانید با وارد کردن دستور - -``python -m pygame.docs`` - -در فضای ترمینال یا کامند لاین سیستم عامل خود, به اسناد ارجاعی دسترسی داشته باشید. - - -اسناد ارجاعی کتابخانه پس از هر بروزرسانی نسخه توسعه داده شده در مخزن -pygame_ce_ -آپدیت می شوند. - -محتوای این اسناد ممکن است از نسخه ای از pygame که شما استفاده می کنید کمی جدید تر باشد. -برای آپگرید کردن pygame خود به آخرین ورژن, دستور زیر را در فضای کامند لاین اجرا کنید. - -``pip install pygame-ce --upgrade`` - -همچنین پوشه ی examples شامل تعداد زیادی از برنامه ها قابل اجرا هست که -می توانید به سادگی با تغییر دادن آنها با قابلیت های کتابخانه آشنا بشوید. - -Building From Source (ساخت و اجرا با استفاده از سرس کد) --------------------- - -اگر می خواهید از قابلیت هایی که در حال توسعه هستند و هنوز به آخرین نسخه پروژه اضافه -نشده اند استفاده کنید, یا می خواهید در توسعه و نگه داری این پروژه مشارکت داشته باشید, -به جای نصب کردن کتابخانه روی سیستم عامل خود با استفاده از pip, -شما باید کتابخانه pygame را روی سیستم خود به صورت local بسازید (build بگیرید). - -نصب کردن کتابخانه با استفاده از سرس کد تا حد زیادی اتوماتیک شد است. -اکثر کار هایی که در این فرایند انجام می شوند شامل کامپایل کردن و نصب کردن -تمام وابستگی (dependency) های پاگیم می باشد. -زمانی که این فرایند به پایان رسیده است, اسکریپت -``setup.py`` -را اجرا کنید که تلاش میکند کتابخانه pygame را روی دستگاه شما پیکربندی (configure) و نصب کند. - -برای کسب اطلاعات بیشتر در رابطه با فرایند نصب کردن و کامپایل کردن, می توانید به صفحه -`Compilation wiki page`_ -مراجعه کنید. - - -Credits -------- - -ما از تمام افرادی که در توسعه و نگه داری این پروژه اپن سرس -با ما همکاری کرده اند سپاس گذاری می کنیم. - -همچنین قصد داریم تشکر ویژه ی خود را از افراد زیر اعلام کنیم. - - -* 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 - - -از افراد زیر بابت ارسال patch ها و تصحیح اشکالات پروژه تشکر می کنیم: -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.org به ما کمک کرده اند متشکریم. - -از تمام افرادی که با ساخت بازی های و متعدد و ارسال کردن آنها -در سایت pygame.org به دیگر کاربران جهت یادگیری و لذت بردن از آنها -کمک کرده اند نیز تشکر ویژه ای داریم. - -تشکر های بسیاری نیز به Jame Paige بابت میزبانی کردن سرویس pygame در bugzilla بدهکاریم. - - -همچنین از Roger Dingledine و تیم SEUL.ORG بابت -میزبانی فوق العاده ای که بابت سایت pygame.org ارائه داده اند سپاس گذاری می کنیم. - -Dependencies (وابستگی ها) ------------- - -**note:** This section translation is out of date (September 2023) - -کتابخانه Pygame به وضوح به کتابخانه SDL و زبان Python وابسته است. -همچنین به چندین کتابخانه کوچکتر دیگر نیز لینک می‌شود و از آنها استفاده می‌کند. -ماژول فونت به کتابخانه SDL_ttf تکیه می کند که خود نیز به freetype وابسته است. -ماژول mixer و mixer.music هم به کتابخانه SDL_mixer وابستگی دارند. - -ماژول image به SDL_image که می تواند به libjpeg و libpng وابستگی داشته باشد تکیه می کند. -ماژول transform نیز از نسخه ای جاسازی شده از SDL_rotozoom برای فانکش rotozoom خود استفاده می کند. - -ماژول surfarray نیز از پکیج NumPy در زبان پایتون, برای پردازش آرایه های چندبعدی عددی خود -استفاده می کند. - - - -در لیست زیر می توانید نسخه های دقیق هر یک از وابستگی های مورد نیاز را -مشاهده کنید. - -+----------+------------------------+ -| CPython | >= 3.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - - - -License -------- -LGPL-2.1-or-later **شناسه مجوز:** - -این کتابخانه با استفاده از -`GNU LGPL version 2.1`_ -لایسنس شده است که در فایل -``docs/LDGP.txt`` -قابل دسترس هست. -ما حق تغییر دادن این لایسنس را در نسخه های آینده این کتابخانه رزرو می کنیم. - -این مسئله در اختصار به این معنی است که شما می توانید از کتابخانه pygame در -تمام پروژه های خود استفاده کنید. اما اگر تغییری در سرس کد pygame ایجاد کنید, -آن تغییرات باید با لایسنسی که با لایسنس pygame سازگار است منتشر شوند. (ترجیحا -ارجاع داده شده به pygame). -انتشار بازی هایی که متن بسته و بازی هایی که منجر به درآمد زایی می شوند مجاز است. - -تمام برنامه های داخل پوشه -``examples`` -شامل اموال عمومی‌ (public domain) می شوند. - -برای اطلاعات بیشتر در مورد لایسنس هر وابستگی (dependency), -فایل 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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 -.. _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 -.. _pygame_ce: https://github.com/pygame-community/pygame-ce - -.. _English: ./../../README.rst -.. _简体中文: README.zh-cn.rst -.. _繁體中文: README.zh-tw.rst -.. _Français: README.fr.rst -.. _Español: README.es.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.fr.rst b/docs/readmes/README.fr.rst deleted file mode 100644 index 7adb883fdf..0000000000 --- a/docs/readmes/README.fr.rst +++ /dev/null @@ -1,218 +0,0 @@ -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| - -`English`_ `简体中文`_ `繁體中文`_ **Français** `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ - ---------------------------------------------------------------------------------------------------------------------------------------------------- - -`Pygame`_ est une bibliothèque multi-plateforme, libre et open-source -permettant de développer des applications multimédias, comme des jeux-vidéos avec Python. -Il utilise la bibliothèque « `Simple DirectMedia Layer`_ » (SDL) et plusieurs autres bibliothèques -populaires pour abstraire les fonctions les plus courantes et rendre l’écriture de programmes -la plus intuitive possible. - -Cette distribution se nomme **« pygame - Community Edition »** (abrégé « pygame-ce »). - -Ceci est un fork du projet initial créé par ses principaux anciens développeurs, -il a été créé suite à de nombreux obstacles impossibles à franchir, les empêchant de continuer -le développement du projet initial. Cette nouvelle distribution a pour but d’offrir des mises à jour -plus régulières, des améliorations et des correctifs, mais aussi un modèle de gouvernance plus -démocratique. - -Tout nouveau contributeur est le/la bienvenu(e) ! - -Installation ------------- - -:: - - pip install pygame-ce - - -Aide ----- - -Si vous venez de commencer avec pygame, vous devriez être capable de vous y lancer assez -rapidement. Pygame vient avec un grand nombre de tutoriels et d'introductions. Vous avez -aussi une documentation très bien référencée sur toute la bibliothèque. Naviguez dans la -documentation sur la `docs page`_. Vous pouvez aussi y jeter un coup d'œil localement en -exécutant la commande ``python -m pygame.docs`` dans votre terminal. Si la documentation -n’est pas trouvée localement, cela va lancer le site web. - -La documentation en ligne reste à jour avec la version de pygame-ce en cours de -développement sur GitHub. Cela peut être un peu plus récent que la version de -pygame-ce que vous utilisez. Pour passer à la version sortie la plus récente, lancez -``pip install pygame-ce --upgrade`` dans votre terminal. - -Un point particulièrement intéressant : vous avez à votre disposition un dossier -d’exemples contenant de nombreux petits programmes jouables, vous permettant -de commencer à jouer avec le code tout de suite. - -Build depuis le code source --------------------- - -Si vous voulez utiliser des fonctionnalités en cours de développement, -ou que vous voulez contribuer à pygame-ce, vous allez avoir besoin de -compiler pygame-ce localement grâce à son code source, plutôt que de l’installer avec -pip. - -Installer pygame-ce depuis le code source est assez automatisé. La majeure -partie du travail sera de compiler et d’installer toutes les dépendances de -pygame. Une fois ceci fait, lancez le script ``setup.py`` qui va essayer -de l’auto-configurer, le build, et l’installer. - -Plus d’informations à propos de l’installation et de la compilation sont disponibles -sur `Compilation wiki page`_. - -Crédits -------- - -Un très grand merci à toutes celles et ceux qui ont contribué et qui contribuent -toujours à ce module. -Des remerciements particuliers s'imposent également. - -* 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 - -Merci à celles et ceux qui ont proposé des correctifs : 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. - -Et à nos chasseurs de bugs : Angus, Guillaume Proux, Frank -Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, -Michael Benfield, David Lau - -Il y a aussi pas mal de personnes présentes qui soumettent des idées utiles et intéressantes, -qui ont permis à ce projet de continuer à vivre, et qui ont pratiquement rendu notre -travail facile. Merci ! - -Très grands remerciements à toutes les personnes commentant la documentation, -et ajoutant du nouveau contenu dans la `documentation de pygame`_ et dans la `documentation de pygame-ce`_. - -Aussi de très grands remerciements à toutes les personnes créant des jeux et les -partageant sur le site pygame.org pour permettre aux autres d'apprendre et de -s’amuser. - -Très grands remerciements à James Paige en particulier pour avoir hébergé -pygame bugzilla. - -Enfin nos meilleurs remerciements à Roger Dingledine et à toute l'équipe -de SEUL.ORG pour notre excellent hébergement. - -Dépendances ------------- - -**note:** This section translation is out of date (September 2023) - -Pygame est évidemment très dépendant de SDL et Python. Il a aussi -des liens, mais de même intègre plusieurs autres petites bibliothèques. -Le module font s’appuie sur SDL_ttf, qui est lui-même dépendant de freetype. -Le module mixer (et mixer.music) dépend de SDL_mixer. Le module image -dépend de SDL_image, qui dépend de libjpeg et libpng. Le module transform -a une version intégrée de SDL_rotozoom pour ses propres fonctions de rotozoom. -Le module surfarray a besoin du package python, numpy, pour ses tableaux numériques -multidimensionnels. - -Versions des dépendances: - -+----------+-----------------------------+ -| CPython | >= 3.10 (Ou utiliser PyPy3) | -+----------+-----------------------------+ -| SDL | >= 2.0.14 | -+----------+-----------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+-----------------------------+ -| SDL_image| >= 2.0.4 | -+----------+-----------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+-----------------------------+ - -Licence -------- -**Identifiant de licence:** LGPL-2.1-or-later - -La bibliothèque est distribuée sous la licence `GNU LGPL version 2.1`_, qui -peut être retrouvée dans le fichier ``docs/LGPL.txt``. Nous nous réservons -le droit de placer les futures versions de cette bibliothèque sous une licence -différente. - -Ceci veut en quelque sorte dire que vous êtes en droit d'utiliser pygame-ce -dans n’importe quel projet que souhaitez, mais que si vous voulez effectuer des -changements ou des ajouts à pygame lui-même, alors vous serez dans l’obligation -de les publier avec une licence compatible (de préférence en les soumettant au projet -pygame-ce). Les codes propriétaires et les jeux commerciaux sont autorisés. - -Les programmes présents dans le sous-répertoire ``examples`` appartiennent -au domaine public. - -Voir les docs/licences pour les licences des dépendances. - -**Last reviewed** : 05 October 2024 - **Dernière vérification** : 05 Octobre 2024 - - -.. |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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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://www.pyga.me/ -.. _documentation de pygame: https://www.pygame.org/docs/ -.. _documentation de pygame-ce: https://pyga.me/docs/ -.. _Simple DirectMedia Layer: 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 - -.. _简体中文: README.zh-cn.rst -.. _繁體中文: README.zh-tw.rst -.. _English: ./../../README.rst -.. _فارسی: README.fa.rst -.. _Español: README.es.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.gr.rst b/docs/readmes/README.gr.rst deleted file mode 100644 index fd912601fe..0000000000 --- a/docs/readmes/README.gr.rst +++ /dev/null @@ -1,268 +0,0 @@ -.. 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`_ `Русский`_ **Ελληνικά** `Português (Brasil)`_ `Deutsch`_ -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -To Pygame_ είναι μια ελεύθερη και ανοικτού κώδικα βιβλιοθήκη πολλαπλών πλατφορμών. -Χρησιμοποιεί το `Simple DirectMedia Layer library`_ και πολλές άλλες -δημοφιλείς βιβλιοθήκες για να χρησιμοποιήσει αφαιρετικά τις περισσότερες βασικές συναρτήσεις, -κάνοντας έτσι τη γραφή αυτών των προγραμμάτων μια πιο διαισθητική εργασία. - -Αυτή η διανομή(distribution) ονομάζεται **'pygame - Community Edition'** ('pygame-ce' για συντομία). - -Είναι μια διακλάδωση(fork) από το αποθετήριο προέλευσης(upstream) του project pygame από τους πρώην κεντρικούς προγραμματιστές, -και δημιουργήθηκε μετά από απίθανες προκλήσεις που τους απέτρεψαν να συνεχίσουν την ανάπτυξη στο αποθετήριο προέλευσης(upstream). -Η νέα διανομή(distribution) στοχεύει στο να προσφέρει πιο συνεχή εκδόσεις, πολλαπλές διορθώσεις σφαλμάτων και βελτιώσεις, -και ένα πιο δημοκρατικό μοντέλο διακυβέρνησης. - -Νέοι συνεισφέροντες είναι ευπρόσδεκτοι! - - -Εγκατάσταση ------------- - -Για να εγκαταστήσετε το pygame-ce, πρώτα βεβαιωθείτε ότι έχετε την Python (και pip) εγκατεστημένη και διαθέσιμη στο PATH σας. -Έπειτα, τρέξτε την παρακάτω εντολή στο τερματικό ή στην γραμμή εντολών σας: - -:: - - pip install pygame-ce - -Σημείωση ότι σε κάποιες πλατφόρμες ίσως χρειαστεί να χρησιμοποιήσετε ``pip3`` αντί για ``pip``. - -Linux Σημείωση: "Breaking System Packages" Error -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Σε κάποιες διανομές Linux (όπως Ubuntu ή Debian), η εγκατάσταση Python πακέτων με pip μπορεί να εμφανίσει ένα μήνυμα όπως το παρακάτω. - -:: - - error: externally-managed-environment - This environment is externally managed when system packages are installed. - -Αυτό σημαίνει ότι η Python του συστήματός σας διαχειρίζεται από το λειτουργικό σύστημα, και η χρήση του pip3 σε καθολικό(globally) επίπεδο μπορεί να προκαλέσει συγκρούσεις με τα πακέτα του συστήματος. - -Προτεινόμενες Λύσεις -^^^^^^^^^^^^^^^^^^^^^ - -1. Χρησιμοποιήστε ``venv`` (Εικονικό Περιβάλλον): - - Μπορείτε να δημιουργήσετε ένα εικονικό περιβάλλον και να εγκαταστήσετε μέσα σε αυτό το pygame-ce. - Με αυτόν τον τρόπο συνεχίζετε να χρησιμοποιείτε την Python του συστήματος, αλλά δημιουργείτε ένα ξεχωριστό περιβάλλον για την εγκατάσταση των πακέτων, ώστε να μην υπάρχουν συγκρούσεις ή προβλήματα στο σύστημα. - - .. code-block:: bash - - python3 -m venv venv # δημιουργία εικονικού περιβάλλοντος με όνομα 'venv' - source venv/bin/activate # ενεργοποίηση του εικονικού περιβάλλοντος - pip install pygame-ce # εγκατάσταση πακέτων μέσα στο venv - -2. Χρησιμοποιήστε ``pyenv`` (Διαχείριση της Python σε επίπεδο χρήστη): - - Το `pyenv `_ σας επιτρέπει να εγκαταστήσετε και να διαχειρίζεστε τις δικές σας εκδόσεις της Python σε επίπεδο χρήστη, χωρίς να επηρεάζετε την έκδοση του συστήματος. - Επιπλέον, μπορείτε να εγκαταστήσετε και να χρησιμοποιήσετε πολλαπλές εκδόσεις της Python ταυτόχρονα. - - -3. Χρησιμοποιήστε ``uv`` (Γρήγορος Μοντέρνος Διαχειριστής Πακέτων): - - Το `uv `_ είναι ένα μοντέρνο, γρήγορο Python πακέτο και διαχειριστής περιβάλλοντος, που μπορεί να λειτουργήσει ως αντικατάσταση τόσο του ``venv`` όσο και του ``pyenv``. - -Βοήθεια ----- - -Αν μόλις ξεκινάτε με το pygame, θα πρέπει να -ξεκινήσετε σχετικά εύκολα. Το pygame έρχεται με αρκετά βοηθητικά υλικά -και εισαγωγές. Επίσης υπάρχουν αρκετές αναφορές στις τεκμηριώσεις -όλης της βιβλιοθήκης. Ξεφυλλίστε τις τεκμηριώσεις στο `docs page`_. Επιπλέον -μπορείτε να ξεφυλλίσετε τις τεκμηριώσεις τοπικά εκτελώντας -``python -m pygame.docs`` στο τερματικό σας. Αν οι τεκμηριώσεις δεν βρεθούν -τοπικά, θα ανοίξει την διαδικτυακή ιστοσελίδα. - -Η διαδικτυακή τεκμηρίωση παραμένει ενημερωμένη με την έκδοση ανάπτυξης -του pygame στο github. Ίσως είναι λίγο νεότερη από την έκδοση του pygame -που χρησιμοποιείς. Για να αναβαθμίσεις στην τελευταία έκδοση, εκτελέστε -``pip install pygame-ce --upgrade`` στο τερματικό σας. - -Το καλύτερο από όλα, ο κατάλογος με τα παραδείγματα έχει αρκετά εκτελέσιμα μικρά προγράμματα. -όπου μπορούν να σε κάνουν να αρχίσεις να ασχολείσαι κατευθείαν με τον κώδικα. - - -Μεταγλώττιση από τον πηγαίο κώδικα --------------------- - -Αν θέλεις να χρησιμοποιείς χαρακτηριστικά τα οποία είναι σε ανάπτυξη -ή θέλεις να συνεισφέρεις στο pygame-ce, θα πρέπει να μεταγλωττίσεις το pygame-ce -τοπικά από τον πηγαίο κώδικα, αντί για την εγκατάσταση μέσω pip. - -Η εγκατάσταση απο τον πηγαίο κώδικα είναι κυρίως αυτοματοποίημένη. Η περισσότερη δουλέια θα -εμπλέκει μεταγλώττιση και εγκατάσταση των εξαρτήσεων του pygame. Μόλις -ολοκληρωθεί, τρέξτε το setup.py script που θα προσπαθήσει να -προσαρμοστή αυτόματα, μεταγλωττίσει και εγκαταστήσει το 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 - -Είναι αρκετοί άλλοι που έχουν υποβάλει βοηθητικές ιδέες, κρατώντας -το project να συνεχίσει, και βασικά έχουν κάνει τη ζωή μας πιο εύκολη. Ευχαριστούμε! - -Πολλές ευχαριστίες σε όσους κάνουν σχόλια στην τεκμηρίωση και προσθέτουν στο -`pygame documentation`_ και στο `pygame-ce documentation`_. - -Επίσης πολλές ευχαριστίες σε όσους δημιουργούν παιχνίδια και τα ανεβάζουν στην -pygame.org ιστοσελίδα ώστε άλλοι να μάθουν και να τα απολαύσουν. - -Πολλές ευχαριστίες στον James Paige για τη φιλοξενία του pygame bugzilla. - -Επίσης ένα μεγάλο ευχαριστώ στον Roger Dingledine και την ομάδα στο SEUL.ORG για την εξαιρετική -φιλοξενία μας. - - -Εξαρτήσεις ------------- - -Το pygame είναι προφανώς δυνατά εξαρτημένο από SDL και Python. Επίσης -συνδέει και ενσωματώνει διάφορες άλλες μικρές βιβλιοθήκες. Το πρόγραμμα -της γραμματοσειράς βασίζεται στο SDL_ttf, το οποίο είναι εξαρτημένο από το freetype. Τα mixer -(και mixer.music) προγράμματα βασίζονται στο SDL_mixer. Το πρόγραμμα της εικόνας -βασίζεται στο SDL_image. Το Transform.rotozoom έχει μια ενσωματωμένη έκδοση -του SDL_rotozoom, και το gfxdraw έχει μια ενσωματωμένη έκδοση του SDL_gfx. -Έκδοσεις εξαρτήσεων: - - -+----------+------------------------+ -| CPython | >= 3.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - -Πώς να συνεισφέρεται ------------------ -Πρώτα απ’ όλα, σας ευχαριστούμε που σκέφτεστε να συνεισφέρετε στο pygame-ce! Είναι άνθρωποι σαν κι εσάς που κάνουν το pygame-ce μια εξαιρετική βιβλιοθήκη. Παρακαλούμε ακολουθήστε τα παρακάτω βήματα για να ξεκινήσετε: - -1. Διαβάστε το `Contribution Guidelines`_ και `Many Ways to Contribute`_ wiki σελίδες. -2. Διαβάστε τις τεκμηριώσεις στο `Opening A Pull Request`_ και `Opening a Great Pull Request`_. -3. Διαβάστε το πως να `label and link reported issues`_. -4. Τσεκάρετε το `issue tracker`_ για ανοιχτά προβλήματα που σας ενδιαφέρουν ή ανοίξτε δικό σας πρόβλημα για να ξεκινήσετε μια συζήτηση σχετικά με την ιδέα σας. - -Υπάρχουν πολλά ακόμα μέσα στο `wiki pages`_ που μπορούν να σας βοηθήσουν να ξεκινήσετε. - -Αν έχετε οποιεσδήποτε ερωτήσεις, μη διστάσετε να ρωτήσετε στο `Pygame Community Discord Server`_ ή να ανοίξετε ένα θέμα. - -Άδεια -------- -**License Identifier:** LGPL-2.1-or-later - -Αυτή η βιβλιοθήκη διανέμεται υπό την άδεια `GNU LGPL version 2.1`_, η οποία -βρίσκεται στο αρχείο ``docs/LGPL.txt``. Διατηρούμε το δικαίωμα να θέσουμε -μελλοντικές εκδόσεις αυτής της βιβλιοθήκης υπό διαφορετική άδεια. - -Αυτό σημαίνει ουσιαστικά ότι μπορείτε να χρησιμοποιείτε το pygame σε οποιοδήποτε project θέλετε, -αλλά αν κάνετε οποιεσδήποτε αλλαγές ή προσθήκες στο ίδιο το pygame, αυτές πρέπει να -κυκλοφορήσουν με συμβατή άδεια (κατά προτίμηση να υποβληθούν πίσω στο 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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 - -.. _简体中文: README.zh-cn.rst -.. _繁體中文: README.zh-tw.rst -.. _English: ./../../README.rst -.. _Français: README.fr.rst -.. _فارسی: README.fa.rst -.. _Español: README.es.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.it.rst b/docs/readmes/README.it.rst deleted file mode 100644 index 2332bdd051..0000000000 --- a/docs/readmes/README.it.rst +++ /dev/null @@ -1,174 +0,0 @@ -.. 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** `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ ---------------------------------------------------------------------------------------------------- - -Pygame_ è una libreria open source gratuita e multipiattaforma -adibita allo sviluppo di applicazioni multimediali come videogiochi utilizzando Python. -Utilizza la `Simple DirectMedia Layer library`_ e altre librerie -popolari per astrarre le operazioni più comuni, rendendo la scrittura -di questi programmi un compito più intuitivo. - -Questa distribuzione si chiama **`pygame - Community Edition`** ('pygame-ce' per abbreviare). - -È una fork (divisione) del progetto pygame originale fondata dai suoi precedenti sviluppatori principali, -ed è stata creata dopo che ostacoli insuperabili gli hanno impedito di continuare a sviluppare l'originale. -La nuova distribuzione ha l'obbiettivo di offrire nuove versioni più di frequente, continue migliorie -e bugfixes e un modello governativo più democratico. - -Nuovi contributori sono i benvenuti! - -Installazione -------------- - -:: - - pip install pygame-ce - - -Aiuto ------ - -Se sei alle prime armi con pygame, dovresti riuscire a iniziare -abbastanza velocemente. Pygame ha a disposizione numerosi tutorial -e introduzioni. Esiste anche una documentazione di riferimento completa -per l'intera libreria. Puoi trovare la documentazione sulla `docs page`_. -Puoi anche visualizzare la documentazione localmente eseguento il comando -``python -m pygame.docs`` nel tuo terminale. Se la documentazione è -inaccessibile localmente, il sito web online verrà aperto al suo posto. - -La documentazione online è aggiornata con la versione di sviluppo di pygame-ce -su github. Essa potrebbe essere leggermente più recente rispetto alla versione -di pygame-ce che stai usando. Per aggiornare alla versione più recente, esegui -il comando ``pip install pygame-ce --upgrade`` nel tuo terminale. - -La cosa migliore è che la cartella degli esempi contiene numerosi piccoli -programmi giocabili che ti permetteranno di iniziare a maneggiare il codice -fin da subito. - -Compilare dal Codice Locale ---------------------------- - -Se vuoi usare funzionalità che sono ancora in sviluppo o se vuoi -contribuire per pygame-ce avrai bisogno di compilare pygame-ce localmente -a partire dal suo codice sorgente piuttosto che installarlo con pip. - -L'installazione dal codice sorgente è abbastanza automatizzata. La maggior -parte del lavoro riguarda compilare e installare le librerie richieste da pygame-ce. -Fatto ciò, esegui lo script ``setup.py`` che tenterà di -configurare automaticamente, compilare e installare pygame-ce. - -Più informazioni riguardo all'installazione e alla compilazione sono -disponibili sulla `Compilation wiki page`_. - -Requisiti ---------- - -Pygame come si può intuire dipende fortemente da SDL e da Python. -È inoltre collegata e incorpora diverse altre librerie più piccole. -Il modulo font dipende da SDL_ttf che dipende a sua volta da freetype. -Il modulo mixer (e mixer.music) dipendono da SDL_mixer. Il modulo image -dipende da SDL_image. La funzione Transform.rotozoom usa una versione -incorporata di SDL_rotozoom e il modulo gfxdraw incorpora una versione -di SDL_gfx. - -Le versioni dei requisiti: - - -+----------+------------------------+ -| CPython | >= 3.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - -Come Contribuire ----------------- -Prima di tutto, grazie per aver considerato di contribuire per pygame-ce! Sono le persone come te che rendono pygame-ce una libreria grandiosa. Per favore segui questi passaggi per iniziare: - -1. Leggi le pagine wiki `Contribution Guidelines`_ e `Many Ways to Contribute`_. -2. Leggi la documentazione riguardo `Opening A Pull Request`_ e `Opening a Great Pull Request`_. -3. Leggi come `label and link reported issues`_. -4. Controlla l'`issue tracker`_ per problemi irrisolti che ti interessano o segnala un nuovo problema per iniziare una discussione riguardo alla tua idea. - -Ci sono molte più risorse nelle `wiki pages`_ che possono aiutarti ad iniziare. - -Se hai qualsiasi domanda, sentiti libero di chiedere nel `Pygame Community Discord Server`_ o segnala un problema. - -Licenza -------- -**License Identifier:** LGPL-2.1-or-later - -Questa libreria è distribuita con la licenza `GNU LGPL version 2.1`_ che può -essere trovata nel file ``docs/LGPL.txt``. Ci riserviamo il diritto di -distribuire future versioni di questa libreria con una licenza differente. - -Questo significa essenzialmente che puoi usare pygame-ce in qualsiasi progetto -che tu voglia, ma se fai alcun cambiamento o aggiunte a pygame-ce stesso, -tali modifiche devono essere distribuite con una licenza compatibile (preferibilmente -presentate al progetto pygame-ce). Giochi commerciali o a codice chiuso sono consentiti. - -I programmi nella sottocartella ``examples`` appartengono al dominio pubblico. - -Controlla docs/licenses per le licenze dei requisiti. - -**** - -**Last reviewed**: 05 October 2024 - **Ultima revisione**: 05 Ottobre 2024 - -.. |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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 -.. _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 -.. _فارسی: README.fa.rst -.. _Français: README.fr.rst -.. _Español: README.es.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.ja.rst b/docs/readmes/README.ja.rst deleted file mode 100644 index 265e22cd6f..0000000000 --- a/docs/readmes/README.ja.rst +++ /dev/null @@ -1,246 +0,0 @@ -.. 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`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ - ---------------------------------------------------------------------------------------------------- - -Pygame_ は、Pythonを使ってビデオゲームのようなマルチメディアアプリケーションを -開発するための、フリーでオープンソースなクロスプラットフォームライブラリです。 -`Simple DirectMedia Layer library`_ や他のいくつかの有名なライブラリを使って、 -最も一般的な機能を抽象化して、これらのプログラムの作成をより直感的な作業にします。 - -このディストリビューションは **'pygame - Community Edition'** (略して 'pygame-ce')と呼ばれます。 - - -これは、以前のコア開発者たちによって作られた pygame プロジェクトのフォークであり、 -アップストリームの開発を継続できなくなるという困難な状況の後に作成されました。 -この新しいディストリビューションは、より頻繁なリリース、継続的なバグ修正や機能強化、 -そしてより民主的なガバナンスモデルを提供することを目指しています。 - -新しいコントリビュータは歓迎されています！ - - -インストール ------------- - -:: - - pip install pygame-ce - - -ヘルプ ------- - -pygame を初めて使用する場合、すぐに開始できるはずです。 -Pygame には多くのチュートリアルや入門資料が付属しています。 -また、ライブラリ全体の完全なリファレンスドキュメントもあります。 -`docs page`_ でドキュメントを参照できます。 - -また、端末で ``python -m pygame.docs`` を実行することで、 -ドキュメントを参照することもできます。もしローカルのドキュメントが -見つからない場合は、オンラインのウェブサイトが代わりに表示されます。 - -オンラインドキュメントは、github の pygame の開発版に最新の状態で -追従しています。これは、あなたが使用している pygame のバージョンよりも -少し新しいかもしれません。最新の完全リリースにアップグレードするには、 -端末で ``pip install pygame-ce --upgrade`` を実行してください。 - - -最も重要なことは、examples ディレクトリに多くのプレイ可能な -小さなプログラムがあり、そのコードによって今すぐ使い始められることです。 - -すぐにコードを使い始めることができることです。 - - -ソースからのビルド ------------------- - -現在開発中の機能を使用したい場合や、pygame-ce に貢献したい場合は、 -pip インストールするのではなく、ソースコードからローカルで -pygame-ce をビルドする必要があります。 - -ソースからのインストールはかなり自動化されています。 -作業のほとんどは、pygame の依存関係をすべてコンパイルして -インストールすることです。それが終われば、 ``setup.py`` スクリプトを -実行してください。自動設定、ビルド、および pygame のインストールが -試みられます。 - -インストールとコンパイルについてのより多くの情報は、 -`Compilation wiki page`_ にあります。 - - -謝辞 ----- - -このライブラリの開発に貢献して下さったすべての人に感謝します。 - -Special thanks: - -* 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 に強く依存します。 -また、他のいくつかの小さなライブラリにもリンクしたり、埋め込まれています。 -フォントモジュールは SDL_ttf に依存しており、これは freetype に依存しています。 -ミキサー（および mixer.music）モジュールは SDL_mixer に依存しています。 -イメージモジュールは SDL_image に依存しています。 -Transform.rotozoom には SDL_rotozoom の埋め込みバージョンが含まれており、 -gfxdraw には SDL_gfx の埋め込みバージョンが含まれています。 - -依存バージョン: - -+----------+------------------------+ -| CPython | >= 3.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - - -コントリビュータになるには --------------------------- - -最初に、pygame-ce のコントリビュータになることを考慮してくれたことに感謝します。 -あなたのような方のおかげで pygame-ce を素晴らしいライブラリにすることができます。 -まずは、以下のステップに従ってください: - -1. `Contribution Guidelines`_ と `Many Ways to Contribute`_ wiki ページをお読みください -2. `Opening A Pull Request`_ と `Opening a Great Pull Request`_ のドキュメントをお読みください -3. `label and link reported issues`_ の How-to をお読みください -4. `issue tracker`_ で興味のある issue があるかどうかをチェックするか、 - あなたのアイデアについての議論を開始するため、新しい issue を開いてください - -`wiki pages`_ にもあなたのスタートを手助けするたくさんの資料があります。 -もし何か疑問があれば、issue を開くか、 `Pygame Community Discord Server`_ でお気軽にご質問ください。 - - -ライセンス ----------- - -**License Identifier:** LGPL-2.1-or-later - - -このライブラリは `GNU LGPL version 2.1`_ ライセンスで配布されています。 -ライセンスは ``docs/LGPL.txt`` にあります。我々はこのライブラリの -将来のバージョンに異なるライセンスを適用する権利を保留しています。 - -これは、基本的にあなたは pygame をあらゆるプロジェクトで使用できることを -意味しますが、あなたが pygame 自体に変更や追加を加えた場合、それらは -互換性のあるライセンスでリリースされることが必要です。 -(できれば pygame-ce プロジェクトに送ってください) -クローズドソースや商用ゲームで使用することができます。 - -``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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.pt-br.rst b/docs/readmes/README.pt-br.rst deleted file mode 100644 index 9dee6f4fb8..0000000000 --- a/docs/readmes/README.pt-br.rst +++ /dev/null @@ -1,229 +0,0 @@ -.. 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`_ `Русский`_ `Ελληνικά`_ **Português (Brasil)** `Deutsch`_ -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -Pygame_ é uma biblioteca gratuita e de código aberto, multiplataforma, -para o desenvolvimento de aplicações multimídia, como videogames, usando Python. -Ela utiliza a `Simple DirectMedia Layer library`_ e várias outras bibliotecas -populares para abstrair as funções mais comuns, tornando a escrita -desses programas uma tarefa mais intuitiva. - -Essa distribuição é chamada **'pygame - Community Edition'** (abreviado como 'pygame-ce'). - -É um fork do projeto pygame original, criado por antigos desenvolvedores principais, -e surgiu após desafios impossíveis impedirem a continuação do desenvolvimento upstream. -A nova distribuição tem como objetivo oferecer lançamentos mais frequentes, correções e melhorias contínuas, -além de um modelo de governança mais democrático. - -Novos contribuidores são bem-vindos! - - -Instalação ----------- - -:: - - pip install pygame-ce - - -Ajuda ------ - -Se você está começando com pygame, deve conseguir iniciar rapidamente. -O Pygame vem com muitos tutoriais e introduções. -Também há documentação completa de referência para toda a biblioteca. -Consulte a documentação na `página de docs`_. -Você também pode acessar a documentação localmente executando -``python -m pygame.docs`` no terminal. -Se os docs não forem encontrados localmente, será aberto o site oficial. - -A documentação online é atualizada com a versão de desenvolvimento -do pygame no GitHub. Isso pode ser um pouco mais recente que a versão do pygame -que você está usando. Para atualizar para o último lançamento completo, rode: -``pip install pygame-ce --upgrade`` no terminal. - -O melhor de tudo é que o diretório de exemplos contém vários pequenos programas jogáveis -que permitem brincar com o código imediatamente. - - -Compilando do Código-Fonte --------------------------- - -Se você deseja usar funcionalidades que estão em desenvolvimento, -ou contribuir para o pygame-ce, precisará compilar o pygame-ce -localmente a partir do código-fonte, em vez de instalar via pip. - -A instalação a partir do código-fonte é bastante automatizada. -A maior parte do trabalho envolve compilar e instalar todas as dependências do pygame. -Depois disso, execute o script ``setup.py``, que tentará -auto-configurar, compilar e instalar o pygame. - -Mais informações sobre instalação e compilação estão disponíveis -na `página de compilação do wiki`_. - - -Créditos --------- - -Obrigado a todos que ajudaram a contribuir com esta biblioteca. -Agradecimentos especiais também são devidos. - -* Marcus Von Appen: muitas mudanças e correções, mantenedor FreeBSD 1.7.1+ -* Lenard Lindstrom: mantenedor Windows 1.8+, muitas mudanças e correções -* Brian Fisher: construtor automático svn, rastreador de bugs e muitas contribuições -* Rene Dudfield: muitas mudanças e correções, gerente de lançamentos/mantenedor 1.7+ -* Phil Hassey: pelo trabalho no site pygame.org -* DR0ID: pelo trabalho no módulo sprite -* Richard Goedeken: pela função smoothscale -* Ulf Ekström: pelo código de detecção de colisão pixel-perfect -* Pete Shinners: autor original -* David Clark: pelo apoio como braço direito -* Ed Boraas e Francis Irving: pacotes Debian -* Maxim Sobolev: empacotamento FreeBSD -* Bob Ippolito: port para macOS e OS X (muito trabalho!) -* Jan Ekhol, Ray Kelm, e Peter Nicolai: por aguentarem ideias de design iniciais -* Nat Pryce: por iniciar nossos testes unitários -* Dan Richter: pelo trabalho de documentação -* TheCorruptor: pelos logos e gráficos incríveis -* Nicholas Dudfield: por muitas melhorias nos testes -* Alex Folkner: pelo pygame-ctypes - -Agradecimentos a todos que enviaram patches e correções: -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. - -E aos caçadores de bugs que foram além: Angus, Guillaume Proux, Frank Raiser, Austin Henry, -Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, Michael Benfield, David Lau. - -Há muitas outras pessoas que enviaram ideias úteis, mantiveram este projeto vivo e -basicamente tornaram nossa vida mais fácil. Obrigado! - -Muito obrigado também a todos que fizeram comentários na documentação, contribuíram para a -`documentação do pygame`_ e a `documentação do pygame-ce`_. - -E obrigado a todos que criam jogos e os publicam no site pygame.org para que outros possam aprender e se divertir. - -Muitos agradecimentos a James Paige por hospedar o bugzilla do pygame. -E um grande obrigado a Roger Dingledine e à equipe do SEUL.ORG pelo excelente serviço de hospedagem. - - -Dependências ------------- - -O Pygame depende fortemente do SDL e do Python. -Também faz uso e incorpora várias outras bibliotecas menores. -O módulo de fontes depende do SDL_ttf, que depende do freetype. -Os módulos mixer (e mixer.music) dependem do SDL_mixer. -O módulo image depende do SDL_image. -Transform.rotozoom contém uma versão embutida do SDL_rotozoom, -e gfxdraw contém uma versão embutida do SDL_gfx. -Versões de dependências: - -+----------+------------------------+ -| CPython | >= 3.10 (Ou use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - - -Como Contribuir ---------------- - -Antes de tudo, obrigado por considerar contribuir com o pygame-ce! -São pessoas como você que tornam o pygame-ce uma ótima biblioteca. -Siga estes passos para começar: - -1. Leia as `Diretrizes de Contribuição`_ e a página de wiki `Muitas Formas de Contribuir`_. -2. Leia a documentação sobre `Abrindo um Pull Request`_ e `Abrindo um Pull Request de Qualidade`_. -3. Leia como `rotular e vincular issues reportadas`_. -4. Confira o `rastreador de issues`_ para ver as issues abertas que te interessam ou abra uma nova issue para iniciar uma discussão sobre sua ideia. - -Existem muitos outros recursos nas `páginas do wiki`_ que podem ajudar você a começar. - -Se tiver dúvidas, sinta-se à vontade para perguntar no `Servidor Discord da Comunidade Pygame`_ ou abrir uma issue. - - -Licença -------- - -**Identificador de Licença:** LGPL-2.1-or-later - -Esta biblioteca é distribuída sob a `GNU LGPL versão 2.1`_, que pode ser encontrada no arquivo ``docs/LGPL.txt``. -Reservamos o direito de disponibilizar versões futuras desta biblioteca sob uma licença diferente. - -Isso basicamente significa que você pode usar pygame em qualquer projeto que quiser, -mas se fizer alterações ou adições ao próprio pygame, estas -devem ser lançadas com uma licença compatível (de preferência submetidas -de volta ao projeto pygame-ce). Jogos comerciais e de código fechado são permitidos. - -Os programas no subdiretório ``examples`` estão em domínio público. - -Veja em docs/licenses as licenças das dependências. - - -.. |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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 -.. _documentação do pygame-ce: https://pyga.me/docs/ -.. _documentação do pygame: https://www.pygame.org/docs/ -.. _Simple DirectMedia Layer library: https://www.libsdl.org -.. _página de compilação do wiki: https://github.com/pygame-community/pygame-ce/wiki#compiling -.. _página de docs: https://pyga.me/docs -.. _GNU LGPL versão 2.1: https://www.gnu.org/copyleft/lesser.html -.. _Diretrizes de Contribuição: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines -.. _Muitas Formas de Contribuir: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute -.. _Abrindo um Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request -.. _Abrindo um Pull Request de Qualidade: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request -.. _rastreador de issues: https://github.com/pygame-community/pygame-ce/issues -.. _rotular e vincular issues reportadas: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues -.. _Servidor Discord da Comunidade Pygame: https://discord.gg/pygame -.. _páginas do wiki: 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 -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.ru.rst b/docs/readmes/README.ru.rst deleted file mode 100644 index ce750a1a2c..0000000000 --- a/docs/readmes/README.ru.rst +++ /dev/null @@ -1,227 +0,0 @@ -.. 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`_ **Русский** `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -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.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - -Как внести свой вклад ------------------ -Прежде всего, спасибо, что согласились внести свой вклад в pygame-ce! Именно такие люди, как вы, делают pygame-ce отличной библиотекой. Пожалуйста, выполните следующие действия, чтобы начать: - -1. Ознакомьтесь со страницами вики `Руководящие принципы по внесению вклада`_ и `Множество способов внести свой вклад`_. -2. Ознакомьтесь с документацией `Отправка запроса на вытягивание`_ и `Отправка отличного запроса на вытягивание`_. -3. Прочитайте, как `маркировать и связывать сообщённые проблемы`_. -4. Проверьте `issue tracker`_ на наличие интересующих вас открытых проблем или создайте новую проблему, чтобы начать обсуждение своей идеи. - -На странице `вики-проекта`_ есть множество ресурсов, которые могут помочь вам начать. - -Если у вас есть какие-то вопросы, не стесняйтесь задавать их на `сервере Discord Pygame Community`_ или открыв проблему (issue). - -License -------- -**License Identifier:** LGPL-2.1-or-later - -Эта библиотека распространяется под лицензией `GNU LGPL version 2.1`_, которую можно -найти в файле ``docs/LGPL.txt``. Мы оставляем за собой право размещать -будущие версии этой библиотеки под другой лицензией. - -По сути, это означает, что вы можете использовать pygame в любом проекте, который захотите, -но если вы вносите какие-либо изменения или дополнения в саму pygame, они -должны быть выпущены с совместимой лицензией (желательно, чтобы они были отправлены -обратно в проект pygame-ce ). Игры с закрытым исходным кодом и коммерческие игры - это нормально. - -Программы в подкаталоге ``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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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 -.. _Руководящие принципы по внесению вклада: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines -.. _Множество способов внести свой вклад: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute -.. _Отправка запроса на вытягивание: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-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 -.. _маркировать и связывать сообщённые проблемы: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues -.. _сервере Discord Pygame Community: https://discord.gg/pygame -.. _вики-проекта: 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 -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.zh-cn.rst b/docs/readmes/README.zh-cn.rst deleted file mode 100644 index a98cd96050..0000000000 --- a/docs/readmes/README.zh-cn.rst +++ /dev/null @@ -1,167 +0,0 @@ -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| - -`English`_ **简体中文** `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ ----- - -Pygame_ 是一款自由且开源的跨平台库，用于开发电子游戏等多媒体应用。Pygame基于 `Simple DirectMedia Layer library`_ 以及其他几个广受欢迎的库，汲取其中最常见的函数，让编写游戏成为更加符合直觉的事情。 - -本发行版名为 **“pygame - Community Edition”** （简称 “pygame-ce”）。 - -pygame-ce是上游pygame项目的分支，由此前pygame项目的核心开发者创建。开发者们在上游的开发中受到了强烈的阻挠，无法继续，所以创建了这个发行版。新的发行版旨在提供更加频繁的版本更新，持续不断的bug修复与功能增强，以及更加民主的管理模式。 - -欢迎新的贡献者加入我们。 - -安装 ------------- - -:: - - pip install pygame-ce - - -入门 ----- - -刚接触pygame的初学者应该可以快速入门。pygame提供了大量教程与介绍，也提供了整个库的完整参考文档。你可以在 `docs page`_ 浏览文档。也可以在终端中运行`python -m pygame.docs`，在本地浏览文档。如果找不到本地文档，会自动打开在线文档。 - -在线文档与github中的开发版pygame同步。文档版本可能比你正在用的pygame版本新一些。在终端中运行 ``pip install pygame-ce --upgrade`` 可以升级到最新完整版本。 - -最重要的是，examples目录中有许多可以玩的小程序，可以使你立即开启代码之旅。 - -从源码开始编译 --------------------- - -如果你想使用那些正在开发的特性，或者你想要为pygame做出贡献，你就需要从源码开始编译pygame，而不是用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. - -以及我们卓越的bug猎人：Angus, Guillaume Proux, Frank -Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, -Michael Benfield, David Lau - -还有许多人提交了有用的想法，助力本项目前进，使我们的生活变得更加轻松。感谢你们！ - -感谢对文档做成评论并将其添加到pygame.org wiki的人。 - -感谢制作游戏并把游戏放到pygame.org网站供人学习与娱乐的人。 - -感谢 James Paige 建立了pygame bugzilla。 - -感谢 Roger Dingledine 与SEUL.ORG上的crew，感谢我们优秀的主持。 - -依赖 ------------- -pygame显然依赖于SDL和Python。此外pygame还嵌入了几个较小的库：font模块依赖于SDL_ttf（SDL_ttf依赖于freetype）；mixer模块（以及mixer.music模块）依赖于SDL_mixer；image模块依赖于SDL_image；transform模块内嵌了一个SDL_rotozoom来实现rotozoom函数；gfxdraw模块内嵌了一个SDL_gfx。 - -依赖的版本要求如下： - - -+----------+------------------------+ -| CPython | >= 3.10 （或 PyPy3） | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - - - -许可证 -------- -**许可证标识符:** LGPL-2.1-or-later - -本库在 `GNU LGPL version 2.1`_ 下发布，许可文件： ``docs/LGPL.txt`` 。我们保留将此库的未来版本置于其他许可证下的权利。 - -这基本代表着你可以在任意项目中使用pygame，但如果你修改或者增加了pygame库的内容，这些内容必须使用兼容的许可证发布（更可取的是将其提交回pygame项目）。闭源或者商业性游戏中可以使用pygame。 - -``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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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://www.pyga.me -.. _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 - -.. _English: ./../../README.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 -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst diff --git a/docs/readmes/README.zh-tw.rst b/docs/readmes/README.zh-tw.rst deleted file mode 100644 index edb8c5e2b4..0000000000 --- a/docs/readmes/README.zh-tw.rst +++ /dev/null @@ -1,186 +0,0 @@ -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| - -`English`_ `简体中文`_ **繁體中文** `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ `Русский`_ `Ελληνικά`_ `Português (Brasil)`_ `Deutsch`_ ----- - -Pygame_ 是一款自由且開源的跨平台程式庫，用於開發電子遊戲等多媒體應用。Pygame基於 `Simple DirectMedia Layer library`_ 以及其他幾個廣受歡迎的程式庫，提取其中最常見的函數，讓編寫遊戲成為更符合直覺的事情。 - -本發行版名為 **“pygame - Community Edition“** （簡稱 “pygame-ce“）。 - -pygame-ce是上游pygame專案的分支，由此前pygame專案的核心開發者創建。開發者們在上游的開發中受到了強烈的阻撓，無法繼續，所以創建了這個發行版。新的發行版主旨在提供更頻繁的版本更新，持續不斷的bug修復與功能增強，以及更民主的管理模式。 - -歡迎新的貢獻者加入我們。 - -安装 ------------- - -:: - - pip install pygame-ce - - -入門 ----- - -剛接觸pygame的初學者應該可以快速入門。pygame提供了大量教學與介紹，也提供了整個函式庫的完整參考文件。你可以在 `docs page`_ 瀏覽文件。也可以在終端機中執行`python -m pygame.docs`，在本機瀏覽文件。如果找不到本機文檔，會自動開啟線上文檔。 - -線上文件與github中的開發版pygame同步。文件版本可能比你正在使用的pygame版本新一些。在終端機中執行 ``pip install pygame-ce --upgrade`` 可以升級到最新完整版本。 - -最重要的是，examples目錄中有許多可以玩的小程序，可以讓你立即開啟程式碼之旅。 - -從原始碼開始編譯 --------------------- - -如果你想使用那些正在開發的特性，或者你想要為pygame做出貢獻，你需要從原始碼開始編譯pygame，而不是用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. - -以及我們卓越的bug獵人：Angus, Guillaume Proux, Frank -Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, -Michael Benfield, David Lau - -還有許多人提交了有用的想法，助力本計畫前進，使我們的生活變得更加輕鬆。感謝你們！ - -非常感謝人們提出文件評論並添加到 pygame 文件和 pygame-ce 文檔 - -感謝製作遊戲並把遊戲放到pygame.org網站供人學習與娛樂的人。 - -感謝 James Paige 建立了pygame bugzilla。 - -感謝 Roger Dingledine 與SEUL.ORG上的crew，感謝我們優秀的主持。 - -依賴 ------------- - - -pygame顯然依賴SDL和Python。此外pygame也嵌入了幾個較小的函式庫：font模組依賴SDL_ttf（SDL_ttf依賴freetype）；mixer模組（以及mixer.music模組）依賴SDL_mixer；image模組依賴SDL_image（SDL_image使用到libjpeg與libpng） ；transform模組內嵌了一個SDL_rotozoom來實現它的rotozoom函式；surfarray模組用到了Numpy中的多維數組。 - -依賴的版本要求如下： - - - -+----------+------------------------+ -| CPython | >= 3.10 （或 PyPy3） | -+----------+------------------------+ -| SDL | >= 2.0.14 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.4 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.15 | -+----------+------------------------+ - - -如何貢獻 --------- - -首先，感謝你考慮為 pygame-ce 做出貢獻！正是像你這樣的人讓 pygame-ce 成為一個偉大的函式庫。請依照以下步驟開始： - -1. 閱讀 `Contribution Guidelines`_ 和 `Many Ways to Contribute`_ wiki 頁面。 -2. 閱讀 `Opening A Pull Request`_ 和 `Opening a Great Pull Request`_ 的相關文件。 -3. 學習How to `label and link reported issues`_ 。 -4. 檢查 `issue tracker`_ 以查找你有興趣的issue，或建立一個新的issue來開始討論你的想法。 - -`wiki pages`_ 上還有許多資源可以幫助你入門。 - -如果有任何問題，請隨時在 `Pygame Community Discord Server`_ 詢問或建立一個issue。 - - -授權條款 -------- -**授權條款版本:** LGPL-2.1-or-later - -本函式庫在 `GNU LGPL version 2.1`_ 下發布，許可文件： ``docs/LGPL.txt`` 。我們保留將此函式庫的未來版本置於其他許可證下的權利。 - -這基本上代表你可以在任意專案中使用pygame，但如果你修改或增加了pygame庫的內容，這些內容必須使用原授權條款相容的授權發布（我們更希望修改者將其提交回pygame專案）。閉源或商業性遊戲中可以使用pygame。 - -``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.5.6.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.6...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://www.pyga.me -.. _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 - -.. _English: ./../../README.rst -.. _简体中文: README.zh-cn.rst -.. _Français: README.fr.rst -.. _فارسی: README.fa.rst -.. _Español: README.es.rst -.. _日本語: README.ja.rst -.. _Italiano: README.it.rst -.. _Русский: README.ru.rst -.. _Ελληνικά: README.gr.rst -.. _Português (Brasil): README.pt-br.rst -.. _Deutsch: README.de.rst