o Ni<@s@dZddlmZdZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZdd lmZddlZdd lmZdd lmZdd lmZmZdd lmZddlmZmZddlm Z ddl!m"Z"m#Z#ddl$m%Z%erddl Z ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1e2e3Z4e 5eddZ6GdddeZ7GdddeZ8dZ9e:dZ;e:d Zded+d,Z? -dfdgd4d5Z@dhd8d9ZAdid;d<ZBdjdAdBZCdkdEdFZDdkdGdHZEdldLdMZFdmdOdPZGdndUdVZHdodYdZZIdpd\d]ZJdqd_d`ZKdrdbdcZLdS)sz*Render math in HTML via dvipng or dvisvgm.) annotationsN)sha1)path)CalledProcessError) TYPE_CHECKING)nodes) package_dir) SphinxError)___)logging)get_node_equation_numberwrap_displaymath) ensuredir)read_png_depthwrite_png_depth) LaTeXRenderer)Element)Sphinx)Builder)Config)ExtensionMetadata)HTML5Translator templatesimgmathcs&eZdZdZ d d fd d ZZS) MathExtErrorzMath extension errorNmsgstrstderr str | NonestdoutreturnNonecs0|r|d|7}|r|d|7}t|dS)Nz [stderr] z [stdout] )super__init__)selfrrr! __class__rF/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/ext/imgmath.pyr%1s   zMathExtError.__init__NN)rrrr r!r r"r#)__name__ __module__ __qualname__categoryr% __classcell__rrr'r)r.src@seZdZdZdS) InvokeErrorzerrors on invoking converters.N)r+r,r-__doc__rrrr)r0;sr0)pngsvgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptzfilenamerr" int | NonecCsht|dd$}|D]}q t|}|r!t|dWdS WddS1s-wYdS)z9Read the depth from comment at last line of SVG file utf-8encodingN)opendepthsvgcomment_rematchintgroup)r4flinematchedrrr)read_svg_depthFs  $rBdepthr=r#cCsBt|ddd}|d|WddS1swYdS)zN)r:write)r4rCr?rrr)write_svg_depthSs"rF image_formatmathconfigrconfdirstr | os.PathLike[str]c Cs|jtt|jd|j|dkrdnd|d}|jrd}nd}|jD] }dD]}t||||}t|rAt ||Sq&q"t t |d |S) zGenerate LaTeX macro.g333333?r2rGz,dvips,tightpage)fontsize baselineskippreamble tightpagerIz preview.texz template.tex).jinja_trQ) imgmath_font_sizer=roundimgmath_latex_preambleimgmath_use_previewtemplates_pathrjoinexistsrrender) rHrIrJrK variables template_name template_dirtemplate_suffixtemplaterrr)generate_latex_macroZs"   r`builderrcCst|ds t|_|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)hasattrtempfilemkdtemprb)rarrr)ensure_tempdirws  rflatexc Cs&t|}t|d}t|ddd }||Wdn1s!wYt|jj}|jjg}|dkr;|d| |jj |dzt j |d|dd d |d vr]t|d WSt|d WSt y|}z ttd|jjt|d}~wty}z d}t||j|j|d}~ww)z%Compile LaTeX macros for math to DVI.zmath.texwr6r7Ntectonicz--interaction=nonstopmodeTascii)capture_outputcwdcheckr8>xelatexrizmath.xdvzmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)rfrrXr:rEbasenamerJ imgmath_latexappendextendimgmath_latex_args subprocessrunOSErrorloggerwarningr r0rrrr!) rgratempdirr4r?imgmath_latex_namecommandexcrrrr) compile_maths:       r}r{ list[str]nametuple[str, str]c Csztj|dddd}|j|jfWSty+}zttd||d|t|d}~wt yA}z t d||j|j|d}~ww)z*Convert DVI file to specific image format.Trj)rkrmr8zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingrNz%s exited with error) rtrur!rrvrwrxr r0rr)r{rretr|rrr)convert_dvi_to_images  rdvipathout_pathc Csd}|jjd|dddg}||jj|jjr|d||t||\}}d}|jjrK|D]}t |} | rJt | d}t |||Sq2|S) zConvert DVI file to PNG image.dvipng-oz-Ttightz-z9z--depthNr9) rJimgmath_dvipngrrimgmath_dvipng_argsrVrqr splitlinesdepth_rer<r=r>r rrarrr{r!rrCr@rArrr)convert_dvi_to_pngs$     rc Csd}|jjd|g}||jj||t||\}}d}|jjrE|D]}t |} | rDt t | ddd}t |||Sq&|S)zConvert DVI file to SVG image.dvisvgmrNr9dgzGR@)rJimgmath_dvisvgmrrimgmath_dvisvgm_argsrqrrVr depthsvg_rer<rTfloatr>rFrrrr)convert_dvi_to_svgs     rr&rtuple[str | None, int | None]c Csj|jjj}|tvrd}t|t|||jj|jj}t| dd d|}t |jj |jjd|}tt |t |r[|dkrOt|}||fS|dkrWt|}||fSt|jdsgt|jd rid Szt||j}Wntyd |j_Yd Swz&|dkrt||j|}n|dkrt||j|}W||fSW||fSW||fStyd |j_Yd Sw) 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.rIr2r3_imgmath_warned_latex _imgmath_warned_image_translatorr*T)rarJimgmath_image_formatlowerSUPPORT_FORMATrr`rKrencode hexdigestrrXoutdirimagedirrdirnameisfilerrBrcr}r0rrrr) r&rIrHunsupported_format_msgrgr4generated_pathrCrrrr) render_mathsV     rrcCspt|d}t|jdd}Wdn1swY|dkr)d|S|dkr2d|Sd}t|) Nrbr6r7r2zdata:image/png;base64,r3zdata:image/svg+xml;base64,r)r:base64 b64encodereaddecoder)rHrr?encodedrrrr)render_maths_to_base64 s   rapprr| ExceptioncCs|rdSt|jdr&ttt|jjWdn1s!wY|jjj rQtttt |jj |jj dWddS1sJwYdSdS)NrbrI)rcra contextlibsuppressrshutilrmtreerbrJ imgmath_embedrrXrr)rr|rrr)clean_up_files+s    "rnodercCs$|jjjrd||SdS)Nz alt="%s"rG)rarJimgmath_add_tooltipsrastextstrip)r&rrrr) get_tooltip:s r nodes.mathc CsBzt|d|d\}}Wn0ty?}z$t|}tj|ddg|d}||tt d||tj |d}~ww|durV|j d| |tj |jjjrh|jjj}t||}nt|} t|jjd| } | tjd}d |d t||} |dur| d | d d 7} |j | dtj )N$WARNINGtypelevelbackrefssourcezdisplay latex %r: %sz%srI/z)rrrrrsystem_message walkaboutrwrxr SkipNodebodyrqrrrarJrrrrrrorXimgpathreplacesepr) r&r rendered_pathrCr|rsmrHimg_srcbname relative_pathcrrr)html_visit_math@s8     rnodes.math_blockc Cs|dr |}nt|dd}z t||\}}Wn0tyJ}z$t|}tj|ddg|d}||t t d||tj |d}~ww|j |j|ddd |j d |d r|t||}|j d |||td |j d|dur|j d||tj |jjjr|jjj} t| |} nt|} t|jjd| } | tjd} |j d| dt ||dtj )NnowrapFrrrzinline latex %r: %sdivrI)CLASSz

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

rz sn                          $    >   '