ó öÀ„\c@s†dZddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZmZerõdd lmZmZmZmZmZdd lmZdd lmZdd lmZni ej d6ej!d6ej"d6ej#d6ej d6ej$d6ej#d6ej#d6ej d6ej"d6Z%de&fd„ƒYZ'de'fd„ƒYZ(igd„Z)ej*dƒZ+igd„Z,ej*dƒZ-ej*d ƒZ.igd!„Z/ej*d"ej0ƒZ1igd#„Z2igd$„Z3i e'd%ej4ƒd&6e(d'e5ƒd(6e)d)6e)d*6e,d+6e,d,6e/d-6e/d.6e2d/6e3d06Z6d1„Z7dS(2s¾ sphinx.roles ~~~~~~~~~~~~ Handlers for additional ReST roles. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. iÿÿÿÿN(tnodestutils(t iteritems(taddnodes(t SphinxError(t_(tws_re(tsplit_explicit_titletprocess_index_entrytset_role_source_info(tAnytDicttListtTupletType(tInliner(tSphinx(tBuildEnvironmenttcommandtdfntkbdt mailheadertmakevartmanpagetmimetypet newsgrouptprogramtregexptXRefRolecBsbeZdZejZejZe e dde d„Z d„Z igd„Z d„Zd„ZRS(sA A generic cross-referencing role. To create a callable that can be used as a role function, create an instance of this class. The general features of this role are: * Automatic creation of a reference and a content node. * Optional separation of title and target with `title `. * The implementation is a class rather than a function to make customization easier. Customization can be done in two ways: * Supplying constructor parameters: * `fix_parens` to normalize parentheses (strip from target, and add to title if configured) * `lowercase` to lowercase the target * `nodeclass` and `innernodeclass` select the node classes for the reference and the content node * Subclassing and overwriting `process_link()` and/or `result_nodes()`. cCsO||_||_||_|dk r3||_n|dk rK||_ndS(N(t fix_parenst lowercaset warn_danglingtNonet nodeclasstinnernodeclass(tselfRRR!R"R((s+lib/python2.7/site-packages/sphinx/roles.pyt__init__Ks      cCsd|s>|jdƒr"|d }n|jjr>|d7}q>n|jdƒrZ|d }n||fS(Ns()iþÿÿÿ(tendswithtconfigtadd_function_parentheses(R#tenvthas_explicit_titlettitlettarget((s+lib/python2.7/site-packages/sphinx/roles.pyt _fix_parensVs   cCs`|jjj}|sT|jjdƒ}|s<|jj}n|s`tdƒ‚q`n |jƒ}d|krˆd|} } d| g} n1|j ddƒ\} } d| d| | fg} |dd!d kr=t j |ƒd}|j r |j |t|dƒ\}} n|j||d | ƒ} |j|j|| d tƒSt|ƒ\}}}t j |ƒ}t j |ƒ}|jrˆ|jƒ}n|j r²|j ||||ƒ\}}n|j|d | d | d|ƒ}t|||ƒ|j|||||ƒ\}}||d<||j||d | ƒ7}|j|d<|j|d<|j|j||d tƒS(Nt default_rolescannot determine default role!t:ttxrefis%s-%sit!tclassestis_reftreftypet refdomaint refexplicitt reftargettrefdoctrefwarn(tdocumenttsettingsR(t temp_datatgetR&R-RtlowertsplitRtunescapeRR,tFalseR"t result_nodesRRR!R t process_linktdocnameRtTrue(R#ttyptrawtextttexttlinenotinlinertoptionstcontentR(tdomaintroleR2ttgtt innernodeR)R*R+trefnode((s+lib/python2.7/site-packages/sphinx/roles.pyt__call__dsL    !      cCs|tjd|ƒfS(sëCalled after parsing title and target text, and creating the reference node (given in *refnode*). This method can alter the reference node and must return a new (or the same) ``(title, target)`` tuple. t (Rtsub(R#R(RQR)R*R+((s+lib/python2.7/site-packages/sphinx/roles.pyRCšscCs |ggfS(s(Called before returning the finished nodes. *node* is the reference node if one was created (*is_ref* is then true), else the content node. This method can add other nodes and must return a ``(nodes, messages)`` tuple (the usual return value of a role function). ((R#R:R(tnodeR3((s+lib/python2.7/site-packages/sphinx/roles.pyRB£sN(t__name__t __module__t__doc__Rt pending_xrefR!RtliteralR"RAR R$R,RRRCRB(((s+lib/python2.7/site-packages/sphinx/roles.pyR0s   5 t AnyXRefRolecBseZd„ZRS(cCs5tj||||||ƒ}|jj|jƒ|S(N(RRCt attributestupdatet ref_context(R#R(RQR)R*R+tresult((s+lib/python2.7/site-packages/sphinx/roles.pyRC®s (RVRWRC(((s+lib/python2.7/site-packages/sphinx/roles.pyR[­sc CsŒ|jjj}|s>|jds(t‚|jdjƒ}n |jƒ}t|ƒ\}} } tj| ƒ} tj| ƒ} d|j dƒ} t j ƒ} t j ddd| gƒ} |jj| ƒ|dkr!dtdƒ| | ddfg| d RRR@t new_serialnoRR`RR+tnote_explicit_targetRR tfindtintt ValueErrortreporterterrort problematict pep_base_urltstrongt referenceRAt rfc_base_urltrfc_url(RFRGRHRIRJRKRLR(R)R*R+ttargetidt indexnodet targetnodetanchort anchorindextpepnumtmsgtprbtreftsntrntrfcnum((s+lib/python2.7/site-packages/sphinx/roles.pytindexmarkup_role·sp               s(?|jds(t‚|jdjƒ}n |jƒ}tj|ƒ}|dkrz|jddƒ}nt j |ƒ}t j d|ƒ} xÍt |ƒD]¿\} } | jddƒ} | dkrt| ƒdkr¨t j| ƒ} | | 7} q¨q¨nt j ƒ} t j| dƒ}| |7} | d jd ƒ| | 7} t j| d ƒ} | | 7} q¨W| d j|ƒ| ggfS( NR-t menuselections-->u‣RGs&&t&iR2t acceleratori(R:R;R(R<RjR>RR@treplacet_amp_reR?Rtinlinet enumeratetlentTexttappend(RFRGRHRIRJRKRLR(tspansRUtitspanttextnodet accel_nodet letter_node((s+lib/python2.7/site-packages/sphinx/roles.pyt menusel_roleüs4       s {([^}]+)}s (\\*{|\\*})cCs¦|jjj}|s>|jds(t‚|jdjƒ}n |jƒ}tjd|jƒd|gƒ}tt j t j |ƒƒƒ} dg} xÍ| D]Å} t j | ƒ} | rNt| ƒd} | ddkr| dcdt| ddƒ| d7RRZtlistt parens_reR?RR@tmatchRŒRnRŽRtemphasistjoin(RFRGRHRIRJRKRLR(tretnodetpartststacktparttmatchedt backslashes((s+lib/python2.7/site-packages/sphinx/roles.pytemph_literal_role"sB !  -" 8 !  s \((.*)\)$c Cstj|ƒ}tj|ƒ}|dkrFtj|||ggfS||jƒ jƒ}|j dƒ} |j ƒ}| |d s^ (          } B"1