}c3 dZddlZddlZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZddlZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZddl m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'ddl(m)Z)m*Z*ddl+m,Z,ddl-m.Z.e!j/e0Z1ej2eddZ3GddeZ4GddeZ5dZ6ej7dZ8ej7dZ9ej7dZ:de;de d=d$e;d%e;d&ed'e;de;f d(Z?d)ede;fd*Z@d+e;d)ede;fd,ZAd-e e;d.e;dee;e;ffd/ZBd0e;d)edee;ez*Render math in HTML via dvipng or dvisvgm.N)path)PIPECalledProcessError)AnyDictListTuple)nodes)Element) package_dir)Sphinx)Builder)Config) SphinxError)___)loggingsha1)get_node_equation_numberwrap_displaymath) ensuredir)read_png_depthwrite_png_depth) LaTeXRenderer)HTMLTranslator templatesimgmathc 6eZdZdZddedededdffd ZxZS) MathExtErrorzMath extension errorNmsgstderrstdoutreturncr|r|d|zz }|r|d|zz }t|dS)Nz [stderr] z [stdout] )super__init__)selfr r!r" __class__s 2lib/python3.11/site-packages/sphinx/ext/imgmath.pyr&zMathExtError.__init__%sO  + >F* *C  + >F* *C NN)__name__ __module__ __qualname__categorystrr& __classcell__)r(s@r)rr"sc%HCSDr*rceZdZdZdS) InvokeErrorzerrors on invoking converters.N)r,r-r.__doc__r*r)r3r3-s((((r*r3)pngsvgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptzfilenamer#ct|d5}|D]}t|}|r.t|dcdddS ddddS#1swxYwYdS)z9Read the depth from comment at last line of SVG file utf-8encodingN)opendepthsvgcomment_rematchintgroup)r8flinematcheds r)read_svg_depthrF8s h ) ) )Q  D $**400  )w}}Q''(( sAA0"A00A47A4depthct|dd5}|d|zddddS#1swxYwYdS)zN)r>write)r8rGrCs r)write_svg_depthrKEs hg . . ./! %-...//////////////////s 9== image_formatmathconfigconfdirc|jtt|jdz|j|dkrdnd|d}|jrd}nd}|jD]P}t j|||}t j|r$t ||cSQtt  ||S)zGenerate LaTeX macro.g333333?r6rLz ,tightpage)fontsize baselineskippreamble tightpagerNz preview.tex_tztemplate.tex_t) imgmath_font_sizerAroundimgmath_latex_preambleimgmath_use_previewtemplates_pathrjoinexistsrrender)rMrNrOrP variables template_name template_dirtemplates r)generate_latex_macrorbLs,E&":S"@AABB1'50BRRl I!)' ( -?? 9WlMBB ;x  ? ??))(I>> > > > ?  ( ( / / y I IIr*builderc`t|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)hasattrtempfilemkdtempre)rcs r)ensure_tempdirrids1 7. / /6#+#3#5#5  ##r*latexct|}tj|d}t|dd5}||dddn #1swxYwY|jjdg}||jj| d tj |tt|dd tj|d S#t$r?}tt!d |jjt"|d}~wt$$r!}t'd |j|j|d}~wwxYw) z%Compile LaTeX macros for math to DVI.zmath.texwr:r;Nz--interaction=nonstopmodeTascii)r"r!cwdcheckr<zmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)rirr[r>rJrO imgmath_latexextendimgmath_latex_argsappend subprocessrunrOSErrorloggerwarningrr3rrr!r")rjrctempdirr8rCcommandexcs r) compile_mathr|qsW%%Gy*--H hg . . .!  ~+-HIG NN7>4555 NN: WwtDgT ' ) ) ) )y*--- ###rFGG~3 5 5 5s" WWW4cj#*MMSVVWs5AA A'8C E*:D$$ E1E  ErznamecR tj|ttdd}|j|jfS#t $r=}t td||d|t|d}~wt$r$}td|z|j|j|d}~wwxYw)z*Convert DVI file to specific image format.Trm)r"r!ror<zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingrNz%s exited with error) rtrurr"r!rvrwrxrr3rr)rzr}retr{s r)convert_dvi_to_imagers [nWT$dU\]]]z3:%% ###rCDDWQZ / / /s" [[[1D8#*cjQQWZZ[s 03 B&8A55 B&B!!B&dvipathc4t|}tj|d}d}|jjd|dddg}||jj|jjr|d||t||\}}d}|jjrg| D]R} t | } | r4t| d }t||nS||fS) zConvert DVI file to PNG image.zmath.pngdvipng-oz-Ttightz-z9z--depthNr=)rirr[rOimgmath_dvipngrqimgmath_dvipng_argsrYrsr splitlinesdepth_rer@rArBr rrcryr8r}rzr"r!rGrDrEs r)convert_dvi_to_pngrsW%%Gy*--H D~,dHdGUSG NN7>5666~)"y!!! NN7)'488NFF E~)%%''  DnnT**G GMM!,,--%000  U?r*ct|}tj|d}d}|jjd|g}||jj||t||\}}d}|jj rz| D]e} t | } | rGtt| ddzdz }t!||nf||fS)zConvert DVI file to SVG image.zmath.svgdvisvgmrNr=dgzGR@)rirr[rOimgmath_dvisvgmrqimgmath_dvisvgm_argsrsrrYr depthsvg_rer@rWfloatrBrKrs r)convert_dvi_to_svgrs W%%Gy*--H D~-tX>G NN7>6777 NN7)'488NFF E~)%%''  D!''--G eGMM!$4$455;eCDD%000  U?r*r'c<|jjj}|tvrt dt |||jj|jj}t|  d|}tj |jj d|}tj |jj|jjd|}tj|r/|dkrt%|}n|dkrt'|}||fSt)|jdst)|jdrdS t+||j}n#t,$rd |j_YdSwxYw |dkrt1||j\} }n|dkrt3||j\} }n#t,$rd |j_YdSwxYwt7tj|t;j| |||fS) aRender the LaTeX math expression *math* using latex and dvipng or dvisvgm. Return the filename relative to the built document 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. z2imgmath_image_format must be either "png" or "svg".rNr6r7_imgmath_warned_latex _imgmath_warned_image_translatorr+T)rcrOimgmath_image_formatlowerSUPPORT_FORMATrrbrPrencode hexdigest posixpathr[imgpathroutdirimagedirisfilerrFrfr|r3rrrrrdirnameshutilmove) r'rNrMrjr8relfnoutfnrGrrs r) render_mathrs<<&;AACCL>)QOPPP !%!%!4!%!5 7 7E u||~~..88::::LLIH N4</ B BE Idl)4<+@&( S SE {5 5  *"5))EE U " *"5))Ee|t|455t|?@@zudl33 -1 *zz  5  G/FFNGUU U " G/FFNGU 8< 5zz dl5!!""" K %<s$E++FF =GG! G!appr{c|rdSt|jdsdS tj|jjdS#t $rYdSwxYw)Nre)rfrcrrmtree_mathpng_tempdir Exception)rr{s r)cleanup_tempdirr sk  3; 2 3 3  ck233333      s= A  A nodec|jjjrd|zt||z}| |d| zz }|j |d ztj ) N$WARNINGtypelevelbackrefssourcezdisplay latex %r: %sz%sz)rrrr0r system_message walkaboutrwrxrSkipNodebodyrsrrr)r'rfnamerGr{r smcs r)html_visit_mathrss&"4t{{}})numberz(%s)zPermalink to this equationzz'%s

z

)rrrrr0r rrrwrxrrrrsstarttagradd_permalink_refrrrr) r'rrjrrGr{r rrs r)html_visit_displaymathr2s* H~=  e<<&"4// uu &&&#hh  !#IQ+-dkkmmEEE Tr/00$++--EEEn#% & IT]]4f]==>>>IU H~$)$55 2V;<<< tQ'C%D%DEEE ### + CT[[]]3399;;< = = = = /E1[t5L5LL)* + + + .sA C< BC77C<c|dtdftdf|ddd|ddd|ddd|d d d|d d d|d gdd|ddgd|dgd|ddd|ddd|ddd|dt t jddS)Nrrr6htmlrrrrrprjrYFr)z-gammaz1.5z-D110z-bg Transparentrz --no-fontsrrrXrLrTrV zbuild-finished)versionparallel_read_safe)add_html_math_rendererrradd_config_valueconnectrsphinx__display_version__)rs r)setuprQsxy /6 6=???/???)8V<<<*Iv>>>'6:::.v>>>.MMM!!!/,HHH-r6:::12v>>>/v>>>,b&999KK /2221 N NNr*)rL)Nr4rrerrtrgosrrrtypingrrrr docutilsr docutils.nodesr rr sphinx.applicationr sphinx.buildersr sphinx.configr sphinx.errorsr sphinx.localerr sphinx.utilrrsphinx.util.mathrrsphinx.util.osutilrsphinx.util.pngrrsphinx.util.templatersphinx.writers.htmlr getLoggerr,rwr[rZrr3rcompilerrr?r0rArFrKrbrir|rrrrrrrrNr math_blockrrr5r*r)rs00 ////////))))))))))))"""""" %%%%%%###### %%%%%%%%%%%%%%GGGGGGGG((((((;;;;;;;;............  8 $ $; Y??;)))))+)))  2:. / /bj,-- RZ 9:: S S    /c/#/$////DFJJsJ"J,2J=@JJMJJJJ0 $G $ $ $ $ $WWgW#WWWW8 [$s) [3 [5c? [ [ [ [g%S/4g%S/0;n;C;E#s(O;;;;|  i D    nG . t,u7GD>OvO$sCx.OOOOOOr*