email.charset.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 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-15 12:24+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 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 ":mod:`!email.charset`: Representing character sets"
msgstr ":mod:`!email.charset`: بازنمایی مجموعه‌های نویسه‌ای"

msgid "**Source code:** :source:`Lib/email/charset.py`"
msgstr "**کد منبع:** :source:`Lib/email/charset.py`"

msgid "This module is part of the legacy (``Compat32``) email API.  In the new API only the aliases table is used."
msgstr "این ماژول بخشی از API ایمیل قدیمی (``Compat32``) است. در API جدید، فقط از جدول نام‌های مستعار استفاده می‌شود."

msgid "The remaining text in this section is the original documentation of the module."
msgstr "متن باقی‌مانده در این بخش، مستندات اصلی ماژول است."

msgid "This module provides a class :class:`Charset` for representing character sets and character set conversions in email messages, as well as a character set registry and several convenience methods for manipulating this registry. Instances of :class:`Charset` are used in several other modules within the :mod:`email` package."
msgstr "این ماژول یک کلاس :class:`Charset` برای بازنمایی مجموعه‌نویسه‌ها و تبدیل‌های مجموعه‌نویسه‌ها در پیام‌های ایمیل، و همچنین یک رجیستری مجموعه‌نویسه‌ها و چند متد کمکی برای دستکاری این رجیستری فراهم می‌کند. نمونه‌های :class:`Charset` در چند ماژول دیگر درون بسته :mod:`email` استفاده می‌شوند."

msgid "Import this class from the :mod:`!email.charset` module."
msgstr "این کلاس را از ماژول :mod:`!email.charset` ایمپورت کنید."

msgid "Map character sets to their email properties."
msgstr "مجموعه‌نویسه‌ها را به ویژگی‌های ایمیلی آن‌ها نگاشت می‌کند."

msgid "This class provides information about the requirements imposed on email for a specific character set.  It also provides convenience routines for converting between character sets, given the availability of the applicable codecs.  Given a character set, it will do its best to provide information on how to use that character set in an email message in an RFC-compliant way."
msgstr "این کلاس اطلاعاتی درباره الزامات تحمیل‌شده بر ایمیل برای یک مجموعه‌نویسه خاص ارائه می‌دهد. همچنین روال‌های آسان‌کننده‌ای برای تبدیل بین مجموعه‌نویسه‌ها، با توجه به دسترس‌پذیری کدک‌های مربوطه، ارائه می‌دهد. با داشتن یک مجموعه‌نویسه، این کلاس نهایت تلاش خود را می‌کند تا اطلاعاتی درباره نحوه استفاده از آن مجموعه‌نویسه در یک پیام ایمیل به شیوه‌ای منطبق با RFC ارائه دهد."

msgid "Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies.  Certain character sets must be converted outright, and are not allowed in email."
msgstr "برخی مجموعه‌های نویسه باید هنگام استفاده در سرآیندها یا بدنه‌های ایمیل با quoted-printable یا base64 کدگذاری شوند. برخی مجموعه‌های نویسه باید به‌طور کامل تبدیل شوند و در ایمیل مجاز نیستند."

msgid "Optional *input_charset* is as described below; it is always coerced to lower case.  After being alias normalized it is also used as a lookup into the registry of character sets to find out the header encoding, body encoding, and output conversion codec to be used for the character set.  For example, if *input_charset* is ``iso-8859-1``, then headers and bodies will be encoded using quoted-printable and no output conversion codec is necessary.  If *input_charset* is ``euc-jp``, then headers will be encoded with base64, bodies will not be encoded, but output text will be converted from the ``euc-jp`` character set to the ``iso-2022-jp`` character set."
msgstr "*input_charset* اختیاری همان‌گونه است که در ادامه توضیح داده شده است؛ این مقدار همیشه به حروف کوچک تبدیل می‌شود. پس از نرمال‌سازی نام مستعار، از آن برای جست‌وجو در فهرست ثبت مجموعه‌های نویسه‌ای نیز استفاده می‌شود تا کدگذاری سرآیند، کدگذاری بدنه و کدک تبدیل خروجی مورد استفاده برای آن مجموعه نویسه‌ای مشخص شود. برای مثال، اگر *input_charset* برابر ``iso-8859-1`` باشد، سرآیندها و بدنه‌ها با استفاده از quoted-printable کدگذاری می‌شوند و نیازی به کدک تبدیل خروجی نیست. اگر *input_charset* برابر ``euc-jp`` باشد، سرآیندها با base64 کدگذاری می‌شوند، بدنه‌ها کدگذاری نمی‌شوند، اما متن خروجی از مجموعه نویسه‌ای ``euc-jp`` به مجموعه نویسه‌ای ``iso-2022-jp`` تبدیل می‌شود."

