j\$ d Z ddlZddlmZ ddlmZmZ ddlZddlm Z ddl
m Z ddl m
Z
mZ ddlmZ ddlZ G d d
e j e j Z G d d e
Zd
Zd Zd Zd Zd Zd Zd Z d Z dS )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.
N)relpath)PurePathPath)nodes)
directives)FigureImage)ExtensionErrorc e Zd ZdS )
figmplnodeN)__name__
__module__ __qualname__ /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/matplotlib/sphinxext/figmpl_directive.pyr r s Dr r c e Zd ZdZdZdZdZdZej ej
ej ej e
j ej ej ej dZd ZdS ) 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 ( t }| j d }| j dd |d< | j dd |d< | j dd |d< | j dd |d< | j dd |d< | j dd |d< | j d d |d < ||d
< | j d d |d < |gS ) Nr r r r r r r r urir )r argumentsoptionsget)self
image_nodeimagenms r runz
FigureMpl.runZ s \\
.# L , ,UB 7 7
5 "l . .w = =
7 "l . .w = =
7 "l . .w = =
7 #| / /$ ? ?
8 "l . .w = =
7 $ 0 0D A 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 s ( (T K % # /<+( ' & K r r c f | d }i }|D ]}| d }t | dk r |d |d< Ht | dk r)|d dd }|d |t | < t d| d |S )
z
parse srcset...
, r r r Nzsrcset argument "z
" is invalid.)splitstriplenfloatr
)stentriesr entrysplmults r _parse_srcsetNodesrA q s hhsmmG
F K Kkkmm!!#&& s88q==AF1II
XX]]q6#2#;D"%a&F5;; !IU!I!I!IJJ J Mr c |d rt |d }nd }t | j d j }| j j }t
|| dd t j d }t | r|dz
}t | j j | j j }t | dd |rJ| D ]4}t || }||j z } t# j ||| z 5n8t ||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\ so H~ #DN33 x0118I \
F
)V
$
$
,
,S"
5
5
=
=bfc
J
JC
3xx s
+T\-BCCH NN555 2==?? 6 6C y#..G %D OGX_ 5 5 5 5 6 9d5k22W\!D 111 VS r c t | | \ }}}t | j d }t | j j d }t || }t | j j d }||z } t t || j }
| j j dk rd|
}
t |d dd j } |
d| | } | |d d }
| }|rud
}d}|
D ]O\ }}t |dd j } |
d| | }||z
}|d k r|d z
}n
|d
|ddz
}||k r|}|}P|d d |
d< |d d
|d |
d< dD ]<}|| r2d|
vr| d|| d|
d< |
dxx | d|| dz
cc< =| j
| |d|d r d|d nd | j
| |d d | | j |d fi |
z d z |d! r| j
| |d" | j
| |d# | j
| |d$d% | j
|d! | j
d& | j
d' d S )(NrC r dirhtmlz..r! r /r )rZ r r7 r z, r6 z1.2fzx, r r )r r r stylez: ;figurer zalign-z align-center)CLASSaz"reference internal image-reference)rd hrefimgz
r
figcaptionpspanz caption-textz
z
)r\ r rH rJ rK r rO rI as_posixrS itemsjoinbodyappendstarttagemptytag)r% rV rP r rY rW rX relsourcedesttopdestimagerelnmr! img_attrsmaxsrcmaxmultsrcsetstr@ rZ pathra s r visit_figmpl_htmlr| s /d ; ;Hfc x011I dl)2
.
.F 6**It|*B//G Y D $+6677@@BBH |I%%"??
$u+abb/ " " 'B
!
!
!R
!
!CDK00I F
, ID##abb'""'B ***b**D HqyyD . . . . ..g~~ 'ssm ( G} XXd7m 4 4 '- A A ; Ai''(-%?%?e%?%?%? '""'"""&@&@$u+&@&@&@@""" I
(.27mO*4=*** Q QR R R I
dC'K! # #
dE//Y// 0
I 7 t\::;;; tS11222 tV> JJKKK i ))) 5666I]#####r c |d Ct | | \ }}d}t |d }t || j |d< | | d S )Nr r7 )defaultr! )r\ maxr rS visit_figure)r% rV rP r ry s r visit_figmpl_latexr si H~!.tT::&fb))) vg//4U dr c d S Nr r% rV s r depart_figmpl_htmlr s Dr c 0 | | d S r )
depart_figurer s r depart_figmpl_latexr s t r c p | t t t ft t
f d S )N)htmllatex)add_noder r| r r r )apps r figurempl_addnoder s@ LL(*<=*,?@ B B B B Br c z | dt t | ddt j d}|S )Nz
figure-mplT)parallel_read_safeparallel_write_safeversion)
add_directiver r
matplotlib __version__)r metadatas r setupr sB lI...c&*4%13 3H Or ) r) rM os.pathr pathlibr r rT docutilsr docutils.parsers.rstr &docutils.parsers.rst.directives.imagesr r
sphinx.errorsr
r GeneralElementr r rA r\ r| r r r r r r r r r s
" " " " " " " "
+ + + + + + @ @ @ @ @ @ @ @ ( ( ( ( ( (
N N N N N N N N b $$! $! $!NR$ R$ R$j B B B r