hSrSSKJrJr SSKJr SSKrSSKJr "SS\R\R5r Sr S r S S jr S S jrS rg)a- Custom roles for the Matplotlib documentation. .. warning:: These roles are considered semi-public. They are only intended to be used in the Matplotlib documentation. However, it can happen that downstream packages end up pulling these roles into their documentation, which will result in documentation build errors. The following describes the exact mechanism and how to fix the errors. There are two ways, Matplotlib docstrings can end up in downstream documentation. You have to subclass a Matplotlib class and either use the ``:inherited-members:`` option in your autodoc configuration, or you have to override a method without specifying a new docstring; the new method will inherit the original docstring and still render in your autodoc. If the docstring contains one of the custom sphinx roles, you'll see one of the following error messages: .. code-block:: none Unknown interpreted text role "mpltype". Unknown interpreted text role "rc". To fix this, you can add this module as extension to your sphinx :file:`conf.py`:: extensions = [ 'matplotlib.sphinxext.roles', # Other extensions. ] .. warning:: Direct use of these roles in other packages is not officially supported. We reserve the right to modify or remove these roles without prior notification. )urlsplit urlunsplit)nodesN)rcParamsDefaultc\rSrSrSrSrSrg)_QueryReference.z Wraps a reference or pending reference to add a query string. The query string is generated from the attributes added to this node. Also equivalent to a `~docutils.nodes.literal` node. cNSRSUR555$)z+Generate query string from node attributes.&c34# UHupUSU3v M g7f)=N).0namevalues L/var/www/html/env/lib/python3.13/site-packages/matplotlib/sphinxext/roles.py 2_QueryReference.to_query_string..9sL^kd4&%)^s)joinattlist)selfs rto_query_string_QueryReference.to_query_string7sxxLT\\^LLLrN)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__rrrrr.s MrrcUR5nUR[R5H,n[ US5R US9n[ U5US'M. URU5 g)zw Resolve *node* into query strings on its ``reference`` children. Then act as if this is a `~docutils.nodes.literal`. refuri)queryN)rfindallr referencer_replacer visit_literal)rnoder#refnodeuris r_visit_query_reference_noder+<sd  "E<<0wx()222?&sO1 trc&URU5 g)z0 Act as if this is a `~docutils.nodes.literal`. N)depart_literal)rr(s r_depart_query_reference_noder.Js rc PSUS3nSnURXwSUS3SU5up[XS9n X- n U /n U[;agUS:waaU R[R "S 5[R "S [[U55[R "S 5/5 X4$) z Sphinx role ``:rc:`` to highlight and link ``rcParams`` entries. Usage: Give the desired ``rcParams`` key as parameter. :code:`:rc:`figure.dpi`` will render as: :rc:`figure.dpi` z rcParams["z"]zmatplotlibrc-sample <>ref) highlightbackendz (default: )) interpretedrrextendrTextliteralrepr) rrawtexttextlinenoinlineroptionscontenttitletarget ref_nodesmessagesqr node_lists r _rcparam_rolerHQsb !E "F!--ewb5J.3V=I  1BOBI 49#4 JJ} % MM"d?4#89 : JJsO   rcvUnSS0nXx;a[SU<35eURXwSXS3SU5upX4$)aa Sphinx role ``:mpltype:`` for custom matplotlib types. In Matplotlib, there are a number of type-like concepts that do not have a direct type representation; example: color. This role allows to properly highlight them in the docs and link to their definition. Currently supported values: - :code:`:mpltype:`color`` will render as: :mpltype:`color` color colors_defzUnknown mpltype: r0r1r2) ValueErrorr7) rr<r=r>r?r@rAmpltypetype_to_link_targetrGrEs r _mpltype_rolerOpsgG),WK899!--9B2;vOI  rcURS[5 URS[5 UR[[ [ 4[ [ 4[ [ 4S9 [RSSS.$)NrcrM)htmllatexr=T)versionparallel_read_safeparallel_write_safe) add_rolerHrOadd_noderr+r. matplotlib __version__)apps rsetupr\siLL}%LLM*LL)+G H*,HI)+G H  "--"&t EEr)NN)r urllib.parserrdocutilsrrYrInline TextElementrr+r.rHrOr\rrrrasM#J.& MellE$5$5 M >2 Er