email.charset.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2018, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-06-30 05:56+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: 秘湯 <xwhhsprings@gmail.com>, 2017\n"
"Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/email.charset.rst:2
msgid ":mod:`email.charset`: Representing character sets"
msgstr ":mod:`email.charset`: 文字集合の表現"

#: ../../library/email.charset.rst:7
msgid "**Source code:** :source:`Lib/email/charset.py`"
msgstr "**ソースコード:** :source:`Lib/email/charset.py`"

#: ../../library/email.charset.rst:11
msgid ""
"This module is part of the legacy (``Compat32``) email API.  In the new API "
"only the aliases table is used."
msgstr ""

#: ../../library/email.charset.rst:14
msgid ""
"The remaining text in this section is the original documentation of the "
"module."
msgstr ""

#: ../../library/email.charset.rst:16
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` クラスに加え、文字集合のレジストリとそれを操作する簡易メソッドを提供しています。\n"
":class:`Charset` インスタンスは :mod:`email` パッケージ中にある他のいくつかのモジュールで使用されます。"

#: ../../library/email.charset.rst:22
msgid "Import this class from the :mod:`email.charset` module."
msgstr "このクラスは :mod:`email.charset` モジュールからインポートしてください。"

#: ../../library/email.charset.rst:27
msgid "Map character sets to their email properties."
msgstr "文字集合を電子メールのプロパティに写像します。"

#: ../../library/email.charset.rst:29
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 ""
"このクラスは、ある特定の文字集合に対し電子メールに課される条件についての情報を提供します。\n"
"また、適用可能なコーデックスが利用出来れば、文字集合間の変換を行う簡易ルーチンを提供します。\n"
"文字集合について、この関数は電子メールメッセージ内での RFC に準拠した文字集合の使い方に関する情報を提供するのに最善を尽くします。"

#: ../../library/email.charset.rst:35
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 形式でエンコードされなければなりません。\n"
"また、文字集合によっては完全に変換する必要があり、電子メールの中では使用できません。"

#: ../../library/email.charset.rst:39
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`` 文字集合に変換されます。"

#: ../../library/email.charset.rst:49
msgid ":class:`Charset` instances have the following data attributes:"
msgstr ":class:`Charset` インスタンスは以下のようなデータ属性をもっています:"

#: ../../library/email.charset.rst:53
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`` に変換されます)。デフォルトは 7-bit の ``us-ascii`` です。"

#: ../../library/email.charset.rst:60
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 エンコーディング)、あるいは最短の QP または "
"BASE64 エンコーディングである ``Charset.SHORTEST`` に設定されます。そうでない場合、この値は ``None`` になります。"

#: ../../library/email.charset.rst:69
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* "
"と同じですが、この値はメッセージ本体のためのエンコーディングを記述します。これはヘッダ用のエンコーディングとは違うかもしれません。*body_encoding*"
" では、``Charset.SHORTEST`` を使うことはできません。"

#: ../../library/email.charset.rst:76
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* "
"がそれらの文字集合のどれかをさしていたら、この *output_charset* "
"属性はそれが出力時に変換される文字集合の名前を表しています。それ以外の場合、この値は ``None`` になります。"

#: ../../library/email.charset.rst:84
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* を Unicode に変換するための Python 用コーデック名です。変換用のコーデックが必要ないときは、この値は "
"``None`` になります。"

#: ../../library/email.charset.rst:91
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 ""
"Unicode を *output_charset* に変換するための Python 用コーデック名です。変換用のコーデックが必要ないときは、この値は "
"``None`` になります。この属性は *input_codec* と同じ値を持つことになるでしょう。"

#: ../../library/email.charset.rst:96
msgid ":class:`Charset` instances also have the following methods:"
msgstr ":class:`Charset` インスタンスは、以下のメソッドも持っています:"

#: ../../library/email.charset.rst:100
msgid "Return the content transfer encoding used for body encoding."
msgstr "メッセージ本体のエンコードに使われる content-transfer-encoding の値を返します。"

#: ../../library/email.charset.rst:102
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` ヘッダ自体を、なんであれ適切な値に設定する必要があります。"

#: ../../library/email.charset.rst:108
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`` "
"を返します。"

#: ../../library/email.charset.rst:148
msgid "Return the output character set."
msgstr "出力用の文字集合を返します。"

#: ../../library/email.charset.rst:150
msgid ""
"This is the *output_charset* attribute if that is not ``None``, otherwise it"
" is *input_charset*."
msgstr ""
"これは *output_charset* 属性が ``None`` でなければその値になります。それ以外の場合、この値は *input_charset*"
" と同じです。"

#: ../../library/email.charset.rst:156
msgid "Header-encode the string *string*."
msgstr "文字列 *string* をヘッダ用にエンコードします。"

