@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version :Python 3.11\n "
1313"Report-Msgid-Bugs-To :\n "
14- "POT-Creation-Date :2025-09-22 20:37 +0000\n "
14+ "POT-Creation-Date :2025-11-01 16:25 +0000\n "
1515"PO-Revision-Date :2025-09-22 16:50+0000\n "
1616"Last-Translator :python-doc bot, 2025\n "
1717"Language-Team :Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
@@ -44,105 +44,116 @@ msgstr ""
4444
4545#: ../../library/html.parser.rst:22
4646msgid ""
47- "If *convert_charrefs* is``True`` (the default), all character references "
48- "(except the ones in ``script``/ ``style`` elements ) are automatically "
49- "converted to the corresponding Unicode characters."
47+ "If *convert_charrefs* istrue (the default), all character references "
48+ "(except the ones inelements like ``script`` and ``style``) are "
49+ "automatically converted to the corresponding Unicode characters."
5050msgstr ""
5151
5252#: ../../library/html.parser.rst:26
5353msgid ""
54+ "If *scripting* is false (the default), the content of the ``noscript`` "
55+ "element is parsed normally; if it's true, it's returned as is without being "
56+ "parsed."
57+ msgstr ""
58+
59+ #: ../../library/html.parser.rst:30
60+ msgid ""
5461"An :class:`.HTMLParser` instance is fed HTML data and calls handler methods "
5562"when start tags, end tags, text, comments, and other markup elements are "
5663"encountered. The user should subclass :class:`.HTMLParser` and override its "
5764"methods to implement the desired behavior."
5865msgstr ""
5966
60- #: ../../library/html.parser.rst:31
67+ #: ../../library/html.parser.rst:35
6168msgid ""
6269"This parser does not check that end tags match start tags or call the end-"
6370"tag handler for elements which are closed implicitly by closing an outer "
6471"element."
6572msgstr ""
6673
67- #: ../../library/html.parser.rst:34
74+ #: ../../library/html.parser.rst:38
6875msgid "*convert_charrefs* keyword argument added."
6976msgstr ""
7077
71- #: ../../library/html.parser.rst:37
78+ #: ../../library/html.parser.rst:41
7279msgid "The default value for argument *convert_charrefs* is now ``True``."
7380msgstr ""
7481
75- #: ../../library/html.parser.rst:42
82+ #: ../../library/html.parser.rst:44
83+ msgid "Added the *scripting* parameter."
84+ msgstr ""
85+
86+ #: ../../library/html.parser.rst:49
7687msgid "Example HTML Parser Application"
7788msgstr ""
7889
79- #: ../../library/html.parser.rst:44
90+ #: ../../library/html.parser.rst:51
8091msgid ""
8192"As a basic example, below is a simple HTML parser that uses the :class:"
8293"`HTMLParser` class to print out start tags, end tags, and data as they are "
8394"encountered::"
8495msgstr ""
8596
86- #: ../../library/html.parser.rst:64
97+ #: ../../library/html.parser.rst:71
8798msgid "The output will then be:"
8899msgstr ""
89100
90- #: ../../library/html.parser.rst:83
101+ #: ../../library/html.parser.rst:90
91102msgid ":class:`.HTMLParser` Methods"
92103msgstr ""
93104
94- #: ../../library/html.parser.rst:85
105+ #: ../../library/html.parser.rst:92
95106msgid ":class:`HTMLParser` instances have the following methods:"
96107msgstr ""
97108
98- #: ../../library/html.parser.rst:90
109+ #: ../../library/html.parser.rst:97
99110msgid ""
100111"Feed some text to the parser. It is processed insofar as it consists of "
101112"complete elements; incomplete data is buffered until more data is fed or :"
102113"meth:`close` is called. *data* must be :class:`str`."
103114msgstr ""
104115
105- #: ../../library/html.parser.rst:97
116+ #: ../../library/html.parser.rst:104
106117msgid ""
107118"Force processing of all buffered data as if it were followed by an end-of-"
108119"file mark. This method may be redefined by a derived class to define "
109120"additional processing at the end of the input, but the redefined version "
110121"should always call the :class:`HTMLParser` base class method :meth:`close`."
111122msgstr ""
112123
113- #: ../../library/html.parser.rst:105
124+ #: ../../library/html.parser.rst:112
114125msgid ""
115126"Reset the instance. Loses all unprocessed data. This is called implicitly "
116127"at instantiation time."
117128msgstr ""
118129
119- #: ../../library/html.parser.rst:111
130+ #: ../../library/html.parser.rst:118
120131msgid "Return current line number and offset."
121132msgstr ""
122133
123- #: ../../library/html.parser.rst:116
134+ #: ../../library/html.parser.rst:123
124135msgid ""
125136"Return the text of the most recently opened start tag. This should not "
126137"normally be needed for structured processing, but may be useful in dealing "
127138"with HTML\" as deployed\" or for re-generating input with minimal changes "
128139"(whitespace between attributes can be preserved, etc.)."
129140msgstr ""
130141
131- #: ../../library/html.parser.rst:122
142+ #: ../../library/html.parser.rst:129
132143msgid ""
133144"The following methods are called when data or markup elements are "
134145"encountered and they are meant to be overridden in a subclass. The base "
135146"class implementations do nothing (except for :meth:`~HTMLParser."
136147"handle_startendtag`):"
137148msgstr ""
138149
139- #: ../../library/html.parser.rst:129
150+ #: ../../library/html.parser.rst:136
140151msgid ""
141152"This method is called to handle the start tag of an element (e.g. ``<div "
142153"id=\" main\" >``)."
143154msgstr ""
144155
145- #: ../../library/html.parser.rst:131
156+ #: ../../library/html.parser.rst:138
146157msgid ""
147158"The *tag* argument is the name of the tag converted to lower case. The "
148159"*attrs* argument is a list of ``(name, value)`` pairs containing the "
@@ -151,29 +162,29 @@ msgid ""
151162"character and entity references have been replaced."
152163msgstr ""
153164
154- #: ../../library/html.parser.rst:137
165+ #: ../../library/html.parser.rst:144
155166msgid ""
156167"For instance, for the tag ``<A HREF=\" https://www.cwi.nl/\" >``, this method "
157168"would be called as ``handle_starttag('a', [('href', 'https://www.cwi."
158169"nl/')])``."
159170msgstr ""
160171
161- #: ../../library/html.parser.rst:140
172+ #: ../../library/html.parser.rst:147
162173msgid ""
163174"All entity references from :mod:`html.entities` are replaced in the "
164175"attribute values."
165176msgstr ""
166177
167- #: ../../library/html.parser.rst:146
178+ #: ../../library/html.parser.rst:153
168179msgid ""
169180"This method is called to handle the end tag of an element (e.g. ``</div>``)."
170181msgstr ""
171182
172- #: ../../library/html.parser.rst:148
183+ #: ../../library/html.parser.rst:155
173184msgid "The *tag* argument is the name of the tag converted to lower case."
174185msgstr ""
175186
176- #: ../../library/html.parser.rst:153
187+ #: ../../library/html.parser.rst:160
177188msgid ""
178189"Similar to :meth:`handle_starttag`, but called when the parser encounters an "
179190"XHTML-style empty tag (``<img ... />``). This method may be overridden by "
@@ -182,61 +193,61 @@ msgid ""
182193"`handle_endtag`."
183194msgstr ""
184195
185- #: ../../library/html.parser.rst:161
196+ #: ../../library/html.parser.rst:168
186197msgid ""
187198"This method is called to process arbitrary data (e.g. text nodes and the "
188- "content of``< script>...</script> `` and ``< style>...</style> ``)."
199+ "content ofelements like `` script`` and ``style``)."
189200msgstr ""
190201
191- #: ../../library/html.parser.rst:167
202+ #: ../../library/html.parser.rst:174
192203msgid ""
193204"This method is called to process a named character reference of the form "
194205"``&name;`` (e.g. ``>``), where *name* is a general entity reference (e.g. "
195- "``'gt'``).never called if *convert_charrefs* is``True`` ."
206+ "``'gt'``). This method isonly called if *convert_charrefs* isfalse ."
196207msgstr ""
197208
198- #: ../../library/html.parser.rst:175
209+ #: ../../library/html.parser.rst:182
199210msgid ""
200211"This method is called to process decimal and hexadecimal numeric character "
201212"references of the form :samp:`&#{NNN};` and :samp:`&#x{NNN};`. For example, "
202213"the decimal equivalent for ``>`` is ``>``, whereas the hexadecimal is "
203- "``>``; in this case the method will receive ``'62'`` or ``'x3E'``. "
204- "This method isnever called if *convert_charrefs* is``True`` ."
214+ "``>``; in this case the method will receive ``'62'`` or ``'x3E'``.This "
215+ "method isonly called if *convert_charrefs* isfalse ."
205216msgstr ""
206217
207- #: ../../library/html.parser.rst:184
218+ #: ../../library/html.parser.rst:191
208219msgid ""
209220"This method is called when a comment is encountered (e.g. ``<!--comment--"
210221">``)."
211222msgstr ""
212223
213- #: ../../library/html.parser.rst:186
224+ #: ../../library/html.parser.rst:193
214225msgid ""
215226"For example, the comment ``<!-- comment -->`` will cause this method to be "
216227"called with the argument ``' comment '``."
217228msgstr ""
218229
219- #: ../../library/html.parser.rst:189
230+ #: ../../library/html.parser.rst:196
220231msgid ""
221232"The content of Internet Explorer conditional comments (condcoms) will also "
222233"be sent to this method, so, for ``<!--[if IE 9]>IE9-specific content<!"
223234"[endif]-->``, this method will receive ``'[if IE 9]>IE9-specific content<!"
224235"[endif]'``."
225236msgstr ""
226237
227- #: ../../library/html.parser.rst:196
238+ #: ../../library/html.parser.rst:203
228239msgid ""
229240"This method is called to handle an HTML doctype declaration (e.g. ``<!"
230241"DOCTYPE html>``)."
231242msgstr ""
232243
233- #: ../../library/html.parser.rst:199
244+ #: ../../library/html.parser.rst:206
234245msgid ""
235246"The *decl* parameter will be the entire contents of the declaration inside "
236247"the ``<!...>`` markup (e.g. ``'DOCTYPE html'``)."
237248msgstr ""
238249
239- #: ../../library/html.parser.rst:205
250+ #: ../../library/html.parser.rst:212
240251msgid ""
241252"Method called when a processing instruction is encountered. The *data* "
242253"parameter will contain the entire processing instruction. For example, for "
@@ -245,67 +256,67 @@ msgid ""
245256"overridden by a derived class; the base class implementation does nothing."
246257msgstr ""
247258
248- #: ../../library/html.parser.rst:213
259+ #: ../../library/html.parser.rst:220
249260msgid ""
250261"The :class:`HTMLParser` class uses the SGML syntactic rules for processing "
251262"instructions. An XHTML processing instruction using the trailing ``'?'`` "
252263"will cause the ``'?'`` to be included in *data*."
253264msgstr ""
254265
255- #: ../../library/html.parser.rst:220
266+ #: ../../library/html.parser.rst:227
256267msgid ""
257268"This method is called when an unrecognized declaration is read by the parser."
258269msgstr ""
259270
260- #: ../../library/html.parser.rst:222
271+ #: ../../library/html.parser.rst:229
261272msgid ""
262273"The *data* parameter will be the entire contents of the declaration inside "
263274"the ``<![...]>`` markup. It is sometimes useful to be overridden by a "
264275"derived class. The base class implementation does nothing."
265276msgstr ""
266277
267- #: ../../library/html.parser.rst:230
278+ #: ../../library/html.parser.rst:237
268279msgid "Examples"
269280msgstr "Exemplos"
270281
271- #: ../../library/html.parser.rst:232
282+ #: ../../library/html.parser.rst:239
272283msgid ""
273284"The following class implements a parser that will be used to illustrate more "
274285"examples::"
275286msgstr ""
276287
277- #: ../../library/html.parser.rst:269
288+ #: ../../library/html.parser.rst:276
278289msgid "Parsing a doctype::"
279290msgstr ""
280291
281- #: ../../library/html.parser.rst:275
292+ #: ../../library/html.parser.rst:282
282293msgid "Parsing an element with a few attributes and a title::"
283294msgstr ""
284295
285- #: ../../library/html.parser.rst:287
296+ #: ../../library/html.parser.rst:294
286297msgid ""
287- "The content of ``script`` and ``style``elements is returned as is, without "
288- "further parsing::"
298+ "The content ofelements like ``script`` and ``style`` is returned as is, "
299+ "without further parsing::"
289300msgstr ""
290301
291- #: ../../library/html.parser.rst:303
302+ #: ../../library/html.parser.rst:310
292303msgid "Parsing comments::"
293304msgstr ""
294305
295- #: ../../library/html.parser.rst:310
306+ #: ../../library/html.parser.rst:317
296307msgid ""
297308"Parsing named and numeric character references and converting them to the "
298309"correct char (note: these 3 references are all equivalent to ``'>'``)::"
299310msgstr ""
300311
301- #: ../../library/html.parser.rst:318
312+ #: ../../library/html.parser.rst:325
302313msgid ""
303314"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, but :meth:"
304- "`~HTMLParser.handle_data` might be called more than once(unless "
305- "*convert_charrefs* isset to ``True``) ::"
315+ "`~HTMLParser.handle_data` might be called more than onceif "
316+ "*convert_charrefs* isfalse ::"
306317msgstr ""
307318
308- #: ../../library/html.parser.rst:331
319+ #: ../../library/html.parser.rst:338
309320msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::"
310321msgstr ""
311322