python-docs-fr/library/sgmllib.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-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 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 <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/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 ``<tag attr=\"value\" ...>`` and ``</"
"tag>``, 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 ``<!--text-->``.  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 ``<PLAINTEXT>`` 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 ""