#: ../../library/email.charset.rst:158
msgid ""
"The type of encoding (base64 or quoted-printable) will be based on the "
"*header_encoding* attribute."
msgstr ""
"エンコーディングの形式 (base64 または quoted-printable) は、*header_encoding* 属性に基づきます。"

#: ../../library/email.charset.rst:164
msgid "Header-encode a *string* by converting it first to bytes."
msgstr "*string* を最初にバイト列に変換し、ヘッダ用にエンコードします。"

#: ../../library/email.charset.rst:166
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* "
"に従って、行の最大長に合うように文字列が調整されるところが異なります。 *maxlengths* はイテレータでなければなりません: "
"このイテレータが返す要素は次の行の最大長を表します。"

#: ../../library/email.charset.rst:174
msgid "Body-encode the string *string*."
msgstr "文字列 *string* をメッセージ本体用にエンコードします。"

#: ../../library/email.charset.rst:176
msgid ""
"The type of encoding (base64 or quoted-printable) will be based on the "
"*body_encoding* attribute."
msgstr "エンコーディングの形式 (base64 または quoted-printable) は、*body_encoding* 属性に基づきます。"

#: ../../library/email.charset.rst:179
msgid ""
"The :class:`Charset` class also provides a number of methods to support "
"standard operations and built-in functions."
msgstr ":class:`Charset` クラスには、標準的な演算と組み込み関数をサポートするいくつかのメソッドがあります。"

#: ../../library/email.charset.rst:185
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__` "
"の別名となっています。"

#: ../../library/email.charset.rst:191
msgid ""
"This method allows you to compare two :class:`Charset` instances for "
"equality."
msgstr "このメソッドは、2つの :class:`Charset` インスタンスが同じかどうかをチェックするのに使います。"

#: ../../library/email.charset.rst:197
msgid ""
"This method allows you to compare two :class:`Charset` instances for "
"inequality."
msgstr "このメソッドは、2つの :class:`Charset` インスタンスが異なるかどうかをチェックするのに使います。"

#: ../../library/email.charset.rst:200
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` "
"モジュールには、グローバルな文字集合、文字集合の別名およびコーデック用のレジストリに新しいエントリを追加する以下の関数も含まれています:"

#: ../../library/email.charset.rst:206
msgid "Add character properties to the global registry."
msgstr "文字の属性をグローバルなレジストリに追加します。"

#: ../../library/email.charset.rst:208
msgid ""
"*charset* is the input character set, and must be the canonical name of a "
"character set."
msgstr "*charset* は入力用の文字集合で、その文字集合の正式名称を指定する必要があります。"

#: ../../library/email.charset.rst:211
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* は quoted-printable エンコーディングを表す "
"``Charset.QP`` か、base64 エンコーディングを表す ``Charset.BASE64``、最短の quoted-printable "
"または base64 エンコーディングを表す ``Charset.SHORTEST``、あるいはエンコーディングなしの ``None`` "
"のいずれかになります。``SHORTEST`` が使えるのは *header_enc* だけです。デフォルトの値はエンコーディングなしの "
"``None`` になっています。"

#: ../../library/email.charset.rst:217
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` "
"が呼ばれたときの変換はまず入力用の文字集合を Unicode "
"に変換し、それから出力用の文字集合に変換されます。デフォルトでは、出力は入力と同じ文字集合になっています。"

#: ../../library/email.charset.rst:222
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* はこのモジュール中の文字集合-コーデック対応表にある Unicode "
"コーデックエントリである必要があります。モジュールがまだ対応していないコーデックを追加するには、 :func:`add_codec` "
"を使ってください。より詳しい情報については :mod:`codecs` モジュールの文書を参照してください。"

#: ../../library/email.charset.rst:227
msgid ""
"The global character set registry is kept in the module global dictionary "
"``CHARSETS``."
msgstr "グローバルな文字集合用のレジストリは、モジュールのグローバル辞書 ``CHARSETS`` 内に保持されています。"

#: ../../library/email.charset.rst:233
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`` のように指定します。"

#: ../../library/email.charset.rst:236
msgid ""
"The global charset alias registry is kept in the module global dictionary "
"``ALIASES``."
msgstr "文字集合のグローバルな別名用レジストリは、モジュールのグローバル辞書 ``ALIASES`` 内に保持されています。"

#: ../../library/email.charset.rst:242
msgid ""
"Add a codec that map characters in the given character set to and from "
"Unicode."
msgstr "与えられた文字集合の文字と Unicode との変換を行うコーデックを追加します。"

#: ../../library/email.charset.rst:244
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* は、 :class:`str` の :meth:`~str.encode` "
"メソッドの第 2 引数で使える Python コーデックの名前です。"