File: //opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyc
�
�j�Tc @ s� d Z d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d e f d � � YZ e j
d f k r� d e f d � � YZ n e Z d � Z
d
e e f d � � YZ d e f d
� � YZ d e f d � � YZ d e f d � � YZ d f d � � YZ d f d � � YZ d f d � � YZ d f d � � YZ d f d � � YZ d f d � � YZ d e f d � � YZ d f d! � � YZ d" f d# � � YZ d$ e f d% � � YZ d& e f d' � � YZ d( e f d) � � YZ d* e f d+ � � YZ d, e f d- � � YZ d. f d/ � � YZ d0 f d1 � � YZ! d2 e f d3 � � YZ" d4 e f d5 � � YZ# d6 f d7 � � YZ$ d8 e e e f d9 � � YZ% d: e e e f d; � � YZ& d< e e e f d= � � YZ' d> e e f d? � � YZ( d@ e e f dA � � YZ) dB e e f dC � � YZ* dD e e f dE � � YZ+ dF e e f dG � � YZ, dH e e f dI � � YZ- dJ e e f dK � � YZ. dL e e f dM � � YZ/ dN e e f dO � � YZ0 dP e e f dQ � � YZ1 dR e e f dS � � YZ2 dT e e f dU � � YZ3 dV e e f dW � � YZ4 dX e e f dY � � YZ5 dZ e e f d[ � � YZ6 d\ e e f d] � � YZ7 d^ e e f d_ � � YZ8 d` e e f da � � YZ9 db e e f dc � � YZ: dd e e f de � � YZ; df e e f dg � � YZ< dh e e f di � � YZ= dj e e f dk � � YZ> dl e e f dm � � YZ? dn e e f do � � YZ@ dp e e f dq � � YZA dr e e f ds � � YZB dt e e f du � � YZC dv e e f dw � � YZD dx e e f dy � � YZE dz e e f d{ � � YZF d| e e f d} � � YZG d~ e e f d � � YZH d� e e f d� � � YZI d� e e f d� � � YZJ d� e e f d� � � YZK d� e e f d� � � YZL d� e e f d� � � YZM d� e e f d� � � YZN d� e e f d� � � YZO d� e e f d� � � YZP d� e e f d� � � YZQ d� e e f d� � � YZR d� e e f d� � � YZS d� e e f d� � � YZT d� e e f d� � � YZU d� e e f d� � � YZV d� e e f d� � � YZW d� e e f d� � � YZX d� e e f d� � � YZY d� e e f d� � � YZZ d� e e f d� � � YZ[ d� e e f d� � � YZ\ d� e e f d� � � YZ] d� e e f d� � � YZ^ d� e e f d� � � YZ_ d� e e f d� � � YZ` d� e e f d� � � YZa d� e e e f d� � � YZb d� e e e f d� � � YZc d� e e e! e e# f d� � � YZd d� e e e e$ e# f d� � � YZe d� e e e e$ e# f d� � � YZf d� e e f d� � � YZg d� e e f d� � � YZh d� e e f d� � � YZi d� e e f d� � � YZj d� e e f d� � � YZk d� e e f d� � � YZl d� e e f d� � � YZm d� e e f d� � � YZn d� e e f d� � � YZo d� e e f d� � � YZp d� e e f d� � � YZq d� e e e e f d� � � YZr d� e e e f d� � � YZs d� e e! e e f d� � � YZt d� e! e f d� � � YZu d� e! e f d� � � YZv d� e! e f d� � � YZw d� e e! e" e f d� � � YZx d� e! e" e f d� � � YZy d� e! e" e f d� � � YZz d� e! e f d� � � YZ{ d� e! e f d� � � YZ| d� e! e f d� � � YZ} d� e! e f d� � � YZ~ d� e! e f d� � � YZ d� e! e f d� � � YZ� d� e! e f d� � � YZ� d� e e! e f d� � � YZ� d� e! e f d� � � YZ� d� e! e f d� � � YZ� d� e! e f d� � � YZ� d� j� � Z� d� f d� � � YZ� d� e� f d� � � YZ� d� e� f d � � YZ� d� Z� d� Z� d� Z� d� Z� e� e� � de� f d� � YZ� de� f d� � YZ� d e� f d
� � YZ� d e� f d � � YZ� d
e� f d� � YZ� de� f d� � YZ� de� f d� � YZ� de� f d� � YZ� d� Z� e j� d� Z� e j� d� Z� i! dd6dd6d d 6d d 6d d!6d"d#6d$d%6d$d&6d'd(6dd)6d*d+6d,d-6d d.6d/d06d1d26d"d36d"d46d5d66d7d86d9d:6d7d;6d d<6d/d=6d"d>6d?d@6d'dA6dBdC6d7dD6dEdF6d?dG6dHdI6dJdK6d5dL6Z� i dMdN6dOdP6dQdR6dSdT6dUdV6Z� dW� Z� dX� Z� dY� Z� dZ� Z� d[� Z� d S(\ 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
t reStructuredTexti����Nt Nodec B s� e Z d Z d Z d Z d Z d Z d � Z e j
d k rH d � Z n d d � Z d d d � Z
d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d e e e e d � Z d e e e e d � Z RS( s0 Abstract base class of nodes in a document tree.c C s t S( 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.
( t True( t self( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __nonzero__4 s i c C s t | � j d � S( Nt raw_unicode_escape( t unicodet encode( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __str__B s c C s: | d k r! d d l j j } n | j � } | j | � S( s6 Return a DOM **fragment** representation of this Node.i����N( t Nonet xml.dom.minidomt domt minidomt Documentt _dom_node( R R t domroot( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt asdomE s s i c C s
t � d S( ss
Return an indented pseudo-XML representation, for test purposes.
Override in subclasses.
N( t NotImplementedError( R t indentt level( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt pformatL s c C s
t � d S( s Return a copy of self.N( R ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt copyT s c C s
t � d S( s3 Return a deep copy of self (also copying children).N( R ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt deepcopyX s c C sg | | _ | j rc | j | _ | j d k r? | j j | _ n | j d k rc | j j | _ qc n d S( N( t parentt documentt sourceR t current_sourcet linet current_line( R t child( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt setup_child\ s c C s� t } | j j j d | j j � y� y | j | � Wn( t t f k
rQ | St k
ra n X| j
} y/ x( | D] } | j | � rv t } Pqv qv WWn t
k
r� n XWn t k
r� t } n X| S( s�
Traverse a tree of `Node` objects, calling the
`dispatch_visit()` method of `visitor` when entering each
node. (The `walkabout()` method is similar, except it also
calls the `dispatch_departure()` method 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`` implementation for each `Node` subclass encountered.
Return true if we should stop the traversal.
s6 docutils.nodes.Node.walk calling dispatch_visit for %s( t FalseR t reportert debugt __class__t __name__t dispatch_visitt SkipChildrent SkipNodet
SkipDeparturet childrent walkR t SkipSiblingst
StopTraversal( R t visitort stopR( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR) e s,
c C s t } t } | j j j d | j j � y� y | j | � Wn( t k
rQ | St k
rg t } n X| j
} y/ x( | D] } | j | � r| t } Pq| q| WWn t k
r� n XWn' t
k
r� n t k
r� t } n X| r| j j j d | j j � | j | � n | S( s�
Perform a tree traversal similarly to `Node.walk()` (which
see), except also call the `dispatch_departure()` method
before exiting each node.
Parameter `visitor`: A `NodeVisitor` object, containing a
``visit`` and ``depart`` implementation for each `Node`
subclass encountered.
Return true if we should stop the traversal.
s; docutils.nodes.Node.walkabout calling dispatch_visit for %ss? docutils.nodes.Node.walkabout calling dispatch_departure for %s( R R R R R! R" R# R$ R& R' R( t walkaboutR* R% R+ t dispatch_departure( R R, t call_departR- R( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR. � s<
c C sS g } t | | � r% | j | � n x' | j D] } | j | j | � � q/ W| S( s: Specialized traverse() that only supports instance checks.( t
isinstancet appendR( t extendt _fast_traverse( R t clst resultR ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR4 � s c C s> g } | j | � x$ | j D] } | j | j � � q W| S( s: Specialized traverse() that doesn't check for a condition.( R2 R( R3 t
_all_traverse( R R6 R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR7 � s
c
C s� | r t } n | r` | r` | r` | d k r8 | j � St | t j t f � r` | j | � Sn t | t j t f � r� | } | d � } n g } | r� | d k s� | | � r� | j | � n | rt | j
� rxB | D]7 } | j | j d t d t d t
d t
d | � � q� Wn | s'| r�| } x� | j r�| j j | � }
xJ | j |
d D]7 } | j | j d t d | d t
d t
d | � � q]W| s�Pq0| j } q0Wn | S( s
Return an iterable containing
* self (if include_self is true)
* all descendants in tree traversal order (if descend is true)
* all siblings (if siblings is true) and their descendants (if
also descend is true)
* the siblings of the parent (if ascend is true) and their
descendants (if also descend is true), and so on
If `condition` is not None, the iterable contains only nodes
for which ``condition(node)`` is true. If `condition` is a
node class ``cls``, it is equivalent to a function consisting
of ``return isinstance(node, cls)``.
If ascend is true, assume siblings to be true as well.
For example, given the following tree::
<paragraph>
<emphasis> <--- emphasis.traverse() and
<strong> <--- strong.traverse() are called.
Foo
Bar
<reference name="Baz" refid="baz">
Baz
Then list(emphasis.traverse()) equals ::
[<emphasis>, <strong>, <#text: Foo>, <#text: Bar>]
and list(strong.traverse(ascend=True)) equals ::
[<strong>, <#text: Foo>, <#text: Bar>, <reference>, <#text: Baz>]
c S s
t | | � S( N( R1 ( t nodet
node_class( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt condition s t include_selft descendt siblingst ascendR: i N( R R R7 R1 t typest ClassTypet typeR4 R2 t lenR( R3 t traverseR R t index( R R: R; R< R= R> R9 t rR R8 RD t sibling( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRC � s> %
c C sO | j d | d | d | d | d | � } y | d SWn t k
rJ d SXd S( s�
Return the first node in the iterable returned by traverse(),
or None if the iterable is empty.
Parameter list is the same as of traverse. Note that
include_self defaults to 0, though.
R: R; R< R= R> i N( RC t
IndexErrorR ( R R: R; R< R= R> t iterable( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt next_node s
N( i ( R# t
__module__t __doc__R R R R R R t syst version_infoR R R R R R R) R. R4 R7 R R RC RI ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR $ s* . + J i t reprunicodec B s e Z d Z d � Z RS( sU
A unicode sub-class that removes the initial u from unicode's repr.
c C s t j | � d S( Ni ( R t __repr__( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRO 1 s ( R# RJ RK RO ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRN , s c C s2 t j d k r. t | t � r. | j d d � S| S( s4
Failsave conversion of `unicode` to `str`.
i t asciit backslashreplace( i ( RL RM R1 R R ( t s( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
ensure_str9 s t Textc B s� e Z d Z d Z d Z e j d k r6 d d � Z n d d � Z d d � Z d d � Z
d � Z d
� Z d � Z
d � Z d
� Z d d d � Z d d � Z d 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 #texti c C s. t | t � r t d � � n t j | | � S( s7 Prevent the rawsource argument from propagating to str.s expecting str data, not bytes( R1 t bytest TypeErrorRN t __new__( R5 t datat rawsource( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRW P s c C s t j | | � S( s7 Prevent the rawsource argument from propagating to str.( RN RW ( R5 RX RY ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRW V s t c C s
| | _ d S( N( RY ( R RX RY ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __init__Z s i c C sD | } t | � | k r- | | d d } n d | j t | � f S( Ni s ...s <%s: %r>( RB t tagnameRN ( R t maxlenRX ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt shortrepr_ s c C s | j d d � S( NR] iD ( R^ ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRO e s c C s | j t | � � S( N( t createTextNodeR ( R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR h s c C s
t | � S( N( RN ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt astextk s c C s | j t | � d | j �S( NRY ( R" RN RY ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR w s c C s
| j � S( N( R ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR z s s i c C sI g } | | } x) | j � D] } | j | | d � q Wd j | � S( Ns
RZ ( t
splitlinesR2 t join( R R R R6 R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR } s
c C s | j t j | | � � S( N( R" RN t rstrip( R t chars( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRc � s c C s | j t j | | � � S( N( R" RN t lstrip( R Rd ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRe � s ( ( i N( R# RJ RK R\ R( RL RM R RW R[ R^ RO R R` R R R Rc Re ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRT B s t Elementc B s� e Z d Z dE Z dF Z e e Z e dG Z dH Z d Z d d � Z
d
� Z d � Z d � Z
d
� Z e j dI k r� e Z n dH d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z dH d � Z d � Z! d � Z" dH d � Z# e! Z$ e! Z d d! � Z% d" � Z& d# � Z' d$ � Z( d% d& � Z) d' � Z* d( � Z+ d) � Z, d* � Z- d+ � Z. d, � Z/ e0 d- � Z1 e0 d. � Z2 d/ � Z3 d0 � Z4 d1 � Z5 e5 e0 e6 d2 � Z7 e0 e6 d3 � Z8 e0 e6 d4 � Z9 e0 e6 d5 � Z: e6 d6 � Z; d7 � Z< d8 � Z= d9 � Z> d: e j? d; � Z@ d: e j? d< � ZA d= d: d> � ZB d? � ZC d@ � ZD dA � ZE dH dH dB � ZF eG dC � � ZH eG dD � � ZI RS(J s�
`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'
There are two special attributes: 'ids' and 'names'. Both are
lists of unique identifiers, and names serve as human interfaces
to IDs. Names are case- and whitespace-normalized (see the
fully_normalize_name() function), and IDs conform to the regular
expression ``[a-z](-?[a-z0-9]+)*`` (see the make_id() function).
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])``.
t idst classest namest dupnamest backrefsR s
RZ c O s� | | _ g | _ | j | � i | _ x | j D] } g | j | <q2 WxS | j � D]E \ } } | j � } | | j k r� | | j | <qV | | j | <qV W| j d k r� | j j
| _ n d S( N( RY R( R3 t
attributest list_attributest itemst lowerR\ R R" R# ( R RY R( Rl t attt value( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s
c C s� | j | j � } xo | j � D]a \ } } t | t � rl d j g | D] } t d | f � ^ qG � } n | j | d | � q Wx' | j D] } | j | j
| � � q� W| S( Nt s %s( t
createElementR\ t attlistR1 t listRb t
serial_escapet setAttributeR( t appendChildR ( R R t elementt attributeRq t vR ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s 2c C s� d } xE | j D]: } | | j � 7} t | � d k r | d d } Pq q W| d r� d | j j d j g | d D] } t | � ^ qu � | f Sd | j j | f Sd S( NRZ i< i8 s ...Ri s
<%s "%s": %s>s ; s <%s: %s>( R( R^ RB R" R# Rb RS ( R RX t ct n( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRO � s
1c C sS | d rD d | j j d j g | d D] } t | � ^ q' � f Sd | j Sd S( NRi s <%s "%s"...>s ; s <%s...>( R" R# Rb RS R\ ( R R} ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR^ � s
.c C sY | j rK d | j � d j g | j D] } t | � ^ q% � | j � f S| j � Sd S( Nu %s%s%sRZ ( R( t starttagRb R t endtagt emptytag( R R| ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __unicode__ s
(i c C s� | d k r t } n | j g } x� | j � D]� \ } } | d k r] | j d | � q. n t | t � r� g | D] } t d | f � ^ qs } d j | � } n t | � } | | � } | j d | | f � q. Wd d j | � S( Ns %s="True"s %sRr u %s=%su <%s>u (
R t pseudo_quoteattrR\ Rt R2 R1 Ru Rv Rb R ( R t quoteattrt partst nameRq R{ t values( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR~ s & c C s d | j S( Ns </%s>( R\ ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR # s c C sD d d j | j g g | j � D] \ } } d | | f ^ q � S( Nu <%s/>u s %s="%s"( Rb R\ Rt ( R R} R{ ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� & s c C s
t | j � S( N( RB R( ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __len__+ s c C s) t | t � r | | j k S| | j k S( N( R1 t
basestringRl R( ( R t key( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __contains__. s
c C s� t | t � r | j | St | t � r4 | j | St | t j � ru | j d k sa t d � � | j | j
| j !St d � d S( Ni s cannot handle slice with stridesF element index must be an integer, a slice, or an attribute name string( Ni (
R1 R� Rl t intR( R? t SliceTypet stepR t AssertionErrort startR- RV ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __getitem__5 s c C s� t | t � r% | | j t | � <n� t | t � rQ | j | � | | j | <nm t | t j � r� | j d k s~ t d � � x | D] } | j | � q� W| | j | j | j
+n t d � d S( Ni s cannot handle slice with stridesF element index must be an integer, a slice, or an attribute name string( Ni ( R1 R� Rl t strR� R R( R? R� R� R R� R� R- RV ( R R� t itemR8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __setitem__A s
c C s� t | t � r | j | =nh t | t � r8 | j | =nL t | t j � r{ | j d k se t d � � | j | j
| j 5n t d � d S( Ni s cannot handle slice with stridesM element index must be an integer, a simple slice, or an attribute name string( Ni (
R1 R� Rl R� R( R? R� R� R R� R� R- RV ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __delitem__P s
c C s | j | S( N( R( ( R t other( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __add__\ s c C s | | j S( N( R( ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __radd___ s c C s? t | t � r | j | � n | d k r; | j | � n | S( s4 Append a node or a list of nodes to `self.children`.N( R1 R R2 R R3 ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __iadd__b s
c C s, | j j g | j D] } | j � ^ q � S( N( t child_text_separatorRb R( R` ( R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR` j s c C sF i } x9 | j j � D]( \ } } | j | � r | | | <q q W| S( N( Rl Rn t is_not_default( R t attsR� Rq ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt non_default_attributesn s
c C s | j � j � } | j � | S( N( R� Rn t sort( R Rt ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRt u s
c C s | j j | | � S( N( Rl t get( R R� t failobj( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� z s c C s
| | j k S( N( Rl ( R t attr( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt hasattr} s c C s | | j k r | j | =n d S( N( Rl ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt delattr� s c C s | j j | | � S( N( Rl t
setdefault( R R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C sa x1 | j d g � D] } | j d � r | d Sq Wy | j j | � SWn t k
r\ | SXd S( s� Return node's language tag.
Look iteratively in self and parents for a class argument
starting with ``language-`` and return the remainder of it
(which should be a `BCP49` language tag) or the `fallback`.
Rh s language-i N( R� t
startswithR t get_languaget AttributeError( R t fallbackR5 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt get_language_code� s
c C s! | j | � | j j | � d S( N( R R( R2 ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR2 � s
c C s" x | D] } | j | � q Wd S( N( R2 ( R R� R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR3 � s
c C sR t | t � r2 | j | � | j j | | � n | d k rN | | | | +n d S( N( R1 R R R( t insertR ( R RD R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s
i����c C s | j j | � S( N( R( t pop( R t i( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C s | j j | � d S( N( R( t remove( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C s | j j | � S( N( R( RD ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRD � s c C s+ | | g k r# | | j k r# d Sd Sd S( Ni i ( Rm ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C sO t | t � r | j } n x- | j D]" } | j | | j | g � � q% Wd S( s�
Update basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') from node or dictionary `dict_`.
N( R1 R Rl t basic_attributest append_attr_listR� ( R t dict_Rp ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_basic_atts� s c C s9 x2 | D]* } | | | k r | | j | � q q Wd S( s�
For each element in values, if it does not exist in self[attr], append
it.
NOTE: Requires self[attr] and values to be sequence type and the
former should specifically be a list.
N( R2 ( R R� R� Rq ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s
c C s[ t | j | � t � s, | | g | | <n t | t � sG | g } n | j | | � d S( s
First, convert both self[attr] and value to a non-string sequence
type; if either is not already a sequence, convert it to a list of one
element. Then call append_attr_list.
NOTE: self[attr] and value both must not be None.
N( R1 R� Ru R� ( R R� Rq ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt coerce_append_attr_list� s
c C s, | s | j | � d k r( | | | <n d S( s�
If self[attr] does not exist or force is True or omitted, set
self[attr] to value, otherwise do nothing.
N( R� R ( R R� Rq t force( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt replace_attr� s c C s, | j | � | k r( | j | | � n d S( s
If attr is an attribute of self, set self[attr] to
[self[attr], value], otherwise set self[attr] to value.
NOTE: replace is not used by this function and is kept only for
compatibility with the other copy functions.
N( R� R� ( R R� Rq t replace( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt copy_attr_convert� s c C si | j | � | k re t | j | � t � s< t | t � rO | j | | � qe | j | | | � n d S( s�
If attr is an attribute of self and either self[attr] or value is a
list, convert all non-sequence values to a sequence of 1 element and
then concatenate the two sequence, setting the result to self[attr].
If both self[attr] and value are non-sequences and replace is True or
self[attr] is None, replace self[attr] with value. Otherwise, do
nothing.
N( R� R1 Ru R� R� ( R R� Rq R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt copy_attr_coerce� s
c C si | j | � | k re t | j | � t � rO t | t � rO | j | | � qe | j | | | � n d S( sM
If attr is an attribute of self and both self[attr] and value are
lists, concatenate the two sequences, setting the result to
self[attr]. If either self[attr] or value are non-sequences and
replace is True or self[attr] is None, replace self[attr] with value.
Otherwise, do nothing.
N( R� R1 Ru R� R� ( R R� Rq R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt copy_attr_concatenate s
c C s/ | j | � | k r+ | j | | | � n d S( sz
If replace is True or selfpattr] is None, replace self[attr] with
value. Otherwise, do nothing.
N( R� R� ( R R� Rq R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt copy_attr_consistent s c C sx t | t � r | j } n | r- | j } n | j } | j | � x. t | | � D] } | | | | | | � qS Wd S( s.
Updates all attributes from node or dictionary `dict_`.
Appends the basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') and then, for all other attributes in
dict_, updates the same attribute in self. When attributes with the
same identifier appear in both self and dict_, the two values are
merged based on the value of update_fun. Generally, when replace is
True, the values in self are replaced or merged with the values in
dict_; otherwise, the values in self may be preserved or merged. When
and_source is True, the 'source' attribute is included in the copy.
NOTE: When replace is False, and self contains a 'source' attribute,
'source' is not replaced even when dict_ has a 'source'
attribute, though it may still be merged into a list depending
on the value of update_fun.
NOTE: It is easier to call the update-specific methods then to pass
the update_fun method to this function.
N( R1 R Rl t is_not_list_attributet is_not_known_attributeR� t filter( R R� t
update_funR� t
and_sourcet
filter_funRp ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_all_atts s
c C s | j | t j | | � d S( sC
Updates all attributes from node or dictionary `dict_`.
Appends the basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') and then, for all other attributes in
dict_, updates the same attribute in self. When attributes with the
same identifier appear in both self and dict_ and replace is True, the
values in self are replaced with the values in dict_; otherwise, the
values in self are preserved. When and_source is True, the 'source'
attribute is included in the copy.
NOTE: When replace is False, and self contains a 'source' attribute,
'source' is not replaced even when dict_ has a 'source'
attribute, though it may still be merged into a list depending
on the value of update_fun.
N( R� Rf R� ( R R� R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_all_atts_consistantly@ s c C s | j | t j | | � d S( s
Updates all attributes from node or dictionary `dict_`.
Appends the basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') and then, for all other attributes in
dict_, updates the same attribute in self. When attributes with the
same identifier appear in both self and dict_ whose values aren't each
lists and replace is True, the values in self are replaced with the
values in dict_; if the values from self and dict_ for the given
identifier are both of list type, then the two lists are concatenated
and the result stored in self; otherwise, the values in self are
preserved. When and_source is True, the 'source' attribute is
included in the copy.
NOTE: When replace is False, and self contains a 'source' attribute,
'source' is not replaced even when dict_ has a 'source'
attribute, though it may still be merged into a list depending
on the value of update_fun.
N( R� Rf R� ( R R� R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_all_atts_concatenatingU s c C s | j | t j | | � d S( s[
Updates all attributes from node or dictionary `dict_`.
Appends the basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') and then, for all other attributes in
dict_, updates the same attribute in self. When attributes with the
same identifier appear in both self and dict_ whose values are both
not lists and replace is True, the values in self are replaced with
the values in dict_; if either of the values from self and dict_ for
the given identifier are of list type, then first any non-lists are
converted to 1-element lists and then the two lists are concatenated
and the result stored in self; otherwise, the values in self are
preserved. When and_source is True, the 'source' attribute is
included in the copy.
NOTE: When replace is False, and self contains a 'source' attribute,
'source' is not replaced even when dict_ has a 'source'
attribute, though it may still be merged into a list depending
on the value of update_fun.
N( R� Rf R� ( R R� R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_all_atts_coercionm s c C s | j | t j d | �d S( s}
Updates all attributes from node or dictionary `dict_`.
Appends the basic attributes ('ids', 'names', 'classes',
'dupnames', but not 'source') and then, for all other attributes in
dict_, updates the same attribute in self. When attributes with the
same identifier appear in both self and dict_ then first any non-lists
are converted to 1-element lists and then the two lists are
concatenated and the result stored in self; otherwise, the values in
self are preserved. When and_source is True, the 'source' attribute
is included in the copy.
NOTE: When replace is False, and self contains a 'source' attribute,
'source' is not replaced even when dict_ has a 'source'
attribute, though it may still be merged into a list depending
on the value of update_fun.
R� N( R� Rf R� ( R R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt update_all_atts_convert� s c C s
g | _ d S( N( R( ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt clear� s c C s\ | j | � } t | t � r8 | j | � | | | <n | d k rX | | | | d +n d S( s8 Replace one child `Node` with another child or children.i N( RD R1 R R R ( R t oldt newRD ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s
c C s� | } t | t � s@ y | d } Wq@ t k
r< d } q@ Xn t | t � r_ | j | � n9 x6 | j D]+ } | | si t d | | | f � � qi W| j j | | � d S( sc
Replace `self` node with `new`, where `new` is a node or a
list of nodes.
i s Losing "%s" attribute: %sN(
R1 R RG R Rf R� R� R� R R� ( R R� t updateRp ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt replace_self� s
i c C sp t | t � s | f } n xN t | t t | � | � � D]. } x% | D] } t | | | � rG | SqG Wq: Wd S( sM
Return the index of the first child whose class exactly matches.
Parameters:
- `childclass`: A `Node` subclass to search for, or a tuple of `Node`
classes. If a tuple, any of the classes may match.
- `start`: Initial index to check.
- `end`: Initial index to *not* check.
N( R1 t tuplet ranget minRB R ( R t
childclassR� t endRD R| ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt first_child_matching_class� s %
c C sw t | t � s | f } n xU t | t t | � | � � D]5 } x, | D] } t | j | | � rG PqG qG W| Sq: Wd S( sI
Return the index of the first child whose class does *not* match.
Parameters:
- `childclass`: A `Node` subclass to skip, or a tuple of `Node`
classes. If a tuple, none of the classes may match.
- `start`: Initial index to check.
- `end`: Initial index to *not* check.
N( R1 R� R� R� RB R( R ( R R� R� R� RD R| ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt first_child_not_matching_class� s %
s c C sN d j d | | | j � f g g | j D] } | j | | d � ^ q* � S( NRZ s %s%s
i ( Rb R~ R( R ( R R R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s c C s | j d | j | j � S( NRY ( R" RY Rl ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s c C s9 | j � } | j g | j D] } | j � ^ q � | S( N( R R3 R( R ( R R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s )c C sC t j d t d d �d | k s( t � | d j | j � � d S( s+ Add a new class to the "classes" attribute.sa docutils.nodes.Element.set_class deprecated; append to Element['classes'] list attribute directlyt
stackleveli Rr Rh N( t warningst warnt DeprecationWarningR� R2 Ro ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt set_class� s
c C s� d | _ t | d i � j | � } t | d i � j | � } | rc | d k sW t � d | _ n | r� | d k s{ t � d | _ n d S( sQ Note that this Element has been referenced by its name
`name` or id `id`.i t expect_referenced_by_namet expect_referenced_by_idN( t
referencedt getattrR� R R� ( R R� t idt by_namet by_id( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_referenced_by� s c C s
| | j k S( s�
Returns True if and only if the given attribute is NOT one of the
basic list attributes defined for all Elements.
( Rm ( R5 R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� s c C s
| | j k S( sj
Returns True if and only if the given attribute is NOT recognized by
this class.
( t known_attributes( R5 R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� s ( Rg Rh Ri Rj ( Rk ( R N( i (J R# RJ RK R� t local_attributesRm R� R R\ R� R[ R RO R^ R� RL RM R R~ R R� R� R� R� R� R� R� R� R� R` R� Rt R� R� R� R� t has_keyR� R2 R3 R� R� R� RD R� R� R� R� R R� R� R� R� R� R R� R� R� R� R� R� R� R� t maxintR� R� R R R R� R� t classmethodR� R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRf � s� #
% t TextElementc B s# e Z d Z d Z d d d � Z RS( s�
An element which directly contains text.
Its children are all `Text` or `Inline` subclass nodes. You can
check whether an element's context is inline simply by checking whether
its immediate parent is a `TextElement` instance (including subclasses).
This is handy for nodes like `image` that can appear both inline and as
standalone body elements.
If passing children to `__init__()`, make sure to set `text` to
``''`` or some other suitable value.
RZ c O sN | d k r4 t | � } t j | | | | | � n t j | | | | � d S( NRZ ( RT Rf R[ ( R RY t textR( Rl t textnode( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ / s
( R# RJ RK R� R[ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� s
t FixedTextElementc B s e Z d Z d d d � Z RS( s5 An element which directly contains preformatted text.RZ c O s* t j | | | | | � d | j d <d S( Nt preserves xml:space( R� R[ Rl ( R RY R� R( Rl ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ < s ( R# RJ RK R[ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� 8 s t
Resolvablec B s e Z d Z RS( i ( R# RJ t resolved( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� E s t BackLinkablec B s e Z d � Z RS( c C s | d j | � d S( NRk ( R2 ( R t refid( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt add_backrefL s ( R# RJ R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� J s t Rootc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� T s t Titularc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� V s t PreBibliographicc B s e Z d Z RS( s< Category of Node which may occur before Bibliographic Nodes.( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� X s t
Bibliographicc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� [ s t
Decorativec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� ] s t
Structuralc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� _ s t Bodyc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� a s t Generalc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� c s t
Sequentialc B s e Z d Z RS( s List-like elements.( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� e s t
Admonitionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� h s t Specialc B s e Z d Z RS( s Special internal body elements.( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� j s t Invisiblec B s e Z d Z RS( s. Internal elements that don't appear in output.( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� m s t Partc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� p s t Inlinec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� r s t Referentialc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� t s t
Targetablec B s e Z d Z d Z RS( i N( R# RJ R� R t indirect_reference_name( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� w s t Labeledc B s e Z d Z RS( s( Contains a `label` as its first element.( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s R c B s+ e Z d Z d � Z d � Z d d � Z d d � Z d d d � Z d � Z d � Z
d d � Z d d � Z d
� Z
d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d d � Z d � Z d d � Z d � Z d � Z d � Z d � Z d � Z RS( s�
The document root element.
Do not instantiate this class directly; use
`docutils.utils.new_document()` instead.
c O s+ t j | | | � d | _ d | _ | | _ | | _ g | _ i | _ i | _ i | _
i | _ i | _ i | _
i | _ i | _ i | _ g | _ g | _ g | _ g | _ g | _ g | _ d | _ d | _ d | _ g | _ g | _ d d l } | j j | � | _ d | _ | | _! d S( Ni i i����(" Rf R[ R R R t settingsR t indirect_targetst substitution_defst substitution_namest refnamest refidst nameidst nametypesRg t
footnote_refst
citation_refst
autofootnotest autofootnote_refst symbol_footnotest symbol_footnote_refst footnotest citationst autofootnote_startt symbol_footnote_startt id_startt parse_messagest transform_messagest docutils.transformst
transformst Transformert transformert
decorationR ( R R� R t argst kwargst docutils( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s< c C s' | j j � } d | d <d | d <| S( sB
Return dict with unpicklable references removed.
R R N( t __dict__R R ( R t state( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt __getstate__� s
c C sG | d k r! d d l j j } n | j � } | j | j | � � | S( s- Return a DOM representation of this document.i����N( R R
R R R
Rx R ( R R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s
c C s1 xf | d D]Z } | | j k r | j | | k r | j j d | � } | d k re | | 7} qe q q W| d s x� | d D]5 } | j j t | � } | r~ | | j k r~ Pq~ q~ Wd } xL | s� | | j k r | j j | j j t | j � } | j d 7_ q� W| d j
| � n | | j | <| S( NRg s Duplicate ID: "%s".Ri RZ i ( Rg R t severeR R� t id_prefixt make_idt auto_id_prefixR� R R2 ( R R8 t msgnodeR� t msgR� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt set_id� s" "
#
c C s^ xW | d D]K } | | j k r< | j | | | | | � q | | j | <| | j | <q Wd S( s�
`self.nameids` maps names to IDs, while `self.nametypes` maps names to
booleans representing hyperlink type (True==explicit,
False==implicit). This method updates the mappings.
The following state transition table shows how `self.nameids` ("ids")
and `self.nametypes` ("types") change with new input (a call to this
method), and what actions are performed ("implicit"-type system
messages are INFO/1, and "explicit"-type system messages are ERROR/3):
==== ===== ======== ======== ======= ==== ===== =====
Old State Input Action New State Notes
----------- -------- ----------------- ----------- -----
ids types new type sys.msg. dupname ids types
==== ===== ======== ======== ======= ==== ===== =====
- - explicit - - new True
- - implicit - - new False
None False explicit - - new True
old False explicit implicit old new True
None True explicit explicit new None True
old True explicit explicit new,old None True [#]_
None False implicit implicit new None False
old False implicit implicit new,old None False
None True implicit implicit new None True
old True implicit implicit new old True
==== ===== ======== ======== ======= ==== ===== =====
.. [#] Do not clear the name-to-id map or invalidate the old target if
both old and new targets are external and refer to identical URIs.
The new target is invalidated regardless.
Ri N( R t set_duplicate_name_idR ( R R8 R� R" t explicitR� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt set_name_id_map s
c C s� | j | } | j | } | p# | | j | <| rV| r d } | d k r� | j | } d | k r� | d }
| d r� d | k r� | d |
k r� d } q� n | d k r� t | | � d | j | <q� n | j j | d | d | g d | �} | d k r
| | 7} n t | | � q�| | j | <| d k r�| j | } t | | � q�nJ | d k r�| r�d | j | <| j | } t | | � n t | | � | s�| r�| d k r�| j j d | d | g d | �} | d k r�| | 7} q�n d S( Ni t refuriRi i s% Duplicate explicit target name: "%s".Rk t base_nodes% Duplicate implicit target name: "%s".( R R R Rg t dupnameR t system_messaget info( R R8 R� R� R" R& t old_idt old_explicitR t old_nodeR( R# ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR% 7 sL
c C s
| | j k S( N( R ( R R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt has_namea s c C s/ | j | | � } | j | | | d d �d S( NR& ( R$ R' R ( R t targetR" R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_implicit_targete s c C s/ | j | | � } | j | | | d t �d S( NR& ( R$ R' R ( R R1 R" R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_explicit_targeti s c C s$ | j j | d g � j | � d S( Nt refname( R R� R2 ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_refnamem s c C s$ | j j | d g � j | � d S( NR� ( R R� R2 ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
note_refidp s c C s. | j j | � | d r* | j | � n d S( NRi ( R� R2 R5 ( R R1 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_indirect_targets s
c C s | j | � d S( N( R$ ( R R1 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_anonymous_targetx s c C s! | j | � | j j | � d S( N( R$ R R2 ( R t footnote( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_autofootnote{ s
c C s! | j | � | j j | � d S( N( R$ R R2 ( R t ref( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_autofootnote_ref s
c C s! | j | � | j j | � d S( N( R$ R
R2 ( R R9 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_symbol_footnote� s
c C s! | j | � | j j | � d S( N( R$ R R2 ( R R; ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_symbol_footnote_ref� s
c C s! | j | � | j j | � d S( N( R$ R R2 ( R R9 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
note_footnote� s
c C s> | j | � | j j | d g � j | � | j | � d S( NR4 ( R$ R R� R2 R5 ( R R; ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_footnote_ref� s
c C s | j j | � d S( N( R
R2 ( R t citation( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
note_citation� s c C s> | j | � | j j | d g � j | � | j | � d S( NR4 ( R$ R R� R2 R5 ( R R; ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_citation_ref� s
c C s� t | � } | | j k rm | j j d | d | �} | d k rP | | 7} n | j | } t | | � n | | j | <| | j t | � <d S( Ns- Duplicate substitution definition name: "%s".R) ( t whitespace_normalize_nameR R t errorR R* R t fully_normalize_name( R t subdeft def_nameR" R� R# t oldnode( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_substitution_def� s
c C s t | � | d <d S( NR4 ( RD ( R t subrefR4 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_substitution_ref� s c C s | j j | | � d S( N( R t add_pending( R t pendingt priority( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_pending� s c C s | j j | � d S( N( R R2 ( R t message( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_parse_message� s c C s | j j | � d S( N( R R2 ( R RQ ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_transform_message� s c C s2 | | _ | d k r! | | _ n
| d | _ d S( Ni ( R R R ( R R t offset( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt note_source� s c C s | j | j | j | j � S( N( R" R� R Rl ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s c C s` | j sY t � | _ | j t � } | d k rC | j | j � qY | j | | j � n | j S( N( R R� R� R R2 R� ( R RD ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt get_decoration� s N(! R# RJ RK R[ R R R R$ R' R% R0 R2 R3 R5 R6 R7 R8 R: R< R= R> R? R@ RB RC RJ RL RP RR RS RU R RV ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s< Y ' * t titlec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRW � s t subtitlec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRX � s t rubricc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRY � s t docinfoc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRZ � s t authorc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s t authorsc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR\ � s t organizationc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR] � s t addressc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR^ � s t contactc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR_ � s t versionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR` � s t revisionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRa � s t statusc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRb � s t datec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRc � s t copyrightc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRd � s R c B s e Z d � Z d � Z RS( c C sH t | j � s' t | j d t � r= | j d t � � n | j d S( Ni ( RB R( R1 t headerR� ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
get_header� s 'c C sE t | j � s' t | j d t � r: | j t � � n | j d S( Ni����( RB R( R1 t footerR2 ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
get_footer� s '( R# RJ Rf Rh ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s Re c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRe � s Rg c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRg � s t sectionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRi s t topicc B s e Z d Z RS( s�
Topics are terminal, "leaf" mini-sections, like block quotes with titles,
or textual figures. A topic is just like a section, except that it has no
subsections, and it doesn't have to conform to section placement rules.
Topics are allowed wherever body elements (list, table, etc.) are allowed,
but only at the top level of a section or document. Topics cannot nest
inside topics, sidebars, or body elements; you can't have a topic inside a
table, list, block quote, etc.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRj s t sidebarc B s e Z d Z RS( s�
Sidebars are like miniature, parallel documents that occur inside other
documents, providing related or reference material. A sidebar is
typically offset by a border and "floats" to the side of the page; the
document's main text may flow around it. Sidebars can also be likened to
super-footnotes; their content is outside of the flow of the document's
main text.
Sidebars are allowed wherever body elements (list, table, etc.) are
allowed, but only at the top level of a section or document. Sidebars
cannot nest inside sidebars, topics, or body elements; you can't have a
sidebar inside a table, list, block quote, etc.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRk s t
transitionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRl " s t paragraphc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRm ) s t compoundc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRn * s t containerc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRo + s t bullet_listc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRp , s t enumerated_listc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRq - s t list_itemc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRr . s t definition_listc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRs / s t definition_list_itemc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRt 0 s t termc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRu 1 s t
classifierc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRv 2 s t
definitionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRw 3 s t
field_listc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRx 4 s t fieldc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRy 5 s t
field_namec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRz 6 s t
field_bodyc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR{ 7 s t optionc B s e Z d Z RS( RZ ( R# RJ R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR| : s t option_argumentc B s e Z d � Z RS( c C s | j d d � t j | � S( Nt delimiterRr ( R� R� R` ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR` A s ( R# RJ R` ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR} ? s t option_groupc B s e Z d Z RS( s , ( R# RJ R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR E s t option_listc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� J s t option_list_itemc B s e Z d Z RS( s ( R# RJ R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� M s t
option_stringc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� R s t descriptionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� S s t
literal_blockc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� T s t
doctest_blockc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� U s t
math_blockc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� V s t
line_blockc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� W s R c B s e Z d Z RS( N( R# RJ R R ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR Z s t block_quotec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� _ s t attributionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� ` s t attentionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� a s t cautionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� b s t dangerc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� c s RE c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRE d s t importantc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� e s t notec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� f s t tipc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� g s t hintc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� h s t warningc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� i s t
admonitionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� j s t commentc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� k s t substitution_definitionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� l s R1 c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR1 m s R9 c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR9 n s RA c B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRA o s t labelc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� p s t figurec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� q s t captionc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� r s t legendc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� s s t tablec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� t s t tgroupc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� u s t colspecc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� v s t theadc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� w s t tbodyc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� x s t rowc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� y s t entryc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� z s R+ c B s# e Z d Z d d � Z d � Z RS( s�
System message element.
Do not instantiate this class directly; use
``document.reporter.info/warning/error/severe()`` instead.
c O s\ | r% t d | � } | f | } n y t j | d | | � Wn d | f GH� n Xd S( NRZ s system_message: children=%r( Rm Rf R[ ( R RQ R( Rl t p( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s c C s> | j d d � } d | d | | d | d t j | � f S( NR RZ u %s:%s: (%s/%s) %sR RA R ( R� Rf R` ( R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR` � s N( R# RJ RK R R[ R` ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR+ } s
RN c B s5 e Z d Z d d d � Z d d d � Z d � Z RS( 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::
<pending ...public attributes...> + internal attributes
Use `document.note_pending()` so that the
`docutils.transforms.Transformer` stage of processing can run all pending
transforms.
RZ c O s2 t j | | | | � | | _ | p( i | _ d S( N( Rf R[ t transformt details( R R� R� RY R( Rl ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s s i c C s� d d | j j | j j f d g } | j j � } | j � x| D]\ } } t | t � r� | j d d | f � | j g | j
� j � D] } d d | f ^ q� � qE | r9t | t � r9t | d t � r9| j d d | f � xa | D]< } | j g | j
� j � D] } d d | f ^ q� q� WqE | j d d | | f � qE Wt
j
| | | � d j g | D] } d | | | f ^ qv� S(
Ns .. internal attributes:s .transform: %s.%ss .details:s %7s%s:RZ s %9s%si s %7s%s: %rs %s%s
( R� RJ R# R� Rn R� R1 R R2 R3 R Ra Ru Rf Rb ( R R R t internalsR� R� Rq R R{ ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s*
0
4 c C s" | j | j | j | j | j � S( N( R" R� R� RY Rl ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR � s N( R# RJ RK R R[ R R ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRN � s
t rawc B s e Z d Z RS( s@
Raw data that is to be passed untouched to the Writer.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t emphasisc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t strongc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t literalc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t referencec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t footnote_referencec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t citation_referencec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t substitution_referencec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t title_referencec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t abbreviationc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t acronymc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t superscriptc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t subscriptc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t mathc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t imagec B s e Z d � Z RS( c C s | j d d � S( Nt altRZ ( R� ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR` � s ( R# RJ R` ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t inlinec B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t problematicc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t generatedc B s e Z RS( ( R# RJ ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s s<
Text
abbreviation acronym address admonition attention attribution author
authors
block_quote bullet_list
caption caution citation citation_reference classifier colspec comment
compound contact container 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 inline
label legend line line_block list_item literal literal_block
math math_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
warningt NodeVisitorc B sA e Z d Z d Z d � Z d � Z d � Z d � Z d � Z RS( s�
"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 `dispatch_visit()` method is called by
`Node.walk()` upon entering a node. `Node.walkabout()` also calls
the `dispatch_departure()` method before exiting a node.
The dispatch methods call "``visit_`` + node class name" or
"``depart_`` + node class name", resp.
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.
c C s
| | _ d S( N( R ( R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ L s c C sO | j j } t | d | | j � } | j j j d | j | f � | | � S( s�
Call self."``visit_`` + node class name" with `node` as
parameter. If the ``visit_...`` method does not exist, call
self.unknown_visit.
t visit_s; docutils.nodes.NodeVisitor.dispatch_visit calling %s for %s( R" R# R� t
unknown_visitR R R! ( R R8 t node_namet method( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR$ O s c C sO | j j } t | d | | j � } | j j j d | j | f � | | � S( s�
Call self."``depart_`` + node class name" with `node` as
parameter. If the ``depart_...`` method does not exist, call
self.unknown_departure.
t depart_s? docutils.nodes.NodeVisitor.dispatch_departure calling %s for %s( R" R# R� t unknown_departureR R R! ( R R8 R� R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR/ \ s c C sJ | j j j s$ | j j | j k rF t d | j | j j f � � n d S( sk
Called when entering unknown `Node` types.
Raise an exception unless overridden.
s! %s visiting unknown node type: %sN( R R� t strict_visitorR" R# t optionalR ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� i s
c C sJ | j j j s$ | j j | j k rF t d | j | j j f � � n d S( si
Called before exiting unknown `Node` types.
Raise exception unless overridden.
s" %s departing unknown node type: %sN( R R� R� R" R# R� R ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� u s
( ( R# RJ RK R� R[ R$ R/ R� R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� % s
t SparseNodeVisitorc B s e Z d Z RS( 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.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s t GenericNodeVisitorc B s e Z d Z d � Z d � Z RS( 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.
c C s
t � d S( s) Override for generic, uniform traversals.N( R ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
default_visit� s c C s
t � d S( s) Override for generic, uniform traversals.N( R ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt default_departure� s ( R# RJ RK R� R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C s | j | � d S( N( R� ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt _call_default_visit� s c C s | j | � d S( N( R� ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt _call_default_departure� s c C s d S( N( ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt _nop� s c C se x^ | D]V } t t d | t � t t d | t � t t d | t � t t d | t � q Wd S( s% Save typing with dynamic assignments:R� R� N( t setattrR� R� R� R� R� ( Ri t _name( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt _add_node_class_names� s
t TreeCopyVisitorc B s2 e Z d Z d � Z d � Z d � Z d � Z RS( sQ
Make a complete copy of a tree or branch, including element attributes.
c C s& t j | | � g | _ g | _ d S( N( R� R[ t parent_stackR ( R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR[ � s c C s | j d S( Ni ( R ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt
get_tree_copy� s c C s< | j � } | j j | � | j j | j � | | _ d S( s9 Copy the current node, and make it the new acting parent.N( R R R2 R� ( R R8 t newnode( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s c C s | j j � | _ d S( s# Restore the previous acting parent.N( R� R� R ( R R8 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s ( R# RJ RK R[ R� R� R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s
t TreePruningExceptionc B s e Z d Z RS( 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.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s R% c B s e Z d Z RS( s�
Do not visit any children of the current node. The current node's
siblings and ``depart_...`` method are not affected.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR% � s R* c B s e Z d Z RS( 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.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR* � s R& c B s e Z d Z RS( sq
Do not visit the current node's children, and do not call the current
node's ``depart_...`` method.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR& � s R' c B s e Z d Z RS( s
Do not call the current node's ``depart_...`` method. The current node's
children and siblings are not affected.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR' � s t NodeFoundc B s e Z d Z RS( 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.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� s R+ c B s e Z d Z RS( s=
Stop the traversal alltogether. The current node's ``depart_...`` method
is not affected. The parent nodes ``depart_...`` methods are also called
as usual. No other nodes are visited. This is an alternative to
NodeFound that does not cause exception handling to trickle up to the
caller.
( R# RJ RK ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR+ s c C s� | j � } t | t � s* | j � } n | j t � } | j t � } t j d | � j d d � j d � } t
j d d j | j
� � � } t j d | � } t | � S( 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
t NFKDRP t ignoret -Rr RZ ( Ro R1 R t decodet translatet _non_id_translate_digraphst _non_id_translatet unicodedatat normalizeR t
_non_id_charst subRb t splitt _non_id_at_endsR� ( t stringR� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR ! s # !s
[^a-z0-9]+s ^[-0-9]+|-+$u oi� u di u hi' u ii1 u liB u tig u bi� i� u ci� i� u fi� u ki� i� u ni� u pi� i� i� u yi� u zi� u gi� i% i4 i5 i6 u ji7 i< u si? i@ u eiG iI u qiK u riM iO u szi� u aei� u oeiS u dbi8 u qpi9 c C s/ | d j | � | d j | � d | _ d S( NRj Ri i ( R2 R� R� ( R8 R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR* s c C s d j | j � j � � S( s. Return a case- and whitespace-normalized name.Rr ( Rb Ro R� ( R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRF � s c C s d j | j � � S( s$ Return a whitespace-normalized name.Rr ( Rb R� ( R� ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRD � s c C s | j d d � j d d � S( sD Escape string values that are elements of a list, for serialization.s \s \\Rr s \ ( R� ( Rq ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyRv � s c C s d | S( s Quote attributes for pseudo-xmls "%s"( ( Rq ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyR� � s (� RK t
__docformat__RL t ost reR� R? R� t objectR RM R RN RS RT Rf R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R RW RX RY RZ R[ R\ R] R^ R_ R` Ra Rb Rc Rd R Re Rg Ri Rj Rk Rl Rm Rn Ro Rp Rq Rr Rs Rt Ru Rv Rw Rx Ry Rz R{ R| R} R R� R� R� R� R� R� R� R� R R� R� R� R� R� RE R� R� R� R� R� R� R� R� R1 R9 RA R� R� R� R� R� R� R� R� R� R� R� R+ RN R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� t node_class_namesR� R� R� R� R� R� R� R� t ExceptionR� R% R* R& R' R� R+ R t compileR� R� R� R� R* RF RD Rv R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/docutils/nodes.pyt <module> s� �
L� � �
� J
""" E
" ]
1