HEX
Server: Apache
System: Linux beluga.o2switch.net 4.18.0-553.123.2.lve.el8.x86_64 #1 SMP Thu May 7 23:17:13 UTC 2026 x86_64
User: sc3naki1272 (1113)
PHP: 8.3.33
Disabled: NONE
$ pwd: /opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/
Upload Files
File: //opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyc
�
��Yc@sIdZdZddlZddlZddlmZmZddlmZm	Z	de	fd��YZ
de	fd	��YZd
e	fd��YZde	fd
��YZ
de	fd��YZde	fd��YZdefd��YZde	fd��YZde	fd��YZde	fd��YZdejfd��YZdS(s&
Transforms for resolving references.
treStructuredTexti����N(tnodestutils(tTransformErrort	TransformtPropagateTargetscBseZdZdZd�ZRS(s}
    Propagate empty internal targets to the next element.

    Given the following nodes::

        <target ids="internal1" names="internal1">
        <target anonymous="1" ids="id1">
        <target ids="internal2" names="internal2">
        <paragraph>
            This is a test.

    PropagateTargets propagates the ids and names of the internal
    targets preceding the paragraph to the paragraph itself::

        <target refid="internal1">
        <target anonymous="1" refid="id1">
        <target refid="internal2">
        <paragraph ids="internal2 id1 internal1" names="internal2 internal1">
            This is a test.
    icCsx�|jjtj�D]�}t|jtj�s|jd�s|jd�s|jd�rdqnt|�dks�t	d��|j
dt�}|dk	rt|tj
�r�t|tj�s�t|tj�r|dj|d�|dj|d�t|d	�si|_nt|d
�s8i|_nx/|dD]#}||jj|<||j|<qCWx|dD]}||j|<quW|jjt|d	i��|jjt|d
i��|dd|d<g|d<g|d<|jj|�qqWdS(Ntrefidtrefuritrefnameis&error: block-level target has childrentascendtidstnamestexpect_referenced_by_nametexpect_referenced_by_id(tdocumentttraverseRttargett
isinstancetparenttTextElementthasattrtlentAssertionErrort	next_nodetTruetNonet	Invisiblet
TargetabletextendRR
R
tupdatetgetattrt
note_refid(tselfRRtidtname((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pytapply*s<		

(t__name__t
__module__t__doc__tdefault_priorityR#(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRstAnonymousHyperlinkscBseZdZdZd�ZRS(s�
    Link anonymous references to targets.  Given::

        <paragraph>
            <reference anonymous="1">
                internal
            <reference anonymous="1">
                external
        <target anonymous="1" ids="id1">
        <target anonymous="1" ids="id2" refuri="http://external">

    Corresponding references are linked via "refid" or resolved via "refuri"::

        <paragraph>
            <reference anonymous="1" refid="id1">
                text
            <reference anonymous="1" refuri="http://external">
                external
        <target anonymous="1" ids="id1">
        <target anonymous="1" ids="id2" refuri="http://external">
    i�c
Cs�g}g}x<|jjtj�D]%}|jd�r"|j|�q"q"Wx<|jjtj�D]%}|jd�ra|j|�qaqaWt|�t|�kr>|jjj	dt|�t|�f�}|jj
|�}xX|D]P}tj|j|jd|�}|jj
|�}|j
|�|j|�q�WdSx�t||�D]�\}}	d|	_x{tr�|	jd�r�|	d|d<d|_Pqf|	ds�|jj|	d}	qfn|	dd|d<|jj|�PqfWqNWdS(Nt	anonymouss]Anonymous hyperlink mismatch: %s references but %s targets.
See "backrefs" attribute for IDs.RiRR
i(RRRt	referencetgettappendRRtreporterterrortset_idtproblematict	rawsourcetadd_backreftreplace_selftzipt
referencedRRtresolvedR
R(
R tanonymous_refstanonymous_targetstnodetmsgtmsgidtreftprbtprbidR((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#rsD	

			
(R$R%R&R'R#(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR(XstIndirectHyperlinkscBsJeZdZdZd�Zd�Zd�Zd�Zd�Zd�Z	RS(sN
    a) Indirect external references::

           <paragraph>
               <reference refname="indirect external">
                   indirect external
           <target id="id1" name="direct external"
               refuri="http://indirect">
           <target id="id2" name="indirect external"
               refname="direct external">

       The "refuri" attribute is migrated back to all indirect targets
       from the final direct target (i.e. a target not referring to
       another indirect target)::

           <paragraph>
               <reference refname="indirect external">
                   indirect external
           <target id="id1" name="direct external"
               refuri="http://indirect">
           <target id="id2" name="indirect external"
               refuri="http://indirect">

       Once the attribute is migrated, the preexisting "refname" attribute
       is dropped.

    b) Indirect internal references::

           <target id="id1" name="final target">
           <paragraph>
               <reference refname="indirect internal">
                   indirect internal
           <target id="id2" name="indirect internal 2"
               refname="final target">
           <target id="id3" name="indirect internal"
               refname="indirect internal 2">

       Targets which indirectly refer to an internal target become one-hop
       indirect (their "refid" attributes are directly set to the internal
       target's "id"). References which indirectly refer to an internal
       target become direct internal references::

           <target id="id1" name="final target">
           <paragraph>
               <reference refid="id1">
                   indirect internal
           <target id="id2" name="indirect internal 2" refid="id1">
           <target id="id3" name="indirect internal" refid="id1">
    i�cCsAx:|jjD],}|js,|j|�n|j|�q
WdS(N(Rtindirect_targetsR6tresolve_indirect_targettresolve_indirect_references(R R((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#�s	cCs�|jd�}|dkr(|d}nV|jjj|�}|s~x4|jjjD]}||�rSPqSqSW|j|�dS|jj|}|jd|�t	|t
j�r|jr|j
d�rt
|d�r�|j|�dSd|_|j|�|`n|j
d�r>|d|d<d|kr�|d=q�nh|j
d�rn|d|d<|jj|�n8|dr�||d<|jj|�n|j|�dS|dk	r�|d=nd|_dS(NRRR!tmultiply_indirectiRR
(R+RRtnameidsttransformertunknown_reference_resolverstnonexistent_indirect_targetR
tnote_referenced_byRRRR6Rtcircular_indirect_referenceRCRAR(R RRtreftarget_idtresolver_functiont	reftarget((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRA�sH


	
	




cCs=|d|jjkr)|j|d�n|j|d�dS(NRs>which is a duplicate, and cannot be used as a unique referenceswhich does not exist(RRDtindirect_target_error(R R((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRGscCs|j|d�dS(Nsforming a circular reference(RM(R R((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRI
scCsed}g}|dr+d|dd}nx1|dD]%}|j|jjj|g��q6Wx1|dD]%}|j|jjj|g��qjW|dr�|d|dd7}n|jjjd||d|fd	|�}|jj|�}xatj	|�D]P}	t
j|	j|	jd
|�}
|jj|
�}|j
|�|	j|
�qWd|_dS(NtRs"%s" iR
s	(id="%s")s7Indirect hyperlink target %s refers to target "%s", %s.Rt	base_nodeRi(RRtrefnamesR+trefidsR-R.R/RtuniqRR0R1R2R3R6(R RtexplanationtnamingtreflistR"R!R:R;R<R=R>((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRM
s*
##

c	Cs�|jd�r$d}|jj}n"|jd�rBd}d}ndS||}x�|dD]�}|jjj|g�}|r�|jd|�nxl|D]d}|jr�q�n|d=|||<|r�||�nd|_t|t	j
�r�|j|�q�q�Wq[Wx�|dD]�}|jjj|g�}|rG|jd|�nxl|D]d}|jrcqNn|d=|||<|r�||�nd|_t|t	j
�rN|j|�qNqNWqWdS(	NRRRR"RiR
R!(
RRRRRPR+RHR6RRRRBRQ(	R Rtattnametcall_methodtattvalR"RUR<R!((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRB$sH	

	

	
	

	(
R$R%R&R'R#RARGRIRMRB(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR?�s2		-			tExternalTargetscBseZdZdZd�ZRS(s�
    Given::

        <paragraph>
            <reference refname="direct external">
                direct external
        <target id="id1" name="direct external" refuri="http://direct">

    The "refname" attribute is replaced by the direct "refuri" attribute::

        <paragraph>
            <reference refuri="http://direct">
                direct external
        <target id="id1" name="direct external" refuri="http://direct">
    i�cCs�x�|jjtj�D]�}|jd�r|d}x�|dD]q}|jjj|g�}|rw|jd|�nx7|D]/}|jr�q~n|d=||d<d|_q~Wq@WqqWdS(NRRR"Ri(	RRRRRRPR+RHR6(R RRR"RUR<((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#`s

	
(R$R%R&R'R#(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRYLstInternalTargetscBs eZdZd�Zd�ZRS(i�cCsTxM|jjtj�D]6}|jd�r|jd�r|j|�qqWdS(NRR(RRRRRtresolve_reference_ids(R R((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#ts cCs�x�|dD]�}|jjj|�}|jjj|g�}|rW|jd|�nx@|D]8}|jrsq^n|r�|d=||d<nd|_q^WqWdS(s�
        Given::

            <paragraph>
                <reference refname="direct internal">
                    direct internal
            <target id="id1" name="direct internal">

        The "refname" attribute is replaced by "refid" linking to the target's
        "id"::

            <paragraph>
                <reference refid="id1">
                    direct internal
            <target id="id1" name="direct internal">
        RR"RRiN(RRDR+RPRHR6(R RR"RRUR<((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR[ys
	
(R$R%R'R#R[(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRZps	t	Footnotesc
BsteZdZdZdZdddddddd	d
dg
Zd�Zd
�Zd�Z	d�Z
d�Zd�ZRS(s�
    Assign numbers to autonumbered footnotes, and resolve links to footnotes,
    citations, and their references.

    Given the following ``document`` as input::

        <document>
            <paragraph>
                A labeled autonumbered footnote referece:
                <footnote_reference auto="1" id="id1" refname="footnote">
            <paragraph>
                An unlabeled autonumbered footnote referece:
                <footnote_reference auto="1" id="id2">
            <footnote auto="1" id="id3">
                <paragraph>
                    Unlabeled autonumbered footnote.
            <footnote auto="1" id="footnote" name="footnote">
                <paragraph>
                    Labeled autonumbered footnote.

    Auto-numbered footnotes have attribute ``auto="1"`` and no label.
    Auto-numbered footnote_references have no reference text (they're
    empty elements). When resolving the numbering, a ``label`` element
    is added to the beginning of the ``footnote``, and reference text
    to the ``footnote_reference``.

    The transformed result will be::

        <document>
            <paragraph>
                A labeled autonumbered footnote referece:
                <footnote_reference auto="1" id="id1" refid="footnote">
                    2
            <paragraph>
                An unlabeled autonumbered footnote referece:
                <footnote_reference auto="1" id="id2" refid="id3">
                    1
            <footnote auto="1" id="id3" backrefs="id2">
                <label>
                    1
                <paragraph>
                    Unlabeled autonumbered footnote.
            <footnote auto="1" id="footnote" name="footnote" backrefs="id1">
                <label>
                    2
                <paragraph>
                    Labeled autonumbered footnote.

    Note that the footnotes are not in the same order as the references.

    The labels and reference text are added to the auto-numbered ``footnote``
    and ``footnote_reference`` elements.  Footnote elements are backlinked to
    their references via "refids" attributes.  References are assigned "id"
    and "refid" attributes.

    After adding labels and reference text, the "auto" attributes can be
    ignored.
    ilt*u†u‡u§u¶t#u♠u♥u♦u♣cCsOg|_|jj}|j|�|j_|j|�|j�|j�dS(N(tautofootnote_labelsRtautofootnote_starttnumber_footnotestnumber_footnote_referencestsymbolize_footnotestresolve_footnotes_and_citations(R tstartnum((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#�s	

cCs�x�|jjD]v}x6trKt|�}|d7}||jjkrPqqW|jdtjd|��x�|dD]�}x�|jjj	|g�D]�}|tj
|�7}|jd�t|d�t|d�ko�dkns�t
�|dd|d<|j|dd�|jj|�d|_q�WqsW|dr
|dr
|dj|�|jj||�|jj|�q
q
W|S(	s�
        Assign numbers to autonumbered footnotes.

        For labeled autonumbered footnotes, copy the number over to
        corresponding footnote references.
        iiRNRRR
Rtdupnames(Rt
autofootnotesRtstrRDtinsertRtlabelt
footnote_refsR+tTexttdelattrRRR2RR6R,tnote_explicit_targetR_(R RetfootnoteRjR"R<((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRa�s*	

6cCs�d}x�|jjD]�}|js|jd�r7qny|j|}Wn�tk
r|jjjdt|j�d|�}|jj	|�}x�|jj|D]n}|js�|jd�r�q�nt
j|j|jd|�}|jj	|�}|j
|�|j|�q�WPnX|t
j|�7}|jj|}	|jj|	}
|	|d<|jj|�t|d�dks�t�|
j
|dd�d|_|d7}qWdS(	s3Assign numbers to autonumbered footnote references.iRsUToo many autonumbered footnote references: only %s corresponding footnotes available.RORR
iN(Rtautofootnote_refsR6RR_t
IndexErrorR-R.RR/RR0R1R2R3RlRDR
RR(R RetiR<RjR:R;R=R>R!Ro((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRbs:


	cCsg}x�|jjD]�}t|jjt|j��\}}|j||d}|j|�|jdtj	d|��|jjd7_|jj