msgid ":class:`Charset` instances have the following data attributes:"
msgstr "نمونه‌های :class:`Charset` دارای ویژگی‌های داده‌ای زیر هستند:"

msgid "The initial character set specified.  Common aliases are converted to their *official* email names (e.g. ``latin_1`` is converted to ``iso-8859-1``).  Defaults to 7-bit ``us-ascii``."
msgstr "مجموعه نویسه‌ی اولیه‌ی مشخص‌شده. نام‌های مستعار رایج به نام‌های ایمیلی *رسمی* خود تبدیل می‌شوند (برای مثال ``latin_1`` به ``iso-8859-1`` تبدیل می‌شود). مقدار پیش‌فرض آن ``us-ascii`` ۷ بیتی است."

msgid "If the character set must be encoded before it can be used in an email header, this attribute will be set to ``charset.QP`` (for quoted-printable), ``charset.BASE64`` (for base64 encoding), or ``charset.SHORTEST`` for the shortest of QP or BASE64 encoding. Otherwise, it will be ``None``."
msgstr "اگر لازم باشد مجموعه نویسه‌ها پیش از استفاده در سرآیند ایمیل کدگذاری شود، این ویژگی روی ``charset.QP`` (برای quoted-printable)، ``charset.BASE64`` (برای کدگذاری base64) یا ``charset.SHORTEST`` برای کوتاه‌ترین حالت بین کدگذاری QP و BASE64 تنظیم می‌شود. در غیر این صورت، ``None`` خواهد بود."

msgid "Same as *header_encoding*, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. ``charset.SHORTEST`` is not allowed for *body_encoding*."
msgstr "مشابه *header_encoding*، اما کدگذاری بدنه‌ی پیام ایمیل را توصیف می‌کند، که در واقع ممکن است با کدگذاری سرآیند متفاوت باشد. ``charset.SHORTEST`` برای *body_encoding* مجاز نیست."

msgid "Some character sets must be converted before they can be used in email headers or bodies.  If the *input_charset* is one of them, this attribute will contain the name of the character set output will be converted to. Otherwise, it will be ``None``."
msgstr "برخی مجموعه‌نویسه‌ها باید پیش از استفاده در سرآیندها یا بدنه‌های ایمیل تبدیل شوند. اگر *input_charset* یکی از آن‌ها باشد، این ویژگی شامل نام مجموعه‌نویسه‌ای خواهد بود که خروجی به آن تبدیل می‌شود. در غیر این صورت، ``None`` خواهد بود."

msgid "The name of the Python codec used to convert the *input_charset* to Unicode.  If no conversion codec is necessary, this attribute will be ``None``."
msgstr "نام کدک پایتون استفاده‌شده برای تبدیل *input_charset* به یونیکد. اگر نیازی به کدک تبدیل نباشد، این ویژگی ``None`` خواهد بود."

msgid "The name of the Python codec used to convert Unicode to the *output_charset*.  If no conversion codec is necessary, this attribute will have the same value as the *input_codec*."
msgstr "نام کدک پایتون که برای تبدیل یونیکد به *output_charset* استفاده می‌شود. اگر به کدک تبدیل نیازی نباشد، این ویژگی همان مقدار *input_codec* را خواهد داشت."

msgid ":class:`Charset` instances also have the following methods:"
msgstr "نمونه‌های :class:`Charset` همچنین دارای متدهای زیر هستند:"

msgid "Return the content transfer encoding used for body encoding."
msgstr "کدگذاری انتقال محتوا را که برای کدگذاری بدنه استفاده می‌شود، برمی‌گرداند."

