; @c@s dZdZdkZdkZdkZdkZdklZl Z l Z l Z l Z l Z dklZdfdYZdeefdYZd efd YZd efd YZd efdYZdfdYZdfdYZdfdYZdfdYZdfdYZdefdYZdefdYZdfdYZdfd YZd!fd"YZd#efd$YZd%efd&YZd'efd(YZ d)efd*YZ!d+fd,YZ"d-fd.YZ#d/fd0YZ$d1efd2YZ%d3efd4YZ&d5fd6YZ'd7eeefd8YZ(d9eeefd:YZ)d;eeefd<YZ*d=eefd>YZ+d?eefd@YZ,dAeefdBYZ-dCeefdDYZ.dEeefdFYZ/dGeefdHYZ0dIeefdJYZ1dKeefdLYZ2dMeefdNYZ3dOeefdPYZ4dQeefdRYZ5dSeefdTYZ6dUeefdVYZ7dWeefdXYZ8dYeefdZYZ9d[eefd\YZ:d]eefd^YZ;d_eefd`YZ<daeefdbYZ=dceefddYZ>deeefdfYZ?dgeefdhYZ@dieefdjYZAdke#efdlYZBdmeefdnYZCdoe#efdpYZDdqe#efdrYZEdse#efdtYZFdue#efdvYZGdweefdxYZHdye#efdzYZId{e#efd|YZJd}e#efd~YZKde#efdYZLde#efdYZMde#efdYZNdeefdYZOde#efdYZPde#efdYZQde#efdYZRdeefdYZSdeefdYZTdeefdYZUdeefdYZVde#efdYZWde efdYZXde efdYZYde efdYZZde efdYZ[de efdYZ\de efdYZ]de efdYZ^de efdYZ_de efdYZ`de efdYZade!e"eefdYZbde!e"efdYZcde!e"e$ee&fdYZddeee'efdYZedeee'efdYZfde#efdYZgdeefdYZhde#efdYZide#efdYZjdeefdYZkde#efdYZlde#efdYZmde#efdYZnde#efdYZode#efdYZpde#efdYZqde!eeefdYZrde!e"eefdYZsde!e$eefdYZtde$efdYZude$efdYZvde$efdYZwdee$e%efdYZxde$e%efdYZyde$e%efdYZzde$efdYZ{de$efdYZ|de$efdYZ}de$efdYZ~de$efdYZde$efdYZdee$efdYZde$efdYZde$efdYZde$efdYZdiZdfdYZdefdYZdefdYZdZdZdZdZeedefdYZdefdYZdefdYZdefdYZdefdYZdefdYZdefd YZd Zeid Zeid Zd ZdZdZdS(s Docutils document tree element class library. Classes in CamelCase are abstract base classes or auxiliary classes. The one exception is `Text`, for a text (PCDATA) node; uppercase is used to differentiate from element classes. Classes in lower_case_with_underscores are element classes, matching the XML element generic identifiers in the DTD_. The position of each node (the level at which it can occur) is significant and is represented by abstract base classes (`Root`, `Structural`, `Body`, `Inline`, etc.). Certain transformations will be easier because we can use ``isinstance(node, base_class)`` to determine the position of the node in the hierarchy. .. _DTD: http://docutils.sourceforge.net/docs/ref/docutils.dtd sreStructuredTextN(sIntTypes SliceTypes StringTypes UnicodeTypes TupleTypesListType(s UserStringsNodecBsttZdZeZeZeZeZdZe i i dZ dddZ dZdZdZd ZRS( s0Abstract base class of nodes in a document tree.cCsdSdS(s8 Node instances are always true, even if they're empty. A node is more than a simple container. Its boolean "truth" does not depend on having one or more subnodes in the doctree. Use `len()` to check node length. Use `None` to represent a boolean false value. iN((sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys __nonzero__7scCs|i}|i|SdS(s6Return a DOM **fragment** representation of this Node.N(sdomsDocumentsdomrootsselfs _dom_node(sselfsdomsdomroot((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysasdomBs s icCs tdS(s@Return an indented pseudo-XML representation, for test purposes.N(sNotImplementedError(sselfsindentslevel((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyspformatGscCs tdS(sReturn a copy of self.N(sNotImplementedError(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyscopyKscCsm||_|ioV|i|_|itjo|ii|_n|itjo|ii|_qindS(N( sselfschildsparentsdocumentssourcesNonescurrent_sourceslines current_line(sselfschild((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys setup_childOs   cCsd|ii}t|||i}|ii i |ddy||Wn/t t fj o dSnt j onX|i}y#x|D]}|i|qWWntj onXdS(s, Traverse a tree of `Node` objects, calling ``visit_...`` methods of `visitor` when entering each node. If there is no ``visit_particular_node`` method for a node of type ``particular_node``, the ``unknown_visit`` method is called. (The `walkabout()` method is similar, except it also calls ``depart_...`` methods before exiting each node.) This tree traversal supports limited in-place tree modifications. Replacing one node with one or more nodes is OK, as is removing an element. However, if the node removed or replaced occurs after the current node, the old node will still be traversed, and any new nodes will not. Within ``visit_...`` methods (and ``depart_...`` methods for `walkabout()`), `TreePruningException` subclasses may be raised (`SkipChildren`, `SkipSiblings`, `SkipNode`, `SkipDeparture`). Parameter `visitor`: A `NodeVisitor` object, containing a ``visit_...`` method for each `Node` subclass encountered. svisit_scategorysnodes.Node.walkN(sselfs __class__s__name__snamesgetattrsvisitors unknown_visitsmethodsdocumentsreportersdebugs SkipChildrensSkipNodes SkipDepartures get_childrenschildrenschildswalks SkipSiblings(sselfsvisitorsnameschildrenschildsmethod((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyswalkXs" cCs:d}d|ii}t|||i}|i i i |ddyy||Wn/t j o dSnt j o d}nX|i}y#x|D]}|i|qWWntj onXWntj onX|oLd|ii}t|||i}|i i i |dd||ndS(s Perform a tree traversal similarly to `Node.walk()` (which see), except also call ``depart_...`` methods before exiting each node. If there is no ``depart_particular_node`` method for a node of type ``particular_node``, the ``unknown_departure`` method is called. Parameter `visitor`: A `NodeVisitor` object, containing ``visit_...`` and ``depart_...`` methods for each `Node` subclass encountered. isvisit_scategorysnodes.Node.walkaboutNisdepart_(s call_departsselfs __class__s__name__snamesgetattrsvisitors unknown_visitsmethodsdocumentsreportersdebugsSkipNodes SkipDepartures get_childrenschildrenschilds walkabouts SkipSiblingss SkipChildrensunknown_departure(sselfsvisitorsnames call_departschildrenschildsmethod((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys walkabout~s4    (s__name__s __module__s__doc__sNonesparentsdocumentssourceslines __nonzero__sxmlsdomsminidomsasdomspformatscopys setup_childswalks walkabout(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysNode's    &sTextcBsntZdZdZddZdZdZdZdZdZ d Z d d d Z d Z RS(s Instances are terminal nodes (leaves) containing text only; no child nodes or attributes. Initialize by passing a string to the constructor. Access the text itself with the `astext` method. s#textscCsti||||_dS(N(s UserStrings__init__sselfsdatas rawsource(sselfsdatas rawsource((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__init__s cCsRt|i}t|djot|id d}nd|i|fSdS(NiFi@s ...s<%s: %s>(sreprsselfsdataslenstagname(sselfsdata((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__repr__scCst|iSdS(N(slensselfsdata(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__len__scCsRt|i}t|djot|id d}nd|i|fSdS(Niis ...s<%s: %s>(sreprsselfsdataslenstagname(sselfsdata((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys shortreprscCs|i|iSdS(N(sdomrootscreateTextNodesselfsdata(sselfsdomroot((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys _dom_nodescCs |iSdS(N(sselfsdata(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysastextscCs|i|iSdS(N(sselfs __class__sdata(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyscopyss icCsPg}||}x,|iiD]}|i||dq Wdi|SdS(Ns s( sresultsindentslevelsselfsdatas splitlinesslinesappendsjoin(sselfsindentslevelslinesresult((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyspformats  cCsgSdS(s'Text nodes have no children. Return [].N((sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys get_childrens( s__name__s __module__s__doc__stagnames__init__s__repr__s__len__s shortreprs _dom_nodesastextscopyspformats get_children(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysTexts        sElementcBstZdZeZdZddZdZdZdZ dZ dZ d Z d Z d Zd Zd ZdZdZdZdZdZdZdZedZdZdZedZeZdZdZdZddZ dZ!dZ"d Z#d!e$i%d"Z&d!e$i%d#Z'd$d!d%Z(d&Z)d'Z*d(Z+RS()s6 `Element` is the superclass to all specific elements. Elements contain attributes and child nodes. Elements emulate dictionaries for attributes, indexing by attribute name (a string). To set the attribute 'att' to 'value', do:: element['att'] = 'value' Elements also emulate lists for child nodes (element nodes and/or text nodes), indexing by integer. To get the first child node, use:: element[0] Elements may be constructed using the ``+=`` operator. To add one new child node to element, do:: element += node This is equivalent to ``element.append(node)``. To add a list of multiple child nodes at once, use the same ``+=`` operator:: element += [node1, node2] This is equivalent to ``element.extend([node1, node2])``. s scOs||_g|_|i|h|_x-|iD]\}}||i|is<%s: %s>( sdatasselfschildrenscs shortreprslenshasattrs __class__s__name__s attributes(sselfsdatasc((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__repr__s  "cCs>|idod|ii|idfSn d|iSdS(Nsnames <%s "%s"...>s<%s...>(sselfshasattrs __class__s__name__s attributesstagname(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys shortrepr&scCs|iidSdS(Nsraw_unicode_escape(sselfs __unicode__sencode(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__str__-scCsl|ioTd|idigi}|iD]}|t|q-~|ifSn |i SdS(Nu%s%s%ss( sselfschildrensstarttagsjoinsappends_[1]scsstrsendtagsemptytag(sselfs_[1]sc((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys __unicode__0s TcCs|ig}x|iD]\}}|tjo|i|qt|t oOgi}|D]}|d|qa~}|id|di |fq|id||fqWddi |SdS(Ns%ss%s="%s"s s<%s>(sselfstagnamespartssattlistsnamesvaluesNonesappends isinstancesListTypes_[1]svsvaluessjoin(sselfsnamesvalues_[1]spartssvaluessv((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysstarttag8s   +$cCsd|iSdS(Ns(sselfstagname(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysendtagDsc CsVddi|iggi}|iD] \}}|d||fq&~SdS(Nu<%s/>s s%s="%s"(sjoinsselfstagnamesappends_[1]sattlistsnsv(sselfs_[1]svsn((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysemptytagGscCst|iSdS(N(slensselfschildren(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__len__LscCst|tp t|to|i|Snqt|to|i|SnRt|to8|i t dfjp t d|i|i |i !Sn tddS(Niscannot handle slice with stridesFelement index must be an integer, a slice, or an attribute name string(s isinstanceskeys UnicodeTypes StringTypesselfs attributessIntTypeschildrens SliceTypesstepsNonesAssertionErrorsstartsstops TypeError(sselfskey((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys __getitem__Os  cCst|tp t|to||it||iigi}|iD]}||iq~SdS(N(sselfschild_text_separatorsjoinsappends_[1]schildrenschildsastext(sselfs_[1]schild((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysastextscCs!|ii}|i|SdS(N(sselfs attributessitemssattlistssort(sselfsattlist((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysattlists cCs|ii||SdS(N(sselfs attributessgetskeysfailobj(sselfskeysfailobj((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysgetscCs|ii|SdS(N(sselfs attributesshas_keysattr(sselfsattr((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyshasattrscCs%|ii|o|i|=ndS(N(sselfs attributesshas_keysattr(sselfsattr((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysdelattrscCs|ii||SdS(N(sselfs attributess setdefaultskeysfailobj(sselfskeysfailobj((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys setdefaultscCs!|i||ii|dS(N(sselfs setup_childsitemschildrensappend(sselfsitem((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysappends cCs2x|D]}|i|qW|ii|dS(N(sitemsnodesselfs setup_childschildrensextend(sselfsitemsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysextendscCsVt|to$|i||ii||n|tj o||||+ndS(N( s isinstancesitemsNodesselfs setup_childschildrensinsertsindexsNone(sselfsindexsitem((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysinserts   icCs|ii|SdS(N(sselfschildrenspopsi(sselfsi((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyspopscCs|ii|dS(N(sselfschildrensremovesitem(sselfsitem((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysremovescCs|ii|SdS(N(sselfschildrensindexsitem(sselfsitem((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysindexscCs`|i|}t|to|i||||scCs/|i||}|i|||dddS(Nsexpliciti(sselfsset_idstargetsmsgnodesidsset_name_id_map(sselfstargetsmsgnodesid((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_explicit_targetBscCs$|ii|dgi|dS(Nsrefname(sselfsrefnamess setdefaultsnodesappend(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys note_refnameFscCs$|ii|dgi|dS(Nsrefid(sselfsrefidss setdefaultsnodesappend(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys note_refidIscCs|ii|dS(N(sselfsexternal_targetssappendstarget(sselfstarget((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_external_targetLscCs|ii|dS(N(sselfsinternal_targetssappendstarget(sselfstarget((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_internal_targetOscCs5|ii||ido|i|ndS(Nsname(sselfsindirect_targetssappendstargetshas_keys note_refname(sselfstarget((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_indirect_targetRscCs!|i||ii|dS(N(sselfsset_idstargetsanonymous_targetssappend(sselfstarget((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_anonymous_targetWs cCs|ii|dS(N(sselfsanonymous_refssappendsref(sselfsref((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_anonymous_ref[scCs!|i||ii|dS(N(sselfsset_idsfootnotes autofootnotessappend(sselfsfootnote((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_autofootnote^s cCs!|i||ii|dS(N(sselfsset_idsrefsautofootnote_refssappend(sselfsref((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_autofootnote_refbs cCs!|i||ii|dS(N(sselfsset_idsfootnotessymbol_footnotessappend(sselfsfootnote((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_symbol_footnotefs cCs!|i||ii|dS(N(sselfsset_idsrefssymbol_footnote_refssappend(sselfsref((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_symbol_footnote_refjs cCs!|i||ii|dS(N(sselfsset_idsfootnotes footnotessappend(sselfsfootnote((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys note_footnotens cCs>|i||ii|dgi||i|dS(Nsrefname(sselfsset_idsrefs footnote_refss setdefaultsappends note_refname(sselfsref((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_footnote_refrs  cCs|ii|dS(N(sselfs citationssappendscitation(sselfscitation((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys note_citationwscCs>|i||ii|dgi||i|dS(Nsrefname(sselfsset_idsrefs citation_refss setdefaultsappends note_refname(sselfsref((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysnote_citation_refzs  cCst|}|d<|ii|oR|iid|d|}|t jo||7}n|i|}t |n||i|<||it|ssentrycBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysentry?sssystem_messagecBstZedZdZRS(NcOs^|o td|}|f|}nyti|d||Wnd|fGHnXdS(Nsssystem_message: children=%r(smessages paragraphspschildrensElements__init__sselfs attributes(sselfsmessageschildrens attributessp((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__init__Ds cCsB|idd}d|d||d|dti|fSdS(Nslinesu%s:%s: (%s/%s) %sssourcestypeslevel(sselfsgetslinesElementsastext(sselfsline((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysastextNs(s__name__s __module__sNones__init__sastext(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyssystem_messageBs spendingcBs5tZdZeddZdddZdZRS(sF The "pending" element is used to encapsulate a pending operation: the operation (transform), the point at which to apply it, and any data it requires. Only the pending operation's location within the document is stored in the public document tree (by the "pending" object itself); the operation and its data are stored in the "pending" object's internal instance attributes. For example, say you want a table of contents in your reStructuredText document. The easiest way to specify where to put it is from within the document, with a directive:: .. contents:: But the "contents" directive can't do its work until the entire document has been parsed and possibly transformed to some extent. So the directive code leaves a placeholder behind that will trigger the second phase of its processing, something like this:: + internal attributes Use `document.note_pending()` so that the `docutils.transforms.Transformer` stage of processing can run all pending transforms. scOs3ti||||||_|ph|_dS(N(sElements__init__sselfs rawsourceschildrens attributess transformsdetails(sselfs transformsdetailss rawsourceschildrens attributes((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__init__ps  s ic Csdd|ii|iifdg}|ii}|ix8|D]0\}}t |t o_|i dd|f|i gi }|iiD]} |dd| fq~qE|o!t |tot |dt op|i dd|fxp|D]J}|i gi }|iiD]} |dd| fq/~q WqE|i dd||fqEWti|||digi }|D]} |d ||| fq~SdS( Ns.. internal attributes:s .transform: %s.%ss .details:s%7s%s:ss%9s%sis %7s%s: %rs %s%s (sselfs transforms __module__s__name__s internalssdetailssitemsssortskeysvalues isinstancesNodesappendsextends_[1]spformats splitlinesslinesListTypesvsElementsindentslevelsjoin( sselfsindentslevels internalssvalues_[1]sdetailsskeysvsline((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyspformat{s%  H+LcCs&|i|i|i|i|iSdS(N(sselfs __class__s transformsdetailss rawsources attribuates(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyscopys(s__name__s __module__s__doc__sNones__init__spformatscopy(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyspendingTs  srawcBstZdZRS(s@ Raw data that is to be passed untouched to the Writer. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysraws semphasiscBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysemphasisssstrongcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysstrongssliteralcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysliteralss referencecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys referencessfootnote_referencecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysfootnote_referencesscitation_referencecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyscitation_referencesssubstitution_referencecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyssubstitution_referencesstitle_referencecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pystitle_referencess abbreviationcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys abbreviationssacronymcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysacronymss superscriptcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys superscriptss subscriptcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys subscriptssimagecBstZdZRS(NcCs|iddSdS(Nsalts(sselfsget(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysastexts(s__name__s __module__sastext(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysimagessinlinecBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysinliness problematiccBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys problematicss generatedcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys generatedss Text abbreviation acronym address admonition attention attribution author authors block_quote bullet_list caption caution citation citation_reference classifier colspec comment contact copyright danger date decoration definition definition_list definition_list_item description docinfo doctest_block document emphasis entry enumerated_list error field field_body field_list field_name figure footer footnote footnote_reference generated header hint image important info inline label legend line_block list_item literal literal_block note option option_argument option_group option_list option_list_item option_string organization paragraph pending problematic raw reference revision row rubric section sidebar status strong subscript substitution_definition substitution_reference subtitle superscript system_message table target tbody term tgroup thead tip title title_reference topic transition version warnings NodeVisitorcBs)tZdZdZdZdZRS(s3 "Visitor" pattern [GoF95]_ abstract superclass implementation for document tree traversals. Each node class has corresponding methods, doing nothing by default; override individual methods for specific and useful behaviour. The "``visit_`` + node class name" method is called by `Node.walk()` upon entering a node. `Node.walkabout()` also calls the "``depart_`` + node class name" method before exiting a node. This is a base class for visitors whose ``visit_...`` & ``depart_...`` methods should be implemented for *all* node types encountered (such as for `docutils.writers.Writer` subclasses). Unimplemented methods will raise exceptions. For sparse traversals, where only certain node types are of interest, subclass `SparseNodeVisitor` instead. When (mostly or entirely) uniform processing is desired, subclass `GenericNodeVisitor`. .. [GoF95] Gamma, Helm, Johnson, Vlissides. *Design Patterns: Elements of Reusable Object-Oriented Software*. Addison-Wesley, Reading, MA, USA, 1995. cCs ||_dS(N(sdocumentsself(sselfsdocument((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__init__scCs#td|i|iifdS(sk Called when entering unknown `Node` types. Raise an exception unless overridden. s!%s visiting unknown node type: %sN(sNotImplementedErrorsselfs __class__snodes__name__(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys unknown_visitscCs#td|i|iifdS(si Called before exiting unknown `Node` types. Raise exception unless overridden. s"%s departing unknown node type: %sN(sNotImplementedErrorsselfs __class__snodes__name__(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysunknown_departures(s__name__s __module__s__doc__s__init__s unknown_visitsunknown_departure(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys NodeVisitors   sSparseNodeVisitorcBstZdZRS(s Base class for sparse traversals, where only certain node types are of interest. When ``visit_...`` & ``depart_...`` methods should be implemented for *all* node types (such as for `docutils.writers.Writer` subclasses), subclass `NodeVisitor` instead. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysSparseNodeVisitors sGenericNodeVisitorcBs tZdZdZdZRS(s Generic "Visitor" abstract superclass, for simple traversals. Unless overridden, each ``visit_...`` method calls `default_visit()`, and each ``depart_...`` method (when using `Node.walkabout()`) calls `default_departure()`. `default_visit()` (and `default_departure()`) must be overridden in subclasses. Define fully generic visitors by overriding `default_visit()` (and `default_departure()`) only. Define semi-generic visitors by overriding individual ``visit_...()`` (and ``depart_...()``) methods also. `NodeVisitor.unknown_visit()` (`NodeVisitor.unknown_departure()`) should be overridden for default behavior. cCs tdS(s)Override for generic, uniform traversals.N(sNotImplementedError(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys default_visit,scCs tdS(s)Override for generic, uniform traversals.N(sNotImplementedError(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysdefault_departure0s(s__name__s __module__s__doc__s default_visitsdefault_departure(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysGenericNodeVisitors  cCs|i|dS(N(sselfs default_visitsnode(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys_call_default_visit4scCs|i|dS(N(sselfsdefault_departuresnode(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys_call_default_departure7scCsdS(N((sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys_nop:scCsex^|D]V}ttd|tttd|tttd|tttd|tqWdS(s%Save typing with dynamic assignments:svisit_sdepart_sdepartN(snamess_namessetattrsGenericNodeVisitors_call_default_visits_call_default_departuresSparseNodeVisitors_nop(snamess_name((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys_add_node_class_names=ssTreeCopyVisitorcBs2tZdZdZdZdZdZRS(sQ Make a complete copy of a tree or branch, including element attributes. cCs&ti||g|_g|_dS(N(sGenericNodeVisitors__init__sselfsdocuments parent_stacksparent(sselfsdocument((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys__init__Ms cCs|idSdS(Ni(sselfsparent(sself((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys get_tree_copyRscCs<|i}|ii||ii|i||_dS(s9Copy the current node, and make it the new acting parent.N(snodescopysnewnodesselfsparentsappends parent_stack(sselfsnodesnewnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys default_visitUs  cCs|ii|_dS(s#Restore the previous acting parent.N(sselfs parent_stackspopsparent(sselfsnode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysdefault_departure\s(s__name__s __module__s__doc__s__init__s get_tree_copys default_visitsdefault_departure(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysTreeCopyVisitorGs    sTreePruningExceptioncBstZdZRS(s Base class for `NodeVisitor`-related tree pruning exceptions. Raise subclasses from within ``visit_...`` or ``depart_...`` methods called from `Node.walk()` and `Node.walkabout()` tree traversals to prune the tree traversed. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysTreePruningExceptionas s SkipChildrencBstZdZRS(s Do not visit any children of the current node. The current node's siblings and ``depart_...`` method are not affected. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys SkipChildrenns s SkipSiblingscBstZdZRS(s Do not visit any more siblings (to the right) of the current node. The current node's children and its ``depart_...`` method are not affected. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys SkipSiblingsxs sSkipNodecBstZdZRS(sq Do not visit the current node's children, and do not call the current node's ``depart_...`` method. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysSkipNodes s SkipDeparturecBstZdZRS(s Do not call the current node's ``depart_...`` method. The current node's children and siblings are not affected. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys SkipDepartures s NodeFoundcBstZdZRS(s Raise to indicate that the target of a search has been found. This exception must be caught by the client; it is not caught by the traversal code. (s__name__s __module__s__doc__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys NodeFounds cCsGtiddi|ii}tid|}t|SdS(s Convert `string` into an identifier and return it. Docutils identifiers will conform to the regular expression ``[a-z](-?[a-z0-9]+)*``. For CSS compatibility, identifiers (the "class" and "id" attributes) should have no underscores, colons, or periods. Hyphens may be used. - The `HTML 4.01 spec`_ defines identifiers based on SGML tokens: ID and NAME tokens must begin with a letter ([A-Za-z]) and may be followed by any number of letters, digits ([0-9]), hyphens ("-"), underscores ("_"), colons (":"), and periods ("."). - However the `CSS1 spec`_ defines identifiers based on the "name" token, a tighter interpretation ("flex" tokenizer notation; "latin1" and "escape" 8-bit characters have been replaced with entities):: unicode \[0-9a-f]{1,4} latin1 [¡-ÿ] escape {unicode}|\[ -~¡-ÿ] nmchar [-a-z0-9]|{latin1}|{escape} name {nmchar}+ The CSS1 "nmchar" rule does not include underscores ("_"), colons (":"), or periods ("."), therefore "class" and "id" attributes should not contain these characters. They should be replaced with hyphens ("-"). Combined with HTML's requirements (the first character must be a letter; no "unicode", "latin1", or "escape" characters), this results in the ``[a-z](-?[a-z0-9]+)*`` pattern. .. _HTML 4.01 spec: http://www.w3.org/TR/html401 .. _CSS1 spec: http://www.w3.org/TR/REC-CSS1 s-s sN( s _non_id_charsssubsjoinsstringslowerssplitsids_non_id_at_endssstr(sstringsid((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysmake_ids"'s [^a-z0-9]+s ^[-0-9]+|-+$cCs|d|d<|d=dS(Nsnamesdupname(snode(snode((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysdupnamescCsdi|iiSdS(s.Return a case- and whitespace-normalized name.s N(sjoinsnameslowerssplit(sname((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pysfully_normalize_namescCsdi|iSdS(s$Return a whitespace-normalized name.s N(sjoinsnamessplit(sname((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pyswhitespace_normalize_names(s__doc__s __docformat__ssyssossresxml.dom.minidomsxmlstypessIntTypes SliceTypes StringTypes UnicodeTypes TupleTypesListTypes UserStringsNodesTextsElements TextElementsFixedTextElements Resolvables BackLinkablesRootsTitulars PreDecorativesPreBibliographics Bibliographics Decoratives StructuralsBodysGenerals Sequentials AdmonitionsSpecials InvisiblesPartsInlines Referentials TargetablesLabeledsdocumentstitlessubtitlesrubricsdocinfosinfosauthorsauthorss organizationsaddressscontactsversionsrevisionsstatussdates copyrights decorationsheadersfooterssectionstopicssidebars transitions paragraphs bullet_listsenumerated_lists list_itemsdefinition_listsdefinition_list_itemsterms classifiers definitions field_listsfields field_names field_bodysoptionsoption_arguments option_groups option_listsoption_list_items option_strings descriptions literal_blocks doctest_blocks line_blocks block_quotes attributions attentionscautionsdangerserrors importantsnotestipshintswarnings admonitionscommentssubstitution_definitionstargetsfootnotescitationslabelsfigurescaptionslegendstablestgroupscolspecstheadstbodysrowsentryssystem_messagespendingsrawsemphasissstrongsliterals referencesfootnote_referencescitation_referencessubstitution_referencestitle_references abbreviationsacronyms superscripts subscriptsimagesinlines problematics generatedssplitsnode_class_namess NodeVisitorsSparseNodeVisitorsGenericNodeVisitors_call_default_visits_call_default_departures_nops_add_node_class_namessTreeCopyVisitors ExceptionsTreePruningExceptions SkipChildrens SkipSiblingssSkipNodes SkipDepartures NodeFoundsmake_idscompiles _non_id_charss_non_id_at_endssdupnamesfully_normalize_nameswhitespace_normalize_name(sdefinition_list_itemscolspecshints abbreviations Sequentialsrubrics NodeFoundssidebars field_listsrowsBodys copyrightstitlesversionspendings SkipSiblingss PreDecoratives attributionsmake_ids Targetablesnode_class_namessLabeledsSkipNodesListTypesInlines line_blocksterms option_groupsTreeCopyVisitors field_bodys SliceTypes classifiersenumerated_lists references admonitionsoption_arguments Referentialssystem_messages StringTypessections list_itemswhitespace_normalize_nameslabelsresPartsfootnote_references UserStrings subscriptstitle_referencesxmlsinlines bullet_lists attentions SkipDeparturesaddresssstrongslegends definitions_call_default_departures option_stringsdupnames transitions Admonitions Resolvablessubstitution_referencesosscomments_non_id_at_endsssubtitlesdangers problematicsimages __docformat__sheaderstablesNodesfiguresFixedTextElementsliteralstheads doctest_blocksoptions_nopsauthorss TupleTypes field_namesinfostopicstargetsTextsacronymsGenerals option_lists UnicodeTypes paragraphs literal_blockserrors block_quotesSpecialscitation_references_call_default_visitsIntTypesTitularsfootnotesGenericNodeVisitorscitations decorationsrawswarningscautions _non_id_charss BackLinkablesTreePruningExceptionstgroups BibliographicsauthorstipstbodysnotesfieldsemphasissSparseNodeVisitors Invisibles NodeVisitors_add_node_class_namessdocumentssubstitution_definitionsrevisionsstatuss descriptionsdefinition_listsElementssyss generateds importantsfully_normalize_namesentrysdatescaptionsRootsdocinfos DecorativesPreBibliographicsfooters TextElements SkipChildrenscontacts Structurals organizationsoption_list_items superscript((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/nodes.pys?s,    + |4(  D"E  0            '