File: //usr/lib/python3/dist-packages/sphinx/ext/__pycache__/imgmath.cpython-310.pyc
o
�W�a
4 � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlmZm Z ddl
m Z m Z m
Z
mZ ddlmZ ddlmZ ddlZddlmZ dd lmZ dd
lmZ dd lmZ dd lm Z dd
l m Z m Z ddl m!Z!m"Z" ddl#m$Z$m%Z% ddl&m'Z' ddl(m)Z)m*Z* ddl+m,Z, ddl-m.Z. e!�/e0�Z1e�2edd�Z3G dd� de �Z4G dd� de �Z5dZ6e�7d�Z8e�7d �Z9e�7d �Z:d e;d e<fd d!�Z=d e;d"e<d dfd#d$�Z> %dKd&e;d'e;d(ed)e;d e;f
d*d+�Z?d,ed e;fd-d.�Z@d/e;d,ed e;fd0d1�ZAd2e
e; d3e;d ee;e;f fd4d5�ZBd6e;d,ed ee;e<f fd7d8�ZCd6e;d,ed ee;e<f fd9d:�ZDd;e.d'e;d ee;e<f fd<d=�ZEd>ed?eFd dfd@dA�ZGd;e.dBed e;fdCdD�ZHd;e.dBejId dfdEdF�ZJd;e.dBejKd dfdGdH�ZLd>ed e e;e f fdIdJ�ZMdS )Lz�
sphinx.ext.imgmath
~~~~~~~~~~~~~~~~~~
Render math in HTML via dvipng or dvisvgm.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�PIPE�CalledProcessError)�Any�Dict�List�Tuple)�nodes)�Element)� package_dir)�Sphinx)�Builder)�Config)� SphinxError)�_�__)�logging�sha1)�get_node_equation_number�wrap_displaymath)� ensuredir)�read_png_depth�write_png_depth)�
LaTeXRenderer)�HTMLTranslator� templates�imgmathc s4 e Zd ZdZd dedededdf� fdd�
Z� ZS )
� MathExtErrorzMath extension errorN�msg�stderr�stdout�returnc s0 |r|d| 7 }|r|d| 7 }t � �|� d S )Nz
[stderr]
z
[stdout]
)�super�__init__)�selfr r r �� __class__� �4/usr/lib/python3/dist-packages/sphinx/ext/imgmath.pyr# - s
zMathExtError.__init__�NN)�__name__�
__module__� __qualname__�category�strr# �
__classcell__r' r' r% r( r * s (r c @ s e Zd ZdZdS )� InvokeErrorz errors on invoking converters.N)r* r+ r, �__doc__r' r' r' r( r0 5 s r0 )�png�svgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptz<!-- DEPTH=(-?\d+) -->�filenamer! c C sd t | ��$}|D ]}qt�|�}|r t|�d��W d � S W d � dS 1 s+w Y dS )z9Read the depth from comment at last line of SVG file
� N)�open�depthsvgcomment_re�match�int�group)r4 �f�line�matchedr' r' r( �read_svg_depth@ s
�$�r> �depthc C s> t | d��}|�d| � W d � dS 1 sw Y dS )z<Write the depth to SVG file as a comment at end of file
�az
<!-- DEPTH=%s -->N)r6 �write)r4 r? r; r' r' r( �write_svg_depthM s "�rB � � image_format�math�config�confdirc C s� |j tt|j d ��|j| dkrdnd|d�}|jr d}nd}|jD ]}t�|||�}t�|�r9t � �
||� S q"t t��
||�S )zGenerate LaTeX macro.g333333�?r2 rC z
,tightpage)�fontsize� baselineskip�preamble� tightpagerE z
preview.tex_tztemplate.tex_t) �imgmath_font_sizer9 �round�imgmath_latex_preamble�imgmath_use_preview�templates_pathr �join�existsr �render)rD rE rF rG � variables�
template_name� template_dir�templater' r' r( �generate_latex_macroT s �
�rX �builderc C s t | d�s
t�� | _| jS )z�Create 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)�hasattr�tempfile�mkdtemprZ )rY r' r' r( �ensure_tempdirl s
r^ �latexc
C s� t |�}t�|d�}t|ddd��
}|�| � W d � n1 s!w Y |jjdg}|�|jj� |� d� zt
j |t t |ddd � t�|d
�W S t
yc } z
t�td �|jj� t|�d}~w tyw } z td |j|j�|�d}~ww )
z%Compile LaTeX macros for math to DVI.zmath.tex�wzutf-8)�encodingNz--interaction=nonstopmodeT�ascii)r r �cwd�checkra zmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)r^ r rQ r6 rA rF �
imgmath_latex�extend�imgmath_latex_args�append�
subprocess�runr �OSError�logger�warningr r0 r r r r )r_ rY �tempdirr4 r; �command�excr' r' r( � compile_mathy s. �
�
����rq ro �namec
C s� zt j| ttddd�}|j|jfW S ty, } zt�td�|| d |� t |�d}~w t
yB } z t d| |j|j�|�d}~ww )z*Convert DVI file to specific image format.Trb )r r rd ra zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingr Nz%s exited with error) ri rj r r r rk rl rm r r0 r r )ro rr �retrp r' r' r( �convert_dvi_to_image� s
����rt �dvipathc C s� t |�}t�|d�}d}|jjd|dddg}|�|jj� |jjr&|�d� |�| � t ||�\}}d}|jjrW|�
� D ]} t � | �}
|
rVt
|
�d ��}t||� ||fS q<||fS )
z Convert DVI file to PNG image.zmath.png�dvipng�-oz-T�tightz-z9z--depthNr5 )r^ r rQ rF �imgmath_dvipngrf �imgmath_dvipng_argsrO rh rt �
splitlines�depth_rer8 r9 r: r � ru rY rn r4 rr ro r r r? r< r= r' r' r( �convert_dvi_to_png� s(
�r~ c C s� t |�}t�|d�}d}|jjd|g}|�|jj� |�| � t||�\}}d}|jj rQ|�
� D ] } t � | �}
|
rPt
t|
�d��d d �}t||� ||fS q0||fS )z Convert DVI file to SVG image.zmath.svg�dvisvgmrw Nr5 �d g�z�GR@)r^ r rQ rF �imgmath_dvisvgmrf �imgmath_dvisvgm_argsrh rt rO r{ � depthsvg_rer8 rM �floatr: rB r} r' r' r( �convert_dvi_to_svg� s$
�r� r$ c
C sp | j jj�� }|tvrtd��t||| j j| j j�}dt|� � ��
� |f }t � | j j
d|�}t� | j j| j jd|�}t�|�rX|dkrLt|�}||fS |dkrTt|�}||fS t| j d�sdt| j d�rfdS zt|| j �}W n ty| d | j _Y dS w z|dkr�t|| j �\} }n |dkr�t|| j �\} }W n ty� d | j _Y dS w tt� |�� t � | |� ||fS )
a� Render 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"z%s.%srE r2 r3 �_imgmath_warned_latex� _imgmath_warned_image_translatorr) T) rY rF �imgmath_image_format�lower�SUPPORT_FORMATr rX rG r �encode� hexdigest� posixpathrQ �imgpathr �outdir�imagedir�isfiler r> r[ rq r0 r� r~ r� r� r �dirname�shutil�move)
r$ rE rD r_ r4 �relfn�outfnr? ru r� r' r' r( � render_math� sR �
�
� �� � r� �apprp c C sB |rd S t | jd�s d S z
t�| jj� W d S ty Y d S w )NrZ )r[ rY r� �rmtree�_mathpng_tempdir� Exception)r� rp r' r' r( �cleanup_tempdir s �r� �nodec C s$ | j jjrd| �|�� ��� S dS )Nz alt="%s"rC )rY rF �imgmath_add_tooltipsr� �astext�strip)r$ r� r' r' r( � get_tooltip s
r� c
C s� zt | d|�� d �\}}W n0 ty? } z$t|�}tj|ddg |�� d�}|�| � t�t d�|�� |� tj
|�d }~ww |d u rV| j � d| �
|�� ��� � tj
�d| t| |� }|d urj|d| 7 }| j � |d � tj
�)
N�$�WARNING� ��type�level�backrefs�sourcezdisplay latex %r: %sz <span class="math">%s</span>z<img class="math" src="%s"z style="vertical-align: %dpx"z/>)r� r� r r. r �system_message� walkaboutrl rm r �SkipNode�bodyrh r� r� r� )r$ r� �fnamer? rp r �sm�cr' r' r( �html_visit_math$ s,
�
����r� c
C sH |d r |� � }nt|� � d d�}z t| |�\}}W n0 tyJ } z$t|�}tj|ddg |� � d�}|�| � t� t
d�|� � |� tj |�d }~ww | j �
| j|ddd �� | j �
d
� |d r|t| |�}| j �
d | � | �|td
�� | j �
d� |d u r�| j �
d| �|� � ��� � tj �| j �
d| t| |� d � tj �)N�nowrapFr� r� r� zinline latex %r: %s�divrE )�CLASSz<p>�numberz<span class="eqno">(%s)zPermalink to this equationz</span>z'<span class="math">%s</span></p>
</div>z
<img src="%s"z
/></p>
</div>)r� r r� r r. r r� r� rl rm r r� r� rh �starttagr �add_permalink_refr r� r� r� ) r$ r� r_ r� r? rp r r� r� r' r' r( �html_visit_displaymath: s>
�
��
���r� c C s� | � dtd ftd f� | �ddd� | �ddd� | �ddd� | �d d
d� | �d d d� | �d
g d�d� | �ddgd� | �dg d� | �ddd� | �ddd� | �ddd� | �dt� tjdd�S )Nr r� r2 �htmlry rv r� r re r_ rO Frz )z-gammaz1.5z-D�110z-bg� Transparentr� z
--no-fontsrg rN rC r� TrL � zbuild-finished)�version�parallel_read_safe)�add_html_math_rendererr� r� �add_config_value�connectr� �sphinx�__display_version__)r� r' r' r( �setupY s( �� r� )rC )Nr1 r� �rer� ri r\ �osr r r �typingr r r r �docutilsr �docutils.nodesr
r� r �sphinx.applicationr �sphinx.buildersr
�
sphinx.configr �
sphinx.errorsr �
sphinx.localer r � sphinx.utilr r �sphinx.util.mathr r �sphinx.util.osutilr �sphinx.util.pngr r �sphinx.util.templater �sphinx.writers.htmlr � getLoggerr* rl rQ rP r r0 r� �compiler| r� r7 r. r9 r> rB rX r^ rq rt r~ r� r� r� r� r� rE r� �
math_blockr� r� r' r' r' r( �<module> sn
����
�
" >