Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 65 additions & 54 deletions 3.10/locale/pot/LC_MESSAGES/library/html.parser.pot
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-10-29 08:23+0000\n"
"POT-Creation-Date: 2026-09-02 12:33+0000\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"
Expand Down Expand Up @@ -38,105 +38,116 @@ msgstr ""

#: ../../../library/html.parser.rst:22
msgid ""
"If *convert_charrefs* is ``True`` (the default), all character references "
"(except the ones in ``script``/``style`` elements) are automatically "
"converted to the corresponding Unicode characters."
"If *convert_charrefs* is true (the default), all character references "
"(except the ones in elements like ``script`` and ``style``) are "
"automatically converted to the corresponding Unicode characters."
msgstr ""

#: ../../../library/html.parser.rst:26
msgid ""
"If *scripting* is false (the default), the content of the ``noscript`` "
"element is parsed normally; if it's true, it's returned as is without being "
"parsed."
msgstr ""

#: ../../../library/html.parser.rst:30
msgid ""
"An :class:`.HTMLParser` instance is fed HTML data and calls handler methods "
"when start tags, end tags, text, comments, and other markup elements are "
"encountered. The user should subclass :class:`.HTMLParser` and override its "
"methods to implement the desired behavior."
msgstr ""

#: ../../../library/html.parser.rst:31
#: ../../../library/html.parser.rst:35
msgid ""
"This parser does not check that end tags match start tags or call the end-"
"tag handler for elements which are closed implicitly by closing an outer "
"element."
msgstr ""

#: ../../../library/html.parser.rst:34
#: ../../../library/html.parser.rst:38
msgid "*convert_charrefs* keyword argument added."
msgstr ""

#: ../../../library/html.parser.rst:37
#: ../../../library/html.parser.rst:41
msgid "The default value for argument *convert_charrefs* is now ``True``."
msgstr ""

#: ../../../library/html.parser.rst:42
#: ../../../library/html.parser.rst:44
msgid "Added the *scripting* parameter."
msgstr ""

#: ../../../library/html.parser.rst:49
msgid "Example HTML Parser Application"
msgstr ""

#: ../../../library/html.parser.rst:44
#: ../../../library/html.parser.rst:51
msgid ""
"As a basic example, below is a simple HTML parser that uses the :class:"
"`HTMLParser` class to print out start tags, end tags, and data as they are "
"encountered::"
msgstr ""

#: ../../../library/html.parser.rst:64
#: ../../../library/html.parser.rst:71
msgid "The output will then be:"
msgstr ""

#: ../../../library/html.parser.rst:83
#: ../../../library/html.parser.rst:90
msgid ":class:`.HTMLParser` Methods"
msgstr ""

#: ../../../library/html.parser.rst:85
#: ../../../library/html.parser.rst:92
msgid ":class:`HTMLParser` instances have the following methods:"
msgstr ""

#: ../../../library/html.parser.rst:90
#: ../../../library/html.parser.rst:97
msgid ""
"Feed some text to the parser. It is processed insofar as it consists of "
"complete elements; incomplete data is buffered until more data is fed or :"
"meth:`close` is called. *data* must be :class:`str`."
msgstr ""

#: ../../../library/html.parser.rst:97
#: ../../../library/html.parser.rst:104
msgid ""
"Force processing of all buffered data as if it were followed by an end-of-"
"file mark. This method may be redefined by a derived class to define "
"additional processing at the end of the input, but the redefined version "
"should always call the :class:`HTMLParser` base class method :meth:`close`."
msgstr ""

#: ../../../library/html.parser.rst:105
#: ../../../library/html.parser.rst:112
msgid ""
"Reset the instance. Loses all unprocessed data. This is called implicitly "
"at instantiation time."
msgstr ""

#: ../../../library/html.parser.rst:111
#: ../../../library/html.parser.rst:118
msgid "Return current line number and offset."
msgstr ""

