ó
öÀ„\c           @   sE  d  Z  d d l Z d d l m Z d d l m Z e rQ d d l m Z m	 Z	 n  d e
 f d „  ƒ  YZ d e
 f d	 „  ƒ  YZ d
 e j e j e f d „  ƒ  YZ d e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ e Z d e j e j e j f d „  ƒ  YZ d e f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d e j e j e j f d „  ƒ  YZ d  e j e j e j f d! „  ƒ  YZ  d" e j e j f d# „  ƒ  YZ! d$ e j e j f d% „  ƒ  YZ" d& e j e j f d' „  ƒ  YZ# d( e j e j f d) „  ƒ  YZ$ d* e j e j e j f d+ „  ƒ  YZ% d, e j& f d- „  ƒ  YZ& d. e j' f d/ „  ƒ  YZ' d0 e' f d1 „  ƒ  YZ( d2 e j) e j e j f d3 „  ƒ  YZ* d4 e j e j f d5 „  ƒ  YZ+ d6 e j f d7 „  ƒ  YZ, d8 e j f d9 „  ƒ  YZ- d: e j f d; „  ƒ  YZ. d< e j/ f d= „  ƒ  YZ0 d> e j f d? „  ƒ  YZ1 d@ e j f dA „  ƒ  YZ2 dB e j f dC „  ƒ  YZ3 dD e j f dE „  ƒ  YZ4 dF e j f dG „  ƒ  YZ5 dH e j6 e j7 e j f dI „  ƒ  YZ8 dJ e j e j f dK „  ƒ  YZ9 dL e j: f dM „  ƒ  YZ; dN e j: f dO „  ƒ  YZ< dP e j= e f dQ „  ƒ  YZ> dR e j? e f dS „  ƒ  YZ@ dT e j e j f dU „  ƒ  YZA dV e j e j f dW „  ƒ  YZB e jC dX „  eD ƒ  jE ƒ  Dƒ ƒ d S(Y   s»   
    sphinx.addnodes
    ~~~~~~~~~~~~~~~

    Additional docutils nodes.

    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
    :license: BSD, see LICENSE for details.
iÿÿÿÿN(   t   nodes(   t   RemovedInSphinx30Warning(   t   Listt   Sequencet   translatablec           B   s)   e  Z d  Z d „  Z d „  Z d „  Z RS(   s¯  Node which supports translation.

    The translation goes forward with following steps:

    1. Preserve original translatable messages
    2. Apply translated messages from message catalog
    3. Extract preserved messages (for gettext builder)

    The translatable nodes MUST preserve original messages.
    And these messages should not be overridden at applying step.
    Because they are used at final step; extraction.
    c         C   s
   t  ‚ d S(   s(   Preserve original translatable messages.N(   t   NotImplementedError(   t   self(    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyt   preserve_original_messages%   s    c         C   s
   t  ‚ d S(   s   Apply translated message.N(   R   (   R   t   original_messaget   translated_message(    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyt   apply_translated_message*   s    c         C   s
   t  ‚ d S(   sj   Extract translation messages.

        :returns: list of extracted messages or messages generator
        N(   R   (   R   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyt   extract_original_messages/   s    (   t   __name__t
   __module__t   __doc__R   R
   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR      s   		t   not_smartquotablec           B   s   e  Z d  Z e Z RS(   s+   A node which does not support smart-quotes.(   R   R   R   t   Falset   support_smartquotes(    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   8   s   t   toctreec           B   s)   e  Z d  Z d „  Z d „  Z d „  Z RS(   s    Node for inserting a "TOC tree".c         C   s$   |  j  d ƒ r  |  d |  d <n  d  S(   Nt   captiont
   rawcaption(   t   get(   R   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   @   s    c         C   s&   |  j  d ƒ | k r" | |  d <n  d  S(   NR   R   (   R   (   R   R   R	   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR
   E   s    c         C   s   d |  k r |  d g Sg  Sd  S(   NR   (    (   R   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   J   s    (   R   R   R   R   R
   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   =   s   		t   descc           B   s   e  Z d  Z RS(   s°   Node for object descriptions.

    This node is similar to a "definition list" with one definition.  It
    contains one or more ``desc_signature`` and a ``desc_content``.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   T   s   t   desc_signaturec           B   s   e  Z d  Z RS(   s%  Node for object signatures.

    The "term" part of the custom Sphinx definition list.

    As default the signature is a single line signature,
    but set ``is_multiline = True`` to describe a multi-line signature.
    In that case all child nodes must be ``desc_signature_line`` nodes.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   \   s   t   desc_signature_linec           B   s   e  Z d  Z RS(   sÓ   Node for a line in a multi-line object signatures.

    It should only be used in a ``desc_signature`` with ``is_multiline`` set.
    Set ``add_permalink = True`` for the line that should get the permalink.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   g   s   t   desc_addnamec           B   s   e  Z d  Z RS(   s9   Node for additional name parts (module name, class name).(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   q   s   t	   desc_typec           B   s   e  Z d  Z RS(   s+   Node for return types or object type names.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   y   s   t   desc_returnsc           B   s   e  Z d  Z d „  Z RS(   s4   Node for a "returns" annotation (a la -> in Python).c         C   s   d t  j j |  ƒ S(   Ns    -> (   R    t   TextElementt   astext(   R   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR      s    (   R   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   }   s   t	   desc_namec           B   s   e  Z d  Z RS(   s   Node for the main object name.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   „   s   t   desc_parameterlistc           B   s   e  Z d  Z d Z RS(   s"   Node for a general parameter list.s   , (   R   R   R   t   child_text_separator(    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   ˆ   s   t   desc_parameterc           B   s   e  Z d  Z RS(   s   Node for a single parameter.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR!      s   t   desc_optionalc           B   s   e  Z d  Z d Z d „  Z RS(   s6   Node for marking optional parts of the parameter list.s   , c         C   s   d t  j j |  ƒ d S(   Nt   [t   ](   R    R   R   (   R   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR   •   s    (   R   R   R   R    R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR"   ‘   s   t   desc_annotationc           B   s   e  Z d  Z RS(   s@   Node for signature annotations (not Python 3-style annotations).(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR%   š   s   t   desc_contentc           B   s   e  Z d  Z RS(   sr   Node for object description content.

    This is the "definition" part of the custom Sphinx definition list.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR&   ž   s   t   versionmodifiedc           B   s   e  Z d  Z RS(   s   Node for version change entries.

    Currently used for "versionadded", "versionchanged" and "deprecated"
    directives.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR'   §   s   t   seealsoc           B   s   e  Z d  Z RS(   s   Custom "see also" admonition.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR(   ¯   s   t   productionlistc           B   s   e  Z d  Z RS(   sK   Node for grammar production lists.

    Contains ``production`` nodes.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR)   ³   s   t
   productionc           B   s   e  Z d  Z RS(   s*   Node for a single grammar production rule.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR*   º   s   t   mathc           B   s   e  Z d  Z d „  Z RS(   s  Node for inline equations.

    .. warning:: This node is provided to keep compatibility only.
                 It will be removed in nearly future.  Don't use this from your extension.

    .. deprecated:: 1.8
       Use ``docutils.nodes.math`` instead.
    c         C   sR   | d k r; d |  j  k r; t j d t d d ƒ|  j ƒ  St j j |  | ƒ Sd S(   s2   Special accessor for supporting ``node['latex']``.t   latexsr   math node for Sphinx was replaced by docutils'. Therefore please use ``node.astext()`` to get an equation instead.t
   stackleveli   N(   t
   attributest   warningst   warnR   R   R    R+   t   __getitem__(   R   t   key(    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR1   Ë   s
    	
(   R   R   R   R1   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR+   Á   s   t
   math_blockc           B   s   e  Z d  Z d „  Z RS(   sÜ   Node for block level equations.

    .. warning:: This node is provided to keep compatibility only.
                 It will be removed in nearly future.  Don't use this from your extension.

    .. deprecated:: 1.8
    c         C   sR   | d k r; d |  j  k r; t j d t d d ƒ|  j ƒ  St j j |  | ƒ Sd  S(   NR,   sy   displaymath node for Sphinx was replaced by docutils'. Therefore please use ``node.astext()`` to get an equation instead.R-   i   (   R.   R/   R0   R   R   R    R3   R1   (   R   R2   (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR1   ß   s
    	
(   R   R   R   R1   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR3   Ö   s   t   displaymathc           B   s   e  Z d  Z RS(   sÜ   Node for block level equations.

    .. warning:: This node is provided to keep compatibility only.
                 It will be removed in nearly future.  Don't use this from your extension.

    .. deprecated:: 1.8
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR4   é   s   t   indexc           B   s   e  Z d  Z RS(   sÈ  Node for index entries.

    This node is created by the ``index`` directive and has one attribute,
    ``entries``.  Its value is a list of 5-tuples of ``(entrytype, entryname,
    target, ignored, key)``.

    *entrytype* is one of "single", "pair", "double", "triple".

    *key* is categorization characters (usually a single character) for
    general index page. For the details of this, please see also:
    :rst:dir:`glossary` and issue #2320.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR5   õ   s   t   centeredc           B   s   e  Z d  Z RS(   s   Deprecated.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR6     s   t   acksc           B   s   e  Z d  Z RS(   s   Special node for "acks" lists.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR7     s   t   hlistc           B   s   e  Z d  Z RS(   sj   Node for "horizontal lists", i.e. lists that should be compressed to
    take up less vertical space.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR8     s   t   hlistcolc           B   s   e  Z d  Z RS(   s)   Node for one column in a horizontal list.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR9     s   t   compact_paragraphc           B   s   e  Z d  Z RS(   s<   Node for a compact paragraph (which never makes a <p> node).(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR:     s   t   glossaryc           B   s   e  Z d  Z RS(   s   Node to insert a glossary.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR;     s   t   onlyc           B   s   e  Z d  Z RS(   sA   Node for "only" directives (conditional inclusion based on tags).(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR<     s   t   start_of_filec           B   s   e  Z d  Z RS(   sA   Node to mark start of a new file, used in the LaTeX builder only.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR=   $  s   t   highlightlangc           B   s   e  Z d  Z RS(   sc   Inserted to set the highlight language and line number options for
    subsequent code blocks.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR>   (  s   t   tabular_col_specc           B   s   e  Z d  Z RS(   s;   Node for specifying tabular columns, used for LaTeX output.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR?   .  s   t   metac           B   s   e  Z d  Z RS(   sY   Node for meta directive -- same as docutils' standard meta node,
    but pickleable.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyR@   2  s   t   pending_xrefc           B   s   e  Z d  Z RS(   sÍ   Node for cross-references that cannot be resolved without complete
    information about all documents.

    These nodes are resolved before writing output, in
    BuildEnvironment.resolve_references.
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRA   :  s   t   number_referencec           B   s   e  Z d  Z RS(   s4   Node for number references, similar to pending_xref.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRB   C  s   t   download_referencec           B   s   e  Z d  Z RS(   s6   Node for download references, similar to pending_xref.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRC   G  s   t   literal_emphasisc           B   s   e  Z d  Z RS(   s{   Node that behaves like `emphasis`, but further text processors are not
    applied (e.g. smartypants for HTML output).
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRD   K  s   t   literal_strongc           B   s   e  Z d  Z RS(   sy   Node that behaves like `strong`, but further text processors are not
    applied (e.g. smartypants for HTML output).
    (   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRE   Q  s   t   abbreviationc           B   s   e  Z d  Z RS(   s)   Node for abbreviations with explanations.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRF   W  s   t   manpagec           B   s   e  Z d  Z RS(   s    Node for references to manpages.(   R   R   R   (    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyRG   [  s   c         c   s1   |  ]' } | d  k r | d d k r | Vq d S(   R    i    t   _N(    (   t   .0t   k(    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pys	   <genexpr>a  s    (F   R   R/   t   docutilsR    t   sphinx.deprecationR   R   t   typingR   R   t   objectR   R   t   Generalt   ElementR   t
   AdmonitionR   t   Partt   InlineR   R   t   FixedTextElementR   R   t   desc_classnameR   R   R   R   R!   R"   R%   R&   R'   R(   R)   R*   R+   R3   R4   t	   InvisibleR5   R6   R7   R8   R9   t	   paragraphR:   R;   R<   R=   R>   R?   t   Specialt   PreBibliographicR@   RA   t	   referenceRB   RC   t   emphasisRD   t   strongRE   RF   RG   t   _add_node_class_namest   globalst   keys(    (    (    s.   lib/python2.7/site-packages/sphinx/addnodes.pyt   <module>
   s`   !"%%
%%%%%%	%	%%%	