From f52a830b5f94fde42348d67cc30cdaa9300ff6bf Mon Sep 17 00:00:00 2001 From: Noah Date: Mon, 23 Sep 2024 14:49:50 +0800 Subject: [PATCH 1/3] commit1 --- docs/readmes/README.zh-tw.rst | 167 ++++++++++++++++++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 docs/readmes/README.zh-tw.rst diff --git a/docs/readmes/README.zh-tw.rst b/docs/readmes/README.zh-tw.rst new file mode 100644 index 0000000000..692611bb50 --- /dev/null +++ b/docs/readmes/README.zh-tw.rst @@ -0,0 +1,167 @@ +.. 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`_ +---- + +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，感謝我們優秀的主持。 + +依賴 +------------ + +**note:** This section translation is out of date (September 2023) + +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.8 （或 PyPy3） | ++----------+------------------------+ +| SDL | >= 2.0.10 | ++----------+------------------------+ +| 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.3.0.svg + :target: https://github.com/pygame-community/pygame-ce/compare/2.3.0...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 From 5957ba6ffe586243f43c132e3c0e7b4d51b9b583 Mon Sep 17 00:00:00 2001 From: Noah Date: Mon, 23 Sep 2024 14:52:14 +0800 Subject: [PATCH 2/3] commit1 --- docs/readmes/README.es.rst | 3 ++- docs/readmes/README.fa.rst | 3 ++- docs/readmes/README.fr.rst | 3 ++- docs/readmes/README.zh-cn.rst | 3 ++- 4 files changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/readmes/README.es.rst b/docs/readmes/README.es.rst index f947c8bc01..9943fdeca8 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** --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ es una biblioteca multiplataforma, gratuita y de código abierto @@ -165,6 +165,7 @@ Consulta docs/licenses para ver las licencias de dependencia. .. _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 diff --git a/docs/readmes/README.fa.rst b/docs/readmes/README.fa.rst index 37f820cda5..c58a627635 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`_ --------------------------------------------------------------------------------------------------- کتابخانه Pygame_ @@ -252,5 +252,6 @@ LGPL-2.1-or-later **شناسه مجوز:** .. _English: ./../../README.rst .. _简体中文: README.zh-cn.rst +.. _繁體中文: README.zh-tw.rst .. _Français: README.fr.rst .. _Español: README.es.rst diff --git a/docs/readmes/README.fr.rst b/docs/readmes/README.fr.rst index 9d36a7514f..26ac06f3f7 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`_ --------------------------------------------------------------------------------------------------------------------------------------------------- `Pygame`_ est une bibliothèque multi-plateforme, libre et open-source @@ -203,6 +203,7 @@ Voir les docs/licences pour les licences des dépendances. .. _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 diff --git a/docs/readmes/README.zh-cn.rst b/docs/readmes/README.zh-cn.rst index 8ca54bfe85..27f4e40a47 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`_ ---- Pygame_ 是一款自由且开源的跨平台库，用于开发电子游戏等多媒体应用。Pygame基于 `Simple DirectMedia Layer library`_ 以及其他几个广受欢迎的库，汲取其中最常见的函数，让编写游戏成为更加符合直觉的事情。 @@ -158,6 +158,7 @@ pygame显然依赖于SDL和Python。此外pygame还嵌入了几个较小的库 .. _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 From 578c098c2e4e7f84639ab6f04a1275d1da32cdd8 Mon Sep 17 00:00:00 2001 From: Noah Date: Mon, 23 Sep 2024 15:12:50 +0800 Subject: [PATCH 3/3] commit2 --- README.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 9503d1a0db..f27d4722d5 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`_ --------------------------------------------------------------------------------------------------- Pygame_ is a free and open-source cross-platform library @@ -215,6 +215,7 @@ See docs/licenses for licenses of dependencies. .. _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