msgid "This is either the string ``quoted-printable`` or ``base64`` depending on the encoding used, or it is a function, in which case you should call the function with a single argument, the Message object being encoded.  The function should then set the :mailheader:`Content-Transfer-Encoding` header itself to whatever is appropriate."
msgstr "این مقدار بسته به کدگذاری استفاده‌شده، یا رشته ``quoted-printable`` است یا ``base64``، یا یک تابع است؛ در این صورت باید تابع را با یک آرگومان فراخوانی کنید: شیء Message که کدگذاری می‌شود. سپس تابع باید خودش سرآیند :mailheader:`Content-Transfer-Encoding` را روی هر مقداری که مناسب است تنظیم کند."

msgid "Returns the string ``quoted-printable`` if *body_encoding* is ``QP``, returns the string ``base64`` if *body_encoding* is ``BASE64``, and returns the string ``7bit`` otherwise."
msgstr "اگر *body_encoding* ``QP`` باشد، رشته ``quoted-printable`` را برمی‌گرداند، اگر *body_encoding* ``BASE64`` باشد، رشته ``base64`` را برمی‌گرداند، و در غیر این صورت رشته ``7bit`` را برمی‌گرداند."

msgid "Return the output character set."
msgstr "مجموعه نویسه‌های خروجی را برمی‌گرداند."

msgid "This is the *output_charset* attribute if that is not ``None``, otherwise it is *input_charset*."
msgstr "این ویژگی *output_charset* است اگر آن ``None`` نباشد، در غیر این صورت *input_charset* است."

msgid "Header-encode the string *string*."
msgstr "رشته‌ی *string* را به‌صورت سرآیند کدگذاری کنید."

msgid "The type of encoding (base64 or quoted-printable) will be based on the *header_encoding* attribute."
msgstr "نوع کدگذاری (base64 یا quoted-printable) بر اساس ویژگی *header_encoding* خواهد بود."

msgid "Header-encode a *string* by converting it first to bytes."
msgstr "یک *string* را با تبدیل آن به بایت‌ها در ابتدا، کدگذاری سرآیند (Header-encode) کنید."

msgid "This is similar to :meth:`header_encode` except that the string is fit into maximum line lengths as given by the argument *maxlengths*, which must be an iterator: each element returned from this iterator will provide the next maximum line length."
msgstr "این مشابه :meth:`header_encode` است، با این تفاوت که رشته در حداکثر طول‌های خط داده‌شده توسط آرگومان *maxlengths*، که باید یک پیمایش‌گر باشد، جای داده می‌شود: هر عنصری که از این پیمایش‌گر بازگردانده شود، حداکثر طول خط بعدی را فراهم می‌کند."

msgid "Body-encode the string *string*."
msgstr "رشته‌ی *string* را کدگذاری بدنه کنید."

msgid "The type of encoding (base64 or quoted-printable) will be based on the *body_encoding* attribute."
msgstr "نوع کدگذاری (base64 یا quoted-printable) بر اساس ویژگی *body_encoding* خواهد بود."

msgid "The :class:`Charset` class also provides a number of methods to support standard operations and built-in functions."
msgstr "کلاس :class:`Charset` همچنین تعدادی متد برای پشتیبانی از عملیات استاندارد و توابع توکار فراهم می‌کند."

msgid "Returns *input_charset* as a string coerced to lower case. :meth:`!__repr__` is an alias for :meth:`!__str__`."
msgstr "*input_charset* را به‌صورت رشته‌ای که به حروف کوچک تبدیل‌شده است برمی‌گرداند. :meth:`!__repr__` نام مستعاری برای :meth:`!__str__` است."

msgid "This method allows you to compare two :class:`Charset` instances for equality."
msgstr "این متد به شما امکان می‌دهد دو نمونه از :class:`Charset` را از نظر برابری مقایسه کنید."

msgid "This method allows you to compare two :class:`Charset` instances for inequality."
msgstr "این متد به شما امکان می‌دهد دو نمونه از :class:`Charset` را از نظر نابرابری مقایسه کنید."

