eh# d Z ddlmZ ddlmZ ddlmZmZ ddlZddl m
Z
ddl m Z m
Z
ddlZddlmZ ddlZ G d d
ej$ ej& Z G d d e Zd
Zd Zd Zd Zd Zd Zd Z d Z y)a
Add a ``figure-mpl`` directive that is a responsive version of ``figure``.
This implementation is very similar to ``.. figure::``, except it also allows a
``srcset=`` argument to be passed to the image tag, hence allowing responsive
resolution images.
There is no particular reason this could not be used standalone, but is meant
to be used with :doc:`/api/sphinxext_plot_directive_api`.
Note that the directory organization is a bit different than ``.. figure::``.
See the *FigureMpl* documentation below.
)nodes)
directives)FigureImageN)relpath)PurePathPath)ExtensionErrorc e Zd Zy)
figmplnodeN)__name__
__module__ __qualname__ c/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/matplotlib/sphinxext/figmpl_directive.pyr r s r r c e Zd ZdZdZdZdZdZej ej ej ej e
j ej ej ej dZd Zy) FigureMpla
Implements a directive to allow an optional hidpi image.
Meant to be used with the *plot_srcset* configuration option in conf.py,
and gets set in the TEMPLATE of plot_directive.py
e.g.::
.. figure-mpl:: plot_directive/some_plots-1.png
:alt: bar
:srcset: plot_directive/some_plots-1.png,
plot_directive/some_plots-1.2x.png 2.00x
:class: plot-directive
The resulting html (at ``some_plots.html``) is::
Note that the handling of subdirectories is different than that used by the sphinx
figure directive::
.. figure-mpl:: plot_directive/nestedpage/index-1.png
:alt: bar
:srcset: plot_directive/nestedpage/index-1.png
plot_directive/nestedpage/index-1.2x.png 2.00x
:class: plot_directive
The resulting html (at ``nestedpage/index.html``)::
where the subdirectory is included in the image name for uniqueness.
F )altheightwidthscalealignclasscaptionsrcsetc 4 t }| j d }| j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j d d |d < ||d
< | j j d d |d < |gS ) Nr r r r r r r r urir )r argumentsoptionsget)self
image_nodeimagenms r runz
FigureMpl.run\ s \
..# LL , ,UB 7
5 "ll . .w =
7 "ll . .w =
7 "ll . .w =
7 #|| / /$ ?
8 "ll . .w =
7 $ 0 0D A
9 $
5 #|| / /$ ?
8 |r N)r
r r __doc__ has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer unchangedlength_or_unitless length_or_percentage_or_unitlessnonnegative_intr r class_option option_specr( r r r r r " ss (T K % ## //<<++(( '' && K r r c | j d }i }|D ]n }|j j d }t | dk( r |d |d< 9t | dk( r|d dd }|d |t | < at d| d |S )
z
parse srcset...
, r r r Nzsrcset argument "z
" is invalid.)splitstriplenfloatr
)stentriesr entrysplmults r _parse_srcsetNodesrA s s hhsmG
F Kkkm!!#& s8q=AF1I
X]q6#2;D"%a&F5; #4UG=!IJ JK Mr c |d rt |d }nd }t | j d j }| j j
}t
|| j dd j t j d }t | r|dz
}t | j j | j j }t | j dd |rJ|j D ]6 }t || }||j z } t# j$ ||| z 8 n7t ||d }||j z } t# j$ ||| z |||fS ) Nr source.r -T)parentsexist_okr! )rA r documentparentbuildersrcdirr replaceossepr: outdirimagedirr mkdirvaluesnameshutilcopyfile)
r% noder docsourcesrctoprelrP srcabspathrS s
r _copy_images_figmplr\ sD H~#DN3 x0188I \\
F
)V
$
,
,S"
5
=
=bffc
JC
3x s
++T\\-B-BCH N5 ==? 6C y#.G %D OOGX_ 5 6 9d5k2W\\!D 1 VS r c t | | \ }}}t | j d }t | j j d }t || }t | j j d }||z } t t || j j }
| j j dk( rd|
}
t |d dd j } |
d| | } | }
d}|rdd}|j D ]J \ }}t |dd j } |
d| | }||z
}|d k( r|d
z
}n
|d |d d
z
}||kD sG|}|}
L |d d }|d }|d d j |d }d| d}nd}g d}d}|D ] }|| s || d|| dz
} |d r|d nd}d| d| d| d| d | d }d | d }|d |
d z
}|d!| d"z
}|d# r|d$z
}|d%|d# d&z
}|d'z
}|d(z
}| j j | y ))NrC r dirhtmlz..r! r /r7 r z, r6 z1.2fzx, r r zclass="")r r r z: ;r centerz
z
z6 z
z
z
)r\ r rH rJ rK r rO rI as_posixrS itemsjoinbodyappend)r% rV rP r rY rW rX relsourcedesttopdestimagerelnmr! maxsrcsrcsetstmaxmultr@ rZ pathr classststylersstyleststylefigalign img_block
html_blocks r visit_figmpl_htmlry s /d ;Hfc x01I dll))2
.F 6*It||**B/G Y D $++67@@BH ||I%z?
$u+ab/ " ' 'B
JauRD
!C FH
ID##ab'"''B ZqbT*D HqyD aT{# ..g~ CR=
u+C G} ((4=)G9A& *GG 2 ; %4;-q1 1G2 !%W
tG}8H cU)G9Jxj I Ry,I(
$7JJ6(RVWWJD :..J I((
9$y/9J-XX
))
- JIIZ r c |d 9t | | \ }}d}t |d }t || j |d< | j | y )Nr r7 )defaultr! )r\ maxr rS visit_figure)r% rV rP r rp s r visit_figmpl_latexr~ sT H~!.tT:&fb) vg/44U dr c y Nr r% rV s r depart_figmpl_htmlr
s r c & | j | y r )
depart_figurer s r depart_figmpl_latexr s t r c \ | j t t t ft t
f y )N)htmllatex)add_noder ry r r~ r )apps r figurempl_addnoder s( LL(*<=*,?@ Br c p | j dt t | ddt j d}|S )Nz
figure-mplT)parallel_read_safeparallel_write_safeversion)
add_directiver r
matplotlib __version__)r metadatas r setupr s4 lI.c&*4%113H Or ) r) docutilsr docutils.parsers.rstr &docutils.parsers.rst.directives.imagesr r rM os.pathr pathlibr r rT
sphinx.errorsr
r GeneralElementr r rA r\ ry r~ r r r r r r r r sx
+ @ "
(
N N b$$!NR!j B r
Note that the handling of subdirectories is different than that used by the sphinx
figure directive::
.. figure-mpl:: plot_directive/nestedpage/index-1.png
:alt: bar
:srcset: plot_directive/nestedpage/index-1.png
plot_directive/nestedpage/index-1.2x.png 2.00x
:class: plot_directive
The resulting html (at ``nestedpage/index.html``)::
where the subdirectory is included in the image name for uniqueness.
F )altheightwidthscalealignclasscaptionsrcsetc 4 t }| j d }| j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j dd |d< | j j d d |d < ||d
< | j j d d |d < |gS ) Nr r r r r r r r urir )r argumentsoptionsget)self
image_nodeimagenms r runz
FigureMpl.run\ s \
..# LL , ,UB 7
5 "ll . .w =
7 "ll . .w =
7 "ll . .w =
7 #|| / /$ ?
8 "ll . .w =
7 $ 0 0D A
9 $
5 #|| / /$ ?
8 |r N)r
r r __doc__ has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer unchangedlength_or_unitless length_or_percentage_or_unitlessnonnegative_intr r class_option option_specr( r r r r r " ss (T K % ## //<<++(( '' && K r r c | j d }i }|D ]n }|j j d }t | dk( r |d |d< 9t | dk( r|d dd }|d |t | < at d| d |S )
z
parse srcset...
, r r r Nzsrcset argument "z
" is invalid.)splitstriplenfloatr
)stentriesr entrysplmults r _parse_srcsetNodesrA s s hhsmG
F Kkkm!!#& s8q=AF1I
X]q6#2;D"%a&F5; #4UG=!IJ JK Mr c |d rt |d }nd }t | j d j }| j j
}t
|| j dd j t j d }t | r|dz
}t | j j | j j }t | j dd |rJ|j D ]6 }t || }||j z } t# j$ ||| z 8 n7t ||d }||j z } t# j$ ||| z |||fS ) Nr source.r -T)parentsexist_okr! )rA r documentparentbuildersrcdirr replaceossepr: outdirimagedirr mkdirvaluesnameshutilcopyfile)
r% noder docsourcesrctoprelrP srcabspathrS s
r _copy_images_figmplr\ sD H~#DN3 x0188I \\
F
)V
$
,
,S"
5
=
=bffc
JC
3x s
++T\\-B-BCH N5 ==? 6C y#.G %D OOGX_ 5 6 9d5k2W\\!D 1 VS r c t | | \ }}}t | j d }t | j j d }t || }t | j j d }||z } t t || j j }
| j j dk( rd|
}
t |d dd j } |
d| | } | }
d}|rdd}|j D ]J \ }}t |dd j } |
d| | }||z
}|d k( r|d
z
}n
|d |d d
z
}||kD sG|}|}
L |d d }|d }|d d j |d }d| d}nd}g d}d}|D ] }|| s || d|| dz
} |d r|d nd}d| d| d| d| d | d }d | d }|d |
d z
}|d!| d"z
}|d# r|d$z
}|d%|d# d&z
}|d'z
}|d(z
}| j j | y ))NrC r dirhtmlz..r! r /r7 r z, r6 z1.2fzx, r r zclass="")r r r z: ;r centerz