3jҟfSrSSKJr SrSSKJrJr SSKJr "SS\5r "SS \5r "S S \5r "S S \5r "SS\5r "SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\R,5rg )!z& Transforms for resolving references. ) annotationsreStructuredText)nodesutils) Transformc&\rSrSrSrSrSSjrSrg) SectionIDsa Add identifiers to sections. If the "legacy_ids" configuration setting is False, the rST parser does not generate identifiers for implicit targets (e.g. sections) in order to give explicit targets preferential access to identifiers matching their reference name. However, the `parts.Contents` transform and most writers expect sections to have an identifier, so this transform adds them. c[URRSS5(agURR[R 5HnURR U5 M g)N legacy_idsT)getattrdocumentsettingsfindallrsectionset_idselfnodes X/home/wildlama/miniconda3/lib/python3.13/site-packages/docutils/transforms/references.pyapplySectionIDs.applysM 4==))< > > MM))%--8D MM  &9NreturnNone__name__ __module__ __qualname____firstlineno____doc__default_priorityr__static_attributes__rrrr r s 'rr c&\rSrSrSrSrSSjrSrg)PropagateTargets&aC Propagate empty internal targets to the next element. Given the following nodes:: This is a test. `PropagateTargets` propagates the ids and names of the internal targets preceding the paragraph to the paragraph itself:: This is a test. icURR[R5GHn[ UR [R 5(dBURS5(d,URS5(dURS5(aMq[U5S:XdS5eURSS9n[ U[R5(a1URSSS 9n[ U[R5(aM1UbN[ U[R[R45(a"[ U[R5(dGM:US RUS 5 US RUS 5 [US 5(d0Ul[US 5(d0UlUS H)nX RR U'XRU'M+ US HnXRU'M URR#[%US 055 URR#[%US 055 [ UR [R&5(a=[ U[R(5(aUR R+U5 GMUS SUS'/US '/US 'URR-U5 GM g)Nrefidrefurirefnamerz&error: block-level target has childrenT)ascendF)r.descendidsnamesexpect_referenced_by_nameexpect_referenced_by_id)rrrtarget isinstanceparent TextElementhasattrlen next_nodesystem_message Invisible Targetableextendr2r3r0updaterfigurecaptionremove note_refid)rr4r:idnames rrPropagateTargets.apply>smmm++ELL9F6==%*;*;<<NN7++v~~h/G/G~~i00v;!# M%M M#(((5IY(<(<==%//tU/K Y(<(<==!i%//5;K;K)LMM"9ell;; e  # #F5M 2 g  % %fWo 69&ABB68 39&?@@46 1Um(1 !!"%9?11"5 $ w @&--66:u}}<.<. $$V,%UmA.F7OF5M F7O MM $ $V ,k:rrNrrrrrr(r(&s*6-rr(c&\rSrSrSrSrSSjrSrg)AnonymousHyperlinkswaa Link anonymous references to targets. Given:: internal external Corresponding references are linked via "refid" or resolved via "refuri":: text external icURR[R5Vs/sHnUR S5(dMUPM nnURR[R 5Vs/sHnUR S5(dMUPM nn[ U5[ U5:waURRRS[ U5<S[ U5<S35nURRU5nUHjn[R"URURUS9nURRU5nURU5 URU5 Ml g[X#5HupiURS5(dURS5(aM3SU lU RS5(aU SUS'SUlMbU S (dURR$U Sn MPU S S US'URR'U5 M gs snfs snf) N anonymouszAnonymous hyperlink mismatch: z references but z+ targets. See "backrefs" attribute for IDs.r+r+r,Tr0r)rrr referencegetr4r9reportererrorr problematic rawsource add_backref replace_selfzipr8 referencedresolvedr0rC) rranonymous_refsanonymous_targetsmsgmsgidrefprbprbidr4s rrAnonymousHyperlinks.applys!]]225??C&CTxx $ C &"]]225<<@&@Txx $ @ & ~ #&7"8 8--((..(#.?*@BCCMM((-E%''mmS]]%A ,,S1&  % & ~AKC{{7##s{{8'<'< $F >>(++$*8$4CM#'CL!%=!%!2!26'?!C #)%=#3CLMM,,S1!B'&&sI I=I I rNrrrrrrHrHws,$rrHcX\rSrSrSrSrS SjrS SjrS SjrS Sjr S Sjr S S jr S r g ) IndirectHyperlinksa a) Indirect external references:: indirect 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):: indirect external Once the attribute is migrated, the preexisting "refname" attribute is dropped. b) Indirect internal references:: indirect internal 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:: indirect internal icURRH6nUR(dURU5 UR U5 M8 gN)rindirect_targetsrWresolve_indirect_targetresolve_indirect_referencesrr4s rrIndirectHyperlinks.applys9mm44F??,,V4  , ,V 45rcURS5nURS5nU(a&URRRU5nOsURRRU5nURRRU5nU(a"U(dURR U5nU(dHURR RHnU"U5(dM g URU5 gURUS9 [U[R5(adUR(dSURS5(a=[US5(aURU5 gSUlUR#U5 U?URS5(aUSUS'SU;aUS OvURS5(a$USUS'URR%U5 Owhich is a duplicate, and cannot be used as a unique referencezwhich does not exist)rr1rNindirect_target_errorrhs rrq.IndirectHyperlinks.nonexistent_indirect_target$sN ==   " "6)#4b 9 A  & &v0N O  & &v/E Frc(URUS5 g)Nzforming a circular reference)ryrhs rrs.IndirectHyperlinks.circular_indirect_reference+s ""6+IJrc Sn/nUS(a SUSS-nUSH8nURURRRU/55 M: USH8nURURRRU/55 M: US(aUSUSS-- nURR R SU<SUS <S U<S 3US 9nURRU5n[R"U5Hjn [R"U RU RUS 9n URRU 5n URU 5 U RU 5 Ml SUlg)Nrxr1z"%s" rr0z (id="%s")zIndirect hyperlink target z refers to target "r-z", . base_noderLT)r>rrefnamesrNrefidsrOrPrruniqrrQrRrSrTrW) rr4 explanationnamingreflistrErDrZr[r\r]r^s rry(IndirectHyperlinks.indirect_target_error.sZ '?vgq11F7OD NN4==1155dB? @$-B NN4==//33B; < %= kF5M!$44 4Fmm$$** *K9DJ+L $$S)::g&C##--e=CMM((-E OOE "   S ! ' rcnURS5(aSnURRnOURS5(aSnSnOgXnUSHnURRR U/5nU(aUR US9 UHenUR (aMUS XGU'U(aU"U5 SUl[U[R5(dMTURU5 Mg M USHnURRR U/5nU(aUR US9 UHenUR (aMUS XGU'U(aU"U5 SUl[U[R5(dMTURU5 Mg M g) Nr+r,r1rEr-Tr0rk) r8rrCrrNrrrWr5rr4rgr) rr4attname call_methodattvalrErr\rDs rrg.IndirectHyperlinks.resolve_indirect_referencesEsl >>' " "G--22K ^^H % %GK 7ODmm,,00r:G))t)4<< N%G $# c5<<0044S9 $-Bmm**..r26G))R)0<<L%G $# c5<<0044S9  rrNr) r r!r"r#r$r%rrfrqrsryrgr&rrrraras10d5 .`GK.%:rrac&\rSrSrSrSrSSjrSrg)ExternalTargetsima Given:: direct external The "refname" attribute is replaced by the direct "refuri" attribute:: direct external icURR[R5HnUR S5(dMUSnUSHinURR R U/5nU(aURUS9 UH$nUR(aMUS X%S'SUlM& Mk M g)Nr,r1rr-T) rrrr4r8rrNrrrW)rr4r,rErr\s rrExternalTargets.applysmm++ELL9F~~h'')"7OD"mm4488rBG11t1<&<<$ N(.H '+ ' ,:rrNrrrrrrrms  ,rrc,\rSrSrSrSSjrSSjrSrg)InternalTargetsiicURR[R5HDnUR S5(aMUR S5(aM3UR U5 MF g)Nr,r+)rrrr4r8resolve_reference_idsrhs rrInternalTargets.applysJmm++ELL9F>>(++FNN74K4K**62:rc@USHnURRRU5nURRRU/5nU(aUR US9 UH+nUR (aMU(aUS X5S'SUlM- M g)a^ Given:: direct internal The "refname" attribute is replaced by "refid" linking to the target's "id":: direct internal r1rr-r+TN)rrnrNrrrrW)rr4rEr+rr\s rr%InternalTargets.resolve_reference_idss"7ODMM))--d3Emm,,00r:G))t)4<<I#(L#  $rrNr)r r!r"r#r%rrr&rrrrrs3 $rrcb\rSrSrSrSrSr/SQrS SjrSr S Sjr S S jr S S jr S S jr S rg) Footnotesia2 Assign numbers to autonumbered footnotes, and resolve links to footnotes, citations, and their references. Given the following ``document`` as input:: A labeled autonumbered footnote reference: An unlabeled autonumbered footnote reference: Unlabeled autonumbered footnote. 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:: A labeled autonumbered footnote reference: 2 An unlabeled autonumbered footnote reference: 1