ó öÀ„\c@sdZddlZddlmZddlmZmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZmZdd lmZdd lmZdd lmZddlmZmZerCddlmZm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(nej)e*ƒZ+e,dddgƒZ-defd„ƒYZ.defd„ƒYZ/de.fd„ƒYZ0de.fd„ƒYZ1de.fd „ƒYZ2d!e.fd"„ƒYZ3d#e.fd$„ƒYZ4d%e.fd&„ƒYZ5iej6d'6ej7d(6ej8d)6ej9d*6ej:d+6Z;d,e.fd-„ƒYZ<d.e.fd/„ƒYZ=d0e.fd1„ƒYZ>d2e.fd3„ƒYZ?d4e.fd5„ƒYZ@d6efd7„ƒYZAd8e e.fd9„ƒYZBd:e.fd;„ƒYZCd<e.fd=„ƒYZDdS(>sß sphinx.transforms ~~~~~~~~~~~~~~~~~ Docutils transforms used by Sphinx when reading documents. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. iÿÿÿÿN(tnodes(t Transformt Transformer(tContentsFilter(t SmartQuotes(tnormalize_language_tag(t smartchars(taddnodes(t_t__(tlogging(t new_document(t format_date(tapply_source_workaroundtis_smartquotable(t GeneratortList(tSphinx(tConfig(tStandardDomain(tBuildEnvironmenttversiontreleasettodaytSphinxTransformcBs;eZdZed„ƒZed„ƒZed„ƒZRS(sŒA base class of Transforms. Compared with ``docutils.transforms.Transform``, this class improves accessibility to Sphinx APIs. cCs|jjjjS(s)Reference to the :class:`.Sphinx` object.(tdocumenttsettingstenvtapp(tself((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR5scCs |jjjS(s3Reference to the :class:`.BuildEnvironment` object.(RRR(R((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR;scCs|jjjjS(s)Reference to the :class:`.Config` object.(RRRtconfig(R((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRAs(t__name__t __module__t__doc__tpropertyRRR(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR.stSphinxTransformercBs,eZdZdZdZd„Zd„ZRS(s# A transformer for Sphinx. cCs ||_dS(N(R(RR((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pytset_environmentPscCs¿t|jtjƒrYt|jjdƒ rI|jrI|j|jj_ntj|ƒnbzNtdƒ}|jrƒ|j|j_n||j7}||_tj|ƒWd|jd|_XdS(NRti( t isinstanceRRthasattrRRRtapply_transformsR (RR((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR(Ts    N(RR R!tNoneRRR$R((((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR#Hs  tDefaultSubstitutionscBseZdZdZd„ZRS(sL Replace some substitutions if they aren't defined in the document. iÒcCs¹tt|jjƒ}xœ|jjtjƒD]…}|d}||kr,|j|}|dkr•| r•t|jj p€t dƒd|jj ƒ}n|j tj ||ƒƒq,q,WdS(NtrefnameRs %b %d, %Ytlanguage(tdefault_substitutionstsetRtsubstitution_defsttraverseRtsubstitution_referenceRR t today_fmtRR,t replace_selftText(Rt to_handletrefR+ttext((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pytapplyos   (RR R!tdefault_priorityR8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR*hstMoveModuleTargetscBseZdZdZd„ZRS(sv Move module targets that are the first thing in a section to the section title. XXX Python specific iÒcCs˜x‘|jjtjƒD]z}|ds,qnd|kr|jjtjkr|jj|ƒdkr|d|jddd+|jj|ƒqqWdS(Ntidstismodii( RR0Rttargettparentt __class__tsectiontindextremove(Rtnode((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8‡s  (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR:~stHandleCodeBlockscBseZdZdZd„ZRS(s5 Several code block related transformations. iÒcCsPxI|jjtjƒD]2}td„|jDƒƒr|j|jƒqqWdS(Ncss!|]}t|tjƒVqdS(N(R&Rt doctest_block(t.0tchild((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pys žs(RR0Rt block_quotetalltchildrenR3(RRC((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8šs (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRD”st AutoNumberingcBseZdZdZd„ZRS(sO Register IDs of tables, figures and literal_blocks to assign numbers. iÒcCsm|jjdƒ}xT|jjtjƒD]=}|j|ƒr(|j|ƒdk r(|jj |ƒq(q(WdS(Ntstd( Rt get_domainRR0RtElementtis_enumerable_nodetget_numfig_titleR)tnote_implicit_target(RtdomainRC((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8³s$(RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRK­stSortIdscBseZdZdZd„ZRS(s@ Sort secion IDs so that the "id[0-9]+" one comes last. icCsuxn|jjtjƒD]W}t|dƒdkr|ddjdƒr|dd|ddg|dtlineR4treplace(Rtcitnodetcittexttrefnode((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8Ðs   (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRWÉss literal-blocks doctest-blocktrawRAtimagetApplySourceWorkaroundcBseZdZdZd„ZRS(s0 update source and rawsource attributes i cCsFx?|jjƒD].}t|tjtjfƒrt|ƒqqWdS(N(RR0R&Rt TextElementRlR (Rtn((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8ñs(RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRmëstAutoIndexUpgradercBseZdZdZd„ZRS(sZ Detect old style; 4 column based indices and automatically upgrade to new style. iÒcCs¼xµ|jjtjƒD]ž}d|krtd„|dDƒƒrtdƒ|d}tj|d|ƒxHt|dƒD]3\}}t |ƒdkrz|d|d|ssG4 column based index found. It might be a bug of extensions you use: %rtlocationi(N( RR0RRAtanyR tloggertwarningt enumerateRUR)(RRCtmsgtiRr((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8þs&  (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRpøstExtraTranslatableNodescBseZdZdZd„ZRS(s! make nodes translatable i cs|jj}gtjƒD]\}}||kr|^q‰ˆsGdS‡fd†}x$|jj|ƒD]}t|d1ssFootnote [#] is not referenced.( Rt footnotest footnote_refsRuRvR t autofootnotesRttautofootnote_refs(R((RCs9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8%s " (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR…stFilterSystemMessagescBseZdZdZd„ZRS(s&Filter system messages from a doctree.içcCsu|jjrdpd}xV|jjtjƒD]?}|d|kr.tjd|jƒƒ|j j |ƒq.q.WdS(Niitlevels%s [filtered system message]( Rt keep_warningsRR0Rtsystem_messageRutdebugRbR>RB(Rt filterlevelRC((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8;s (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR7stSphinxContentsFiltercBs eZdZd„Zd„ZRS(sx Used with BuildEnvironment.add_toc_from() to discard cross-file links within table-of-contents link nodes. cCs5|jƒ}|jjtj||ƒƒtj‚dS(N(RbR>tappendRtliteraltSkipNode(RRCR7((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pytvisit_pending_xrefIs cCs tj‚dS(N(RR˜(RRC((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyt visit_imageOs(RR R!R™Rš(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR•Ds tSphinxSmartQuotescBs>eZdZdZd„Zd„Zed„ƒZd„ZRS(sr Customized SmartQuotes to avoid transform for some extra node types. refs: sphinx.parsers.RSTParser iîcCs!|jƒsdStj|ƒdS(N(t is_availableRR8(R((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8\s cCsÐ|jjjdgƒ}|jjjdgƒ}|jjjtkrItS|jjtkr_tS|jj j |krxtS|jj |krŽtS|j jd}x+t |ƒD]}|tjkr«tSq«WtSdS(Ntbuilderst languagest language_code(Rtsmartquotes_excludestgetRRt smart_quotesR`t smartquotesRtbuildertnameR,RRRtquotesRd(RRRžR,ttag((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyRœcscCs |jjS(s„A smartquotes_action setting for SmartQuotes. Users can change this setting through :confval:`smartquotes_action`. (Rtsmartquotes_action(R((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR¨}sccsKidt6dt6}x0|D](}t|ƒ }|||jƒfVqWdS(NR—tplain(RdR`RRb(Rttxtnodesttexttypettxtnodetnotsmartquotable((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyt get_tokens†s     ( RR R!R9R8RœR"R¨R®(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR›Ts    tDoctreeReadEventcBseZdZdZd„ZRS(s!Emit :event:`doctree-read` event.ipcCs|jjd|jƒdS(Ns doctree-read(RtemitR(R((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8–s(RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR¯’st ManpageLinkcBseZdZdZd„ZRS(s&Find manpage section numbers and namesiçcCs¹x²|jjtjƒD]›}djg|jD]$}t|tjƒr,t |ƒ^q,ƒ}d}i|d6|d6dd6}t j ||ƒ}|r¡|j ƒ}n|j j|ƒqWdS(Nt s7^(?P(?P.+)[\(\.](?P
[1-9]\w*)?\)?)$tpathtpageR%R@(RR0RtmanpagetjoinRJR&RR4tstrtretmatcht groupdictt attributestupdate(RRCtxRµtpatterntinfotr((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR8Ÿs'  (RR R!R9R8(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyR±›s(ER!R¸tdocutilsRtdocutils.transformsRRtdocutils.transforms.partsRtdocutils.transforms.universalRtdocutils.utilsRtdocutils.utils.smartquotesRtsphinxRt sphinx.localeRR t sphinx.utilR tsphinx.util.docutilsR tsphinx.util.i18nR tsphinx.util.nodesR RR`ttypingRRtsphinx.applicationRt sphinx.configRtsphinx.domain.stdRtsphinx.environmentRt getLoggerRRuR.R-RR#R*R:RDRKRSRWt literal_blockRERkRARlR€RmRpRzR…RR•R›R¯R±(((s9lib/python2.7/site-packages/sphinx/transforms/__init__.pyt s^           >