§
    _÷#d[  ã                   ó´  — d Z ddlZddlZddlmZmZmZmZmZm	Z	m
Z
mZmZmZ ddlmZ ddlmZmZ ddlmZ ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ erddlm Z  ddl!m"Z" ddl#m$Z$ ddl%m&Z&  ej'        e(¦  «        Z) ej*        dej+        ¦  «        Z,e,Z- G d„ d¦  «        Z.dede/fd„Z0d’dede1de/fd„Z2deddfd„Z3ej4        ej5        ej6        ej7        fZ8dede9fd„Z:dede9fd„Z;ej5        ej6        ej<        ej=        fZ>ej?        fZ@ejA        fZBdedeeee/f                  fd„ZCdede	e/         fd„ZDdede	e1         fd„ZEd“ded edee         fd!„ZFdede	e         fd"„ZGdedeeeed#         f                  fd$„ZHd%ed&edede/fd'„ZIdede/fd(„ZJd)e/dee9e/e/f         fd*„ZKg d+¢ZLd,e/d-e/deee/e/e/e/e	e/         f                  fd.„ZMd/d0d1e
e/         d2e/d3ejN        d4ed5ee/         dejN        fd6„ZOd7e/de/fd8„ZP ej*        d9¦  «        ZQ ej*        d:¦  «        ZRi d;d<“d=d>“d?d@“dAdB“dCdD“dEdF“dGdH“dIdH“dJdK“dLd>“dMdN“dOdP“dQdD“dRdS“dTdU“dVdF“dWdF“i dXdY“dZd[“d\d]“d^d[“d_dD“d`dS“dadF“dbdc“dddK“dedf“dgd[“dhdi“djdc“dkdl“dmdn“dodY“¥ZSdpdqdrdsdtduœZT	 d”dwdxdyejN        dze/d{e	e/         de/f
d|„ZUdejV        d}e/de	e         fd~„ZW	 d“d/d0de/d€e/d-e/d�eeee         f         d‚e	e/         dejX        fdƒ„ZYd„ededdfd…„ZZd†ed‡e1deddfdˆ„Z[d‰edŠeddfd‹„Z\ej]        ej^        ej_        ej?        ej=        ej`        eja        fZbdede9fdŒ„Zcdyed�dŽddfd�„Zdd�edefd‘„Zeeeej        _f        dS )•z3Docutils node-related utility functions for Sphinx.é    N)
ÚTYPE_CHECKINGÚAnyÚCallableÚIterableÚListÚOptionalÚSetÚTupleÚTypeÚUnion)Únodes)ÚElementÚNode)Ú	Directive)ÚInliner)Ú
StringList)Úaddnodes)Ú__)Úlogging)ÚBuilder)Ú
IndexEntry)ÚBuildEnvironment)ÚTagsz^(.+?)\s*(?<!\x00)<([^<]*?)>$c                   óR   — e Zd ZdZdee         deddfd„Zdedefd„Z	dedefd	„Z
dS )
ÚNodeMatchera"  A helper class for Node.findall().

    It checks that the given node is an instance of the specified node-classes and
    has the specified node-attributes.

    For example, following example searches ``reference`` node having ``refdomain``
    and ``reftype`` attributes::

        matcher = NodeMatcher(nodes.reference, refdomain='std', reftype='citation')
        doctree.findall(matcher)
        # => [<reference ...>, <reference ...>, ...]

    A special value ``typing.Any`` matches any kind of node-attributes.  For example,
    following example searches ``reference`` node having ``refdomain`` attributes::

        from typing import Any
        matcher = NodeMatcher(nodes.reference, refdomain=Any)
        doctree.findall(matcher)
        # => [<reference ...>, <reference ...>, ...]
    Únode_classesÚattrsÚreturnNc                 ó"   — || _         || _        d S ©N)Úclassesr   )Úselfr   r   s      ú3/usr/lib/python3/dist-packages/sphinx/util/nodes.pyÚ__init__zNodeMatcher.__init__6   s   € Ø#ˆŒØˆŒ
