Fe=<dZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddlm Z ddlmZmZddlmZddlZdd lmZdd lmZdd lmZmZdd lmZdd lmZmZddlm Z ddl!m"Z"m#Z#ddl$m%Z%er"ddl Z ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ej`e1Z2e jfeddZ4dZ5GddeZ6GddeZ7dZ8ejrdZ:ejrdZ;ejrd Z d2 d3d#Z?d4d$Z@d5d%ZAd6d&ZBd7d'ZCd7d(ZD d8d)ZEd9d*ZFd:d+ZGd;d,ZHdd/ZKy)?z*Render math in HTML via dvipng or dvisvgm.) annotationsN)sha1)path)CalledProcessError) TYPE_CHECKINGAny)nodes) package_dir) SphinxError)___)logging)get_node_equation_numberwrap_displaymath) ensuredir)read_png_depthwrite_png_depth) LaTeXRenderer)Element)Sphinx)Builder)Config)HTML5Translator templatesimgmathc6eZdZdZ d dfd ZxZS) MathExtErrorzMath extension errorcL|r|d|zz }|r|d|zz }t||y)Nz [stderr] z [stdout] )super__init__)selfmsgstderrstdout __class__s 4/usr/lib/python3/dist-packages/sphinx/ext/imgmath.pyr!zMathExtError.__init__0s6  >F* *C  >F* *C NN)r#strr$ str | Noner%r+returnNone)__name__ __module__ __qualname__categoryr! __classcell__)r&s@r'rr-s9%HIM *;E r(rceZdZdZy) InvokeErrorzerrors on invoking converters.N)r.r/r0__doc__rr(r'r4r4:s(r(r4)pngsvgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptzct|d5}|D]}tj}|r#t|j dcdddS dddy#1swYyxYw)z9Read the depth from comment at last line of SVG file utf-8encodingN)opendepthsvgcomment_rematchintgroup)filenameflinematcheds r'read_svg_depthrFEsl h )Q D  %**40 w}}Q'( s8AAA#crt|dd5}|jd|zdddy#1swYyxYw)zN)r=write)rBdepthrCs r'write_svg_depthrKRs9 hg ./! %-.///s-6c|jtt|jdz|j|dk(rdnd|d}|jrd}nd}|j D]J}t j|||}t j|s0tj||cStt j||S)zGenerate LaTeX macro.g333333?r6z,dvips,tightpage)fontsize baselineskippreamble tightpagemathz preview.tex_tztemplate.tex_t) imgmath_font_sizer@roundimgmath_latex_preambleimgmath_use_previewtemplates_pathrjoinexistsrrender) image_formatrRconfigconfdir variables template_name template_dirtemplates r'generate_latex_macrorbYs ,,E&":":S"@AB11(50R6HI!!' ( --? 99WlMB ;;x  ?))(I> >?  ( / / y IIr(cdt|dstj|_|jS)zCreate temporary directory. use only one tempdir per build -- the use of a directory is cleaner than using temporary files, since we can clean up everything at once just removing the whole directory (see cleanup_tempdir) _imgmath_tempdir)hasattrtempfilemkdtemprd)builders r'ensure_tempdirrius, 7. /#+#3#3#5  # ##r(cNt|}tj|d}t|dd5}|j |dddtj |j j}|j jg}|dvr|jd|j|j j|jd tj|d|dd |d vrtj|d Stj|d S#1swYxYw#t$r?}tjt!d|j jt"|d}~wt$$r)}d}t'||j(|j*|d}~wwxYw)z%Compile LaTeX macros for math to DVI.zmath.texwr9r:N)tectonicz--interaction=nonstopmodeTascii)capture_outputcwdcheckr;)xelatexrlzmath.xdvzmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)rirrXr=rIbasenamer\ imgmath_latexappendextendimgmath_latex_args subprocessrunOSErrorloggerwarningr r4rrr$r%) latexrhtempdirrBrCimgmath_latex_namecommandexcr#s r' compile_mathrscW%Gyy*-H hg .! w~~'C'CD ~~++,G-23 NN7>>445 NN:Awt ' ) !8 899Wj1 199Wj1 1+, #rFG~~33 5s" A'3 CJJ7S@As5D 3D, D, D), F$5:E// F$;$FF$c@ tj|ddd}|j|jfS#t$r0}t j td||d|t|d}~wt$r*}td|z|j|j|d}~wwxYw)z*Convert DVI file to specific image format.Trm)rnrpr;zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingrNz%s exited with error) rwrxr%r$ryrzr{r r4rr)rnameretrs r'convert_dvi_to_imagers [nnWTPWXzz3::%% #rCDWQZ /s" [1D8#**cjjQWZZ[s 03 B+A'' B3%BBcd}|jjd|dddg}|j|jj|jjr|j d|j |t ||\}}d}|jjrU|jD]B}tj|} | st| jd}t|||S|S) zConvert DVI file to PNG image.dvipng-oz-Ttightz-z9z--depthNr<) r\imgmath_dvipngruimgmath_dvipng_argsrVrtr splitlinesdepth_rer?r@rAr dvipathrhout_pathrrr%r$rJrDrEs r'convert_dvi_to_pngrs D~~,,dHdGUSG NN7>>556~~))y! NN7)'48NFF E~~))%%' DnnT*GGMM!,-%0 L  Lr(cd}|jjd|g}|j|jj|j |t ||\}}d}|jj rd|jD]Q}tj|} | stt| jddzdz }t|||S|S)zConvert DVI file to SVG image.dvisvgmrNr<dgzGR@)r\imgmath_dvisvgmruimgmath_dvisvgm_argsrtrrVr depthsvg_rer?rTfloatrArKrs r'convert_dvi_to_svgrs D~~--tX>G NN7>>667 NN7)'48NFF E~~))%%' D!''-GeGMM!$45;eCD%0 L  Lr(c |jjjj}|tvr d}t |t |||jj|jj}t|jdjd|}tj|jj|jjd|}ttj |tj"|r(|dk(rt%|}||fS|dk(r t'|}|fSt)|jdst)|jd ry t+||j} |dk(rt1||j|}n|dk(rt3||j|}|fS#t,$rd |j_Yy wxYw#t,$rd |j_Yy wxYw) a{Render the LaTeX math expression *math* using latex and dvipng or dvisvgm. Return the image absolute filename and the "depth", that is, the distance of image bottom and baseline in pixels, if the option to use preview_latex is switched on. Error handling may seem strange, but follows a pattern: if LaTeX or dvipng (dvisvgm) aren't available, only a warning is generated (since that enables people on machines without these programs to at least build the rest of the docs successfully). If the programs are there, however, they may not fail since that indicates a problem in the math source. 2imgmath_image_format must be either "png" or "svg"F)usedforsecurity.rRr6r7_imgmath_warned_latex _imgmath_warned_image_translatorr)T)rhr\imgmath_image_formatlowerSUPPORT_FORMATrrbr]rencode hexdigestrrXoutdirimagedirrdirnameisfilerrFrerr4rrrr) r"rRr[unsupported_format_msgr|rBgenerated_pathrJrs r' render_mathrs"<<&&;;AACL>)!U122 !%!%!4!4!%!5!5 7E u||~u=GGIJ!L>ZHYYt||22DLL4I4I6S[\N dll>*+ {{>" 5 ">2Eu$$U "">2Eu$$t||45t||?@udll3  5 &w nME U "&w nME 5   -1 * 8< 5s$1G9G%G"!G"%HHct|d5}tj|jj d}ddd|dk(rdS|dk(rdSd}t |#1swY*xYw) Nrbr9r:r6zdata:image/png;base64,r7zdata:image/svg+xml;base64,r)r=base64 b64encodereaddecoder)r[rrCencodedrs r'render_maths_to_base64rs nd #Fq""1668,33W3EFu'y11u+G955Q - ..FFs 4A**A3c&|ryt|jdrKtjt5t j |jjddd|jjjrutjt5t j tj|jj|jjddddyy#1swYxYw#1swYyxYw)NrdrR)rerh contextlibsuppress Exceptionshutilrmtreerdr\ imgmath_embedrrXrr)apprs r'clean_up_filesr)s s{{./   + 8 MM#++66 7 8 {{''  + W MM$))CKK$6$6 8L8LfU V W W( 8 8  W Ws*C;AD;DDc|jjjr0d|j|j j zSy)Nz alt="%s"rM)rhr\imgmath_add_tooltipsrastextstrip)r"nodes r' get_tooltipr8s; ||//T[[7==??? r(c : t|d|jzdz\}}|Y|jjd|j|jjztj|jj j"r;|jj j$j'}t)||}n`t+j,|} t+j.|jj0d| } | j3t*j4d}d |d t7||z} | | d | d d z } |jj| dztj#t$r}t|}t j |ddg|j}|j |tjtd|j|tj|d}~wwxYw)N$WARNINGtypelevelbackrefssourcezdisplay latex %r: %sz%srR/z)rrrr*r system_message walkaboutrzr{r SkipNodebodyrtrrrhr\rrrrrrrrXimgpathreplacesepr) r"r rendered_pathrJrr#smr[img_srcbname relative_pathcs r'html_visit_mathr>s&*4t{{}1Ds1JK u 7T[[]399;< = .. <<   , ,<<..CCIIKL,\=IGMM-0E IIdll&:&:FEJM#++DHHc:G%gYa 0;tT3J J   +UF1:S9 9A T" ..1 &#h  ! !#IQ+-dkkmE Tr014;;=#Fnn#% &s#F HBHHc |dr|j}nt|jdd} t||\}}|jj|j|dd |jjd |d r`t||}|jjd |z|j!|t#d |jjd|Y|jjd|j%|jj'zt j|j(j*j,r;|j(j*j.j1} t3| |} n`t5j6|} t5j8|j(j:d| } | j=t4j>d} |jjd| dtA||zdzt j#t$r}t |}t j |ddg|j}|j|tjtd|j|t j|d}~wwxYw)NnowrapFrrrzinline latex %r: %sdivrR)CLASSz

