| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/ext/__pycache__/ |
Upload File : |
a
�ab4 � @ 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:e;e<d �d d �Z=e;e<dd!�d"d#�Z>dFe;e;ee;e;d%�d&d'�Z?ee;d(�d)d*�Z@e;ee;d+�d,d-�ZAe
e; e;ee;e;f d.�d/d0�ZBe;eee;e<f d1�d2d3�ZCe;eee;e<f d1�d4d5�ZDe.e;ee;e<f d6�d7d8�ZEeeFdd9�d:d;�ZGe.ee;d<�d=d>�ZHe.ejIdd<�d?d@�ZJe.ejKdd<�dAdB�ZLee e;e f dC�dDdE�ZMdS )Gz�
sphinx.ext.imgmath
~~~~~~~~~~~~~~~~~~
Render math in HTML via dvipng or dvisvgm.
:copyright: Copyright 2007-2022 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)�HTMLTranslatorZ templates�imgmathc s. e Zd ZdZdeeedd�� 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__� �6/usr/lib/python3.9/site-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' r. 5 s r. )�png�svgz\[\d+ depth=(-?\d+)\]z.*, depth=(.*)ptz<!-- DEPTH=(-?\d+) -->)�filenamer c C sb t | ��F}|D ]}qt�|�}|r>t|�d��W d � S W d � dS 1 sT0 Y dS )z9Read the depth from comment at last line of SVG file
� N)�open�depthsvgcomment_re�match�int�group)r2 �f�line�matchedr& r& r' �read_svg_depth@ s
r< )r2 �depthr c C s< t | d�� }|�d| � W d � n1 s.0 Y dS )z<Write the depth to SVG file as a comment at end of file
�az
<!-- DEPTH=%s -->N)r4 �write)r2 r= r9 r& r& r' �write_svg_depthM s r@ � )� image_format�math�config�confdirr c C s� |j tt|j d ��|j| dkr$dnd|d�}|jr:d}nd}|jD ].}t�|||�}t�|�rDt � �
||� S qDt t��
||�S )zGenerate LaTeX macro.g333333�?r0 rA z
,tightpage)ZfontsizeZ baselineskipZpreambleZ tightpagerC z
preview.tex_tztemplate.tex_t) �imgmath_font_sizer7 �round�imgmath_latex_preamble�imgmath_use_preview�templates_pathr �join�existsr Zrender)rB rC rD rE Z variablesZ
template_nameZ template_dir�templater& r& r' �generate_latex_macroT s �
rN )�builderr c C s t | d�st�� | _| 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�tempfileZmkdtemprP )rO r& r& r' �ensure_tempdirl s
rS )�latexrO r c
C s t |�}t�|d�}t|ddd��}|�| � W d � n1 sB0 Y |jjdg}|�|jj� |� d� z$t
j |t t |ddd � t�|d
�W S t
y� } z&t�td �|jj� t|�W Y d}~n@d}~0 t�y } z td |j|j�|�W Y d}~n
d}~0 0 dS )
z%Compile LaTeX macros for math to DVI.zmath.tex�wzutf-8)�encodingNz--interaction=nonstopmodeT�ascii)r r �cwd�checkrV zmath.dvizYLaTeX command %r cannot be run (needed for math display), check the imgmath_latex settingzlatex exited with error)rS r rK r4 r? rD �
imgmath_latex�extend�imgmath_latex_args�append�
subprocess�runr �OSError�logger�warningr r. r r r r )rT rO �tempdirr2 r9 �command�excr& r& r' � compile_mathy s& (
�
�rf )rd �namer c
C s� z"t j| ttddd�}|j|jfW S tyd } z*t�td�|| d |� t |�W Y d}~nBd}~0 t
y� } z"t d| |j|j�|�W Y d}~n
d}~0 0 dS )z*Convert DVI file to specific image format.TrW )r r rY rV zS%s command %r cannot be run (needed for math display), check the imgmath_%s settingr Nz%s exited with error) r^ r_ r r r r` ra rb r r. r r )rd rg �retre r& r& r' �convert_dvi_to_image� s
�ri )�dvipathrO r c C s� t |�}t�|d�}d}|jjd|dddg}|�|jj� |jjrL|�d� |�| � t ||�\}}d}|jjr�|�
� D ].} t � | �}
|
rxt
|
�d ��}t||� q�qx||fS )
z Convert DVI file to PNG image.zmath.png�dvipng�-oz-TZtightz-z9z--depthNr3 )rS r rK rD �imgmath_dvipngr[ �imgmath_dvipng_argsrI r] ri �
splitlines�depth_rer6 r7 r8 r � rj rO rc r2 rg rd r r r= r: r; r& r& r' �convert_dvi_to_png� s$
rr c C s� t |�}t�|d�}d}|jjd|g}|�|jj� |�| � t||�\}}d}|jj r�|�
� D ]:} t � | �}
|
r`t
t|
�d��d d �}t||� q�q`||fS )z Convert DVI file to SVG image.zmath.svg�dvisvgmrl Nr3 �d g�z�GR@)rS r rK rD �imgmath_dvisvgmr[ �imgmath_dvisvgm_argsr] ri rI ro � depthsvg_rer6 rG �floatr8 r@ rq r& r& r' �convert_dvi_to_svg� s
ry )r# rC r c
C sp | j jj�� }|tvr td��t||| j j| j j�}dt|� � ��
� |f }t � | j j
d|�}t� | j j| j jd|�}t�|�r�|dkr�t|�}n|dkr�t|�}||fS t| j d�s�t| j d�r�dS zt|| j �}W n ty� d | j _Y dS 0 z:|dk�rt|| j �\} }n|dk�r,t|| j �\} }W n t�yL d | j _Y dS 0 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.%srC r0 r1 �_imgmath_warned_latex� _imgmath_warned_image_translator)NNT) rO rD �imgmath_image_format�lower�SUPPORT_FORMATr rN rE r �encodeZ hexdigest� posixpathrK �imgpathr ZoutdirZimagedir�isfiler r< rQ rf r. rz rr ry r{ r �dirname�shutil�move)
r# rC rB rT r2 ZrelfnZoutfnr= rj r� r& r& r' � render_math� sJ �
�
r� )�appre r c C sB |rd S t | jd�sd S zt�| jj� W n ty< Y n0 d S )NrP )rQ rO r� �rmtreeZ_mathpng_tempdir� Exception)r� re r& r& r' �cleanup_tempdir s r� )r# �noder c C s$ | j jjr d| �|�� ��� S dS )Nz alt="%s"rA )rO rD �imgmath_add_tooltipsr �astext�strip)r# r� r& r& r' � get_tooltip s
r� c
C s� z t | d|�� d �\}}W nl ty� } zTt|�}tj|ddg |�� d�}|�| � t�t d�|�� |� tj
|�W Y d }~n
d }~0 0 |d u r�| j � d| �
|�� ��� � n8d| t| |� }|d ur�|d| 7 }| j � |d � tj
�d S )
N�$�WARNING� ��type�levelZbackrefs�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� walkaboutra rb r �SkipNode�bodyr] r r� r� )r# r� �fnamer= re r �sm�cr& r& r' �html_visit_math$ s&
�
�r� c
C sX |d r|� � }nt|� � d d�}zt| |�\}}W nl ty� } zTt|�}tj|ddg |� � d�}|�| � t� t
d�|� � |� tj |�W Y d }~n
d }~0 0 | j �
| j|ddd �� | j �
d
� |d �rt| |�}| j �
d | � | �|td
�� | j �
d� |d u �r0| j �
d| �|� � ��� � n | j �
d| t| |� d � tj �d S )NZnowrapFr� r� r� zinline latex %r: %sZdivrC )ZCLASSz<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� ra rb r r� r� r] Zstarttagr Zadd_permalink_refr r r� r� ) r# r� rT r� r= re r r� r� r& r& r' �html_visit_displaymath: s8
�
��r� )r� 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| r0 Zhtmlrm rk ru rs rZ rT rI Frn )z-gammaz1.5z-DZ110z-bgZ Transparentrv z
--no-fontsr\ rH rA r� TrF � zbuild-finished)�versionZparallel_read_safe)Zadd_html_math_rendererr� r� Zadd_config_valueZconnectr� �sphinxZ__display_version__)r� r& r& r' �setupY s( �� r� )rA )Nr/ r� �rer� r^ rR �osr r r �typingr r r r Zdocutilsr Zdocutils.nodesr
r� r Zsphinx.applicationr Zsphinx.buildersr
Z
sphinx.configr Z
sphinx.errorsr Z
sphinx.localer r Z sphinx.utilr r Zsphinx.util.mathr r Zsphinx.util.osutilr Zsphinx.util.pngr r Zsphinx.util.templater Zsphinx.writers.htmlr Z getLoggerr( ra rK rJ r r. r~ �compilerp rw r5 r, r7 r< r@ rN rS rf ri rr ry r� r� r� r� rC r� Z
math_blockr� r� r& r& r& r' �<module> s`
��
>