ˆ
ˆ
ó    Únodec                 óD  — 	 | j         rt          || j         ¦  «        sdS | j        rht          |t          j        ¦  «        sdS | j                             ¦   «         D ]2\  }}||vr dS |t          u rŒ|                     |¦  «        |k    r dS Œ3dS # t          $ r Y dS w xY w)NFT)	r!   Ú
isinstancer   r   r   Úitemsr   ÚgetÚ	Exception)r"   r&   ÚkeyÚvalues       r#   ÚmatchzNodeMatcher.match:   sÓ   € ð	ØŒ|ð ¥J¨t°T´\Ñ$BÔ$Bð Ø�uàŒzð 
%Ý! $­¬Ñ6Ô6ð !Ø ˜5à"&¤*×"2Ò"2Ñ"4Ô"4ð %ð %‘J�C˜Ø $��Ø$˜u˜uØ¥#˜˜Ø ØŸš #™œ¨%Ò/Ð/Ø$˜u˜uð 0ð �4øÝð 	ð 	ð 	à�5�5ð	øøøs(   ‚B  !B Á#B Á($B ÂB Â
BÂBc                 ó,   — |                       |¦  «        S r    )r.   )r"   r&   s     r#   Ú__call__zNodeMatcher.__call__P   s   € Ø�zŠz˜$ÑÔÐr%   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r$   Úboolr.   r0   © r%   r#   r   r       s�   € € € € € ðð ð* d¨4¤jð ¸3ð À4ð ð ð ð ð˜$ð  4ð ð ð ð ð, ˜Tð   dð  ð  ð  ð  ð  ð  r%   r   r&   r   c                 óL   — d                      | j        | j        j        ¦  «        S )z—
    Return full module dotted path like: 'docutils.nodes.paragraph'

    :param nodes.Node node: target node
    :return: full module dotted path
    z{}.{})Úformatr2   Ú	__class__r1   ©r&   s    r#   Úget_full_module_namer;   T   s   € ð �>Š>˜$œ/¨4¬>Ô+BÑCÔCÐCr%   éP   Úlengthc                 óØ   — 	 |                       ¦   «                              ¦   «         }n# t          $ r t          | ¦  «        }Y nw xY w|r t	          |¦  «        |k    r|d|…         dz   }|S )a†  
    return DOM XML representation of the specified node like:
    '<paragraph translatable="False"><inline classes="versionmodified">New in version...'

    :param nodes.Node node: target node
    :param int length:
       length of return value to be striped. if false-value is specified, repr_domxml
       returns full of DOM XML representation.
    :return: DOM XML representation
    Nz...)ÚasdomÚtoxmlr+   ÚstrÚlen)r&   r=   Útexts      r#   Úrepr_domxmlrD   ^   s{   € ðØ�zŠz‰|Œ|×!Ò!Ñ#Ô#ˆˆøÝð ð ð Ý�4‰yŒyˆˆˆðøøøàð %•#�d‘)”)˜fÒ$Ð$Ø�G�V�GŒ}˜uÑ$ˆØ€Ks   ‚&) ©AÁAc                 ó  — t          | t          j        ¦  «        ry| j        srt                               dt          | ¦  «        t          | ¦  «        ¦  «         | j        }|j	        | _	        |j
        dz
  | _
        |                      ¦   «         | _        n2t          | t          j        ¦  «        r| j	        s| j        j	        | _	        t          | t          j        ¦  «        r`| j	        €Yt                               dt          | ¦  «        t          | ¦  «        ¦  «         | j        j	        | j        j
        c| _	        | _
        t          | t          j        ¦  «        r`| j	        €Yt                               dt          | ¦  «        t          | ¦  «        ¦  «         | j        j	        | j        j
        c| _	        | _
        t          | t          j        ¦  «        r¾t                               dt          | ¦  «        t          | ¦  «        ¦  «         t          t!          | j                             t          j        ¦  «        ¦  «        ¦  «        D ]I}t%          j        dt%          j        |                     ¦   «         ¦  «        z  d| j        ¦  «        | _        ŒJt          | t          j        ¦  «        r`| j	        €Yt                               dt          | ¦  «        t          | ¦  «        ¦  «         | j        j	        | j        j
        c| _	        | _
        t          | t          j        ¦  «        r| j	        €t/          | ¦  «        | _	        | j        s|                      ¦   «         | _        | j	        r	| j        rd S t          | t          j        t          j
        t          j        t          j        f¦  «        rUt                               dt          | ¦  «        t          | ¦  «        ¦  «         t/          | ¦  «        pd| _	        d	| _
        d S d S )
Nz7[i18n] PATCH: %r to have source, line and rawsource: %sé   z)[i18n] PATCH: %r to have source, line: %sz#[i18n] PATCH: %r to have source: %sz&[i18n] PATCH: %r to have rawsource: %sz	\s*:\s*%sÚ z,[i18n] PATCH: %r to have source and line: %sr   )r(   r   Ú
classifierÚ	rawsourceÚloggerÚdebugr;   rD   ÚparentÚsourceÚlineÚastextÚimageÚtitleÚtermÚreversedÚlistÚfindallÚreÚsubÚescapeÚtopicÚliteral_blockÚget_node_sourceÚrubricÚ
field_name)r&   Údefinition_list_itemrH   s      r#   Úapply_source_workaroundr_   r   sƒ  € õ �$�Ô(Ñ)Ô)ð 	)°$´.ð 	)Ý�ŠÐNÝ)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Dà#œ{ÐØ*Ô1ˆŒØ(Ô-°Ñ1ˆŒ	ØŸš™œˆŒˆÝ	�D�%Ô*Ñ	+Ô	+ð )°D´Kð )à”kÔ(ˆŒÝ�$�œÑ$Ô$ð F¨¬Ð)<Ý�ŠÐ@Ý)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Dà!%¤Ô!3°T´[Ô5EÐˆŒ�T”YÝ�$�œÑ$Ô$ð F¨¬Ð)<Ý�ŠÐ:Ý)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Dà!%¤Ô!3°T´[Ô5EÐˆŒ�T”YÝ�$�œ
Ñ#Ô#ð 8Ý�ŠÐ=Ý)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Dõ #¥4¨¬×(;Ò(;½EÔ<LÑ(MÔ(MÑ#NÔ#NÑOÔOð 	8ð 	8ˆJÝœV Lµ2´9¸Z×=NÒ=NÑ=PÔ=PÑ3QÔ3QÑ$QØ$&¨¬ñ8ô 8ˆDŒNˆNå�$�œÑ$Ô$ð F¨¬Ð)<å�ŠÐ@Ý)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Dà!%¤Ô!3°T´[Ô5EÐˆŒ�T”Yõ �$�Ô+Ñ,Ô,ð ,°´Ð1DÝ% dÑ+Ô+ˆŒð Œ>ð 'ØŸš™œˆŒà„{ð �t”~ð Øˆõ 	�4ÝŒLÝŒJÝŒKÝÔð	ñ 	ô 	ð 
õ 	�ŠÐCÝ)¨$Ñ/Ô/µ¸TÑ1BÔ1Bñ	Dô 	Dð 	Då% dÑ+Ô+Ð1¨rˆŒØˆŒ	Øˆð
ð 
r%   c                 ó²   — t          | t          j        ¦  «        r<t          | j                             dd g¦  «        d         t
          j        ¦  «        rdS dS )Nr   r   TF)r(   r   ÚpendingÚdetailsr*   r   Úmetar:   s    r#   Úis_pending_metard   ¹   sM   € Ý�4�œÑ'Ô'ð Ý�$”,×"Ò" 7¨T¨FÑ3Ô3°AÔ6½¼ÑFÔFðàˆtàˆur%   c                 óT  — t          | t          j        ¦  «        rdS t          | t          j        ¦  «        r,|                      d¦  «        s|                      d¦  «        rdS t          | t          j        ¦  «        rd| vrdS t          | t          j        ¦  «        �rC| j        s8t           
                    dt          | ¦  «        t          | ¦  «        ¦  «         dS t          | t          ¦  «        r<d| vr8t           
                    dt          | ¦  «        t          | ¦  «        ¦  «         dS |                      dd¦  «        s8t           
                    dt          | ¦  «        t          | ¦  «        ¦  «         dS t          | t          j        ¦  «        rI| j        d         d	k    r8t           
                    d
t          | ¦  «        t          | ¦  «        ¦  «         dS dS t!          | ¦  «        st          | t          j        ¦  «        rdS t          | t          j        ¦  «        rdS dS )NTÚtranslatableÚaltFz)[i18n] SKIP %r because no node.source: %szO[i18n] SKIP %r because node is in IGNORED_NODES and no node['translatable']: %sz3[i18n] SKIP %r because not node['translatable']: %sr   Úorphanz&[i18n] SKIP %r because orphan node: %s)r(   r   rf   r   rP   r*   ÚInlineÚTextElementrM   rJ   rK   r;   rD   ÚIGNORED_NODESr]   Úchildrenrd   rc   Údocutils_metar:   s    r#   Úis_translatablern   Á   s  € Ý�$�Ô-Ñ.Ô.ð Øˆtõ �$�œÑ$Ô$ð ¨$¯(ª(°>Ñ*BÔ*Bð ÀdÇhÂhÈuÁoÄoð Øˆtå�$�œÑ%Ô%ð ¨.ÀÐ*DÐ*Dàˆuå�$�Ô)Ñ*Ô*ñ ØŒ{ð 	Ý�LŠLÐDÝ-¨dÑ3Ô3µ[ÀÑ5FÔ5FñHô Hð Hà�5Ý�d�MÑ*Ô*ð 	¨~ÀTÐ/IÐ/IÝ�LŠLð ;å-¨dÑ3Ô3µ[ÀÑ5FÔ5FñHô Hð Hð �5Ø�xŠx˜¨Ñ-Ô-ð 	å�LŠLÐNÝ-¨dÑ3Ô3µ[ÀÑ5FÔ5FñHô Hð Hà�5õ �d�EÔ,Ñ-Ô-ð 	°$´-ÀÔ2BÀhÒ2NÐ2NÝ�LŠLÐAÝ-¨dÑ3Ô3µ[ÀÑ5FÔ5FñHô Hð Hà�5Øˆtå�tÑÔð ¥
¨4µ´Ñ ?Ô ?ð àˆtÝ	�D�(Ô0Ñ	1Ô	1ð àˆtàˆ5r%   Údoctreec              #   óL  K  — |                       t          ¦  «        D �]…}t          |t          j        ¦  «        r|                     ¦   «         D ]}||fV — Œ	Œ;t          |t          ¦  «        r|j        }|s|                     ¦   «         }�nt          |t          j
        ¦  «        rE|                     d¦  «        r||d         fV — |                     d¦  «        rd|d         z  }n²d}n¯t          |t          ¦  «        r|j        }n’t          |t          j        ¦  «        r(t          |¦  «        r|j        d         d         j        }nPt          |t          j        ¦  «        r	|d         }n-|j                             d	d
¦  «                             ¦   «         }|r||fV — �Œ‡dS )z3Extract translatable messages from a document tree.rg   rf   z.. image:: %sÚurirG   r   r   Úcontentú
ú N)rU   rn   r(   r   rf   Úextract_original_messagesÚLITERAL_TYPE_NODESrI   rO   r   rP   r*   ÚMETA_TYPE_NODESÚ
rawcontentra   rd   rb   rm   ÚreplaceÚstrip)ro   r&   Úmsgs      r#   Úextract_messagesr|   ü   s²  è è € à—’¥Ñ0Ô0ð ñ ˆÝ�d�HÔ1Ñ2Ô2ð 	Ø×5Ò5Ñ7Ô7ð  ð  �Ø˜C�i����ØÝ�dÕ.Ñ/Ô/ð 	<Ø”.ˆCØð $Ø—k’k‘m”m�ùÝ˜�eœkÑ*Ô*ð 	<Ø�xŠx˜‰Œð (Ø˜D œKÐ'Ð'Ð'Ð'Ø�xŠx˜Ñ'Ô'ð Ø%¨¨U¬Ñ3��à��Ý˜�oÑ.Ô.ð 
	<à”/ˆCˆCÝ˜�eœmÑ,Ô,ð 	<µÀÑ1FÔ1Fð 	<à”,˜wÔ'¨Ô*Ô5ˆCˆCÝ˜�hÔ4Ñ5Ô5ð 	<à�y”/ˆCˆCà”.×(Ò(¨¨sÑ3Ô3×9Ò9Ñ;Ô;ˆCð ð 	Ø˜�)ˆOˆOˆOùð=ð r%   c                 óJ   — t          | ¦  «        D ]}|j        r	|j        c S Œd S r    )Útraverse_parentrM   ©r&   Úpnodes     r#   r[   r[     s;   € Ý  Ñ&Ô&ð  ð  ˆØŒ<ð 	 Ø”<ÐÐÐð	 àˆ4r%   c                 óJ   — t          | ¦  «        D ]}|j        r	|j        c S Œd S r    )r~   rN   r   s     r#   Úget_node_liner‚   &  s;   € Ý  Ñ&Ô&ð ð ˆØŒ:ð 	Ø”:ÐÐÐð	àˆ4r%   Úclsc              #   óP   K  — | r!|�t          | |¦  «        r| V — | j        } | °d S d S r    )r(   rL   )r&   rƒ   s     r#   r~   r~   -  sO   è è € Ø
ð Øˆ;�* T¨3Ñ/Ô/ˆ;ØˆJˆJˆJØŒ{ˆð ð ð ð ð ð r%   c                 óf   — | j                              | ¦  «        }|dk    r| j         |dz
           S d S )Nr   rF   )rL   Úindex)r&   Úposs     r#   Úget_prev_noderˆ   4  s6   € Ø
Œ+×
Ò
˜DÑ
!Ô
!€CØ
ˆQ‚w€wØŒ{˜3 ™7Ô#Ð#àˆtr%   r   c              #   ó¦   K  — t          t          j        d¬¦  «        }|                      |¦  «        D ]}d|v r	|d         }n|d         }||fV — ŒdS )z6Traverse translatable index node from a document tree.F)ÚinlineÚraw_entriesÚentriesN)r   r   r†   rU   )ro   Úmatcherr&   rŒ   s       r#   Útraverse_translatable_indexrŽ   <  sr   è è € å�(œ.°Ð7Ñ7Ô7€GØ—’ Ñ(Ô(ð ð ˆØ˜DÐ Ð Ø˜=Ô)ˆGˆGà˜9”oˆGØ�GˆmÐÐÐÐðð r%   Ústaterr   c                 ó   — | j         j        }| j         j        }g | j         _        d| j         _        	 |                      |d|d¬¦  «        || j         _        || j         _        S # || j         _        || j         _        w xY w)zûVersion of state.nested_parse() that allows titles and does not require
    titles to have the same decoration as the calling document.

    This is useful when the parsed content comes from a completely different
    context, such as docstrings.
    r   rF   )Úmatch_titles)ÚmemoÚtitle_stylesÚsection_levelÚnested_parse)r�   rr   r&   Úsurrounding_title_stylesÚsurrounding_section_levels        r#   Únested_parse_with_titlesr˜   G  s‡   € ð  %œzÔ6ÐØ %¤
Ô 8ÐØ €E„JÔØ €E„JÔð=Ø×!Ò! '¨1¨dÀÐ!ÑCÔCà":ˆŒ
ÔØ#<ˆŒ
Ô Ð øð #;ˆŒ
ÔØ#<ˆŒ
Ô Ð<Ð<Ð<Ð<s   ²A# Á#A=c                 ó2  — |                       ¦   «         } |                      t          j        ¦  «        D ]}d|d<   Œt	          |                      t          j        ¦  «        ¦  «        D ]}|j                             |¦  «         Œ|                      ¦   «         S )z&Like node.astext(), but ignore images.rG   rg   )	ÚdeepcopyrU   r   rP   rT   ÚrawrL   ÚremoverO   )r&   Úimgr›   s      r#   Úclean_astextrž   Z  sƒ   € à�=Š=‰?Œ?€DØ�|Š|�EœKÑ(Ô(ð ð ˆØˆˆE‰
ˆ
Ý�D—L’L¥¤Ñ+Ô+Ñ,Ô,ð ð ˆØŒ
×Ò˜#ÑÔÐÐØ�;Š;‰=Œ=Ðr%   rC   c                 óš   — t                                | ¦  «        }|r+d|                     d¦  «        |                     d¦  «        fS d| | fS )z3Split role content into title and target, if given.TrF   é   F)Úexplicit_title_rer.   Úgroup)rC   r.   s     r#   Úsplit_explicit_titler£   d  sK   € å×#Ò# DÑ)Ô)€EØð 4Ø�U—[’[ ‘^”^ U§[¢[°¡^¤^Ð3Ð3Ø�$˜ÐÐr%   )ÚsingleÚpairÚdoubleÚtripleÚseeÚseealsoÚentryÚtargetidc                 ór  — ddl m} g }|                      ¦   «         } | }d}|                      d¦  «        rd}| dd …                              ¦   «         } |D ]p}|                      |dz   ¦  «        rV| t          |¦  «        dz   d …                              ¦   «         }||         dz   |z   }|                     d	|||d f¦  «          nñŒqt          D ]j}|                      |dz   ¦  «        rP| t          |¦  «        dz   d …                              ¦   «         }|d
k    rd	}|                     ||||d f¦  «          nŒk|                     d¦  «        D ]h}|                     ¦   «         }d}|                     d¦  «        rd}|dd …                              ¦   «         }|sŒN|                     d|||d f¦  «         Œi|S )Nr   )ÚpairindextypesrG   ú!ÚmainrF   ú:z; r¥   r¦   ú,r¤   )	Úsphinx.domains.pythonr­   rz   Ú
startswithÚlstriprB   ÚappendÚ
indextypesÚsplit)rª   r«   r­   ÚindexentriesÚoentryr¯   Útyper-   s           r#   Úprocess_index_entryr»   q  s  € à4Ð4Ð4Ð4Ð4Ð4àCE€LØ�KŠK‰MŒM€EØ€FØ€DØ×Ò˜ÑÔð #ØˆØ�a�b�b”	× Ò Ñ"Ô"ˆØð Mð MˆØ×Ò˜D 3™JÑ'Ô'ð 	Ø�#˜d™)œ) a™-˜.˜.Ô)×/Ò/Ñ1Ô1ˆEØ" 4Ô(¨4Ñ/°%Ñ7ˆEØ×Ò ¨°¸$ÀÐ EÑFÔFÐFØˆEð		õ ð 	Mð 	MˆDØ×Ò  s¡
Ñ+Ô+ð Ø�c $™iœi¨!™m˜n˜nÔ-×3Ò3Ñ5Ô5�Ø˜8Ò#Ð#Ø!�DØ×#Ò# T¨5°(¸DÀ$Ð$GÑHÔHÐHØ�ðð  Ÿš cÑ*Ô*ð Mð M�ØŸš™œ�Ø�Ø×#Ò# CÑ(Ô(ð /Ø!�DØ! ! " "œI×,Ò,Ñ.Ô.�EØð ØØ×#Ò# X¨u°hÀÀdÐ$KÑLÔLÐLÐLØÐr%   Úbuilderr   Ú
docnamesetÚdocnameÚtreeÚ	colorfuncÚ	traversedc           
      óP  — |                      ¦   «         }t          |                     t          j        ¦  «        ¦  «        D �]c}g }t          t          |d         ¦  «        }|D �]$}	|	|v�r	 |                     |	¦  «         t           	                     ||	¦  «        dz   d¬¦  «         t          | ||	| j                             |	¦  «        ||¦  «        }
|                     |	¦  «         t          j        |	¬¦  «        }|
j        |_        |                     t           j        ¦  «        D ]}d|vr|	|d<   Œ|                     |¦  «         Œé# t$          $ r. t                               t)          d¦  «        |	|¬¦  «         Y �Œ w xY w�Œ&|j                             ||¦  «         �Œe|S )	zwInline all toctrees in the *tree*.

    Record all docnames in *docnameset*, and output docnames with *colorfunc*.
    Úincludefilesrt   T)Únonl)r¾   r¾   z+toctree contains ref to nonexisting file %r©Úlocation)rš   rT   rU   r   ÚtoctreeÚmaprA   rµ   rJ   ÚinfoÚinline_all_toctreesÚenvÚget_doctreeÚaddÚstart_of_filerl   r   Úsectionr+   Úwarningr   rL   ry   )r¼   r½   r¾   r¿   rÀ   rÁ   ÚtoctreenodeÚnewnodesrÃ   ÚincludefileÚsubtreeÚsofÚsectionnodes                r#   rÊ   rÊ   ˜  s×  € ð �=Š=‰?Œ?€DÝ˜DŸLšL­Ô)9Ñ:Ô:Ñ;Ô;ð :ñ :ˆØˆÝ�3 ¨NÔ ;Ñ<Ô<ˆØ'ð 	)ñ 	)ˆKØ )Ð+Ñ+ð)Ø×$Ò$ [Ñ1Ô1Ð1Ý—K’K 	 	¨+Ñ 6Ô 6¸Ñ <À4�KÑHÔHÐHÝ1°'¸:À{Ø29´+×2IÒ2IÈ+Ñ2VÔ2VØ2;¸YñHô H�Gð —N’N ;Ñ/Ô/Ð/õ
 #Ô0¸ÐEÑEÔE�CØ#*Ô#3�C”LØ'*§{¢{µ5´=Ñ'AÔ'Að Að A˜Ø$¨KÐ7Ð7Ø5@˜K¨	Ñ2øØ—O’O CÑ(Ô(Ð(Ð(øõ !ð Bð Bð BÝ—N’N¥2Ð&SÑ#TÔ#TØ#.¸ð #ñ Bô Bð Bð Bñ BðBøøøñ ,ð$ 	Ô×"Ò" ;°Ñ9Ô9Ð9Ñ9Ø€Ks   Á,A>EÅ4FÆFÚstringc                 ó¶  — |                       t          ¦  «        }|                      t          ¦  «        }t          j        d|¦  «                             dd¦  «                             d¦  «        }t                               dd 	                    | 
                    ¦   «         ¦  «        ¦  «        }t                               d|¦  «        }t          |¦  «        S )aë  Convert `string` into an identifier and return it.

    This function is a modified version of ``docutils.nodes.make_id()`` of
    docutils-0.16.

    Changes:

    * Allow to use capital alphabet characters
    * Allow to use dots (".") and underscores ("_") for an identifier
      without a leading character.

    # Author: David Goodger <goodger@python.org>
    # Maintainer: docutils-develop@lists.sourceforge.net
    # Copyright: This module has been placed in the public domain.
    ÚNFKDÚasciiÚignoreú-rt   rG   )Ú	translateÚ_non_id_translate_digraphsÚ_non_id_translateÚunicodedataÚ	normalizeÚencodeÚdecodeÚ_non_id_charsrW   Újoinr·   Ú_non_id_at_endsrA   )r×   Úids     r#   Ú_make_idrè   º  s¥   € ð  
×	Ò	Õ4Ñ	5Ô	5€BØ	�ŠÕ'Ñ	(Ô	(€Bõ 
Ô	˜v rÑ	*Ô	*×	1Ò	1°'¸8Ñ	DÔ	D×	KÒ	KÈGÑ	TÔ	T€Bå	×	Ò	˜3 §¢¨¯ª©¬Ñ 4Ô 4Ñ	5Ô	5€BÝ	×	Ò	˜R Ñ	$Ô	$€BÝˆr‰7Œ7€Nr%   z[^a-zA-Z0-9._]+z^[-0-9._]+|-+$éø   Úoi  Údi'  Úhi1  ÚiiB  Úlig  Úti€  Úbiƒ  iˆ  ÚciŒ  i’  Úfi™  Úkiš  iž  Úni¥  Úpi«  i­  i´  Úyi¶  Úziå  Úgi%  i4  i5  i6  i7  Úji<  i?  Úsi@  iG  ÚeiI  iK  ÚqiM  ÚriO  ÚszÚaeÚoeÚdbÚqp)éß   éæ   iS  i8  i9  rG   rË   r   ÚdocumentÚprefixrR   c                 ó  — d}|r|dz   }n|j         j        pddz   }|r|rt          ||z  ¦  «        }||k    rd}n|rt          |¦  «        }|dk    rd}|�	||j        v r#||                      |¦  «        z  }|®||j        v °#|S )z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%srç   z%srG   )ÚsettingsÚ	id_prefixrè   ÚidsÚnew_serialno)rË   r  r  rR   Únode_idÚidformats         r#   Úmake_idr    sÉ   € ð €GØð @Ø˜E‘>ˆˆàÔ%Ô/Ð7°4¸4Ñ?ˆð ð �$ð Ý˜8 d™?Ñ+Ô+ˆØ�fÒÐàˆGøØ	ð Ý˜4‘.”.ˆØ�bŠ=ˆ=ØˆGà
ˆ/˜W¨¬Ð4Ð4Ø˜S×-Ò-¨fÑ5Ô5Ñ5ˆð ˆ/˜W¨¬Ð4Ð4ð €Nr%   Ú	conditionc                 ó~   — | D ]9}t          |t          j        ¦  «        r|                     d¦  «        |k    r|c S Œ:dS )zBPick matched pending_xref_condition node up from the pending_xref.r  N)r(   r   Úpending_xref_conditionr*   )r&   r  Úsubnodes      r#   Úfind_pending_xref_conditionr    sN   € ð ð ð ˆÝ�w¥Ô ?Ñ@Ô@ð 	Ø—’˜KÑ(Ô(¨IÒ5Ð5ØˆNˆNˆNøàˆtr%   ÚfromdocnameÚ	todocnameÚchildrQ   c                 óÞ   — t          j        ddd¬¦  «        }||k    r|r||d<   n;|r |                      ||¦  «        dz   |z   |d<   n|                      ||¦  «        |d<   |r||d<   ||z  }|S )z$Shortcut to create a reference node.rG   T)ÚinternalÚrefidú#ÚrefuriÚreftitle)r   Ú	referenceÚget_relative_uri)r¼   r  r  r«   r  rQ   r&   s          r#   Úmake_refnoder  (  s¤   € õ Œ?˜2˜r¨DÐ1Ñ1Ô1€DØ�iÒÐ HÐØ ˆˆW‰ˆàð 	NØ%×6Ò6°{ÀIÑNÔNØ!ñ"Ø$,ñ-ˆD�‰NˆNð %×5Ò5°kÀ9ÑMÔMˆD�‰NØð !Ø ˆˆZÑØˆE�M€DØ€Kr%   Ú	directivec                 ó^   — | j                              | j        ¦  «        \  |_        |_        d S r    )Ústate_machineÚget_source_and_lineÚlinenorM   rN   )r   r&   s     r#   Úset_source_infor%  ;  s*   € àÔ×3Ò3°IÔ4DÑEÔEñ €D„K�”��r%   Úinlinerr$  c                 óT   — | j                              |¦  «        \  |_        |_        d S r    )Úreporterr#  rM   rN   )r&  r$  r&   s      r#   Úset_role_source_infor)  @  s%   € Ø$Ô-×AÒAÀ&ÑIÔIÑ€D„K�”��r%   ÚsrcÚdstc                 óV   — t          | ¦  «        |_        t          | ¦  «        |_        d S r    )r[   rM   r‚   rN   )r*  r+  s     r#   Úcopy_source_infor-  D  s$   € Ý  Ñ%Ô%€C„JÝ˜SÑ!Ô!€C„H€H€Hr%   c                 óÄ   — t          | j        ¦  «        D ]5}t          |t          ¦  «        r dS |                     dd¦  «        du r dS Œ6t          | dd¦  «        du rdS dS )z0Check whether the node is smart-quotable or not.FÚsupport_smartquotesNT)r~   rL   r(   ÚNON_SMARTQUOTABLE_PARENT_NODESr*   Úgetattrr   s     r#   Úis_smartquotabler2  T  s   € å  ¤Ñ-Ô-ð ð ˆÝ�eÕ;Ñ<Ô<ð 	Ø�5�5Ø�YŠYÐ,¨dÑ3Ô3°uÐ<Ð<Ø�5�5ð =õ ˆtÐ*¨DÑ1Ô1°UÐ:Ð:Øˆuàˆ4r%   Útagsr   c                 ó
  — |                       t          j        ¦  «        D ]â}	 |                     |d         ¦  «        }|r.|                     |j        pt          j        ¦   «         ¦  «         ŒN|                     t          j        ¦   «         ¦  «         Œu# t          $ ra}t           
                    t          d¦  «        ||¬¦  «         |                     |j        pt          j        ¦   «         ¦  «         Y d}~ŒÛd}~ww xY wdS )z0Filter ``only`` nodes which do not match *tags*.Úexprz8exception while evaluating only directive expression: %srÅ   N)rU   r   ÚonlyÚeval_conditionÚreplace_selfrl   r   Úcommentr+   rJ   rÐ   r   )r  r3  r&   ÚretÚerrs        r#   Úprocess_only_nodesr<  b  s  € à× Ò ¥¤Ñ/Ô/ð 3ð 3ˆð	3Ø×%Ò% d¨6¤lÑ3Ô3ˆCð ð 3Ø×!Ò! $¤-Ð"Bµ5´=±?´?ÑCÔCÐCÐCð ×!Ò!¥%¤-¡/¤/Ñ2Ô2Ð2Ð2øõ ð 	@ð 	@ð 	@Ý�NŠN�2ÐXÑYÔYÐ[^Ø$(ð ñ *ô *ð *à×Ò˜dœmÐ>­u¬}©¬Ñ?Ô?Ð?Ð?Ð?Ð?Ð?Ð?øøøøð	@øøøð3ð 3s   £BÂ
D ÂAC;Ã;D r"   c                 óš   —  | j         | j        fi | j        ¤Ž}t          | t          j        ¦  «        r| j        |_        | j        |_        |S )z¡monkey-patch Element.copy to copy the rawsource and line
    for docutils-0.16 or older versions.

    refs: https://sourceforge.net/p/docutils/patches/165/
    )r9   rI   Ú
attributesr(   r   r   rM   rN   )r"   Únewnodes     r#   Ú	_new_copyr@  v  sL   € ð ˆdŒn˜Tœ^Ð?Ð?¨t¬Ð?Ð?€GÝ�$�œÑ&Ô&ð !ØœˆŒØ”yˆŒØ€Nr%   )r<   r    )rG   N)gr4   rV   rà   Útypingr   r   r   r   r   r   r	   r
   r   r   Údocutilsr   Údocutils.nodesr   r   Údocutils.parsers.rstr   Údocutils.parsers.rst.statesr   Údocutils.statemachiner   Úsphinxr   Úsphinx.localer   Úsphinx.utilr   Úsphinx.buildersr   Úsphinx.domainr   Úsphinx.environmentr   Úsphinx.util.tagsr   Ú	getLoggerr1   rJ   ÚcompileÚDOTALLr¡   Úcaption_ref_rer   rA   r;   ÚintrD   r_   Ú	InvisiblerZ   Údoctest_blockÚversionmodifiedrk   r5   rd   rn   Ú
math_blockr›   rv   rP   ÚIMAGE_TYPE_NODESrc   rw   r|   r[   r‚   r~   rˆ   rŽ   r˜   rž   r£   r¶   r»   r  rÊ   rè   rä   ræ   rß   rÞ   r  Úpending_xrefr  r  r  r%  r)  r-  ÚFixedTextElementÚliteralÚmathÚproblematicÚnot_smartquotabler0  r2  r<  r@  Úcopyr6   r%   r#   ú<module>r_     sX	  ðØ 9Ð 9à 	€	€	€	Ø Ð Ð Ð ðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð Ð Ð Ð Ð Ð Ø (Ð (Ð (Ð (Ð (Ð (Ð (Ð (Ø *Ð *Ð *Ð *Ð *Ð *Ø /Ð /Ð /Ð /Ð /Ð /Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,à Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð àð &Ø'Ð'Ð'Ð'Ð'Ð'Ø(Ð(Ð(Ð(Ð(Ð(Ø3Ð3Ð3Ð3Ð3Ð3Ø%Ð%Ð%Ð%Ð%Ð%à	ˆÔ	˜8Ñ	$Ô	$€ð �B”JÐ?ÀÄÑKÔKÐ Ø"€ð1 ð 1 ð 1 ð 1 ð 1 ñ 1 ô 1 ð 1 ðhD˜tð D¨ð Dð Dð Dð Dðð �dð  Cð °ð ð ð ð ð(; 'ð ;¨dð ;ð ;ð ;ð ;ð~ 
„OØ	ÔØ	ÔØÔð	€ð˜$ð  4ð ð ð ð ð*˜$ð * 4ð *ð *ð *ð *ð\ 
ÔØ	ÔØ	ÔØ	„Ið	Ð ð 
„KðÐ ð „Mð€ð
 ˜gð  ¨(°5¸À#¸Ô3FÔ*Gð  ð  ð  ð  ðF˜'ð  h¨s¤mð ð ð ð ð˜ð  H¨S¤Mð ð ð ð ðð ˜'ð ¨ð °xÀÔ7Hð ð ð ð ð˜ð  ¨$¤ð ð ð ð ð¨ð °X¸eÀGÈTÐR^ÔM_ÐD_Ô>`Ô5að ð ð ð ð= Cð =°*ð =ÀDð =ÈSð =ð =ð =ð =ð&�wð  3ð ð ð ð ð˜sð  u¨T°3¸¨^Ô'<ð ð ð ð ðð ð €
