python-docs-fr/library/xml.dom.minidom.po

376 lines
14 KiB
Plaintext

# 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/xml.dom.minidom.rst:2
msgid ":mod:`xml.dom.minidom` --- Minimal DOM implementation"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:13
msgid "**Source code:** :source:`Lib/xml/dom/minidom.py`"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:17
msgid ""
":mod:`xml.dom.minidom` is a minimal implementation of the Document Object "
"Model interface, with an API similar to that in other languages. It is "
"intended to be simpler than the full DOM and also significantly smaller. "
"Users who are not already proficient with the DOM should consider using the :"
"mod:`xml.etree.ElementTree` module for their XML processing instead."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:26
msgid ""
"The :mod:`xml.dom.minidom` module is not secure against maliciously "
"constructed data. If you need to parse untrusted or unauthenticated data "
"see :ref:`xml-vulnerabilities`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:31
msgid ""
"DOM applications typically start by parsing some XML into a DOM. With :mod:"
"`xml.dom.minidom`, this is done through the parse functions::"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:43
msgid ""
"The :func:`parse` function can take either a filename or an open file object."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:48
msgid ""
"Return a :class:`Document` from the given input. *filename_or_file* may be "
"either a file name, or a file-like object. *parser*, if given, must be a "
"SAX2 parser object. This function will change the document handler of the "
"parser and activate namespace support; other parser configuration (like "
"setting an entity resolver) must have been done in advance."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:54
msgid ""
"If you have XML in a string, you can use the :func:`parseString` function "
"instead:"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:60
msgid ""
"Return a :class:`Document` that represents the *string*. This method creates "
"a :class:`~StringIO.StringIO` object for the string and passes that on to :"
"func:`parse`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:63
msgid ""
"Both functions return a :class:`Document` object representing the content of "
"the document."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:66
msgid ""
"What the :func:`parse` and :func:`parseString` functions do is connect an "
"XML parser with a \"DOM builder\" that can accept parse events from any SAX "
"parser and convert them into a DOM tree. The name of the functions are "
"perhaps misleading, but are easy to grasp when learning the interfaces. The "
"parsing of the document will be completed before these functions return; "
"it's simply that these functions do not provide a parser implementation "
"themselves."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:73
msgid ""
"You can also create a :class:`Document` by calling a method on a \"DOM "
"Implementation\" object. You can get this object either by calling the :"
"func:`getDOMImplementation` function in the :mod:`xml.dom` package or the :"
"mod:`xml.dom.minidom` module. Using the implementation from the :mod:`xml."
"dom.minidom` module will always return a :class:`Document` instance from the "
"minidom implementation, while the version from :mod:`xml.dom` may provide an "
"alternate implementation (this is likely if you have the `PyXML package "
"<http://pyxml.sourceforge.net/>`_ installed). Once you have a :class:"
"`Document`, you can add child nodes to it to populate the DOM::"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:92
msgid ""
"Once you have a DOM document object, you can access the parts of your XML "
"document through its properties and methods. These properties are defined "
"in the DOM specification. The main property of the document object is the :"
"attr:`documentElement` property. It gives you the main element in the XML "
"document: the one that holds all others. Here is an example program::"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:101
msgid ""
"When you are finished with a DOM tree, you may optionally call the :meth:"
"`unlink` method to encourage early cleanup of the now-unneeded objects. :"
"meth:`unlink` is an :mod:`xml.dom.minidom`\\ -specific extension to the DOM "
"API that renders the node and its descendants are essentially useless. "
"Otherwise, Python's garbage collector will eventually take care of the "
"objects in the tree."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:110
msgid ""
"`Document Object Model (DOM) Level 1 Specification <https://www.w3.org/TR/"
"REC-DOM-Level-1/>`_"
msgstr ""
"`Spécification Level 1 Document Object Model (DOM) <https://www.w3.org/TR/"
"REC-DOM-Level-1/>`_"
#: ../Doc/library/xml.dom.minidom.rst:111
msgid "The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`."
msgstr ""
"La recommandation du *W3C* pour le DOM supporté par :mod:`xml.dom.minidom`."
#: ../Doc/library/xml.dom.minidom.rst:117
msgid "DOM Objects"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:119
msgid ""
"The definition of the DOM API for Python is given as part of the :mod:`xml."
"dom` module documentation. This section lists the differences between the "
"API and :mod:`xml.dom.minidom`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:126
msgid ""
"Break internal references within the DOM so that it will be garbage "
"collected on versions of Python without cyclic GC. Even when cyclic GC is "
"available, using this can make large amounts of memory available sooner, so "
"calling this on DOM objects as soon as they are no longer needed is good "
"practice. This only needs to be called on the :class:`Document` object, but "
"may be called on child nodes to discard children of that node."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:136
msgid ""
"Write XML to the writer object. The writer should have a :meth:`write` "
"method which matches that of the file object interface. The *indent* "
"parameter is the indentation of the current node. The *addindent* parameter "
"is the incremental indentation to use for subnodes of the current one. The "
"*newl* parameter specifies the string to use to terminate newlines."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:142
#: ../Doc/library/xml.dom.minidom.rst:149
msgid ""
"For the :class:`Document` node, an additional keyword argument *encoding* "
"can be used to specify the encoding field of the XML header."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:145
msgid ""
"The optional keyword parameters *indent*, *addindent*, and *newl* were added "
"to support pretty output."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:156
msgid "Return the XML that the DOM represents as a string."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:158
msgid ""
"With no argument, the XML header does not specify an encoding, and the "
"result is Unicode string if the default encoding cannot represent all "
"characters in the document. Encoding this string in an encoding other than "
"UTF-8 is likely incorrect, since UTF-8 is the default encoding of XML."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:163
msgid ""
"With an explicit *encoding* [1]_ argument, the result is a byte string in "
"the specified encoding. It is recommended that this argument is always "
"specified. To avoid :exc:`UnicodeError` exceptions in case of "
"unrepresentable text data, the encoding argument should be specified as "
"\"utf-8\"."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:168
msgid "the *encoding* argument was introduced; see :meth:`writexml`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:174
msgid ""
"Return a pretty-printed version of the document. *indent* specifies the "
"indentation string and defaults to a tabulator; *newl* specifies the string "
"emitted at the end of each line and defaults to ``\\n``."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:180
msgid "the encoding argument was introduced; see :meth:`writexml`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:183
msgid ""
"The following standard DOM methods have special considerations with :mod:"
"`xml.dom.minidom`:"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:189
msgid ""
"Although this method was present in the version of :mod:`xml.dom.minidom` "
"packaged with Python 2.0, it was seriously broken. This has been corrected "
"for subsequent releases."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:197
msgid "DOM Example"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:199
msgid ""
"This example program is a fairly realistic example of a simple program. In "
"this particular case, we do not take much advantage of the flexibility of "
"the DOM."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:208
msgid "minidom and the DOM standard"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:210
msgid ""
"The :mod:`xml.dom.minidom` module is essentially a DOM 1.0-compatible DOM "
"with some DOM 2 features (primarily namespace features)."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:213
msgid ""
"Usage of the DOM interface in Python is straight-forward. The following "
"mapping rules apply:"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:216
msgid ""
"Interfaces are accessed through instance objects. Applications should not "
"instantiate the classes themselves; they should use the creator functions "
"available on the :class:`Document` object. Derived interfaces support all "
"operations (and attributes) from the base interfaces, plus any new "
"operations."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:221
msgid ""
"Operations are used as methods. Since the DOM uses only :keyword:`in` "
"parameters, the arguments are passed in normal order (from left to right). "
"There are no optional arguments. ``void`` operations return ``None``."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:225
msgid ""
"IDL attributes map to instance attributes. For compatibility with the OMG "
"IDL language mapping for Python, an attribute ``foo`` can also be accessed "
"through accessor methods :meth:`_get_foo` and :meth:`_set_foo`. "
"``readonly`` attributes must not be changed; this is not enforced at runtime."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:230
msgid ""
"The types ``short int``, ``unsigned int``, ``unsigned long long``, and "
"``boolean`` all map to Python integer objects."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:233
msgid ""
"The type ``DOMString`` maps to Python strings. :mod:`xml.dom.minidom` "
"supports either byte or Unicode strings, but will normally produce Unicode "
"strings. Values of type ``DOMString`` may also be ``None`` where allowed to "
"have the IDL ``null`` value by the DOM specification from the W3C."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:238
msgid ""
"``const`` declarations map to variables in their respective scope (e.g. "
"``xml.dom.minidom.Node.PROCESSING_INSTRUCTION_NODE``); they must not be "
"changed."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:241
msgid ""
"``DOMException`` is currently not supported in :mod:`xml.dom.minidom`. "
"Instead, :mod:`xml.dom.minidom` uses standard Python exceptions such as :exc:"
"`TypeError` and :exc:`AttributeError`."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:245
msgid ""
":class:`NodeList` objects are implemented using Python's built-in list type. "
"Starting with Python 2.2, these objects provide the interface defined in the "
"DOM specification, but with earlier versions of Python they do not support "
"the official API. They are, however, much more \"Pythonic\" than the "
"interface defined in the W3C recommendations."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:251
msgid ""
"The following interfaces have no implementation in :mod:`xml.dom.minidom`:"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:253
msgid ":class:`DOMTimeStamp`"
msgstr ":class:`DOMTimeStamp`"
#: ../Doc/library/xml.dom.minidom.rst:255
msgid ":class:`DocumentType` (added in Python 2.1)"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:257
msgid ":class:`DOMImplementation` (added in Python 2.1)"
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:259
msgid ":class:`CharacterData`"
msgstr ":class:`CharacterData`"
#: ../Doc/library/xml.dom.minidom.rst:261
msgid ":class:`CDATASection`"
msgstr ":class:`CDATASection`"
#: ../Doc/library/xml.dom.minidom.rst:263
msgid ":class:`Notation`"
msgstr ":class:`Notation`"
#: ../Doc/library/xml.dom.minidom.rst:265
msgid ":class:`Entity`"
msgstr ":class:`Entity`"
#: ../Doc/library/xml.dom.minidom.rst:267
msgid ":class:`EntityReference`"
msgstr ":class:`EntityReference`"
#: ../Doc/library/xml.dom.minidom.rst:269
msgid ":class:`DocumentFragment`"
msgstr ":class:`DocumentFragment`"
#: ../Doc/library/xml.dom.minidom.rst:271
msgid ""
"Most of these reflect information in the XML document that is not of general "
"utility to most DOM users."
msgstr ""
#: ../Doc/library/xml.dom.minidom.rst:275
msgid "Footnotes"
msgstr "Notes"
#: ../Doc/library/xml.dom.minidom.rst:276
msgid ""
"The encoding string included in XML output should conform to the appropriate "
"standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://"
"www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://www.iana."
"org/assignments/character-sets/character-sets.xhtml."
msgstr ""