#: ../../../library/html.parser.rst:116
#: ../../../library/html.parser.rst:123
msgid ""
"Return the text of the most recently opened start tag. This should not "
"normally be needed for structured processing, but may be useful in dealing "
"with HTML \"as deployed\" or for re-generating input with minimal changes "
"(whitespace between attributes can be preserved, etc.)."
msgstr ""

#: ../../../library/html.parser.rst:122
#: ../../../library/html.parser.rst:129
msgid ""
"The following methods are called when data or markup elements are "
"encountered and they are meant to be overridden in a subclass. The base "
"class implementations do nothing (except for :meth:`~HTMLParser."
"handle_startendtag`):"
msgstr ""

#: ../../../library/html.parser.rst:129
#: ../../../library/html.parser.rst:136
msgid ""
"This method is called to handle the start tag of an element (e.g. ``<div "
"id=\"main\">``)."
msgstr ""

#: ../../../library/html.parser.rst:131
#: ../../../library/html.parser.rst:138
msgid ""
"The *tag* argument is the name of the tag converted to lower case. The "
"*attrs* argument is a list of ``(name, value)`` pairs containing the "
Expand All @@ -145,29 +156,29 @@ msgid ""
"character and entity references have been replaced."
msgstr ""

#: ../../../library/html.parser.rst:137
#: ../../../library/html.parser.rst:144
msgid ""
"For instance, for the tag ``<A HREF=\"https://www.cwi.nl/\">``, this method "
"would be called as ``handle_starttag('a', [('href', 'https://www.cwi."
"nl/')])``."
msgstr ""

#: ../../../library/html.parser.rst:140
#: ../../../library/html.parser.rst:147
msgid ""
"All entity references from :mod:`html.entities` are replaced in the "
"attribute values."
msgstr ""

#: ../../../library/html.parser.rst:146
#: ../../../library/html.parser.rst:153
msgid ""
"This method is called to handle the end tag of an element (e.g. ``</div>``)."
msgstr ""

#: ../../../library/html.parser.rst:148
#: ../../../library/html.parser.rst:155
msgid "The *tag* argument is the name of the tag converted to lower case."
msgstr ""

#: ../../../library/html.parser.rst:153
#: ../../../library/html.parser.rst:160
msgid ""
"Similar to :meth:`handle_starttag`, but called when the parser encounters an "
"XHTML-style empty tag (``<img ... />``). This method may be overridden by "
Expand All @@ -176,61 +187,61 @@ msgid ""
"`handle_endtag`."
msgstr ""

#: ../../../library/html.parser.rst:161
#: ../../../library/html.parser.rst:168
msgid ""
"This method is called to process arbitrary data (e.g. text nodes and the "
"content of ``<script>...</script>`` and ``<style>...</style>``)."
"content of elements like ``script`` and ``style``)."
msgstr ""

#: ../../../library/html.parser.rst:167
#: ../../../library/html.parser.rst:174
msgid ""
"This method is called to process a named character reference of the form "
"``&name;`` (e.g. ``&gt;``), where *name* is a general entity reference (e.g. "
"``'gt'``). This method is never called if *convert_charrefs* is ``True``."
"``'gt'``). This method is only called if *convert_charrefs* is false."
msgstr ""

#: ../../../library/html.parser.rst:175
#: ../../../library/html.parser.rst:182
msgid ""
"This method is called to process decimal and hexadecimal numeric character "
"references of the form ``&#NNN;`` and ``&#xNNN;``. For example, the decimal "
"equivalent for ``&gt;`` is ``&#62;``, whereas the hexadecimal is ``&#x3E;``; "
"in this case the method will receive ``'62'`` or ``'x3E'``. This method is "
"never called if *convert_charrefs* is ``True``."
"in this case the method will receive ``'62'`` or ``'x3E'``. This method is "
"only called if *convert_charrefs* is false."
msgstr ""

#: ../../../library/html.parser.rst:184
#: ../../../library/html.parser.rst:191
msgid ""
"This method is called when a comment is encountered (e.g. ``<!--comment--"
">``)."
msgstr ""

