U \Sh ;@sdZddlmZddlZddlZddlZddlZddlZddlm Z ddlm Z ddl m Z ddl mZddlmZddlZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZddlmZm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'm(Z(ddl)m*Z*ddl+m,Z,e-e.Z/e 0eddZ1dZ2GdddeZ3GdddeZ4dZ5e6dZ7e6dZ8e6dZ9d d!d"d#d$Z:d d%d&d'd(d)Z;d[d d d+d d d,d-d.Zd6d d7d8d9d:Z?d d/d d!d;dd?ZAd@d dAdBdCdDZBd d d dEdFdGZCdHdId&dJdKdLZDd@dMd dNdOdPZEd@dQd&dNdRdSZFd@dTd&dNdUdVZGdHdWdXdYdZZHdS)\z*Render math in HTML via dvipng or dvisvgm.) annotationsN)path)CalledProcessError)Any)nodes)Element) package_dir)Sphinx)Builder)Config) SphinxError)___)loggingsha1)get_node_equation_numberwrap_displaymath) ensuredir)read_png_depthwrite_png_depth) LaTeXRenderer)HTML5TranslatorZ templatesimgmathcs.eZdZdZd dddddfdd ZZS) MathExtErrorzMath extension errorNstrz str | NoneNone)msgstderrstdoutreturncs0|r|d|7}|r |d|7}t|dS)Nz [stderr] z [stdout] )super__init__)selfrrr __class__rE/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/ext/imgmath.pyr")s   zMathExtError.__init__)NN)__name__ __module__ __qualname__categoryr" __classcell__rrr$r&r&src@seZdZdZdS) InvokeErrorzerrors on invoking converters.N)r'r(r)__doc__rrrr&r,3sr,)pngsvgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptzrz int | None)filenamer c CsXt|ddB}|D]}qt|}|r@t|dW5QRSW5QRdSQRXdS)z9Read the depth from comment at last line of SVG file utf-8encodingN)opendepthsvgcomment_rematchintgroup)r0flinematchedrrr&read_svg_depth>s r=r8r)r0depthr c Cs,t|ddd}|d|W5QRXdS)zN)r5write)r0r>r:rrr&write_svg_depthKsrAr ) image_formatmathconfigconfdirr cCs|jtt|jd|j|dkr$dnd|d}|jr:d}nd}|jD].}t|||}t|rDt ||SqDt t ||S)zGenerate LaTeX macro.g333333?r.rBz,dvips,tightpage)ZfontsizeZ baselineskippreambleZ tightpagerDz preview.tex_tztemplate.tex_t) imgmath_font_sizer8roundimgmath_latex_preambleimgmath_use_previewtemplates_pathrjoinexistsrrender)rCrDrErF variablesZ template_nameZ template_dirtemplaterrr&generate_latex_macroRs   rRr )builderr cCst|dst|_|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)hasattrtempfilemkdtemprT)rSrrr&ensure_tempdirns  rX)latexrSr c Cs,t|}t|d}t|ddd}||W5QRXt|jj}|jjg}|dkrb|d| |jj |dzr;r<rrr&convert_dvi_to_pngs      rzc Csd}|jjd|g}||jj||t||\}}d}|jjr|D]:}t |} | rLt t | ddd}t ||qqL|S)zConvert DVI file to SVG image.dvisvgmrtNr4dgzGR@)rEimgmath_dvisvgmrcimgmath_dvisvgm_argsrbrprKrw depthsvg_rer7rIfloatr9rAryrrr&convert_dvi_to_svgs    rrztuple[str | None, int | None])r#rDr cCsT|jjj}|tkrtdt|||jj|jj}t|  d|}t |jj |jjd|}tt |t |r|dkrt|}n|dkrt|}||fSt|jdst|jdrdSzt||j}Wntk rd |j_YdSXz6|dkrt||j|}n|dkr(t||j|}Wn tk rJd |j_YdSX||fS) 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".rDr.r/_imgmath_warned_latex _imgmath_warned_image_translator)NNT)rSrEimgmath_image_formatlowerSUPPORT_FORMATrrRrFrencode hexdigestrrMoutdirimagedirrdirnameisfilerr=rUrmr,rrzrr)r#rDrCrYr0generated_pathr>rqrrr& render_mathsF      r)rCrr c Cs\t|d}t|jdd}W5QRX|dkr>d|S|dkrPd|StddS) Nrbr1r2r.zdata:image/png;base64,r/zdata:image/svg+xml;base64,r)r5base64 b64encodereaddecoder)rCrr:encodedrrr&render_maths_to_base64s    rr Exception)apprlr cCs|rdSt|jdr%srD/z)rrrrrsystem_message walkaboutrhrirSkipNodebodyrbrrrSrErrrrrr`rMimgpathreplacesepr) r#r rendered_pathr>rlrsmrCimg_srcbname relative_pathcrrr&html_visit_math8s4      rznodes.math_blockc Cs|dr|}nt|dd}zt||\}}Wnjtk r}zLt|}tj|ddg|d}||t t d||tj |W5d}~XYnX|j |j|ddd |j d |d rt||}|j d |||td |j d|dkr.|j d||nr|jjjrT|jjj} t| |} n*t|} t|jjd| } | tjd} |j d| dt ||dtj dS)NZnowrapFrrrzinline latex %r: %sdivrD)ZCLASSz

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

rz