# 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/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 " "`_ 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 `_" msgstr "" "`Spécification Level 1 Document Object Model (DOM) `_" #: ../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 ""