#: ../../../library/html.parser.rst:186
#: ../../../library/html.parser.rst:193
msgid ""
"For example, the comment ``<!-- comment -->`` will cause this method to be "
"called with the argument ``' comment '``."
msgstr ""

#: ../../../library/html.parser.rst:189
#: ../../../library/html.parser.rst:196
msgid ""
"The content of Internet Explorer conditional comments (condcoms) will also "
"be sent to this method, so, for ``<!--[if IE 9]>IE9-specific content<!"
"[endif]-->``, this method will receive ``'[if IE 9]>IE9-specific content<!"
"[endif]'``."
msgstr ""

#: ../../../library/html.parser.rst:196
#: ../../../library/html.parser.rst:203
msgid ""
"This method is called to handle an HTML doctype declaration (e.g. ``<!"
"DOCTYPE html>``)."
msgstr ""

#: ../../../library/html.parser.rst:199
#: ../../../library/html.parser.rst:206
msgid ""
"The *decl* parameter will be the entire contents of the declaration inside "
"the ``<!...>`` markup (e.g. ``'DOCTYPE html'``)."
msgstr ""

#: ../../../library/html.parser.rst:205
#: ../../../library/html.parser.rst:212
msgid ""
"Method called when a processing instruction is encountered. The *data* "
"parameter will contain the entire processing instruction. For example, for "
Expand All @@ -239,67 +250,67 @@ msgid ""
"overridden by a derived class; the base class implementation does nothing."
msgstr ""

#: ../../../library/html.parser.rst:213
#: ../../../library/html.parser.rst:220
msgid ""
"The :class:`HTMLParser` class uses the SGML syntactic rules for processing "
"instructions. An XHTML processing instruction using the trailing ``'?'`` "
"will cause the ``'?'`` to be included in *data*."
msgstr ""

#: ../../../library/html.parser.rst:220
#: ../../../library/html.parser.rst:227
msgid ""
"This method is called when an unrecognized declaration is read by the parser."
msgstr ""

#: ../../../library/html.parser.rst:222
#: ../../../library/html.parser.rst:229
msgid ""
"The *data* parameter will be the entire contents of the declaration inside "
"the ``<![...]>`` markup. It is sometimes useful to be overridden by a "
"derived class. The base class implementation does nothing."
msgstr ""

#: ../../../library/html.parser.rst:230
#: ../../../library/html.parser.rst:237
msgid "Examples"
msgstr ""

#: ../../../library/html.parser.rst:232
#: ../../../library/html.parser.rst:239
msgid ""
"The following class implements a parser that will be used to illustrate more "
"examples::"
msgstr ""

#: ../../../library/html.parser.rst:269
#: ../../../library/html.parser.rst:276
msgid "Parsing a doctype::"
msgstr ""

#: ../../../library/html.parser.rst:275
#: ../../../library/html.parser.rst:282
msgid "Parsing an element with a few attributes and a title::"
msgstr ""

#: ../../../library/html.parser.rst:287
#: ../../../library/html.parser.rst:294
msgid ""
"The content of ``script`` and ``style`` elements is returned as is, without "
"further parsing::"
"The content of elements like ``script`` and ``style`` is returned as is, "
"without further parsing::"
msgstr ""

#: ../../../library/html.parser.rst:303
#: ../../../library/html.parser.rst:310
msgid "Parsing comments::"
msgstr ""

#: ../../../library/html.parser.rst:310
#: ../../../library/html.parser.rst:317
msgid ""
"Parsing named and numeric character references and converting them to the "
"correct char (note: these 3 references are all equivalent to ``'>'``)::"
msgstr ""

#: ../../../library/html.parser.rst:318
#: ../../../library/html.parser.rst:325
msgid ""
"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, but :meth:"
"`~HTMLParser.handle_data` might be called more than once (unless "
"*convert_charrefs* is set to ``True``)::"
"`~HTMLParser.handle_data` might be called more than once if "
"*convert_charrefs* is false::"
msgstr ""

#: ../../../library/html.parser.rst:331
#: ../../../library/html.parser.rst:338
msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::"
msgstr ""

Expand Down
Loading