ð
$˜sð $¨cð $Ø! %¨¨S°#°s¸HÀS¼MÐ(IÔ"JÔKð$ð $ð $ð $ðN ð ¸¸C¼ð È3ð Ø#œnðØ9AðØNRÐSVÌiðà"œ^ðð ð ð ðD�Sð ˜Sð ð ð ð ð6 �”
Ð,Ñ-Ô-€Ø�"”*Ð-Ñ.Ô.€ð"Ø
ˆCð"à
ˆCð"ð ˆCð"ð ˆCð	"ð
 ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð ˆCð"ð  ˆCð!"ð" ˆCð#"ð "ð$ ˆCð%"ð& ˆCð'"ð( ˆCð)"ð* ˆCð+"ð, ˆCð-"ð. ˆCð/"ð0 ˆCð1"ð2 ˆCð3"ð4 ˆCð5"ð6 ˆCð7"ð8 ˆCð9"ð: ˆCð;"ð< ˆCð="ð> ˆCð?"ð@ ˆCðA"ðB ˆCðC"ð "Ð ðH ØØØØðð Ð ð 59ðð Ð#ð ¨u¬~ð ØðØ$,¨S¤MðØ=@ðð ð ð ð4 hÔ&;ð Èð Ø%-¨gÔ%6ðð ð ð ð IMðð ˜)ð °#ð À#ð ÐQTð Ø˜d D¨¤JÐ.Ô/ðØ8@À¼ðà”oðð ð ð ð&F˜yð F°ð F¸ð Fð Fð Fð Fð
J 'ð J°3ð J¸dð JÀtð Jð Jð Jð Jð"˜'ð "¨ð "°Dð "ð "ð "ð "ð 
ÔØ	„MØ	„JØ	„KØ	„IØ	ÔØÔð"Ð ð˜4ð  Dð ð ð ð ð3 ð 3¨Vð 3¸ð 3ð 3ð 3ð 3ð(
�Gð 
 ð 
ð 
ð 
ð 
ð €„Ô Ð Ð r%   