Added persian transaltion for README.rst

README.rst

@@ -7,7 +7,7 @@
 |PyPiVersion| |PyPiLicense|
 |Python3| |GithubCommits| |BlackFormatBadge|
 
-**English** `简体中文`_ `Français`_
+**English** `简体中文`_ `Français`_ `فارسی`_
 ---------------------------------------------------------------------------------------------------
 
 Pygame_ is a free and open-source cross-platform library
@@ -199,4 +199,5 @@ See docs/licenses for licenses of dependencies.
 .. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html
 
 .. _简体中文: ./docs/readmes/README.zh-cn.rst
-.. _Français: ./docs/readmes/README.fr.rst
+.. _Français: ./docs/readmes/README.fr.rst
+.. _فارسی: ./docs/readmes/README.fa.rst

docs/readmes/README.fa.rst

@@ -0,0 +1,254 @@
+.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_logo.svg
+  :alt: pygame
+  :target: https://pyga.me/
+
+
+|DocsStatus|
+|PyPiVersion| |PyPiLicense|
+|Python3| |GithubCommits| |BlackFormatBadge|
+
+`English`_ `简体中文`_ `Français`_ **فارسی**
+---------------------------------------------------------------------------------------------------
+کتابخانه
+Pygame_
+برای توسعه دادن برنامه های چند رسانه ای
+مانند بازی های رایانه ای, به کار می رود.
+
+پایگیم به عنوان زیرساخت های اصلی خود از کتابخانه
+`Simple DirectMedia Layer library`_
+استفاده می کند.
+
+
+همچنین از کتابخانه های پرطرفدار و متعدد زیادی برای دسترسی
+به پرکاربرد ترین الگوریتم ها استفاده می کند,
+که در نتیجه این مسئله, فرایند تولید و توسعه برنامه
+با استفاده از کتابخانه پایگیم خلاقانه تر و آسان تر می شود۰
+
+
+این توزیع با نام 
+**'pygame - Community Edition'** ('pygame-ce' برای اختصار)
+شناخته می شود.
+
+این توزیع یک فورک از نسخه آپ استریم (نسخه اصلی) کتابخانه پایگیم می باشد
+که توسط مشارکت کنندگان (contributor) های سابق نسخه
+آپ استریم در حال توسعه و نگهداری هست, 
+و بعد از رخ دادن چالش هایی حل نشدنی که همکاری در نسخه اصلی کتابخانه
+را غیر ممکن می کرد, برای اولین بار ساخته شد.
+
+این توزیع به عنوان اهداف خود, انتشار های سریع تر و بیشتر نسخه های پروژه, رفع ادامه دار باگ ها و بهینه سازی پروژه,
+و کنترل کردن فرایند توسعه پروژه به صورت دموکراتیک
+را مد نظر خود دارد.
+
+ما به مشارکت کننده (contributor) هایی که علاقه مند به همکاری با
+ما هستند خوش آمد میگوییم و از آنها به گرمی استقبال می کنیم!.
+
+
+
+روش نصب
+------------
+
+::
+
+   pip install pygame-ce
+
+
+Help (کمک و راهنمایی)
+----
+اگر به تازگی قصد یادگیری کتابخانه پایگیم را دارید, می توانید به سادگی
+این فرایند را آغاز کنید.
+آموزش ها و معرفی های زیادی از کتابخانه پایگیم در اینترنت موجود هست.
+همچنین اسناد ارجاعی کاملی برای این کتابخانه تهیه و تدوین شده است.
+می توانید با استفاده از این لینک
+`docs page`_
+به اسناد ارجاعی دسترسی داشته باشید.
+
+همچنین اگر کتابخانه پایگیم را نصب کرده اید می توانید با وارد کردن دستور
+
+``python -m pygame.docs`` 
+
+در فضای ترمینال یا کامند لاین سیستم عامل خود, به اسناد ارجاعی دسترسی داشته باشید۰
+
+
+اسناد ارجاعی کتابخانه پس از هر بروزرسانی نسخه توسعه داده شده در مخزن
+pygame_ce_
+آپدیت می شوند۰
+
+محتوای این اسناد ممکن است از نسخه ای از پایگیم که شما استفاده می کنید کمی جدید تر باشد۰
+برای آپگرید کردن پایگیم خود به آخرین ورژن, دستور زیر را در فضای کامند لاین اجرا کنید۰
+
+``pip install pygame-ce --upgrade``
+
+همچنین پوشه ی examples شامل تعداد زیادی از برنامه ها قابل اجرا هست که
+می توانید به سادگی با تغییر دادن آنها با قابلیت های کتابخانه آشنا بشوید.
+
+Building From Source (ساخت و اجرا با استفاده از سرس کد)
+--------------------
+
+اگر می خواهید از قابلیت هایی که در حال توسعه هستند و هنوز به آخرین نسخه پروژه اضافه
+نشده اند استفاده کنید, یا می خواهید در توسعه و نگه داری این پروژه مشارکت داشته باشید,
+به جای نصب کردن کتابخانه روی سیستم عامل خود با استفاده از pip,
+شما باید کتابخانه پایگیم را روی سیستم خود به صورت local بسازید (build بگیرید).
+
+نصب کردن کتابخانه با استفاده از سرس کد تا حد زیادی اتوماتیک شد است.
+اکثر کار هایی که در این فرایند انجام می شوند شامل کامپایل کردن و نصب کردن
+تمام وابستگی (dependency) های پاگیم می باشد.
+زمانی که این فرایند به پایان رسیده است, اسکریپت
+``setup.py``
+را اجرا کنید که تلاش میکند کتابخانه پایگیم را روی دستگاه شما پیکربندی (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 (وابستگی ها)
+------------
+
+کتابخانه Pygame به وضوح به کتابخانه SDL و زبان Python وابسته است.
+همچنین به چندین کتابخانه کوچکتر دیگر نیز لینک می‌شود و از آنها استفاده می‌کند.
+ماژول فونت به کتابخانه SDL_ttf تکیه می کند که خود نیز به freetype وابسته است.
+ماژول mixer و mixer.music هم به کتابخانه SDL_mixer وابستگی دارند.
+
+ماژول image به SDL_image که می تواند به libjpeg و libpng وابستگی داشته باشد تکیه می کند.
+ماژول transform نیز از نسخه ای جاسازی شده از SDL_rotozoom برای فانکش rotozoom خود استفاده می کند.
+
+ماژول surfarray نیز از پکیج NumPy در زبان پایتون, برای پردازش آرایه های چندبعدی عددی خود
+استفاده می کند.
+
+
+
+در لیست زیر می توانید نسخه های دقیق هر یک از وابستگی های مورد نیاز را
+مشاهده کنید.
+
++----------+------------------------+
+| CPython  | >= 3.7 (Or use PyPy3)  |
++----------+------------------------+
+| SDL      | >= 2.0.8               |
++----------+------------------------+
+| SDL_mixer| >= 2.0.0               |
++----------+------------------------+
+| SDL_image| >= 2.0.2               |
++----------+------------------------+
+| SDL_ttf  | >= 2.0.11              |
++----------+------------------------+
+| SDL_gfx  | (Optional, vendored in)|
++----------+------------------------+
+| NumPy    | >= 1.6.2 (Optional)    |
++----------+------------------------+
+
+
+
+License
+-------
+این کتابخانه با استفاده از
+`GNU LGPL version 2.1`_
+لایسنس شده است که در فایل
+``docs/LDGP.txt``
+قابل دسترس هست.
+ما حق تغییر دادن این لایسنس را در نسخه های آینده این کتابخانه رزرو می کنیم.
+
+این مسئله در اختصار به این معنی است که شما می توانید از کتابخانه پایگیم در
+تمام پروژه های خود استفاده کنید. اما اگر تغییری در سرس کد پایگیم ایجاد کنید,
+آن تغییرات باید با لایسنسی که با لایسنس پایگیم سازگار است منتشر شوند. (ترجیحا
+ارجاع داده شده به پایگیم).
+انتشار بازی هایی که متن بسته و بازی هایی که منجر به درآمد زایی می شوند مجاز است.
+
+تمام برنامه های داخل پوشه
+``examples``
+شامل اموال عمومی‌ (public domain) می شوند.
+
+برای اطلاعات بیشتر در مورد لایسنس هر وابستگی (dependency), از
+لینک های زیر استفاده کنید.
+
+.. |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.2.1.svg
+   :target: https://github.com/pygame-community/pygame-ce/compare/2.2.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
+.. _Simple DirectMedia Layer library: https://www.libsdl.org
+.. _We need your help: https://www.pygame.org/contribute.html
+.. _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
+.. _Français: README.fr.rst

docs/readmes/README.fr.rst

@@ -7,7 +7,7 @@
 |PyPiVersion| |PyPiLicense|
 |Python3| |GithubCommits| |BlackFormatBadge|
 
-`English`_ `简体中文`_ **Français**
+`English`_ `简体中文`_ **Français**  `فارسی`_
 ---------------------------------------------------------------------------------------------------
 
 Pygame est une bibliothèque multi-plateforme, libre et open-source
@@ -207,3 +207,4 @@ Voir les docs/licences pour les licences des dépendances.
 
 .. _简体中文: README.zh-cn.rst
 .. _English: ./../../README.rst
+.. _فارسی: README.fa.rst

docs/readmes/README.zh-cn.rst

@@ -7,7 +7,7 @@
 |PyPiVersion| |PyPiLicense|
 |Python3| |GithubCommits| |BlackFormatBadge|
 
-`English`_ **简体中文** `Français`_
+`English`_ **简体中文** `Français`_ `فارسی`_
 ----
 
 Pygame_ 是一款自由且开源的跨平台库，用于开发电子游戏等多媒体应用。Pygame基于 `Simple DirectMedia Layer library`_ 以及其他几个广受欢迎的库，汲取其中最常见的函数，让编写游戏成为更加符合直觉的事情。
@@ -160,4 +160,5 @@ pygame显然依赖于SDL和Python。此外pygame还嵌入了几个较小的库
 .. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html
 
 .. _English: ./../../README.rst
-.. _Français: README.fr.rst
+.. _Français: README.fr.rst
+.. _فارسی: README.fa.rst