-Pha"dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZeeZd Zd Zd5dZGddeZ d6dddd7d#Zd8d&Zd9d(Zd:d.Zd;d/Zd;d0Zd;d1ZGd2d3ej Z!d4S)._warn's6 *S * *x      zmust be a dictionaryzkey must be a string: z value must be a dictionaryinheritz! value must have an 'inherit' key'z'.inherit' is an unknown directive key: optionsz$.options' value must be a dictionaryargumentz!.argument' value must be a stringz.options' unknown key z .options.z' value must be a stringT)override)sd_custom_directives isinstancedictitemsstr option_spec add_directive) rrr conf_valuer&namedata directive_clskeyvalues r%setup_custom_directivesr:"so,J   j$ ' ' $%%%&(# &&((>> d$$$  E3433 4 4 4 $%%  ET888 9 9 9  D ET>>> ? ? ?   ?- / / ETdTT4 ?TT U U U %d9o6   d9ot44 D$DDDEEET!!*T*5Es*K*K!A$AAABBB"9o3355   Um777EAdAA#AABBB!%--EJdJJSJJJKKK $ ====9>>r'c2eZdZdZeddZddZdS) SdDirectivea1Base class for all sphinx-design directives. Having a base class allows for shared functionality to be implemented in one place. Namely, we allow for default options to be configured, per directive name. This class should be sub-classed by all directives in the sphinx-design extension. rlist[nodes.Node]c h|jj|jx}r|js,|dx}rt |g|_|diD]\}}||jvr||jvr |j|t ||j|<D#t$rL}t d|d|jd|td|j j|jfYd}~d}~wwxYw|S) zpRun the directive. This method should not be overridden, instead override `run_with_defaults`. r+r*zInvalid default option z for z: directive)r r!locationN)rr-getr5 argumentsr1r0r*r2 Exceptionr"rr#envdocnamelinenorun_with_defaults)selfr6r+r8r9excs r%runzSdDirective.run\se ;377 BB B4 N 1TXXj5I5I)I 1"%h--"hhy"55;;==   Udl**sd6F/F/F,AD,zmake_choice..sJ-h@@r'rQ)rfs`r% make_choicerls @ @ @ @@r'r+ str | None class_prefixallowed list[str]cJ|td|}|D]}||vrt|d|t|dkrd|dgSt|dkrfdtgd |DStd ) zvValidate the margin/padding is one (all) or four (top bottom left right) integers, between 0 and 5 or 'auto'. Nz#argument required but none suppliedz is not in: -rc(g|]\}}|d|S)rsrQ).0sider9rns r% z-_margin_or_padding_option..s@   e +T + +E + +   r')tblrzCargument must be one (all) or four (top bottom left right) integers) ValueErrorsplitlenzip)r+rnrovaluesr9s ` r%_margin_or_padding_optionrs>??? ^^  F>>   <<7<<== =  6{{a--&)--.. 6{{a    "#7#7#7@@     M  r'c$t|ddS)znValidate the margin is one (all) or four (top bottom left right) integers, between 0 and 5 or 'auto'. zsd-m)auto012345rr+s r% margin_optionrs %&@  r'c$t|ddS)zeValidate the padding is one (all) or four (top bottom left right) integers, between 0 and 5. zsd-p)rrrrrrrrs r%padding_optionrs %Xv7U V VVr'c<tj|gd}d|gS)z:Validate the text align is left, right, center or justify.)leftrightcenterjustifyzsd-text-ri)r+r9s r% text_alignrs,  h(N(N(N O OE u   r'ceZdZdZdS)PassthroughTextElementa9A text element which will not render anything. This is required for reference node to render correctly outside of paragraphs. Since sphinx expects them to be within a ``TextElement``: https://github.com/sphinx-doc/sphinx/blob/068f802df90ea790f89319094e407c4d5f6c26ff/sphinx/writers/html5.py#L224 N)rMrNrOrPrQr'r%rrsr'rN)rrrr rrrr)rQ) r5r1rUrVrSr1rTrWrrX)r`rbr5r1)rfrV)r+rmrnr1rorVrrp)r+rmrrp)"rP __future__rcollections.abcrtypingrdocutilsrdocutils.parsers.rstrsphinx.applicationr sphinx.configr sphinx.util.docutilsr sphinx.util.loggingr rMr"r#SEMANTIC_COLORSr:r<rarerlrrrr TextElementrrQr'r%rs%%""""""$$$$$$++++++%%%%%% 000000)))))) 8    *>*>*>*>Z("("("("("/("("("Z  %'       AAAA 4WWWW    U.r'