xml.sax.handler.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-05-09 00:03+0000\n"
"PO-Revision-Date: 2016-11-19 00:36+0000\n"
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/xml.sax.handler.rst:2
msgid ":mod:`!xml.sax.handler` --- Base classes for SAX handlers"
msgstr ":mod:`!xml.sax.handler` --- SAX 處理函式的基本類別"

#: ../../library/xml.sax.handler.rst:10
msgid "**Source code:** :source:`Lib/xml/sax/handler.py`"
msgstr "**原始碼：**\\ :source:`Lib/xml/sax/handler.py`"

#: ../../library/xml.sax.handler.rst:14
msgid ""
"The SAX API defines five kinds of handlers: content handlers, DTD handlers, "
"error handlers, entity resolvers and lexical handlers. 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 ""

#: ../../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 ""

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

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

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.sax.handler.rst:53
msgid ""
"Interface used by the parser to represent low frequency events which may not "
"be of interest to many applications."
msgstr ""

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

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

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

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

#: ../../library/xml.sax.handler.rst:66 ../../library/xml.sax.handler.rst:76
#: ../../library/xml.sax.handler.rst:85 ../../library/xml.sax.handler.rst:94
#: ../../library/xml.sax.handler.rst:102 ../../library/xml.sax.handler.rst:112
#: ../../library/xml.sax.handler.rst:144
msgid "access: (parsing) read-only; (not parsing) read/write"
msgstr ""

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#: ../../library/xml.sax.handler.rst:126 ../../library/xml.sax.handler.rst:135
msgid "access: read/write"
msgstr ""

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

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

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

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

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

#: ../../library/xml.sax.handler.rst:143
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 ""

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

#: ../../library/xml.sax.handler.rst:150
msgid "data type: Bytes"
msgstr ""

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

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

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

#: ../../library/xml.sax.handler.rst:164
msgid "ContentHandler Objects"
msgstr "ContentHandler 物件"

#: ../../library/xml.sax.handler.rst:166
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 ""

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

#: ../../library/xml.sax.handler.rst:176
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 ""

#: ../../library/xml.sax.handler.rst:181
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 ""

#: ../../library/xml.sax.handler.rst:188
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 ""

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

#: ../../library/xml.sax.handler.rst:197
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 ""

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

#: ../../library/xml.sax.handler.rst:205
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 ""

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

#: ../../library/xml.sax.handler.rst:215
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 ""

#: ../../library/xml.sax.handler.rst:220
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 ""

#: ../../library/xml.sax.handler.rst:228
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 ""

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

#: ../../library/xml.sax.handler.rst:240
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 ""

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

#: ../../library/xml.sax.handler.rst:249
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 ""

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

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

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

#: ../../library/xml.sax.handler.rst:271
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 ""

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

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

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

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

#: ../../library/xml.sax.handler.rst:298
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 ""

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

#: ../../library/xml.sax.handler.rst:309
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 ""

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

#: ../../library/xml.sax.handler.rst:320
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 ""

#: ../../library/xml.sax.handler.rst:325
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 ""

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

#: ../../library/xml.sax.handler.rst:335
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 ""

#: ../../library/xml.sax.handler.rst:339
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 ""

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

#: ../../library/xml.sax.handler.rst:347
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 ""

#: ../../library/xml.sax.handler.rst:357
msgid "DTDHandler Objects"
msgstr "DTDHandler 物件"

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

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

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

#: ../../library/xml.sax.handler.rst:375
msgid "EntityResolver Objects"
msgstr "EntityResolver 物件"

#: ../../library/xml.sax.handler.rst:380
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 ""

#: ../../library/xml.sax.handler.rst:388
msgid "ErrorHandler Objects"
msgstr "ErrorHandler 物件"

#: ../../library/xml.sax.handler.rst:390
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:`~xml.sax.SAXParseException` as the only "
"parameter.  Errors and warnings may be converted to an exception by raising "
"the passed-in exception object."
msgstr ""

#: ../../library/xml.sax.handler.rst:403
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 ""

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

#: ../../library/xml.sax.handler.rst:417
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 ""

#: ../../library/xml.sax.handler.rst:426
msgid "LexicalHandler Objects"
msgstr "LexicalHandler 物件"

#: ../../library/xml.sax.handler.rst:427
msgid "Optional SAX2 handler for lexical events."
msgstr ""

#: ../../library/xml.sax.handler.rst:429
msgid ""
"This handler is used to obtain lexical information about an XML document. "
"Lexical information includes information describing the document encoding "
"used and XML comments embedded in the document, as well as section "
"boundaries for the DTD and for any CDATA sections. The lexical handlers are "
"used in the same manner as content handlers."
msgstr ""

#: ../../library/xml.sax.handler.rst:435
msgid ""
"Set the LexicalHandler of an XMLReader by using the setProperty method with "
"the property identifier ``'http://xml.org/sax/properties/lexical-handler'``."
msgstr ""

#: ../../library/xml.sax.handler.rst:442
msgid ""
"Reports a comment anywhere in the document (including the DTD and outside "
"the document element)."
msgstr ""

#: ../../library/xml.sax.handler.rst:447
msgid ""
"Reports the start of the DTD declarations if the document has an associated "
"DTD."
msgstr ""

#: ../../library/xml.sax.handler.rst:452
msgid "Reports the end of DTD declaration."
msgstr ""

#: ../../library/xml.sax.handler.rst:456
msgid "Reports the start of a CDATA marked section."
msgstr ""

#: ../../library/xml.sax.handler.rst:458
msgid ""
"The contents of the CDATA marked section will be reported through the "
"characters handler."
msgstr ""

#: ../../library/xml.sax.handler.rst:463
msgid "Reports the end of a CDATA marked section."
msgstr ""