-Ph> d Z ddlmZ dZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl m
Z
ddlmZ ddl
mZ ddlmZ dd lmZ ddlZdd
lmZ dd lmZ dd lmZmZ dd
l m Z ddl m Z m Z ddl!m"Z"m#Z# ddl$m%Z% er*ddl&m'Z' ddl(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/ ddl0m1Z1 ddl2m3Z3 e j4 e5 Z6 ej7 dd Z8 G d de Z9 G d d e Z:d Z; ej< d Z= ej< d Z> ej< d! Z?dVd&Z@dWd+ZAdXd3ZBdYd6ZCdZd8ZDd[d=ZEd\d@ZFd\dAZGd]dEZHd^dGZId_dLZJd`dOZKdadQZLdbdSZMdcdUZNdS )dz*Render math in HTML via dvipng or dvisvgm. ) annotations N)sha1)Path)CalledProcessError)
TYPE_CHECKING)nodes) package_dir) SphinxError)___)logging)get_node_equation_numberwrap_displaymath)read_png_depthwrite_png_depth)
LaTeXRenderer)Element)Sphinx)Builder)Config)_StrPath)ExtensionMetadata)HTML5Translator templatesimgmathc ( e Zd ZdZ d d fd
Z xZS )
MathExtErrorzMath extension errorNmsgstrstderr
str | NonestdoutreturnNonec r |r|d|z z
}|r|d|z z
}t | d S )Nz
[stderr]
z
[stdout]
)super__init__)selfr r! r# __class__s R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/ext/imgmath.pyr( zMathExtError.__init__1 sQ + >F* *C + >F* *C
NN)r r r! r" r# r" r$ r% )__name__
__module__ __qualname__categoryr(
__classcell__)r* s @r+ r r . sN %H IM r, r c e Zd ZdZdS ) InvokeErrorz errors on invoking converters.N)r. r/ r0 __doc__r r, r+ r4 r4 ; s ((((r, r4 )pngsvgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptzfilenamestr | os.PathLike[str]r$
int | Nonec t | d 5 }|D ]}t | }|r.t | d cddd S ddd dS # 1 swxY w Y dS )z4Read the depth from comment at last line of SVG fileutf-8encoding N)opendepthsvgcomment_rematchintgroup)r8 flinematcheds r+ read_svg_depthrH F s
h ) ) ) Q D $**400 )w}}Q''((
s AA0"A00A47A4r depthrC r% c t | dd 5 }| d|z ddd dS # 1 swxY w Y dS )z7Write the depth to SVG file as a comment at end of filear< r= z
N)r@ write)r8 rI rE s r+ write_svg_depthrM R s
hg . . . /! %-.../ / / / / / / / / / / / / / / / / /s
9= = image_formatr mathconfigr confdirr c x |j t |j dz |j | dk rdnd|d}|j rd}nd}|j D ]L}dD ]G}||z ||z z }| r&t
|| c c S HMt
t g |d z | S )
zGenerate LaTeX macro.g333333?r6 z,dvips,tightpage)fontsize baselineskippreamble tightpagerO z preview.texz template.tex).jinja_trX )imgmath_font_sizeroundimgmath_latex_preambleimgmath_use_previewtemplates_pathexistsr render) rN rO rP rQ variables
template_name template_dirtemplate_suffixtemplates r+ generate_latex_macrorf X s , f 6 <==1 (500RR6H I ! '%
&
- C C / C CO - 1PQH
C$--h BBBBBBB
C C
.) * * 1 1-(2JI V VVr, builderr c z t | d s%t t j | _ | j S )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)hasattrr tempfilemkdtempri )rg s r+ ensure_tempdirrm w s9 7 . / / <#'(8(:(:#;#; ##r, latexc t | }|dz }t |dd 5 }| | ddd n # 1 swxY w Y t j |j j }|j j g}|dk r| d | |j j
| d t j |d|dd
|d v r|d z S |d
z S # t $ r?}t t! d |j j t" |d}~wt$ $ r#}d}t' ||j |j |d}~ww xY w)z%Compile LaTeX macros for math to DVI.zmath.texwr< r= Ntectonicz--interaction=nonstopmodeTascii)capture_outputcwdcheckr> > xelatexrq zmath.xdvzmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)rm r@ rL ospathbasenamerP
imgmath_latexappendextendimgmath_latex_args
subprocessrunOSErrorloggerwarningr
r4 r r r! r# ) rn rg tempdirr8 rE imgmath_latex_namecommandexcr s r+ compile_mathr s W%%G#H
hg . . . ! ))'.*FGG
~+,GZ''2333 NN7>4555 NN: A DgTG
!8 8 8Z' 'Z' ' # # # <
N (
s" A A A'3
CJ77S@As; A A
A
!D <D
E5 :E
E5 E00E5r list[str]nametuple[str, str]c @ t j | ddd }|j |j fS # t $ r=}t
t d || d | t |d}~wt $ r&}| d}t ||j |j |d}~ww xY w)z*Convert DVI file to specific image format.Trr )rs ru r> zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingr Nz exited with error) r~ r r# r! r r r r
r4 r r )r r retr r s r+ convert_dvi_to_imager s AnWTPWXXXz3:%%
#
#
# 9
AJ
s" A A A)))3
CJ77S@As %(
B 8A**
B 7!BB dvipathout_pathc d}|j j d|dddg}| |j j |j j r| d | | t
|| \ }}d}|j j rg| D ]R}t | } | r4t | d }t || nS|S ) z Convert DVI file to PNG image.dvipng-oz-Ttightz-z9z--depthNr? )
rP imgmath_dvipngr| imgmath_dvipng_argsr] r{ r
splitlinesdepth_rerB rC rD r
r rg r r r r# r! rI rF rG s
r+ convert_dvi_to_pngr s D~,dHdGUSG NN7>5666~) "y!!! NN7)'488NFF E~) %%'' D nnT**G
GMM! , ,-- %000
Lr, c d}|j j d|g}| |j j | | t || \ }}d}|j j rz| D ]e}t | } | rGt t | d dz dz }t || nf|S )z Convert DVI file to SVG image.dvisvgmr Nr? d gzGR@)rP imgmath_dvisvgmr| imgmath_dvisvgm_argsr{ r r] r depthsvg_rerB r[ floatrD rM r s
r+ convert_dvi_to_svgr s D~-tX>G NN7>6777 NN7)'488NFF E~) %%'' D!''--G
eGMM!$4$4 5 5 ;e CDD %000
Lr, r) r "tuple[_StrPath | None, int | None]c | j j j }|t vrd}t | t
||| j j | j j }t | d
d| }| j j | j j z dz |z }|j
dd | r/|dk rt! | }n|d k rt# | }||fS t% | j d
}t% | j d } |s| rd S t' || j }
n # t( $ r d| j _ Y d S w xY w |dk rt- |
| j | }n |d k rt/ |
| j | }n # t( $ r d| j _ Y d S w xY w||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"F)usedforsecurity.rO T)parentsexist_okr6 r7 _imgmath_warned_latex _imgmath_warned_image_translatorr- )rg rP imgmath_image_formatlowerSUPPORT_FORMATr rf rQ r encode hexdigestoutdirimagedirparentmkdiris_filer rH rj r r4 r r r r ) r) rO rN unsupported_format_msgrn r8 generated_pathrI latex_failed trans_failedr s r+ render_mathr s " <&;AACCL>))!U 1222 dDL / 1E
E
6 6 6 @ @ B BSS\SS
\(4<+@@6IHTN t <<< % 5 ">22EE
U
"
"">22E u$$ 4<)@AAL4<)KLLL | z udl33 -1 *zz
5 &w nMMEE
U
"
"&w nMME 8< 5zz 5 s$
E# #E=<E=9F; ;GGr c t |d 5 }| }d d d n # 1 swxY w Y t j | d }| dk rd| S | dk rd| S d}t | ) Nrbr< r= r6 zdata:image/png;base64,r7 zdata:image/svg+xml;base64,r )r@ readbase64 b64encodedecoder )rN r rE contentencodedr s r+ render_maths_to_base64r . s
nd # # q&&(( w''...@@Gu 1111u 5G555 Q
-
.
..s 266appr r Exceptionc |rd S t | j d rOt j t 5 t j | j j d d d n # 1 swxY w Y | j j j rbt j t 5 t j | j j
| j j z dz d d d d S # 1 swxY w Y d S d S )Nri rO ) rj rg
contextlibsuppressr shutilrmtreeri rP
imgmath_embedr r )r r s r+ clean_up_filesr : sm
s{ .// 8
+
+ 8 8 M#+6 7 7 7 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 {' N
+
+ N N M#+,s{/CCfL M M M N N N N N N N N N N N N N N N N N NN Ns# A A"%A"/CCCnoder c | j j j r=d| | dS dS )Nz alt=""rS )rg rP imgmath_add_tooltipsr astextstrip)r) r s r+ get_tooltipr I sH |/ >= DKKMM2288::====
2r,
nodes.mathc t | d| z dz \ }}n# t $ r}t | }t j |ddg | }| | t t d | | t j
|d }~ww xY w|V| j d|
| d n| j j j r4| j j j }t) || }nNt* j | } t1 | j j d| }
|
}|d | d
d nd } | j d
| dt7 | | | d t j
)N$WARNING typelevelbackrefssourcezdisplay latex %r: %srO z style="vertical-align: dzpx"rS z r r r r r system_message walkaboutr r r
SkipNodebodyr{ r r rg rP r r r r rw rx ry r imgpathas_posixr ) r) r
rendered_pathrI r r smrN img_srcbname
relative_pathaligns r+ html_visit_mathr O s & *4t{{}}1Ds1J K K
uu & & &#hh
! iq2dkkmm
Tr0114;;==#FFFn#%& M$++dkkmm)
numberz(%s)zLink to this equationr r z
z
)
>>IU H~ $)$55 2V;<<< tQ'>%?%?@@@ ### Y$++dkkmm"<"<"B"B"D"D Y Y Y
< , / <.CIIKKL,\=IIGGG$$]33E !5vu E EM#,,..G WgWW D$0G0GWWWXXX
.s $A8 8
D BDD r c | dt d ft d f | dddt t
h | dddt t
h | d d
dt t
h | d d dt t
h | d
ddt t h | dg ddt t h | ddgdt t t h | dg dt t t h | dddt t
h | dddt t h | dddt t h | dddt t h |
dt t j
dd S ) Nr )inline_renderersblock_renderersr r6 html)typesr r r r rz rn r] Fr )z-gammaz1.5z-D110z-bg Transparentr z
--no-fontsr} r\ rS r TrZ r zbuild-finished)versionparallel_read_safe)add_html_math_rendererr r add_config_value frozensetr boollisttuplerC connectr sphinx__display_version__)r s r+ setupr
sr )40/6 /iQTPUFVFVWWW)8V9cUCSCSTTT*IvYPSuEUEUVVV '6C5AQAQRRR.vYPTvEVEVWWW <<< iu
>V>V b& 4-0H0H 12vYPSuEUEUVVV/vYPTvEVEVWWW,b& 3%@P@PQQQ %y$?P?PQQQKK .111- " r, )r8 r9 r$ r: )r8 r rI rC r$ r% )
rN r rO r rP r rQ r r$ r )rg r r$ r )rn r rg r r$ r )r r r r r$ r )r r rg r r r r$ r: )r) r rO r r$ r )rN r r r r$ r )r r r r r$ r% )r) r r r r$ r )r) r r r r$ r% )r) r r r r$ r% )r r r$ r )Or5
__future__r __all__r r rw os.pathrer r~ rk hashlibr pathlibr r typingr docutilsr r r
sphinx.errorsr
sphinx.localer r
sphinx.utilr sphinx.util.mathr r sphinx.util.pngr r sphinx.util.templater docutils.nodesr sphinx.applicationr sphinx.buildersr
sphinx.configr sphinx.util._pathlibr sphinx.util.typingr sphinx.writers.html5r getLoggerr. r joinpathr^ r r4 r compiler r rA rH rM rf rm r r r r r r r r r r r
r r, r+ r# s 0 0 " " " " " "
) ) ) ) ) )
% % % % % % G G G G G G G G ; ; ; ; ; ; ; ; . . . . . . 5&&&&&&))))))''''''$$$$$$------444444444444 8 $ $%%k9==
;
) ) ) ) )+ ) ) ) 2:. / /bj,-- RZ 9:: / / / / W W W W>
$
$
$
$&A &A &A &ARA A A A* . *=! =! =! =!@ / / / / N N N N @% % % %P r,