-
Notifications
You must be signed in to change notification settings - Fork 13
/
Copy pathemail.header.po
274 lines (234 loc) · 9.93 KB
/
email.header.po
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Stan Ulbrych, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-04-04 14:18+0000\n"
"PO-Revision-Date: 2021-06-28 01:05+0000\n"
"Last-Translator: Stan Ulbrych, 2025\n"
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pl\n"
"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && "
"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && "
"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"
msgid ":mod:`!email.header`: Internationalized headers"
msgstr ""
msgid "**Source code:** :source:`Lib/email/header.py`"
msgstr ""
msgid ""
"This module is part of the legacy (``Compat32``) email API. In the current "
"API encoding and decoding of headers is handled transparently by the "
"dictionary-like API of the :class:`~email.message.EmailMessage` class. In "
"addition to uses in legacy code, this module can be useful in applications "
"that need to completely control the character sets used when encoding "
"headers."
msgstr ""
msgid ""
"The remaining text in this section is the original documentation of the "
"module."
msgstr ""
msgid ""
":rfc:`2822` is the base standard that describes the format of email "
"messages. It derives from the older :rfc:`822` standard which came into "
"widespread use at a time when most email was composed of ASCII characters "
"only. :rfc:`2822` is a specification written assuming email contains only 7-"
"bit ASCII characters."
msgstr ""
msgid ""
"Of course, as email has been deployed worldwide, it has become "
"internationalized, such that language specific character sets can now be "
"used in email messages. The base standard still requires email messages to "
"be transferred using only 7-bit ASCII characters, so a slew of RFCs have "
"been written describing how to encode email containing non-ASCII characters "
"into :rfc:`2822`\\ -compliant format. These RFCs include :rfc:`2045`, :rfc:"
"`2046`, :rfc:`2047`, and :rfc:`2231`. The :mod:`email` package supports "
"these standards in its :mod:`email.header` and :mod:`email.charset` modules."
msgstr ""
msgid ""
"If you want to include non-ASCII characters in your email headers, say in "
"the :mailheader:`Subject` or :mailheader:`To` fields, you should use the :"
"class:`Header` class and assign the field in the :class:`~email.message."
"Message` object to an instance of :class:`Header` instead of using a string "
"for the header value. Import the :class:`Header` class from the :mod:`email."
"header` module. For example::"
msgstr ""
msgid ""
">>> from email.message import Message\n"
">>> from email.header import Header\n"
">>> msg = Message()\n"
">>> h = Header('p\\xf6stal', 'iso-8859-1')\n"
">>> msg['Subject'] = h\n"
">>> msg.as_string()\n"
"'Subject: =?iso-8859-1?q?p=F6stal?=\\n\\n'"
msgstr ""
msgid ""
"Notice here how we wanted the :mailheader:`Subject` field to contain a non-"
"ASCII character? We did this by creating a :class:`Header` instance and "
"passing in the character set that the byte string was encoded in. When the "
"subsequent :class:`~email.message.Message` instance was flattened, the :"
"mailheader:`Subject` field was properly :rfc:`2047` encoded. MIME-aware "
"mail readers would show this header using the embedded ISO-8859-1 character."
msgstr ""
msgid "Here is the :class:`Header` class description:"
msgstr ""
msgid ""
"Create a MIME-compliant header that can contain strings in different "
"character sets."
msgstr ""
msgid ""
"Optional *s* is the initial header value. If ``None`` (the default), the "
"initial header value is not set. You can later append to the header with :"
"meth:`append` method calls. *s* may be an instance of :class:`bytes` or :"
"class:`str`, but see the :meth:`append` documentation for semantics."
msgstr ""
msgid ""
"Optional *charset* serves two purposes: it has the same meaning as the "
"*charset* argument to the :meth:`append` method. It also sets the default "
"character set for all subsequent :meth:`append` calls that omit the "
"*charset* argument. If *charset* is not provided in the constructor (the "
"default), the ``us-ascii`` character set is used both as *s*'s initial "
"charset and as the default for subsequent :meth:`append` calls."
msgstr ""
msgid ""
"The maximum line length can be specified explicitly via *maxlinelen*. For "
"splitting the first line to a shorter value (to account for the field header "
"which isn't included in *s*, e.g. :mailheader:`Subject`) pass in the name of "
"the field in *header_name*. The default *maxlinelen* is 78, and the default "
"value for *header_name* is ``None``, meaning it is not taken into account "
"for the first line of a long, split header."
msgstr ""
msgid ""
"Optional *continuation_ws* must be :rfc:`2822`\\ -compliant folding "
"whitespace, and is usually either a space or a hard tab character. This "
"character will be prepended to continuation lines. *continuation_ws* "
"defaults to a single space character."
msgstr ""
msgid ""
"Optional *errors* is passed straight through to the :meth:`append` method."
msgstr ""
msgid "Append the string *s* to the MIME header."
msgstr ""
msgid ""
"Optional *charset*, if given, should be a :class:`~email.charset.Charset` "
"instance (see :mod:`email.charset`) or the name of a character set, which "
"will be converted to a :class:`~email.charset.Charset` instance. A value of "
"``None`` (the default) means that the *charset* given in the constructor is "
"used."
msgstr ""
msgid ""
"*s* may be an instance of :class:`bytes` or :class:`str`. If it is an "
"instance of :class:`bytes`, then *charset* is the encoding of that byte "
"string, and a :exc:`UnicodeError` will be raised if the string cannot be "
"decoded with that character set."
msgstr ""
msgid ""
"If *s* is an instance of :class:`str`, then *charset* is a hint specifying "
"the character set of the characters in the string."
msgstr ""
msgid ""
"In either case, when producing an :rfc:`2822`\\ -compliant header using :rfc:"
"`2047` rules, the string will be encoded using the output codec of the "
"charset. If the string cannot be encoded using the output codec, a "
"UnicodeError will be raised."
msgstr ""
msgid ""
"Optional *errors* is passed as the errors argument to the decode call if *s* "
"is a byte string."
msgstr ""
msgid ""
"Encode a message header into an RFC-compliant format, possibly wrapping long "
"lines and encapsulating non-ASCII parts in base64 or quoted-printable "
"encodings."
msgstr ""
msgid ""
"Optional *splitchars* is a string containing characters which should be "
"given extra weight by the splitting algorithm during normal header "
"wrapping. This is in very rough support of :RFC:`2822`\\'s 'higher level "
"syntactic breaks': split points preceded by a splitchar are preferred "
"during line splitting, with the characters preferred in the order in which "
"they appear in the string. Space and tab may be included in the string to "
"indicate whether preference should be given to one over the other as a split "
"point when other split chars do not appear in the line being split. "
"Splitchars does not affect :RFC:`2047` encoded lines."
msgstr ""
msgid ""
"*maxlinelen*, if given, overrides the instance's value for the maximum line "
"length."
msgstr ""
msgid ""
"*linesep* specifies the characters used to separate the lines of the folded "
"header. It defaults to the most useful value for Python application code "
"(``\\n``), but ``\\r\\n`` can be specified in order to produce headers with "
"RFC-compliant line separators."
msgstr ""
msgid "Added the *linesep* argument."
msgstr ""
msgid ""
"The :class:`Header` class also provides a number of methods to support "
"standard operators and built-in functions."
msgstr ""
msgid ""
"Returns an approximation of the :class:`Header` as a string, using an "
"unlimited line length. All pieces are converted to unicode using the "
"specified encoding and joined together appropriately. Any pieces with a "
"charset of ``'unknown-8bit'`` are decoded as ASCII using the ``'replace'`` "
"error handler."
msgstr ""
msgid "Added handling for the ``'unknown-8bit'`` charset."
msgstr ""
msgid ""
"This method allows you to compare two :class:`Header` instances for equality."
msgstr ""
msgid ""
"This method allows you to compare two :class:`Header` instances for "
"inequality."
msgstr ""
msgid ""
"The :mod:`email.header` module also provides the following convenient "
"functions."
msgstr ""
msgid ""
"Decode a message header value without converting the character set. The "
"header value is in *header*."
msgstr ""
msgid ""
"This function returns a list of ``(decoded_string, charset)`` pairs "
"containing each of the decoded parts of the header. *charset* is ``None`` "
"for non-encoded parts of the header, otherwise a lower case string "
"containing the name of the character set specified in the encoded string."
msgstr ""
msgid "Here's an example::"
msgstr ""
msgid ""
">>> from email.header import decode_header\n"
">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
"[(b'p\\xf6stal', 'iso-8859-1')]"
msgstr ""
">>> from email.header import decode_header\n"
">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
"[(b'p\\xf6stal', 'iso-8859-1')]"
msgid ""
"Create a :class:`Header` instance from a sequence of pairs as returned by :"
"func:`decode_header`."
msgstr ""
msgid ""
":func:`decode_header` takes a header value string and returns a sequence of "
"pairs of the format ``(decoded_string, charset)`` where *charset* is the "
"name of the character set."
msgstr ""
msgid ""
"This function takes one of those sequence of pairs and returns a :class:"
"`Header` instance. Optional *maxlinelen*, *header_name*, and "
"*continuation_ws* are as in the :class:`Header` constructor."
msgstr ""