# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 2.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:44+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/sgmllib.rst:2 msgid ":mod:`sgmllib` --- Simple SGML parser" msgstr "" #: ../Doc/library/sgmllib.rst:8 msgid "The :mod:`sgmllib` module has been removed in Python 3." msgstr "" #: ../Doc/library/sgmllib.rst:13 msgid "" "This module defines a class :class:`SGMLParser` which serves as the basis " "for parsing text files formatted in SGML (Standard Generalized Mark-up " "Language). In fact, it does not provide a full SGML parser --- it only " "parses SGML insofar as it is used by HTML, and the module only exists as a " "base for the :mod:`htmllib` module. Another HTML parser which supports " "XHTML and offers a somewhat different interface is available in the :mod:" "`HTMLParser` module." msgstr "" #: ../Doc/library/sgmllib.rst:23 msgid "" "The :class:`SGMLParser` class is instantiated without arguments. The parser " "is hardcoded to recognize the following constructs:" msgstr "" #: ../Doc/library/sgmllib.rst:26 msgid "" "Opening and closing tags of the form ```` and ````, respectively." msgstr "" #: ../Doc/library/sgmllib.rst:29 msgid "Numeric character references of the form ``&#name;``." msgstr "" #: ../Doc/library/sgmllib.rst:31 msgid "Entity references of the form ``&name;``." msgstr "" #: ../Doc/library/sgmllib.rst:33 msgid "" "SGML comments of the form ````. Note that spaces, tabs, and " "newlines are allowed between the trailing ``>`` and the immediately " "preceding ``--``." msgstr "" #: ../Doc/library/sgmllib.rst:37 msgid "A single exception is defined as well:" msgstr "" #: ../Doc/library/sgmllib.rst:42 msgid "" "Exception raised by the :class:`SGMLParser` class when it encounters an " "error while parsing." msgstr "" #: ../Doc/library/sgmllib.rst:47 msgid ":class:`SGMLParser` instances have the following methods:" msgstr "" #: ../Doc/library/sgmllib.rst:52 msgid "" "Reset the instance. Loses all unprocessed data. This is called implicitly " "at instantiation time." msgstr "" #: ../Doc/library/sgmllib.rst:58 msgid "" "Stop processing tags. Treat all following input as literal input (CDATA). " "(This is only provided so the HTML tag ```` can be implemented.)" msgstr "" #: ../Doc/library/sgmllib.rst:64 msgid "Enter literal mode (CDATA mode)." msgstr "" #: ../Doc/library/sgmllib.rst:69 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." msgstr "" #: ../Doc/library/sgmllib.rst:76 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 :meth:`close`." msgstr "" #: ../Doc/library/sgmllib.rst:84 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 "" #: ../Doc/library/sgmllib.rst:92 msgid "" "This method is called to handle start tags for which either a :meth:" "`start_tag` or :meth:`do_tag` method has been defined. The *tag* argument " "is the name of the tag converted to lower case, and the *method* argument is " "the bound method which should be used to support semantic interpretation of " "the start tag. The *attributes* argument is a list of ``(name, value)`` " "pairs containing the attributes found inside the tag's ``<>`` brackets." msgstr "" #: ../Doc/library/sgmllib.rst:99 msgid "" "The *name* has been translated to lower case. Double quotes and backslashes " "in the *value* have been interpreted, as well as known character references " "and known entity references terminated by a semicolon (normally, entity " "references can be terminated by any non-alphanumerical character, but this " "would break the very common case of ``<A HREF=\"url?spam=1&eggs=2\">`` when " "``eggs`` is a valid entity name)." msgstr "" #: ../Doc/library/sgmllib.rst:106 msgid "" "For instance, for the tag ``<A HREF=\"http://www.cwi.nl/\">``, this method " "would be called as ``unknown_starttag('a', [('href', 'http://www.cwi." "nl/')])``. The base implementation simply calls *method* with *attributes* " "as the only argument." msgstr "" #: ../Doc/library/sgmllib.rst:111 msgid "Handling of entity and character references within attribute values." msgstr "" #: ../Doc/library/sgmllib.rst:117 msgid "" "This method is called to handle endtags for which an :meth:`end_tag` method " "has been defined. The *tag* argument is the name of the tag converted to " "lower case, and the *method* argument is the bound method which should be " "used to support semantic interpretation of the end tag. If no :meth:" "`end_tag` method is defined for the closing element, this handler is not " "called. The base implementation simply calls *method*." msgstr "" #: ../Doc/library/sgmllib.rst:127 msgid "" "This method is called to process arbitrary data. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:133 msgid "" "This method is called to process a character reference of the form ``&#ref;" "``. The base implementation uses :meth:`convert_charref` to convert the " "reference to a string. If that method returns a string, it is passed to :" "meth:`handle_data`, otherwise ``unknown_charref(ref)`` is called to handle " "the error." msgstr "" #: ../Doc/library/sgmllib.rst:138 msgid "Use :meth:`convert_charref` instead of hard-coding the conversion." msgstr "" #: ../Doc/library/sgmllib.rst:144 msgid "" "Convert a character reference to a string, or ``None``. *ref* is the " "reference passed in as a string. In the base implementation, *ref* must be " "a decimal number in the range 0-255. It converts the code point found using " "the :meth:`convert_codepoint` method. If *ref* is invalid or out of range, " "this method returns ``None``. This method is called by the default :meth:" "`handle_charref` implementation and by the attribute value parser." msgstr "" #: ../Doc/library/sgmllib.rst:156 msgid "" "Convert a code point to a :class:`str` value. Encodings can be handled here " "if appropriate, though the rest of :mod:`sgmllib` is oblivious on this " "matter." msgstr "" #: ../Doc/library/sgmllib.rst:164 msgid "" "This method is called to process a general entity reference of the form " "``&ref;`` where *ref* is a general entity reference. It converts *ref* by " "passing it to :meth:`convert_entityref`. If a translation is returned, it " "calls the method :meth:`handle_data` with the translation; otherwise, it " "calls the method ``unknown_entityref(ref)``. The default :attr:`entitydefs` " "defines translations for ``&amp;``, ``&apos``, ``&gt;``, ``&lt;``, and " "``&quot;``." msgstr "" #: ../Doc/library/sgmllib.rst:171 msgid "Use :meth:`convert_entityref` instead of hard-coding the conversion." msgstr "" #: ../Doc/library/sgmllib.rst:177 msgid "" "Convert a named entity reference to a :class:`str` value, or ``None``. The " "resulting value will not be parsed. *ref* will be only the name of the " "entity. The default implementation looks for *ref* in the instance (or " "class) variable :attr:`entitydefs` which should be a mapping from entity " "names to corresponding translations. If no translation is available for " "*ref*, this method returns ``None``. This method is called by the default :" "meth:`handle_entityref` implementation and by the attribute value parser." msgstr "" #: ../Doc/library/sgmllib.rst:190 msgid "" "This method is called when a comment is encountered. The *comment* argument " "is a string containing the text between the ``<!--`` and ``-->`` delimiters, " "but not the delimiters themselves. For example, the comment ``<!--text-->`` " "will cause this method to be called with the argument ``'text'``. The " "default method does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:199 msgid "" "Method called when an SGML declaration is read by the parser. In practice, " "the ``DOCTYPE`` declaration is the only thing observed in HTML, but the " "parser does not discriminate among different (or broken) declarations. " "Internal subsets in a ``DOCTYPE`` declaration are not supported. The *data* " "parameter will be the entire contents of the declaration inside the ``<!``..." "\\ ``>`` markup. The default implementation does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:209 msgid "" "This method is called when an end tag is found which does not correspond to " "any open element." msgstr "" #: ../Doc/library/sgmllib.rst:215 msgid "" "This method is called to process an unknown start tag. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:221 msgid "" "This method is called to process an unknown end tag. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:227 msgid "" "This method is called to process unresolvable numeric character references. " "Refer to :meth:`handle_charref` to determine what is handled by default. It " "is intended to be overridden by a derived class; the base class " "implementation does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:235 msgid "" "This method is called to process an unknown entity reference. It is " "intended to be overridden by a derived class; the base class implementation " "does nothing." msgstr "" #: ../Doc/library/sgmllib.rst:238 msgid "" "Apart from overriding or extending the methods listed above, derived classes " "may also define methods of the following form to define processing of " "specific tags. Tag names in the input stream are case independent; the *tag* " "occurring in method names must be in lower case:" msgstr "" #: ../Doc/library/sgmllib.rst:247 msgid "" "This method is called to process an opening tag *tag*. It has preference " "over :meth:`do_tag`. The *attributes* argument has the same meaning as " "described for :meth:`handle_starttag` above." msgstr "" #: ../Doc/library/sgmllib.rst:255 msgid "" "This method is called to process an opening tag *tag* for which no :meth:" "`start_tag` method is defined. The *attributes* argument has the same " "meaning as described for :meth:`handle_starttag` above." msgstr "" #: ../Doc/library/sgmllib.rst:263 msgid "This method is called to process a closing tag *tag*." msgstr "" #: ../Doc/library/sgmllib.rst:265 msgid "" "Note that the parser maintains a stack of open elements for which no end tag " "has been found yet. Only tags processed by :meth:`start_tag` are pushed on " "this stack. Definition of an :meth:`end_tag` method is optional for these " "tags. For tags processed by :meth:`do_tag` or by :meth:`unknown_tag`, no :" "meth:`end_tag` method must be defined; if defined, it will not be used. If " "both :meth:`start_tag` and :meth:`do_tag` methods exist for a tag, the :meth:" "`start_tag` method takes precedence." msgstr ""