-
-
Notifications
You must be signed in to change notification settings - Fork 260
Expand file tree
/
Copy pathemail.generator.po
More file actions
320 lines (278 loc) · 12.8 KB
/
email.generator.po
File metadata and controls
320 lines (278 loc) · 12.8 KB
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
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, 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.5\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:42+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/email.generator.rst:2
msgid ":mod:`email.generator`: Generating MIME documents"
msgstr ""
#: ../Doc/library/email.generator.rst:7
msgid "**Source code:** :source:`Lib/email/generator.py`"
msgstr ""
#: ../Doc/library/email.generator.rst:11
msgid ""
"One of the most common tasks is to generate the flat text of the email "
"message represented by a message object structure. You will need to do this "
"if you want to send your message via the :mod:`smtplib` module or the :mod:"
"`nntplib` module, or print the message on the console. Taking a message "
"object structure and producing a flat text document is the job of the :class:"
"`Generator` class."
msgstr ""
#: ../Doc/library/email.generator.rst:17
msgid ""
"Again, as with the :mod:`email.parser` module, you aren't limited to the "
"functionality of the bundled generator; you could write one from scratch "
"yourself. However the bundled generator knows how to generate most email in "
"a standards-compliant way, should handle MIME and non-MIME email messages "
"just fine, and is designed so that the transformation from flat text, to a "
"message structure via the :class:`~email.parser.Parser` class, and back to "
"flat text, is idempotent (the input is identical to the output) [#]_. On "
"the other hand, using the Generator on a :class:`~email.message.Message` "
"constructed by program may result in changes to the :class:`~email.message."
"Message` object as defaults are filled in."
msgstr ""
#: ../Doc/library/email.generator.rst:28
msgid ""
":class:`bytes` output can be generated using the :class:`BytesGenerator` "
"class. If the message object structure contains non-ASCII bytes, this "
"generator's :meth:`~BytesGenerator.flatten` method will emit the original "
"bytes. Parsing a binary message and then flattening it with :class:"
"`BytesGenerator` should be idempotent for standards compliant messages."
msgstr ""
#: ../Doc/library/email.generator.rst:34
msgid ""
"Here are the public methods of the :class:`Generator` class, imported from "
"the :mod:`email.generator` module:"
msgstr ""
#: ../Doc/library/email.generator.rst:40
msgid ""
"The constructor for the :class:`Generator` class takes a :term:`file-like "
"object` called *outfp* for an argument. *outfp* must support the :meth:"
"`write` method and be usable as the output file for the :func:`print` "
"function."
msgstr ""
#: ../Doc/library/email.generator.rst:44
msgid ""
"Optional *mangle_from_* is a flag that, when ``True``, puts a ``>`` "
"character in front of any line in the body that starts exactly as ``From``, "
"i.e. ``From`` followed by a space at the beginning of the line. This is the "
"only guaranteed portable way to avoid having such lines be mistaken for a "
"Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH "
"FORMAT IS BAD <https://www.jwz.org/doc/content-length.html>`_ for details). "
"*mangle_from_* defaults to ``True``, but you might want to set this to "
"``False`` if you are not writing Unix mailbox format files."
msgstr ""
#: ../Doc/library/email.generator.rst:53
msgid ""
"Optional *maxheaderlen* specifies the longest length for a non-continued "
"header. When a header line is longer than *maxheaderlen* (in characters, "
"with tabs expanded to 8 spaces), the header will be split as defined in the :"
"class:`~email.header.Header` class. Set to zero to disable header wrapping. "
"The default is 78, as recommended (but not required) by :rfc:`2822`."
msgstr ""
#: ../Doc/library/email.generator.rst:59 ../Doc/library/email.generator.rst:141
msgid ""
"The *policy* keyword specifies a :mod:`~email.policy` object that controls a "
"number of aspects of the generator's operation. If no *policy* is "
"specified, then the *policy* attached to the message object passed to :attr:"
"`flatten` is used."
msgstr ""
#: ../Doc/library/email.generator.rst:64 ../Doc/library/email.generator.rst:146
msgid "Added the *policy* keyword."
msgstr ""
#: ../Doc/library/email.generator.rst:66
msgid "The other public :class:`Generator` methods are:"
msgstr ""
#: ../Doc/library/email.generator.rst:71
msgid ""
"Print the textual representation of the message object structure rooted at "
"*msg* to the output file specified when the :class:`Generator` instance was "
"created. Subparts are visited depth-first and the resulting text will be "
"properly MIME encoded."
msgstr ""
#: ../Doc/library/email.generator.rst:76 ../Doc/library/email.generator.rst:172
msgid ""
"Optional *unixfrom* is a flag that forces the printing of the envelope "
"header delimiter before the first :rfc:`2822` header of the root message "
"object. If the root object has no envelope header, a standard one is "
"crafted. By default, this is set to ``False`` to inhibit the printing of "
"the envelope delimiter."
msgstr ""
#: ../Doc/library/email.generator.rst:82 ../Doc/library/email.generator.rst:178
msgid "Note that for subparts, no envelope header is ever printed."
msgstr ""
#: ../Doc/library/email.generator.rst:84
msgid ""
"Optional *linesep* specifies the line separator character used to terminate "
"lines in the output. If specified it overrides the value specified by the "
"*msg*\\'s or ``Generator``\\'s ``policy``."
msgstr ""
#: ../Doc/library/email.generator.rst:88
msgid ""
"Because strings cannot represent non-ASCII bytes, if the policy that applies "
"when ``flatten`` is run has :attr:`~email.policy.Policy.cte_type` set to "
"``8bit``, ``Generator`` will operate as if it were set to ``7bit``. This "
"means that messages parsed with a Bytes parser that have a :mailheader:"
"`Content-Transfer-Encoding` of ``8bit`` will be converted to a use a "
"``7bit`` Content-Transfer-Encoding. Non-ASCII bytes in the headers will be :"
"rfc:`2047` encoded with a charset of ``unknown-8bit``."
msgstr ""
#: ../Doc/library/email.generator.rst:96
msgid ""
"Added support for re-encoding ``8bit`` message bodies, and the *linesep* "
"argument."
msgstr ""
#: ../Doc/library/email.generator.rst:102
msgid ""
"Return an independent clone of this :class:`Generator` instance with the "
"exact same options."
msgstr ""
#: ../Doc/library/email.generator.rst:107
msgid ""
"Write the string *s* to the underlying file object, i.e. *outfp* passed to :"
"class:`Generator`'s constructor. This provides just enough file-like API "
"for :class:`Generator` instances to be used in the :func:`print` function."
msgstr ""
#: ../Doc/library/email.generator.rst:111
msgid ""
"As a convenience, see the :class:`~email.message.Message` methods :meth:"
"`~email.message.Message.as_string` and ``str(aMessage)``, a.k.a. :meth:"
"`~email.message.Message.__str__`, which simplify the generation of a "
"formatted string representation of a message object. For more detail, see :"
"mod:`email.message`."
msgstr ""
#: ../Doc/library/email.generator.rst:120
msgid ""
"The constructor for the :class:`BytesGenerator` class takes a binary :term:"
"`file-like object` called *outfp* for an argument. *outfp* must support a :"
"meth:`write` method that accepts binary data."
msgstr ""
#: ../Doc/library/email.generator.rst:124
msgid ""
"Optional *mangle_from_* is a flag that, when ``True``, puts a ``>`` "
"character in front of any line in the body that starts exactly as ``From``, "
"i.e. ``From`` followed by a space at the beginning of the line. This is the "
"only guaranteed portable way to avoid having such lines be mistaken for a "
"Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH "
"FORMAT IS BAD <https://www.jwz.org/doc/content-length.html>`_ for details). "
"*mangle_from_* defaults to ``True``, but you might want to set this to "
"``False`` if you are not writing Unix mailbox format files."
msgstr ""
#: ../Doc/library/email.generator.rst:133
msgid ""
"Optional *maxheaderlen* specifies the longest length for a non-continued "
"header. When a header line is longer than *maxheaderlen* (in characters, "
"with tabs expanded to 8 spaces), the header will be split as defined in the :"
"class:`~email.header.Header` class. Set to zero to disable header "
"wrapping. The default is 78, as recommended (but not required) by :rfc:"
"`2822`."
msgstr ""
#: ../Doc/library/email.generator.rst:148
msgid "The other public :class:`BytesGenerator` methods are:"
msgstr ""
#: ../Doc/library/email.generator.rst:153
msgid ""
"Print the textual representation of the message object structure rooted at "
"*msg* to the output file specified when the :class:`BytesGenerator` instance "
"was created. Subparts are visited depth-first and the resulting text will "
"be properly MIME encoded. If the :mod:`~email.policy` option :attr:`~email."
"policy.Policy.cte_type` is ``8bit`` (the default), then any bytes with the "
"high bit set in the original parsed message that have not been modified will "
"be copied faithfully to the output. If ``cte_type`` is ``7bit``, the bytes "
"will be converted as needed using an ASCII-compatible Content-Transfer-"
"Encoding. In particular, RFC-invalid non-ASCII bytes in headers will be "
"encoded using the MIME ``unknown-8bit`` character set, thus rendering them "
"RFC-compliant."
msgstr ""
#: ../Doc/library/email.generator.rst:168
msgid ""
"Messages parsed with a Bytes parser that have a :mailheader:`Content-"
"Transfer-Encoding` of 8bit will be reconstructed as 8bit if they have not "
"been modified."
msgstr ""
#: ../Doc/library/email.generator.rst:180
msgid ""
"Optional *linesep* specifies the line separator character used to terminate "
"lines in the output. If specified it overrides the value specified by the "
"``Generator``\\ or *msg*\\ 's ``policy``."
msgstr ""
#: ../Doc/library/email.generator.rst:186
msgid ""
"Return an independent clone of this :class:`BytesGenerator` instance with "
"the exact same options."
msgstr ""
#: ../Doc/library/email.generator.rst:191
msgid ""
"Write the string *s* to the underlying file object. *s* is encoded using "
"the ``ASCII`` codec and written to the *write* method of the *outfp* "
"*outfp* passed to the :class:`BytesGenerator`'s constructor. This provides "
"just enough file-like API for :class:`BytesGenerator` instances to be used "
"in the :func:`print` function."
msgstr ""
#: ../Doc/library/email.generator.rst:199
msgid ""
"The :mod:`email.generator` module also provides a derived class, called :"
"class:`DecodedGenerator` which is like the :class:`Generator` base class, "
"except that non-\\ :mimetype:`text` parts are substituted with a format "
"string representing the part."
msgstr ""
#: ../Doc/library/email.generator.rst:207
msgid ""
"This class, derived from :class:`Generator` walks through all the subparts "
"of a message. If the subpart is of main type :mimetype:`text`, then it "
"prints the decoded payload of the subpart. Optional *_mangle_from_* and "
"*maxheaderlen* are as with the :class:`Generator` base class."
msgstr ""
#: ../Doc/library/email.generator.rst:212
msgid ""
"If the subpart is not of main type :mimetype:`text`, optional *fmt* is a "
"format string that is used instead of the message payload. *fmt* is expanded "
"with the following keywords, ``%(keyword)s`` format:"
msgstr ""
#: ../Doc/library/email.generator.rst:216
msgid "``type`` -- Full MIME type of the non-\\ :mimetype:`text` part"
msgstr ""
#: ../Doc/library/email.generator.rst:218
msgid "``maintype`` -- Main MIME type of the non-\\ :mimetype:`text` part"
msgstr ""
#: ../Doc/library/email.generator.rst:220
msgid "``subtype`` -- Sub-MIME type of the non-\\ :mimetype:`text` part"
msgstr ""
#: ../Doc/library/email.generator.rst:222
msgid "``filename`` -- Filename of the non-\\ :mimetype:`text` part"
msgstr ""
#: ../Doc/library/email.generator.rst:224
msgid ""
"``description`` -- Description associated with the non-\\ :mimetype:`text` "
"part"
msgstr ""
#: ../Doc/library/email.generator.rst:226
msgid ""
"``encoding`` -- Content transfer encoding of the non-\\ :mimetype:`text` part"
msgstr ""
#: ../Doc/library/email.generator.rst:228
msgid "The default value for *fmt* is ``None``, meaning ::"
msgstr ""
#: ../Doc/library/email.generator.rst:234
msgid "Footnotes"
msgstr "Notes"
#: ../Doc/library/email.generator.rst:235
msgid ""
"This statement assumes that you use the appropriate setting for the "
"``unixfrom`` argument, and that you set maxheaderlen=0 (which will preserve "
"whatever the input line lengths were). It is also not strictly true, since "
"in many cases runs of whitespace in headers are collapsed into single "
"blanks. The latter is a bug that will eventually be fixed."
msgstr ""