# 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.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-04-02 22:11+0200\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"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/xml.sax.handler.rst:2
msgid ":mod:`xml.sax.handler` --- Base classes for SAX handlers"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:10
msgid "**Source code:** :source:`Lib/xml/sax/handler.py`"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:14
msgid ""
"The SAX API defines four kinds of handlers: content handlers, DTD handlers, "
"error handlers, and entity resolvers. Applications normally only need to "
"implement those interfaces whose events they are interested in; they can "
"implement the interfaces in a single object or in multiple objects. Handler "
"implementations should inherit from the base classes provided in the module :"
"mod:`xml.sax.handler`, so that all methods get default implementations."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:24
msgid ""
"This is the main callback interface in SAX, and the one most important to "
"applications. The order of events in this interface mirrors the order of the "
"information in the document."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:31
msgid "Handle DTD events."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:33
msgid ""
"This interface specifies only those DTD events required for basic parsing "
"(unparsed entities and attributes)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:39
msgid ""
"Basic interface for resolving entities. If you create an object implementing "
"this interface, then register the object with your Parser, the parser will "
"call the method in your object to resolve all external entities."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:46
msgid ""
"Interface used by the parser to present error and warning messages to the "
"application.  The methods of this object control whether errors are "
"immediately converted to exceptions or are handled in some other way."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:50
msgid ""
"In addition to these classes, :mod:`xml.sax.handler` provides symbolic "
"constants for the feature and property names."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:56
msgid "value: ``\"http://xml.org/sax/features/namespaces\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:57
msgid "true: Perform Namespace processing."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:59
msgid ""
"false: Optionally do not perform Namespace processing (implies namespace-"
"prefixes; default)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:60 ../Doc/library/xml.sax.handler.rst:70
#: ../Doc/library/xml.sax.handler.rst:79 ../Doc/library/xml.sax.handler.rst:88
#: ../Doc/library/xml.sax.handler.rst:96 ../Doc/library/xml.sax.handler.rst:106
#: ../Doc/library/xml.sax.handler.rst:138
msgid "access: (parsing) read-only; (not parsing) read/write"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:65
msgid "value: ``\"http://xml.org/sax/features/namespace-prefixes\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:67
msgid ""
"true: Report the original prefixed names and attributes used for Namespace "
"declarations."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:69
msgid ""
"false: Do not report attributes used for Namespace declarations, and "
"optionally do not report original prefixed names (default)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:75
msgid "value: ``\"http://xml.org/sax/features/string-interning\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:77
msgid ""
"true: All element names, prefixes, attribute names, Namespace URIs, and "
"local names are interned using the built-in intern function."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:78
msgid ""
"false: Names are not necessarily interned, although they may be (default)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:84
msgid "value: ``\"http://xml.org/sax/features/validation\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:86
msgid ""
"true: Report all validation errors (implies external-general-entities and "
"external-parameter-entities)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:87
msgid "false: Do not report validation errors."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:93
msgid "value: ``\"http://xml.org/sax/features/external-general-entities\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:94
msgid "true: Include all external general (text) entities."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:95
msgid "false: Do not include external general entities."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:101
msgid "value: ``\"http://xml.org/sax/features/external-parameter-entities\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:103
msgid ""
"true: Include all external parameter entities, including the external DTD "
"subset."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:105
msgid ""
"false: Do not include any external parameter entities, even the external DTD "
"subset."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:111
msgid "List of all features."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:116
msgid "value: ``\"http://xml.org/sax/properties/lexical-handler\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:117
msgid "data type: xml.sax.sax2lib.LexicalHandler (not supported in Python 2)"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:119
msgid ""
"description: An optional extension handler for lexical events like comments."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:120
#: ../Doc/library/xml.sax.handler.rst:129
msgid "access: read/write"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:125
msgid "value: ``\"http://xml.org/sax/properties/declaration-handler\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:126
msgid "data type: xml.sax.sax2lib.DeclHandler (not supported in Python 2)"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:128
msgid ""
"description: An optional extension handler for DTD-related events other than "
"notations and unparsed entities."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:134
msgid "value: ``\"http://xml.org/sax/properties/dom-node\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:135
msgid "data type: org.w3c.dom.Node (not supported in Python 2)"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:137
msgid ""
"description: When parsing, the current DOM node being visited if this is a "
"DOM iterator; when not parsing, the root DOM node for iteration."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:143
msgid "value: ``\"http://xml.org/sax/properties/xml-string\"``"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:144
msgid "data type: String"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:146
msgid ""
"description: The literal string of characters that was the source for the "
"current event."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:147
msgid "access: read-only"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:152
msgid "List of all known property names."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:158
msgid "ContentHandler Objects"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:160
msgid ""
"Users are expected to subclass :class:`ContentHandler` to support their "
"application.  The following methods are called by the parser on the "
"appropriate events in the input document:"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:167
msgid ""
"Called by the parser to give the application a locator for locating the "
"origin of document events."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:170
msgid ""
"SAX parsers are strongly encouraged (though not absolutely required) to "
"supply a locator: if it does so, it must supply the locator to the "
"application by invoking this method before invoking any of the other methods "
"in the DocumentHandler interface."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:175
msgid ""
"The locator allows the application to determine the end position of any "
"document-related event, even if the parser is not reporting an error. "
"Typically, the application will use this information for reporting its own "
"errors (such as character content that does not match an application's "
"business rules). The information returned by the locator is probably not "
"sufficient for use with a search engine."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:182
msgid ""
"Note that the locator will return correct information only during the "
"invocation of the events in this interface. The application should not "
"attempt to use it at any other time."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:189
msgid "Receive notification of the beginning of a document."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:191
msgid ""
"The SAX parser will invoke this method only once, before any other methods "
"in this interface or in DTDHandler (except for :meth:`setDocumentLocator`)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:197
msgid "Receive notification of the end of a document."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:199
msgid ""
"The SAX parser will invoke this method only once, and it will be the last "
"method invoked during the parse. The parser shall not invoke this method "
"until it has either abandoned parsing (because of an unrecoverable error) or "
"reached the end of input."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:207
msgid "Begin the scope of a prefix-URI Namespace mapping."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:209
msgid ""
"The information from this event is not necessary for normal Namespace "
"processing: the SAX XML reader will automatically replace prefixes for "
"element and attribute names when the ``feature_namespaces`` feature is "
"enabled (the default)."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:214
msgid ""
"There are cases, however, when applications need to use prefixes in "
"character data or in attribute values, where they cannot safely be expanded "
"automatically; the :meth:`startPrefixMapping` and :meth:`endPrefixMapping` "
"events supply the information to the application to expand prefixes in those "
"contexts itself, if necessary."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:222
msgid ""
"Note that :meth:`startPrefixMapping` and :meth:`endPrefixMapping` events are "
"not guaranteed to be properly nested relative to each-other: all :meth:"
"`startPrefixMapping` events will occur before the corresponding :meth:"
"`startElement` event, and all :meth:`endPrefixMapping` events will occur "
"after the corresponding :meth:`endElement` event, but their order is not "
"guaranteed."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:232
msgid "End the scope of a prefix-URI mapping."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:234
msgid ""
"See :meth:`startPrefixMapping` for details. This event will always occur "
"after the corresponding :meth:`endElement` event, but the order of :meth:"
"`endPrefixMapping` events is not otherwise guaranteed."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:241
msgid "Signals the start of an element in non-namespace mode."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:243
msgid ""
"The *name* parameter contains the raw XML 1.0 name of the element type as a "
"string and the *attrs* parameter holds an object of the :class:`~xml.sax."
"xmlreader.Attributes` interface (see :ref:`attributes-objects`) containing "
"the attributes of the element.  The object passed as *attrs* may be re-used "
"by the parser; holding on to a reference to it is not a reliable way to keep "
"a copy of the attributes. To keep a copy of the attributes, use the :meth:"
"`copy` method of the *attrs* object."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:255
msgid "Signals the end of an element in non-namespace mode."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:257
msgid ""
"The *name* parameter contains the name of the element type, just as with "
"the :meth:`startElement` event."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:263
msgid "Signals the start of an element in namespace mode."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:265
msgid ""
"The *name* parameter contains the name of the element type as a ``(uri, "
"localname)`` tuple, the *qname* parameter contains the raw XML 1.0 name used "
"in the source document, and the *attrs* parameter holds an instance of the :"
"class:`~xml.sax.xmlreader.AttributesNS` interface (see :ref:`attributes-ns-"
"objects`) containing the attributes of the element.  If no namespace is "
"associated with the element, the *uri* component of *name* will be "
"``None``.  The object passed as *attrs* may be re-used by the parser; "
"holding on to a reference to it is not a reliable way to keep a copy of the "
"attributes.  To keep a copy of the attributes, use the :meth:`copy` method "
"of the *attrs* object."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:276
msgid ""
"Parsers may set the *qname* parameter to ``None``, unless the "
"``feature_namespace_prefixes`` feature is activated."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:282
msgid "Signals the end of an element in namespace mode."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:284
msgid ""
"The *name* parameter contains the name of the element type, just as with "
"the :meth:`startElementNS` method, likewise the *qname* parameter."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:290
msgid "Receive notification of character data."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:292
msgid ""
"The Parser will call this method to report each chunk of character data. SAX "
"parsers may return all contiguous character data in a single chunk, or they "
"may split it into several chunks; however, all of the characters in any "
"single event must come from the same external entity so that the Locator "
"provides useful information."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:298
msgid ""
"*content* may be a string or bytes instance; the ``expat`` reader module "
"always produces strings."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:303
msgid ""
"The earlier SAX 1 interface provided by the Python XML Special Interest "
"Group used a more Java-like interface for this method.  Since most parsers "
"used from Python did not take advantage of the older interface, the simpler "
"signature was chosen to replace it.  To convert old code to the new "
"interface, use *content* instead of slicing content with the old *offset* "
"and *length* parameters."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:312
msgid "Receive notification of ignorable whitespace in element content."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:314
msgid ""
"Validating Parsers must use this method to report each chunk of ignorable "
"whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-"
"validating parsers may also use this method if they are capable of parsing "
"and using content models."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:319
msgid ""
"SAX parsers may return all contiguous whitespace in a single chunk, or they "
"may split it into several chunks; however, all of the characters in any "
"single event must come from the same external entity, so that the Locator "
"provides useful information."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:327
msgid "Receive notification of a processing instruction."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:329
msgid ""
"The Parser will invoke this method once for each processing instruction "
"found: note that processing instructions may occur before or after the main "
"document element."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:333
msgid ""
"A SAX parser should never report an XML declaration (XML 1.0, section 2.8) "
"or a text declaration (XML 1.0, section 4.3.1) using this method."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:339
msgid "Receive notification of a skipped entity."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:341
msgid ""
"The Parser will invoke this method once for each entity skipped. Non-"
"validating processors may skip entities if they have not seen the "
"declarations (because, for example, the entity was declared in an external "
"DTD subset). All processors may skip external entities, depending on the "
"values of the ``feature_external_ges`` and the ``feature_external_pes`` "
"properties."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:351
msgid "DTDHandler Objects"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:353
msgid ":class:`DTDHandler` instances provide the following methods:"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:358
msgid "Handle a notation declaration event."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:363
msgid "Handle an unparsed entity declaration event."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:369
msgid "EntityResolver Objects"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:374
msgid ""
"Resolve the system identifier of an entity and return either the system "
"identifier to read from as a string, or an InputSource to read from. The "
"default implementation returns *systemId*."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:382
msgid "ErrorHandler Objects"
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:384
msgid ""
"Objects with this interface are used to receive error and warning "
"information from the :class:`~xml.sax.xmlreader.XMLReader`.  If you create "
"an object that implements this interface, then register the object with "
"your :class:`~xml.sax.xmlreader.XMLReader`, the parser will call the methods "
"in your object to report all warnings and errors. There are three levels of "
"errors available: warnings, (possibly) recoverable errors, and unrecoverable "
"errors.  All methods take a :exc:`SAXParseException` as the only parameter.  "
"Errors and warnings may be converted to an exception by raising the passed-"
"in exception object."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:397
msgid ""
"Called when the parser encounters a recoverable error.  If this method does "
"not raise an exception, parsing may continue, but further document "
"information should not be expected by the application.  Allowing the parser "
"to continue may allow additional errors to be discovered in the input "
"document."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:405
msgid ""
"Called when the parser encounters an error it cannot recover from; parsing "
"is expected to terminate when this method returns."
msgstr ""

#: ../Doc/library/xml.sax.handler.rst:411
msgid ""
"Called when the parser presents minor warning information to the "
"application. Parsing is expected to continue when this method returns, and "
"document information will continue to be passed to the application. Raising "
"an exception in this method will cause parsing to end."
msgstr ""