numberz(%s)zLink to this equationzz'%s

rz IIU H~)$5 2V;< tQ'>%?@ # CT[[]399;< = .. <<   , ,<<..CCIIKL,\=IGMM-0E IIdll&:&:FEJM#++DHHc:G :gYa0;tT3JJ)* + ..; &#h  ! !#IQ+-dkkmE Tr/0$++-Enn#% &sI K BKKcl|jdtdftdf|jddd|jddd|jddd|jd d d|jd d d|jd gdd|jddgd|jdgd|jddd|jddd|jddd|jdd dtg|j dt tjddS)Nrrr6htmlrrrrrsr|rVFr)z-gammaz1.5z-D110z-bg Transparentrz --no-fontsrvrUrMrTrS rzbuild-finished)versionparallel_read_safe) add_html_math_rendererrradd_config_valueboolconnectrsphinx__display_version__)rs r'setuprs2y /6 6=?/?)8V<*Iv>'6:.v>.M!/,H-r6:12v>/v>,b&9%$@KK .111 NNr()rBr*r, int | None)rBr*rJr@r,r-)rM) r[r*rRr*r\rr]zstr | os.PathLike[str]r,r*)rhrr,r*)r|r*rhrr,r*)rz list[str]rr*r,ztuple[str, str])rr*rhrrr*r,r)r"rrRr*r,ztuple[str | None, int | None])r[r*rr*r,r*)rrrrr,r-)r"rrrr,r*)r"rrz nodes.mathr,r-)r"rrznodes.math_blockr,r-)rrr,zdict[str, Any])Lr5 __future__rrrrerrwrfhashlibrosrrtypingrrdocutilsr rr sphinx.errorsr sphinx.localer r sphinx.utilrsphinx.util.mathrrsphinx.util.osutilrsphinx.util.pngrrsphinx.util.templaterdocutils.nodesrsphinx.applicationrsphinx.buildersr sphinx.configrsphinx.writers.htmlr getLoggerr.rzrXrW__all__rr4rcompilerrr>rFrKrbrirrrrrrrrrrrrr(r'r sv0"  )% %G(;. &)'$3   8 $; Y?  ; )+)  2::. /bjj,- RZZ 9: /<>J"J!'J#9JCFJ8 $!AH [.*;! ;! ;!#;!|/ W <$NOr(