diff --git a/README.rst b/README.rst index 40ed6441f4..a75fb3dd5c 100644 --- a/README.rst +++ b/README.rst @@ -8,7 +8,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -**English** `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ +**English** `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ --------------------------------------------------------------------------------------------------- Pygame_ is a free and open-source cross-platform library @@ -220,3 +220,4 @@ See docs/licenses for licenses of dependencies. .. _فارسی: ./docs/readmes/README.fa.rst .. _Español: ./docs/readmes/README.es.rst .. _日本語: ./docs/readmes/README.ja.rst +.. _Italiano: ./docs/readmes/README.it.rst diff --git a/docs/readmes/README.es.rst b/docs/readmes/README.es.rst index e8f3da48b4..9c78006fe2 100644 --- a/docs/readmes/README.es.rst +++ b/docs/readmes/README.es.rst @@ -7,7 +7,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ **Español** `日本語`_ +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ **Español** `日本語`_ `Italiano`_ --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ es una biblioteca multiplataforma, gratuita y de código abierto @@ -170,3 +170,4 @@ Consulta docs/licenses para ver las licencias de dependencia. .. _فارسی: README.fa.rst .. _Français: README.fr.rst .. _日本語: README.ja.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.fa.rst b/docs/readmes/README.fa.rst index db704eeab0..e41ebb3ea8 100644 --- a/docs/readmes/README.fa.rst +++ b/docs/readmes/README.fa.rst @@ -7,7 +7,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ `Français`_ **فارسی** `Español`_ `日本語`_ +`English`_ `简体中文`_ `繁體中文`_ `Français`_ **فارسی** `Español`_ `日本語`_ `Italiano`_ --------------------------------------------------------------------------------------------------- کتابخانه Pygame_ @@ -256,3 +256,4 @@ LGPL-2.1-or-later **شناسه مجوز:** .. _Français: README.fr.rst .. _Español: README.es.rst .. _日本語: README.ja.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.fr.rst b/docs/readmes/README.fr.rst index 4c6f1d3e98..e546df1afe 100644 --- a/docs/readmes/README.fr.rst +++ b/docs/readmes/README.fr.rst @@ -7,7 +7,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ `简体中文`_ `繁體中文`_ **Français** `فارسی`_ `Español`_ `日本語`_ +`English`_ `简体中文`_ `繁體中文`_ **Français** `فارسی`_ `Español`_ `日本語`_ `Italiano`_ --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ est une bibliothèque multi-plateforme, libre et open-source @@ -210,3 +210,4 @@ Voir les docs/licences pour les licences des dépendances. .. _فارسی: README.fa.rst .. _Español: README.es.rst .. _日本語: README.ja.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.it.rst b/docs/readmes/README.it.rst new file mode 100644 index 0000000000..df7dcddb58 --- /dev/null +++ b/docs/readmes/README.it.rst @@ -0,0 +1,228 @@ +.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg + :width: 800 + :alt: pygame + :target: https://pyga.me/ + + +|DocsStatus| +|PyPiVersion| |PyPiLicense| +|Python3| |GithubCommits| |BlackFormatBadge| + +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ **Italiano** +--------------------------------------------------------------------------------------------------- + +Pygame_ è 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`_. + +Crediti +------- + +Grazie a tutti coloro che hanno aiutato a contribuire per questa libraria. +In ordine sono riportati i ringraziamenti speciali. + +* 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 + +Grazie a coloro che inviano patches e correzioni: 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 ai nostri incredibili cacciatori di bug: Angus, Guillaume Proux, Frank +Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, +Michael Benfield, David Lau. + +Ci sono molte altre persone là fuori che hanno condiviso utili idee, che +hanno mantenuto il progetto in vita e che ci hanno essenzialmente reso la +vita più facile. Grazie! + +Molte grazie alle persone che pubblicano commenti sulla documentazione e che +contribuiscono alla `pygame documentation`_ e alla `pygame-ce documentation`_. + +Altrettanti ringraziamenti alle persone che creano giochi e che li pubblicano +sul sito pygame.org per rendere possibile agli altri di imparare da essi e di divertirsi. + +Molte grazie a James Paige per aver ospitato il bugzilla di pygame. + +Un altro grande ringraziamento a Roger Dingledine e al team di SEUL.ORG +per un hosting eccellente. + +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.8 (Or use PyPy3) | ++----------+------------------------+ +| SDL | >= 2.0.10 | ++----------+------------------------+ +| 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.4.1.svg + :target: https://github.com/pygame-community/pygame-ce/compare/2.4.1...main + +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F + :target: https://pyga.me/docs/ + +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg + :target: https://github.com/psf/black + +.. _Pygame: https://pyga.me +.. _pygame-ce documentation: https://pyga.me/docs/ +.. _pygame documentation: https://www.pygame.org/docs/ +.. _Simple DirectMedia Layer library: https://www.libsdl.org +.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling +.. _docs page: https://pyga.me/docs +.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html +.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines +.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute +.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request +.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request +.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues +.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues +.. _Pygame Community Discord Server: https://discord.gg/pygame +.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki + +.. _English: ./../../README.rst +.. _简体中文: README.zh-cn.rst +.. _繁體中文: README.zh-tw.rst +.. _فارسی: README.fa.rst +.. _Français: README.fr.rst +.. _Español: README.es.rst +.. _日本語: README.ja.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.ja.rst b/docs/readmes/README.ja.rst index 674c28399c..7774b97a1d 100644 --- a/docs/readmes/README.ja.rst +++ b/docs/readmes/README.ja.rst @@ -8,7 +8,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English` `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ **日本語** +`English` `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ **日本語** `Italiano`_ --------------------------------------------------------------------------------------------------- Pygame_ は、Pythonを使ってビデオゲームのようなマルチメディアアプリケーションを @@ -237,3 +237,4 @@ gfxdraw には SDL_gfx の埋め込みバージョンが含まれています。 .. _Français: ./docs/readmes/README.fr.rst .. _فارسی: ./docs/readmes/README.fa.rst .. _Español: ./docs/readmes/README.es.rst +.. _Italiano: README.it.rst diff --git a/docs/readmes/README.zh-cn.rst b/docs/readmes/README.zh-cn.rst index 378167b43f..7816284e70 100644 --- a/docs/readmes/README.zh-cn.rst +++ b/docs/readmes/README.zh-cn.rst @@ -7,7 +7,7 @@ |PyPiVersion| |PyPiLicense| |Python3| |GithubCommits| |BlackFormatBadge| -`English`_ **简体中文** `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ +`English`_ **简体中文** `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ `Italiano`_ ---- Pygame_ 是一款自由且开源的跨平台库，用于开发电子游戏等多媒体应用。Pygame基于 `Simple DirectMedia Layer library`_ 以及其他几个广受欢迎的库，汲取其中最常见的函数，让编写游戏成为更加符合直觉的事情。 @@ -160,3 +160,4 @@ pygame显然依赖于SDL和Python。此外pygame还嵌入了几个较小的库 .. _فارسی: README.fa.rst .. _Español: README.es.rst .. _日本語: README.ja.rst +.. _Italiano: README.it.rst