msgid "The :mod:`!email.charset` module also provides the following functions for adding new entries to the global character set, alias, and codec registries:"
msgstr "ماژول :mod:`!email.charset` همچنین توابع زیر را برای افزودن ورودی‌های جدید به رجیستری‌های سراسری مجموعه‌نویسه، نام مستعار و کدک فراهم می‌کند:"

msgid "Add character properties to the global registry."
msgstr "ویژگی‌های نویسه را به رجیستری سراسری اضافه کنید."

msgid "*charset* is the input character set, and must be the canonical name of a character set."
msgstr "*charset* مجموعه نویسه‌های ورودی است و باید نام کانونیکال یک مجموعه نویسه باشد."

msgid "Optional *header_enc* and *body_enc* is either ``charset.QP`` for quoted-printable, ``charset.BASE64`` for base64 encoding, ``charset.SHORTEST`` for the shortest of quoted-printable or base64 encoding, or ``None`` for no encoding.  ``SHORTEST`` is only valid for *header_enc*. The default is ``None`` for no encoding."
msgstr "*header_enc* و *body_enc* اختیاری می‌توانند یکی از مقادیر زیر باشند: ``charset.QP`` برای کدگذاری quoted-printable، ``charset.BASE64`` برای کدگذاری base64، ``charset.SHORTEST`` برای کوتاه‌ترین حالت از کدگذاری quoted-printable یا base64، یا ``None`` برای بدون کدگذاری. ``SHORTEST`` فقط برای *header_enc* معتبر است. مقدار پیش‌فرض ``None`` برای بدون کدگذاری است."

msgid "Optional *output_charset* is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method :meth:`Charset.convert` is called.  The default is to output in the same character set as the input."
msgstr "*output_charset* اختیاری، مجموعه نویسه‌ای است که خروجی باید با آن باشد. هنگامی که متد :meth:`Charset.convert` فراخوانی می‌شود، تبدیل‌ها از مجموعه نویسه ورودی، به یونیکد و سپس به مجموعه نویسه خروجی انجام می‌شوند. به‌طور پیش‌فرض، خروجی با همان مجموعه نویسه ورودی خواهد بود."

msgid "Both *input_charset* and *output_charset* must have Unicode codec entries in the module's character set-to-codec mapping; use :func:`add_codec` to add codecs the module does not know about.  See the :mod:`codecs` module's documentation for more information."
msgstr "هر دو *input_charset* و *output_charset* باید دارای مداخل کدک یونیکد در نگاشت مجموعه نویسه به کدک ماژول باشند؛ برای افزودن کدک‌هایی که ماژول آن‌ها را نمی‌شناسد، از :func:`add_codec` استفاده کنید. برای اطلاعات بیشتر، مستندات ماژول :mod:`codecs` را ببینید."

msgid "The global character set registry is kept in the module global dictionary ``CHARSETS``."
msgstr "ثبت سراسری مجموعه نویسه‌ها در دیکشنری سراسری ماژول ``CHARSETS`` نگهداری می‌شود."

msgid "Add a character set alias.  *alias* is the alias name, e.g. ``latin-1``. *canonical* is the character set's canonical name, e.g. ``iso-8859-1``."
msgstr "یک نام مستعار برای مجموعه نویسه اضافه کنید. *alias* نام مستعار است، مثلاً ``latin-1``. *canonical* نام کانونیکال مجموعه نویسه است، مثلاً ``iso-8859-1``."

msgid "The global charset alias registry is kept in the module global dictionary ``ALIASES``."
msgstr "ثبت سراسری نام‌های مستعار مجموعه‌نویسه در دیکشنری سراسری ماژول ``ALIASES`` نگهداری می‌شود."

msgid "Add a codec that map characters in the given character set to and from Unicode."
msgstr "یک کدک اضافه کنید که نویسه‌های موجود در مجموعه نویسه داده‌شده را به یونیکد و از یونیکد نگاشت می‌کند."

msgid "*charset* is the canonical name of a character set. *codecname* is the name of a Python codec, as appropriate for the second argument to the :class:`str`'s :meth:`~str.encode` method."
msgstr "*charset* نام کانونیکال مجموعه‌ای از نویسه‌ها است. *codecname* نام یک کدک پایتون است، مناسب برای آرگومان دوم متد :meth:`~str.encode` کلاس :class:`str`."