|�qWd}xk|jjD]]}y|tj||�7}Wn�t
k
r�|jjjdt|�d|�}|jj
|�}	x�|jj|D]n}|js-|jd�rQq-ntj|j|jd|	�}
|jj
|
�}|j|�|j|
�q-WPnX|jj|}t|d�dks�t�|dd|d<|jj|�|j|dd�|d7}q�WdS(	s<Add symbols indexes to "[*]"-style footnotes and references.iiRNsOToo many symbol footnote references: only %s corresponding footnotes available.RORR
N(Rtsymbol_footnotestdivmodtsymbol_footnote_startRtsymbolsR,RiRRjR/tsymbol_footnote_refsRlRqR-R.R6RR0R1R2R3RR(R tlabelsRotrepstindext	labeltextRrR<R:R;R=R>((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRc1sD


	
cCs�x^|jjD]P}xG|dD];}||jjkr|jj|}|j||�qqWq
Wx^|jjD]P}xG|dD];}||jjkr|jj|}|j||�qqWqnWdS(sa
        Link manually-labeled footnotes and citations to/from their
        references.
        RN(Rt	footnotesRktresolve_referencest	citationst
citation_refs(R RoRjRUtcitation((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyRdVscCs�t|d�dkst�|dd}xn|D]f}|jrFq1n|jd�||d<t|d�dksyt�|j|dd�d|_q1Wd|_dS(NR
iiRR(RRR6RmR2(R tnoteRUR!R<((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR}fs
	


N(
R$R%R&R'RR_RvR#RaRbRcRdR}(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR\�s&;				!	%	t#CircularSubstitutionDefinitionErrorcBseZRS((R$R%(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�tst
SubstitutionscBseZdZdZd�ZRS(sD
    Given the following ``document`` as input::

        <document>
            <paragraph>
                The
                <substitution_reference refname="biohazard">
                    biohazard
                 symbol is deservedly scary-looking.
            <substitution_definition name="biohazard">
                <image alt="biohazard" uri="biohazard.png">

    The ``substitution_reference`` will simply be replaced by the
    contents of the corresponding ``substitution_definition``.

    The transformed result will be::

        <document>
            <paragraph>
                The
                <image alt="biohazard" uri="biohazard.png">
                 symbol is deservedly scary-looking.
            <substitution_definition name="biohazard">
                <image alt="biohazard" uri="biohazard.png">
    i�cCs#|jj}|jj}|jjtj�}i}x�|D]�}|d}d}||kre|}n%|j�}||kr�||}n|dkr|jjj	d|d|�}	|jj
|	�}
tj|j|jd|
�}|jj
|�}|	j
|�|j|�q:||}
|j}|j|�}d|
jksTd|
jkr�|dkr�t||dtj�r�|j||d||dj��q�nd	|
jks�d|
jkr t|�|dkr t||dtj�r |j||d||dj��q n|
j�}y~xw|jtj�D]c}||dj�}||j|g�kr}t�qB||j|�||d
<|j|�qBWWntk
r�|j}t|tj�r|jjj	dtj|j|j�d|jd|�}	|j|	�q|}x|jd
�rC|d
}q'W|jjj	d
|d|�}	|jj
|	�}
tj|j|jd|
�}|jj
|�}|	j
|�|j|�q:X|j|j �xE|j D]:}t|tj!�r�d|kr|jj"|�qq�q�Wq:WdS(NRs(Undefined substitution referenced: "%s".RORtltrimttrimiitrtrims
ref-origins*Circular substitution definition detected:tlines2Circular substitution definition referenced: "%s".(#Rtsubstitution_defstsubstitution_namesRRtsubstitution_referenceRtlowerR-R.R/R0R1R2R3RRzt
attributesRRltreplacetrstripRtlstriptdeepcopyt
setdefaultR�R,tsubstitution_definitiont
literal_blockR�RtchildrentReferentialtnote_refname(R tdefstnormedt
subreflisttnestedR<Rtkeytnormed_nameR:R;R=R>tsubdefRRztsubdef_copyt
nested_reftnested_namet
ref_originR9((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#�s�

	


			

	
(R$R%R&R'R#(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�wstTargetNotescBs/eZdZdZd�Zd�Zd�ZRS(s�
    Creates a footnote for each external target in the text, and corresponding
    footnote references after each reference.
    icCs2tj||d|�|jjdg�|_dS(Nt	startnodetclass(Rt__init__tdetailsR+tclasses(R RR�((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR��sc	Csyi}g}x�|jjtj�D]�}|jd�s=q"n|d}g}x-|D]%}|j|jjj|g��qTW|s�q"n|j|d||�}|d|kr"|||d<|j	|�q"q"Wx�|jjtj
�D]w}|jd�sq�n|jd�r�|j|d|g|�}|d|kra|||d<|j	|�qaq�q�W|jj|�dS(NRRR)(
RRRRRRRPR+tmake_target_footnoteR,R*R�R3(	R tnotestnodelistRRtrefsR"RoR<((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#�s4

#		cCs�||krC||}t|d�dks2t�|dd}n�tj�}|jj|�}d|}d|d<|g|d<tj�}|tjd|d|�7}||7}|jj|�|jj	||�x|D]�}t
|tj�r�q�ntjd|dd�}	|	d	c|j
7<|jj|	�|jj|	�|jj|�d}
|	g}tj|jj�s�|j
r�|jdtjd
dd|j
��q�|jdtjd��n|jj|
|�q�W|S(
NRiis
TARGET_NOTE: tautoRNRRR�ttextt tClasses(RRRRoRR/t	paragraphR*tnote_autofootnoteRnRRtfootnote_referenceR�tnote_autofootnote_reftnote_footnote_refRRzRtget_trim_footnote_ref_spacetsettingsRitinlineRl(R RR�R�Rot
footnote_nametfootnote_idtfootnote_paragraphR<trefnodeRzRU((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�s:





		((R$R%R&R'R�R#R�(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR��s
		tDanglingReferencescBseZdZdZd�ZRS(se
    Check for dangling references (incl. footnote & citation) and for
    unreferenced targets.
    iRcCs�t|j|jjj�}|jj|�x�|jjtj�D]�}|jsA|j	d�reqAn|dr�|dd}n%|dr�|dd}n
|d}|jj
jd|d|�qAqAWdS(NR)RiR
Rs(Hyperlink target "%s" is not referenced.RO(tDanglingReferencesVisitorRRERFtwalkRRRR5R+R-tinfo(R tvisitorRRT((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR#Js 	


(R$R%R&R'R#(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�AsR�cBs-eZd�Zd�Zd�ZeZZRS(cCs)tjj||�||_||_dS(N(RtSparseNodeVisitorR�RRF(R RRF((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�hs	cCsdS(N((R R9((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyt
unknown_visitmsc	Cs�|js|jd�rdS|d}|jjj|�}|dkrLx5|jD]}||�rRPqRqRW||jjkr�|jjjd|dd|�}n#|jjjd|dd|�}|jj	|�}t
j|j|jd|�}y|dd}Wn#t
k
r.|jj	|�}nX|j|�|j|�n4|d=||d<|jj|jd|�d	|_dS(
NRsBDuplicate target name, cannot be used as a unique reference: "%s".ROsUnknown target name: "%s".RR
iR!i(R6RRRDR+RRFR-R.R/RR0R1RqR2R3R
RH(	R R9RR!RKR:R;R=R>((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pytvisit_referenceps8
	


(R$R%R�R�R�tvisit_footnote_referencetvisit_citation_reference(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyR�fs			!(R&t
__docformat__tsystretdocutilsRRtdocutils.transformsRRRR(R?RYRZR\t	ExceptionR�R�R�R�R�R�(((sO/opt/alt/python27/lib/python2.7/site-packages/docutils/transforms/references.pyt<module>s GB�$(�wS%
@ Telegram