# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: # Rafael Fontenelle , 2025 # Revisto , 2025 # Sepehr Rasouli , 2026 # msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-09-16 12:56+0000\n" "PO-Revision-Date: 2026-09-14 10:40+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: Persian (https://github.com/python/python-docs-fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" "X-Generator: Poedit 3.6\n" msgid "Using Python on macOS" msgstr "استفاده از پایتون در macOS" msgid "This document aims to give an overview of macOS-specific behavior you should know about to get started with Python on Mac computers. Python on a Mac running macOS is very similar to Python on other Unix-derived platforms, but there are some differences in installation and some features." msgstr "هدف این سند، ارائه‌ی مروری کلی بر رفتارهای اختصاصی macOS است که برای شروع کار با پایتون روی رایانه‌های مک باید از آن‌ها آگاه باشید. پایتون روی مکی که macOS را اجرا می‌کند، بسیار شبیه به پایتون روی سایر پلتفرم‌های برگرفته از یونیکس است، اما تفاوت‌هایی در نصب و برخی ویژگی‌ها وجود دارد." msgid "There are various ways to obtain and install Python for macOS. Pre-built versions of the most recent versions of Python are available from a number of distributors. Much of this document describes use of the Pythons provided by the CPython release team for download from the `python.org website `_. See :ref:`alternative_bundles` for some other options." msgstr "روش‌های مختلفی برای دریافت و نصب پایتون در macOS وجود دارد. نسخه‌های از پیش ساخته‌شده‌ی جدیدترین نسخه‌های پایتون از تعدادی توزیع‌کننده در دسترس هستند. بخش عمده‌ی این سند به استفاده از پایتون‌هایی می‌پردازد که تیم انتشار سی‌پایتون آن‌ها را برای دانلود از `وب‌سایت python.org `_ ارائه کرده است. برای برخی گزینه‌های دیگر، :ref:`alternative_bundles` را ببینید." msgid "Using Python for macOS from ``python.org``" msgstr "استفاده از پایتون برای مک‌او‌اس از ``python.org``" msgid "Installation steps" msgstr "مراحل نصب" msgid "For `current Python versions `_ (other than those in ``security`` status), the release team produces a **Python for macOS** installer package for each new release. A list of available installers is available `here `_. We recommend using the most recent supported Python version where possible. Current installers provide a `universal2 binary `_ build of Python which runs natively on all Macs (Apple Silicon and Intel) that are supported by a wide range of macOS versions, currently typically from at least **macOS 10.15 Catalina** on." msgstr "برای `نسخه‌های فعلی پایتون `_ (به‌جز نسخه‌هایی که در وضعیت ``security`` قرار دارند)، تیم انتشار برای هر انتشار جدید یک بسته‌ی نصب‌کننده‌ی **Python for macOS** تولید می‌کند. فهرستی از نصب‌کننده‌های موجود `اینجا `_ در دسترس است. توصیه می‌کنیم در صورت امکان، از جدیدترین نسخه‌ی پشتیبانی‌شده‌ی پایتون استفاده کنید. نصب‌کننده‌های فعلی، یک ساخت‌ `دودوییِ universal2 `_ از پایتون ارائه می‌دهند که به‌طور بومی روی همه‌ی مک‌ها (Apple Silicon و Intel) اجرا می‌شود؛ مک‌هایی که توسط طیف گسترده‌ای از نسخه‌های macOS — در حال حاضر معمولاً از حداقل **macOS 10.15 Catalina** به بعد — پشتیبانی می‌شوند." msgid "The downloaded file is a standard macOS installer package file (``.pkg``). File integrity information (checksum, size, sigstore signature, etc) for each file is included on the release download page. Installer packages and their contents are signed and notarized with ``Python Software Foundation`` Apple Developer ID certificates to meet `macOS Gatekeeper requirements `_." msgstr "پرونده دانلود‌شده یک پرونده بسته نصب استاندارد macOS است (``.pkg``). اطلاعات یکپارچگی پرونده (جمع‌آزما، اندازه، امضای sigstore و غیره) برای هر پرونده در صفحه دانلود نسخه گنجانده شده است. بسته‌های نصب و محتویات آن‌ها با گواهی‌های Apple Developer ID متعلق به ``Python Software Foundation`` امضا و نوتاری‌سازی (notarized) شده‌اند تا `الزامات macOS Gatekeeper `_ برآورده شوند." msgid "For a default installation, double-click on the downloaded installer package file. This should launch the standard macOS Installer app and display the first of several installer windows steps." msgstr "برای نصب پیش‌فرض، روی پرونده‌ی بسته‌ی نصب‌کننده‌ی دانلود‌شده دوبار کلیک کنید. این کار باید برنامه‌ی استاندارد Installer در macOS را اجرا کند و نخستین مرحله از چندین مرحله‌ی پنجره‌های نصب‌کننده را نمایش دهد." msgid "Clicking on the **Continue** button brings up the **Read Me** for this installer. Besides other important information, the **Read Me** documents which Python version is going to be installed and on what versions of macOS it is supported. You may need to scroll through to read the whole file. By default, this **Read Me** will also be installed in |applications_python_version_literal| and available to read anytime." msgstr "با کلیک روی دکمه‌ی **Continue**، **Read Me** این نصب‌کننده نمایش داده می‌شود. **Read Me** در کنار سایر اطلاعات مهم، شرح می‌دهد که کدام نسخه‌ی پایتون قرار است نصب شود و روی کدام نسخه‌های macOS پشتیبانی می‌شود. ممکن است برای خواندن کل پرونده، لازم باشد آن را اسکرول کنید. به‌طور پیش‌فرض، این **Read Me** همچنین در |applications_python_version_literal| نصب خواهد شد و هر زمان که بخواهید قابل مطالعه خواهد بود." msgid "Clicking on **Continue** proceeds to display the license for Python and for other included software. You will then need to **Agree** to the license terms before proceeding to the next step. This license file will also be installed and available to be read later." msgstr "با کلیک روی **Continue**، مجوز پایتون و سایر نرم‌افزارهای همراه نمایش داده می‌شود. سپس پیش از ادامه به گام بعدی، باید برای موافقت با شرایط مجوز روی **Agree** کلیک کنید. این پرونده مجوز نیز نصب خواهد شد و بعداً برای مطالعه در دسترس خواهد بود." msgid "After the license terms are accepted, the next step is the **Installation Type** display. For most uses, the standard set of installation operations is appropriate." msgstr "پس از پذیرفته شدن شرایط مجوز، گام بعدی نمایش **Installation Type** است. برای بیشتر کاربردها، مجموعه استاندارد عملیات‌های نصب مناسب است." msgid "By pressing the **Customize** button, you can choose to omit or select certain package components of the installer. Click on each package name to see a description of what it installs. To also install support for the optional free-threaded feature, see :ref:`install-freethreaded-macos`." msgstr "با فشردن دکمه‌ی **Customize** می‌توانید برخی از اجزای بسته‌ی نصب‌کننده را حذف کرده یا انتخاب کنید. روی نام هر بسته کلیک کنید تا توضیحی درباره‌ی آنچه نصب می‌کند ببینید. برای اینکه پشتیبانی از قابلیت اختیاری نخ‌آزاد را نیز نصب کنید، به :ref:`install-freethreaded-macos` مراجعه کنید." msgid "In either case, clicking **Install** will begin the install process by asking permission to install new software. A macOS user name with ``Administrator`` privilege is needed as the installed Python will be available to all users of the Mac." msgstr "در هر دو حالت، کلیک روی **Install** فرایند نصب را با درخواست مجوز برای نصب نرم‌افزار جدید آغاز می‌کند. نام کاربری macOS با امتیاز ``Administrator`` لازم است، زیرا پایتون نصب‌شده برای همه‌ی کاربران مک در دسترس خواهد بود." msgid "When the installation is complete, the **Summary** window will appear." msgstr "پس از اتمام نصب، پنجره‌ی **Summary** نمایش داده می‌شود." msgid "Double-click on the :command:`Install Certificates.command` icon or file in the |applications_python_version_literal| window to complete the installation." msgstr "برای تکمیل نصب، روی نماد یا پرونده‌ی :command:`Install Certificates.command` در پنجره‌ی |applications_python_version_literal| دوبار کلیک کنید." msgid "This will open a temporary :program:`Terminal` shell window that will use the new Python to download and install SSL root certificates for its use." msgstr "این کار یک پنجره‌ی پوسته‌ی موقت :program:`Terminal` باز می‌کند که با استفاده از پایتون جدید، گواهی‌های ریشه‌ی SSL را برای استفاده‌ی خود دانلود و نصب می‌کند." msgid "If ``Successfully installed certifi`` and ``update complete`` appears in the terminal window, the installation is complete. Close this terminal window and the installer window." msgstr "اگر ``Successfully installed certifi`` و ``update complete`` در پنجره‌ی پایانه ظاهر شد، نصب کامل شده است. این پنجره‌ی پایانه و پنجره‌ی نصاب را ببندید." msgid "A default install will include:" msgstr "نصب پیش‌فرض شامل موارد زیر خواهد بود:" msgid "A |python_version_literal| folder in your :file:`Applications` folder. In here you find :program:`IDLE`, the development environment that is a standard part of official Python distributions; and :program:`Python Launcher`, which handles double-clicking Python scripts from the macOS `Finder `_." msgstr "پوشه‌ی |python_version_literal| در پوشه‌ی :file:`Applications` شما. در این پوشه :program:`IDLE` را می‌یابید؛ محیط توسعه‌ای که بخش استانداردی از توزیع‌های رسمی پایتون است؛ و :program:`Python Launcher` را که دابل‌کلیک کردن اسکریپت‌های پایتون از `Finder `_ مک‌اواس را مدیریت می‌کند." msgid "A framework :file:`/Library/Frameworks/Python.framework`, which includes the Python executable and libraries. The installer adds this location to your shell path. To uninstall Python, you can remove these three things. Symlinks to the Python executable are placed in :file:`/usr/local/bin/`." msgstr "یک چارچوب :file:`/Library/Frameworks/Python.framework` که شامل پرونده اجرایی پایتون و کتابخانه‌ها است. نصب‌کننده این مکان را به مسیر پوسته‌ی شما اضافه می‌کند. برای لغو نصب پایتون، می‌توانید این سه مورد را حذف کنید. پیوندهای نمادین به پرونده اجرایی پایتون در :file:`/usr/local/bin/` قرار می‌گیرند." msgid "Recent versions of macOS include a :command:`python3` command in :file:`/usr/bin/python3` that links to a usually older and incomplete version of Python provided by and for use by the Apple development tools, :program:`Xcode` or the :program:`Command Line Tools for Xcode`. You should never modify or attempt to delete this installation, as it is Apple-controlled and is used by Apple-provided or third-party software. If you choose to install a newer Python version from ``python.org``, you will have two different but functional Python installations on your computer that can co-exist. The default installer options should ensure that its :command:`python3` will be used instead of the system :command:`python3`." msgstr "نسخه‌های اخیر macOS شامل فرمان :command:`python3` در :file:`/usr/bin/python3` هستند که به نسخه‌ای معمولاً قدیمی‌تر و ناقص از پایتون پیوند دارد؛ نسخه‌ای که توسط ابزارهای توسعه Apple، یعنی :program:`Xcode` یا :program:`Command Line Tools for Xcode`، فراهم شده و برای استفاده‌ی آن‌هاست. هرگز نباید این نصب را تغییر دهید یا تلاش کنید آن را حذف کنید، زیرا این نصب تحت کنترل Apple است و نرم‌افزارهای ارائه‌شده توسط Apple یا نرم‌افزارهای شخص ثالث از آن استفاده می‌کنند. اگر تصمیم بگیرید نسخه‌ی جدیدتری از پایتون را از ``python.org`` نصب کنید، دو نصب متفاوت اما کارآمد از پایتون روی رایانه‌ی خود خواهید داشت که می‌توانند در کنار هم وجود داشته باشند. گزینه‌های پیش‌فرض نصاب باید تضمین کنند که :command:`python3` آن به‌جای :command:`python3` سیستم استفاده خواهد شد." msgid "How to run a Python script" msgstr "نحوه اجرای یک اسکریپت پایتون" msgid "There are two ways to invoke the Python interpreter. If you are familiar with using a Unix shell in a terminal window, you can invoke |python_x_dot_y_literal| or ``python3`` optionally followed by one or more command line options (described in :ref:`using-on-general`). The Python tutorial also has a useful section on :ref:`using Python interactively from a shell `." msgstr "دو راه برای فراخوانی مفسر پایتون وجود دارد. اگر با استفاده از پوسته‌ی یونیکس در پنجره‌ی پایانه آشنا هستید، می‌توانید |python_x_dot_y_literal| یا ``python3`` را فراخوانی کنید که به‌اختیار می‌توانند با یک یا چند گزینه‌ی خط فرمان همراه شوند (در :ref:`using-on-general` شرح داده شده‌اند). آموزش پایتون نیز بخش مفیدی درباره‌ی :ref:`استفاده‌ی تعاملی از پایتون در پوسته ` دارد." msgid "You can also invoke the interpreter through an integrated development environment. :ref:`idle` is a basic editor and interpreter environment which is included with the standard distribution of Python. :program:`IDLE` includes a Help menu that allows you to access Python documentation. If you are completely new to Python, you can read the tutorial introduction in that document." msgstr "همچنین می‌توانید مفسر را از طریق یک محیط توسعه یکپارچه فراخوانی کنید. :ref:`idle` یک ویرایشگر و محیط مفسر پایه است که همراه با توزیع استاندارد پایتون ارائه می‌شود. :program:`IDLE` شامل منوی راهنما (Help) است که به شما امکان می‌دهد به مستندات پایتون دسترسی داشته باشید. اگر کاملاً تازه‌کار در پایتون هستید، می‌توانید مقدمه‌ی آموزشی را در آن سند بخوانید." msgid "There are many other editors and IDEs available, see :ref:`editors` for more information." msgstr "ویرایشگر‌ها و IDE‌های بسیاری دیگر در دسترس هستند؛ برای اطلاعات بیشتر به :ref:`editors` مراجعه کنید." msgid "To run a Python script file from the terminal window, you can invoke the interpreter with the name of the script file:" msgstr "برای اجرای یک پرونده اسکریپت پایتون از پنجره پایانه، می‌توانید مفسر را با نام پرونده اسکریپت فراخوانی کنید:" msgid "|python_x_dot_y_literal| ``myscript.py``" msgstr "|python_x_dot_y_literal| ``myscript.py``" msgid "To run your script from the Finder, you can either:" msgstr "برای اجرای اسکریپت خودتان از Finder، می‌توانید یکی از این دو کار را انجام دهید:" msgid "Drag it to :program:`Python Launcher`." msgstr "آن را به :program:`Python Launcher` بکشید." msgid "Select :program:`Python Launcher` as the default application to open your script (or any ``.py`` script) through the Finder Info window and double-click it. :program:`Python Launcher` has various preferences to control how your script is launched. Option-dragging allows you to change these for one invocation, or use its ``Preferences`` menu to change things globally." msgstr "از طریق پنجره اطلاعات Finder، :program:`Python Launcher` را به‌عنوان برنامه پیش‌فرض برای باز کردن اسکریپت خود (یا هر اسکریپت ``.py``) انتخاب کنید و روی آن دوبار کلیک کنید. :program:`Python Launcher` تنظیمات گوناگونی برای کنترل نحوه راه‌اندازی اسکریپت شما دارد. کشیدن همراه با نگه‌داشتن کلید Option به شما امکان می‌دهد این تنظیمات را برای یک اجرا تغییر دهید، یا از منوی ``Preferences`` آن برای اعمال تغییرات به‌صورت سراسری استفاده کنید." msgid "Be aware that running the script directly from the macOS Finder might produce different results than when running from a terminal window as the script will not be run in the usual shell environment including any setting of environment variables in shell profiles. And, as with any other script or program, be certain of what you are about to run." msgstr "آگاه باشید که اجرای مستقیم اسکریپت از Finder در macOS ممکن است نتایجی متفاوت نسبت به اجرای آن از طریق یک پنجره پایانه به دست دهد، زیرا اسکریپت در محیط معمول پوسته، از جمله هر تنظیمی از متغیرهای محیطی در پروفایل‌های پوسته، اجرا نخواهد شد. و همانند هر اسکریپت یا برنامه دیگری، از چیزی که می‌خواهید اجرا کنید مطمئن باشید." msgid "Alternative Distributions" msgstr "توزیع‌های جایگزین" msgid "Besides the standard ``python.org`` for macOS installer, there are third-party distributions for macOS that may include additional functionality. Some popular distributions and their key features:" msgstr "علاوه بر نصب‌کننده استاندارد ``python.org`` برای macOS، توزیع‌های شخص ثالثی برای macOS وجود دارند که ممکن است قابلیت‌های اضافی داشته باشند. برخی از توزیع‌های محبوب و ویژگی‌های کلیدی آن‌ها:" msgid "`ActivePython `_" msgstr "`ActivePython `_" msgid "Installer with multi-platform compatibility, documentation" msgstr "نصب‌کننده با سازگاری چندسکویی، مستندات" msgid "`Anaconda `_" msgstr "`Anaconda `_" msgid "Popular scientific modules (such as numpy, scipy, and pandas) and the ``conda`` package manager." msgstr "ماژول‌های علمی محبوب (مانند numpy، scipy و pandas) و مدیر بسته ``conda``." msgid "`Homebrew `_" msgstr "`Homebrew `_" msgid "Package manager for macOS including multiple versions of Python and many third-party Python-based packages (including numpy, scipy, and pandas)." msgstr "مدیر بسته برای macOS که شامل نسخه‌های متعدد پایتون و بسیاری از بسته‌های شخص ثالث مبتنی بر پایتون (از جمله numpy، scipy و pandas) است." msgid "`MacPorts `_" msgstr "`MacPorts `_" msgid "Another package manager for macOS including multiple versions of Python and many third-party Python-based packages. May include pre-built versions of Python and many packages for older versions of macOS." msgstr "یک مدیر بسته‌ی دیگر برای macOS که شامل چندین نسخه از پایتون و بسیاری از بسته‌های شخص ثالث مبتنی بر پایتون است. ممکن است شامل نسخه‌های پیش‌ساخته‌ی پایتون و بسیاری از بسته‌ها برای نسخه‌های قدیمی‌تر macOS باشد." msgid "Note that distributions might not include the latest versions of Python or other libraries, and are not maintained or supported by the core Python team." msgstr "توجه داشته باشید که توزیع‌ها ممکن است شامل جدیدترین نسخه‌های پایتون یا کتابخانه‌های دیگر نباشند و توسط تیم اصلی پایتون نگهداری یا پشتیبانی نمی‌شوند." msgid "Installing Additional Python Packages" msgstr "نصب بسته‌های اضافی پایتون" msgid "Refer to the `Python Packaging User Guide`_ for more information." msgstr "برای اطلاعات بیشتر به `Python Packaging User Guide`_ مراجعه کنید." msgid "GUI Programming" msgstr "برنامه‌نویسی رابط کاربری گرافیکی" msgid "There are several options for building GUI applications on the Mac with Python." msgstr "چندین گزینه برای ساخت برنامه‌های رابط کاربری گرافیکی (GUI) روی مک با پایتون وجود دارد." msgid "The standard Python GUI toolkit is :mod:`tkinter`, based on the cross-platform Tk toolkit (https://www.tcl.tk). A macOS-native version of Tk is included with the installer." msgstr "جعبه‌ابزار رابط گرافیکی کاربر استاندارد پایتون، :mod:`tkinter` است که بر پایه‌ی جعبه‌ابزار چندسکویی Tk (https://www.tcl.tk) ساخته شده است. نسخه‌ی بومی Tk برای macOS همراه با نصب‌کننده ارائه می‌شود." msgid "*PyObjC* is a Python binding to Apple's Objective-C/Cocoa framework. Information on PyObjC is available from :pypi:`pyobjc`." msgstr "*PyObjC* یک مقیدسازی پایتون برای چارچوب Objective-C/Cocoa اپل است. اطلاعات درباره‌ی PyObjC از طریق :pypi:`pyobjc` در دسترس است." msgid "A number of alternative macOS GUI toolkits are available including:" msgstr "تعدادی از جعبه‌ابزارهای رابط گرافیکی کاربر (GUI) جایگزین برای macOS در دسترس هستند، از جمله:" msgid "`PySide `_: Official Python bindings to the `Qt GUI toolkit `_." msgstr "`PySide `_: پیوندهای رسمی پایتون به `جعبه‌ابزار گرافیکی Qt `_." msgid "`PyQt `_: Alternative Python bindings to Qt." msgstr "`PyQt `_: پیوندهای جایگزین پایتون برای Qt." msgid "`Kivy `_: A cross-platform GUI toolkit that supports desktop and mobile platforms." msgstr "`Kivy `_: یک مجموعه ابزار رابط کاربری گرافیکی چندسکویی که از پلتفرم‌های دسکتاپ و موبایل پشتیبانی می‌کند." msgid "`Toga `_: Part of the `BeeWare Project `_; supports desktop, mobile, web and console apps." msgstr "`Toga `_: بخشی از `پروژه BeeWare `_ است؛ از برنامه‌های دسکتاپ، موبایل، وب و کنسول پشتیبانی می‌کند." msgid "`wxPython `_: A cross-platform toolkit that supports desktop operating systems." msgstr "`wxPython `_: مجموعه ابزار چندسکویی که از سیستم‌عامل‌های دسکتاپ پشتیبانی می‌کند." msgid "Advanced Topics" msgstr "مباحث پیشرفته" msgid "Installing Free-threaded Binaries" msgstr "نصب دودویی‌های نخ‌آزاد" msgid "The ``python.org`` :ref:`Python for macOS ` installer package can optionally install an additional build of Python |version| that supports :pep:`703`, the free-threading feature (running with the :term:`global interpreter lock` disabled). Check the release page on ``python.org`` for possible updated information." msgstr "بسته‌ی نصب‌کننده‌ی :ref:`پایتون برای macOS ` در ``python.org`` می‌تواند به‌صورت اختیاری یک ساخت اضافی از پایتون |version| را نصب کند که از :pep:`703`، یعنی قابلیت نخ‌بندی آزاد (اجرا با :term:`قفل مفسر سراسری ` غیرفعال)، پشتیبانی می‌کند. صفحه‌ی انتشار در ``python.org`` را برای اطلاعات احتمالیِ به‌روز بررسی کنید." msgid "The free-threaded mode is working and continues to be improved, but there is some additional overhead in single-threaded workloads compared to the regular build. Additionally, third-party packages, in particular ones with an :term:`extension module`, may not be ready for use in a free-threaded build, and will re-enable the :term:`GIL`. Therefore, the support for free-threading is not installed by default. It is packaged as a separate install option, available by clicking the **Customize** button on the **Installation Type** step of the installer as described above." msgstr "حالت نخ‌آزاد کار می‌کند و بهبود آن همچنان ادامه دارد، اما در مقایسه با ساخت‌ معمولی، در بارهای کاری تک‌نخی مقداری سربار اضافی وجود دارد. علاوه بر این، بسته‌های شخص ثالث، به‌ویژه بسته‌هایی که دارای :term:`ماژول توسعه‌ای ` هستند، ممکن است برای استفاده در ساخت‌ نخ‌آزاد آماده نباشند و :term:`قفل مفسر سراسری ` را دوباره فعال خواهند کرد. بنابراین، پشتیبانی از نخ‌بندی آزاد به‌صورت پیش‌فرض نصب نمی‌شود. این پشتیبانی به‌عنوان یک گزینه نصب جداگانه بسته‌بندی شده است و مطابق توضیحات بالا، با کلیک روی دکمه‌ی **Customize** در مرحله‌ی **Installation Type** نصب‌کننده در دسترس است." msgid "If the box next to the **Free-threaded Python** package name is checked, a separate :file:`PythonT.framework` will also be installed alongside the normal :file:`Python.framework` in :file:`/Library/Frameworks`. This configuration allows a free-threaded Python |version| build to co-exist on your system with a traditional (GIL only) Python |version| build with minimal risk while installing or testing. This installation layout may change in future releases." msgstr "اگر کادر کنار نام بسته‌ی **Free-threaded Python** علامت‌گذاری شده باشد، یک :file:`PythonT.framework` جداگانه نیز در کنار :file:`Python.framework` معمولی در :file:`/Library/Frameworks` نصب خواهد شد. این پیکربندی اجازه می‌دهد نسخه‌ای از پایتون نخ‌آزاد |version| در حین نصب یا آزمایش، با کمترین ریسک در کنار نسخه‌ای از پایتون سنتی |version| (فقط با قفل مفسر سراسری) روی سیستم شما هم‌زیستی کند. این چیدمان نصب ممکن است در نسخه‌های آینده تغییر کند." msgid "Known cautions and limitations:" msgstr "هشدارها و محدودیت‌های شناخته‌شده:" msgid "The **UNIX command-line tools** package, which is selected by default, will install links in :file:`/usr/local/bin` for |python_x_dot_y_t_literal|, the free-threaded interpreter, and |python_x_dot_y_t_literal_config|, a configuration utility which may be useful for package builders. Since :file:`/usr/local/bin` is typically included in your shell ``PATH``, in most cases no changes to your ``PATH`` environment variables should be needed to use |python_x_dot_y_t_literal|." msgstr "بسته‌ی **UNIX command-line tools** که به‌طور پیش‌فرض انتخاب شده است، پیوندهایی را در :file:`/usr/local/bin` برای |python_x_dot_y_t_literal| (مفسر نخ‌آزاد) و |python_x_dot_y_t_literal_config| (ابزار پیکربندی که ممکن است برای سازندگان بسته مفید باشد) نصب می‌کند. از آنجا که :file:`/usr/local/bin` معمولاً در ``PATH`` پوسته‌ی شما قرار دارد، در بیشتر موارد برای استفاده از |python_x_dot_y_t_literal| نیازی به تغییر متغیرهای محیطی ``PATH`` شما نخواهد بود." msgid "For this release, the **Shell profile updater** package and the :file:`Update Shell Profile.command` in |applications_python_version_literal| do not support the free-threaded package." msgstr "برای این نسخه، بسته‌ی **به‌روزرسان پروفایل پوسته (Shell profile updater)** و :file:`Update Shell Profile.command` در |applications_python_version_literal| از بسته‌ی نخ‌آزاد پشتیبانی نمی‌کنند." msgid "The free-threaded build and the traditional build have separate search paths and separate :file:`site-packages` directories so, by default, if you need a package available in both builds, it may need to be installed in both. The free-threaded package will install a separate instance of :program:`pip` for use with |python_x_dot_y_t_literal|." msgstr "ساخت‌ نخ‌آزاد و ساخت‌ سنتی مسیرهای جست‌وجوی جداگانه و پوشه‌های :file:`site-packages` جداگانه دارند؛ بنابراین، به‌طور پیش‌فرض، اگر به بسته‌ای نیاز دارید که در هر دو ساخت‌ در دسترس باشد، ممکن است لازم باشد در هر دو نصب شود. بسته‌ی نخ‌آزاد یک نمونه‌ی جداگانه از :program:`pip` را برای استفاده همراه با |python_x_dot_y_t_literal| نصب می‌کند." msgid "To install a package using :command:`pip` without a :command:`venv`:" msgstr "برای نصب یک بسته با استفاده از :command:`pip` بدون :command:`venv`:" msgid "python\\ |version|\\ t -m pip install " msgstr "python\\ |version|\\ t -m pip install " msgid "When working with multiple Python environments, it is usually safest and easiest to :ref:`create and use virtual environments `. This can avoid possible command name conflicts and confusion about which Python is in use:" msgstr "هنگام کار با چندین محیط پایتون، معمولاً ایمن‌ترین و ساده‌ترین کار این است که :ref:`محیط‌های مجازی ایجاد کنید و از آن‌ها استفاده کنید `. این کار می‌تواند از تداخل‌های احتمالی در نام فرمان‌ها و سردرگمی درباره‌ی اینکه کدام پایتون در حال استفاده است جلوگیری کند:" msgid "python\\ |version|\\ t -m venv " msgstr "python\\ |version|\\ t -m venv " msgid "then :command:`activate`." msgstr "سپس :command:`activate`." msgid "To run a free-threaded version of IDLE:" msgstr "برای اجرای نسخه‌ی نخ‌آزاد IDLE:" msgid "python\\ |version|\\ t -m idlelib" msgstr "python\\ |version|\\ t -m idlelib" msgid "The interpreters in both builds respond to the same :ref:`PYTHON environment variables ` which may have unexpected results, for example, if you have ``PYTHONPATH`` set in a shell profile. If necessary, there are :ref:`command line options ` like ``-E`` to ignore these environment variables." msgstr "مفسرهای هر دو ساخت‌ به همان :ref:`متغیرهای محیطی PYTHON ` پاسخ می‌دهند که ممکن است نتایج غیرمنتظره‌ای در پی داشته باشد، برای مثال، اگر ``PYTHONPATH`` را در یک پروفایل پوسته تنظیم کرده باشید. در صورت نیاز، :ref:`گزینه‌های خط فرمان ` مانند ``-E`` برای نادیده گرفتن این متغیرهای محیطی وجود دارند." msgid "The free-threaded build links to the third-party shared libraries, such as ``OpenSSL`` and ``Tk``, installed in the traditional framework. This means that both builds also share one set of trust certificates as installed by the :command:`Install Certificates.command` script, thus it only needs to be run once." msgstr "ساخت‌ نخ‌آزاد به کتابخانه‌های اشتراکی شخص ثالث، مانند ``OpenSSL`` و ``Tk``، که در چارچوب سنتی نصب شده‌اند پیوند می‌شود. این بدان معناست که هر دو ساخت‌ همچنین یک مجموعه واحد از گواهی‌های اعتمادی را که توسط اسکریپت :command:`Install Certificates.command` نصب شده‌اند به اشتراک می‌گذارند؛ بنابراین تنها لازم است یک بار اجرا شود." msgid "If you cannot depend on the link in ``/usr/local/bin`` pointing to the ``python.org`` free-threaded |python_x_dot_y_t_literal| (for example, if you want to install your own version there or some other distribution does), you can explicitly set your shell ``PATH`` environment variable to include the ``PythonT`` framework ``bin`` directory:" msgstr "اگر نمی‌توانید مطمئن باشید که پیوند موجود در ``/usr/local/bin`` به |python_x_dot_y_t_literal| نخ‌آزاد ``python.org`` اشاره می‌کند (برای مثال، اگر بخواهید نسخه‌ی خودتان را در آنجا نصب کنید یا توزیع دیگری این کار را انجام داده باشد)، می‌توانید به‌طور صریح متغیر محیطی ``PATH`` پوسته‌ی خود را طوری تنظیم کنید که پوشه‌ی ``bin`` چارچوب ``PythonT`` را در بر بگیرد:" msgid "export PATH=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /bin\":\"$PATH\"" msgstr "export PATH=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /bin\":\"$PATH\"" msgid "The traditional framework installation by default does something similar, except for :file:`Python.framework`. Be aware that having both framework ``bin`` directories in ``PATH`` can lead to confusion if there are duplicate names like |python_x_dot_y_literal| in both; which one is actually used depends on the order they appear in ``PATH``. The ``which python3.x`` or ``which python3.xt`` commands can show which path is being used. Using virtual environments can help avoid such ambiguities. Another option might be to create a shell :command:`alias` to the desired interpreter, like:" msgstr "نصب چارچوب به روش سنتی به‌طور پیش‌فرض کاری مشابه انجام می‌دهد، به‌جز :file:`Python.framework`. آگاه باشید که اگر نام‌های تکراری مانند |python_x_dot_y_literal| در هر دو وجود داشته باشند، داشتن هر دو پوشه‌ی ``bin`` چارچوب در ``PATH`` می‌تواند باعث سردرگمی شود؛ اینکه کدام‌یک در واقع استفاده می‌شود، به ترتیبی که در ``PATH`` ظاهر می‌شوند بستگی دارد. دستورهای ``which python3.x`` یا ``which python3.xt`` می‌توانند نشان دهند که کدام مسیر در حال استفاده است. استفاده از محیط‌های مجازی می‌تواند به پرهیز از چنین ابهام‌هایی کمک کند. گزینه‌ی دیگر ممکن است ایجاد یک :command:`alias` در پوسته برای مفسر دلخواه باشد، مانند:" msgid "" "alias py\\ |version|\\ =\"/Library/Frameworks/Python.framework/Versions/\\ |version|\\ /bin/python\\ |version|\\ \"\n" "alias py\\ |version|\\ t=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /bin/python\\ |version|\\ t\"" msgstr "" "alias py\\ |version|\\ =\"/Library/Frameworks/Python.framework/Versions/\\ |version|\\ /bin/python\\ |version|\\ \"\n" "alias py\\ |version|\\ t=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /bin/python\\ |version|\\ t\"" msgid "Installing using the command line" msgstr "نصب با استفاده از خط فرمان" msgid "If you want to use automation to install the ``python.org`` installer package (rather than by using the familiar macOS :program:`Installer` GUI app), the macOS command line :command:`installer` utility lets you select non-default options, too. If you are not familiar with :command:`installer`, it can be somewhat cryptic (see :command:`man installer` for more information). As an example, the following shell snippet shows one way to do it, using the |x_dot_y_b2_literal| release and selecting the free-threaded interpreter option:" msgstr "اگر می‌خواهید برای نصب بسته‌ی نصب‌کننده‌ی ``python.org`` از خودکارسازی استفاده کنید (به‌جای استفاده از برنامه‌ی گرافیکی آشنای :program:`Installer` در macOS)، ابزار :command:`installer` در خط فرمان macOS به شما امکان می‌دهد گزینه‌های غیرپیش‌فرض را نیز انتخاب کنید. اگر با :command:`installer` آشنایی ندارید، ممکن است تا حدی گنگ باشد (برای اطلاعات بیشتر، :command:`man installer` را ببینید). به‌عنوان مثال، قطعه‌کد پوسته‌ی زیر یکی از راه‌های انجام این کار را با استفاده از نسخه‌ی |x_dot_y_b2_literal| و انتخاب گزینه‌ی مفسر نخ‌آزاد نشان می‌دهد:" msgid "" "RELEASE=\"python-\\ |version|\\ 0b2-macos11.pkg\"\n" "\n" "# download installer pkg\n" "curl -O \\https://www.python.org/ftp/python/\\ |version|\\ .0/${RELEASE}\n" "\n" "# create installer choicechanges to customize the install:\n" "# enable the PythonTFramework-\\ |version|\\ package\n" "# while accepting the other defaults (install all other packages)\n" "cat > ./choicechanges.plist <\n" "\n" "\n" "\n" " \n" " attributeSetting\n" " 1\n" " choiceAttribute\n" " selected\n" " choiceIdentifier\n" " org.python.Python.PythonTFramework-\\ |version|\\ \n" " \n" "\n" "\n" "EOF\n" "\n" "sudo installer -pkg ./${RELEASE} -applyChoiceChangesXML ./choicechanges.plist -target /" msgstr "" "RELEASE=\"python-\\ |version|\\ 0b2-macos11.pkg\"\n" "\n" "# download installer pkg\n" "curl -O \\https://www.python.org/ftp/python/\\ |version|\\ .0/${RELEASE}\n" "\n" "# create installer choicechanges to customize the install:\n" "# enable the PythonTFramework-\\ |version|\\ package\n" "# while accepting the other defaults (install all other packages)\n" "cat > ./choicechanges.plist <\n" "\n" "\n" "\n" " \n" " attributeSetting\n" " 1\n" " choiceAttribute\n" " selected\n" " choiceIdentifier\n" " org.python.Python.PythonTFramework-\\ |version|\\ \n" " \n" "\n" "\n" "EOF\n" "\n" "sudo installer -pkg ./${RELEASE} -applyChoiceChangesXML ./choicechanges.plist -target /" msgid "You can then test that both installer builds are now available with something like:" msgstr "سپس می‌توانید با چیزی شبیه به موارد زیر آزمون کنید که هر دو ساخت‌ نصب‌کننده اکنون در دسترس هستند:" msgid "" "$ # test that the free-threaded interpreter was installed if the Unix Command Tools package was enabled\n" "$ /usr/local/bin/python\\ |version|\\ t -VV\n" "Python \\ |version|\\ .0b2 free-threading build (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ # and the traditional interpreter\n" "$ /usr/local/bin/python\\ |version|\\ -VV\n" "Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ # test that they are also available without the prefix if /usr/local/bin is on $PATH\n" "$ python\\ |version|\\ t -VV\n" "Python \\ |version|\\ .0b2 free-threading build (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ python\\ |version|\\ -VV\n" "Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]" msgstr "" "$ # test that the free-threaded interpreter was installed if the Unix Command Tools package was enabled\n" "$ /usr/local/bin/python\\ |version|\\ t -VV\n" "Python \\ |version|\\ .0b2 free-threading build (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ # and the traditional interpreter\n" "$ /usr/local/bin/python\\ |version|\\ -VV\n" "Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ # test that they are also available without the prefix if /usr/local/bin is on $PATH\n" "$ python\\ |version|\\ t -VV\n" "Python \\ |version|\\ .0b2 free-threading build (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]\n" "$ python\\ |version|\\ -VV\n" "Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]" msgid "Current ``python.org`` installers only install to fixed locations like :file:`/Library/Frameworks/`, :file:`/Applications`, and :file:`/usr/local/bin`. You cannot use the :command:`installer` ``-domain`` option to install to other locations." msgstr "نصب‌کننده‌های فعلی ``python.org`` فقط در مکان‌های ثابتی مانند :file:`/Library/Frameworks/`، :file:`/Applications` و :file:`/usr/local/bin` نصب می‌کنند. شما نمی‌توانید از گزینه ``-domain`` دستور :command:`installer` برای نصب در مکان‌های دیگر استفاده کنید." msgid "Distributing Python Applications" msgstr "توزیع برنامه‌های پایتون" msgid "A range of tools exist for converting your Python code into a standalone distributable application:" msgstr "طیفی از ابزارها برای تبدیل کد پایتون شما به یک برنامه‌ی مستقل و قابل توزیع وجود دارد:" msgid ":pypi:`py2app`: Supports creating macOS ``.app`` bundles from a Python project." msgstr ":pypi:`py2app`: ساخت بسته‌های ``.app`` macOS از یک پروژه‌ی پایتون را پشتیبانی می‌کند." msgid "`Briefcase `_: Part of the `BeeWare Project `_; a cross-platform packaging tool that supports creation of ``.app`` bundles on macOS, as well as managing signing and notarization." msgstr "`Briefcase `_: بخشی از پروژه `BeeWare `_؛ ابزار بسته‌بندی چندسکویی که از ایجاد بسته‌های ``.app`` در macOS و همچنین مدیریت امضا و تأیید رسمی (notarization) پشتیبانی می‌کند." msgid "`PyInstaller `_: A cross-platform packaging tool that creates a single file or folder as a distributable artifact." msgstr "`PyInstaller `_: ابزار بسته‌بندی چندسکویی که یک پرونده یا پوشه‌ی واحد را به‌عنوان یک مصنوع توزیع‌پذیر (distributable artifact) ایجاد می‌کند." msgid "App Store Compliance" msgstr "انطباق با App Store" msgid "Apps submitted for distribution through the macOS App Store must pass Apple's app review process. This process includes a set of automated validation rules that inspect the submitted application bundle for problematic code." msgstr "اپلیکیشن‌هایی که برای توزیع از طریق macOS App Store ارسال می‌شوند، باید فرایند بررسی اپلیکیشن اپل را با موفقیت پشت سر بگذارند. این فرایند شامل مجموعه‌ای از قواعد اعتبارسنجی خودکار است که بسته اپلیکیشن ارسالی را از نظر وجود کد مشکل‌دار بررسی می‌کنند." msgid "The Python standard library contains some code that is known to violate these automated rules. While these violations appear to be false positives, Apple's review rules cannot be challenged. Therefore, it is necessary to modify the Python standard library for an app to pass App Store review." msgstr "کتابخانه استاندارد پایتون شامل کدهایی است که می‌دانیم این قوانین خودکار را نقض می‌کنند. اگرچه این نقض‌ها ظاهراً مثبت کاذب هستند، نمی‌توان قوانین بررسی اپل را به چالش کشید. بنابراین، برای اینکه یک برنامه از بررسی App Store عبور کند، لازم است که کتابخانه استاندارد پایتون تغییر داده شود." msgid "The Python source tree contains :source:`a patch file ` that will remove all code that is known to cause issues with the App Store review process. This patch is applied automatically when CPython is configured with the :option:`--with-app-store-compliance` option." msgstr "درخت منبع پایتون شامل :source:`یک پرونده وصله ` است که تمام کدهایی که مشخص است در فرایند بررسی App Store مشکل ایجاد می‌کنند را حذف خواهد کرد. این وصله به‌طور خودکار زمانی اعمال می‌شود که سی‌پایتون با گزینه‌ی :option:`--with-app-store-compliance` پیکربندی شود." msgid "This patch is not normally required to use CPython on a Mac; nor is it required if you are distributing an app *outside* the macOS App Store. It is *only* required if you are using the macOS App Store as a distribution channel." msgstr "این وصل معمولاً برای استفاده از سی‌پایتون روی مک لازم نیست؛ و اگر برنامه‌ای را *خارج از* macOS App Store توزیع می‌کنید نیز لازم نیست. این وصل *تنها* زمانی لازم است که از macOS App Store به‌عنوان کانال توزیع استفاده کنید." msgid "Other Resources" msgstr "منابع دیگر" msgid "The `python.org Help page `_ has links to many useful resources. The `Pythonmac-SIG mailing list `_ is another support resource specifically for Python users and developers on the Mac." msgstr "`صفحه‌ی راهنمای python.org `_ پیوندهایی به بسیاری از منابع مفید دارد. `فهرست پستی Pythonmac-SIG `_ منبع پشتیبانی دیگری است که به‌طور خاص برای کاربران پایتون و توسعه‌دهندگان روی مک در نظر گرفته شده است."