ەhQX h d Z dZddlmZmZ ddlmZ G d de Z G d de Z G d d
e Z G d d e Z
G d
de Z G d de Z G d de
Z G d de Z G d de Z G d de Z G d dej ZdS ) z&
Transforms for resolving references.
reStructuredText )nodesutils) Transformc e Zd ZdZdZd ZdS )PropagateTargetsa}
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.
i c | j t j D ]T}t |j t j s?| d s*| d s| d rbt | dk s
J d | d }t |t j
r1| dd }t |t j
1|@t |t j t j f r t |t j s$|d
|d
|d
|d t |d si |_ t |d
si |_ |d
D ]}|| j j |< ||j |< |d D ] }||j |<
|j t% |d i |j t% |d
i |d
d |d< g |d
< g |d < | j | Vd S )Nrefidrefurirefnamer z&error: block-level target has childrenT)ascendF)r
descendidsnamesexpect_referenced_by_nameexpect_referenced_by_id)documentfindallr target
isinstanceparent TextElementhasattrlen next_nodesystem_message Invisible
Targetableextendr r r updategetattr
note_refid)selfr r idnames ~/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/docutils/transforms/references.pyapplyzPropagateTargets.apply( s m++EL99 - - - -F6=%*;<<
NN7++
/5~~h/G/G
~~i00
v;;!###%M### (((55I Y(<==
L % / /tU / K K Y(<==
L ! i%/5;K)LMM ""9el;; " e # #F5M 2 2 2 g % %fWo 6 6 69&ABB
968 39&?@@
746 1 Um
?
?(1
!"% 9? 1"55 w
C
C>
@
@
@ %UmA .F7O F5M F7O M $ $V , , , ,[- - - - N__name__
__module__ __qualname____doc__default_priorityr' r( r& r r s5 * .- .- .- .- .-r( r c e Zd ZdZdZd ZdS )AnonymousHyperlinksa
Link anonymous references to targets. Given::
internal
external
Corresponding references are linked via "refid" or resolved via "refuri"::
text
external
i c D g }g }| j t j D ],}| d r| | -| j t j D ],}| d r| | -t | t | k r| j j dt | dt | d }| j
| }|D ]g}t j |j |j | }| j
| }|
| | | hd S t || D ]\ }} d| _ | d r| d |d< d|_ nM| d s| j j | d
} J| d d |d
< | j | d S ) N anonymousz Anonymous hyperlink mismatch: z references but z+ targets.
See "backrefs" attribute for IDs.r
Tr r r
r )r r r referencegetappendr r reportererrorset_id problematic rawsource add_backref replace_selfzip
referencedr resolvedr r" )
r# anonymous_refsanonymous_targetsnodemsgmsgidrefprbprbidr s
r& r' zAnonymousHyperlinks.applys sC M))%/:: , ,Dxx $$
, %%d+++M))%,77 / /Dxx $$
/!((... ~ #&7"8"8 8 8-(... ((((#.?*@*@*@*@BC CC M((--E%
&
&'mS]%A A A
,,S11&&& %%%% F ~/@AA KC !F
>>(++ $*8$4CM#$CL!%= !!% !26'?!C #)%=#3CLM,,S111 r( Nr) r/ r( r& r1 r1 Y s5 , $ $ $ $ $r( r1 c : e Zd ZdZdZd Zd Zd Zd Zd Z d Z
d S )
IndirectHyperlinksaN
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
i c | j j D ]3}|j s| | | | 4d S N)r indirect_targetsrB resolve_indirect_targetresolve_indirect_referencesr# r s r& r' zIndirectHyperlinks.apply sU m4 5 5F?
5,,V444 , ,V 4 4 4 4 5 5r( c | d }| |d }nY| j j | }|s8| j j j D ]} || r n| | d S | j j | }| | t |t j
ra|j sZ| d rEt |d r|
| d S d|_ | | |`| d r|d |d< d|v r|d= nz| d r&|d |d< | j | n?|d r ||d< | j | n| | d S ||d= d|_ d S )Nr r
r$ multiply_indirectr5 r r )r7 r nameids transformerunknown_reference_resolversnonexistent_indirect_targetr note_referenced_byr r r rB r circular_indirect_referencerU rP r" )r# r r reftarget_idresolver_function reftargets r& rP z*IndirectHyperlinks.resolve_indirect_target s **Y'' ?!'?LL =044W==L
1M= =%((00 44V<<<M%l3 $$ $555 y%, / / ) & )!!),, ) v 233
00888'(F $ ( ( 3 3 3( X & &
( 2F8 & 7O
w
'
' ' 0F7O M $ $V , , , ,
".w
((000000888 y!r( c |d | j j v r| |d d S | |d d S )Nr z>which is a duplicate, and cannot be used as a unique referencezwhich does not exist)r rV indirect_target_errorrR s r& rY z.IndirectHyperlinks.nonexistent_indirect_target se )
5 5 5 & &v 0N
O
O
O
O
O
& &v/E F F F F Fr( c 2 | |d d S )Nz forming a circular reference)r` rR s r& r[ z.IndirectHyperlinks.circular_indirect_reference s ""6+IJJJJJr( c d}g }|d rd|d d z }|d D ]5}| | j j |g 6|d D ]5}| | j j |g 6|d r|d|d d z z
}| j j d|d|d d
|d | }| j | }t j | D ]g} t j | j | j |
}
| j |
} |
| | |
hd|_ d S )N r z"%s" r r z (id="%s")zIndirect hyperlink target z refers to target "r z", . base_noder4 r5 )r r refnamesr7 refidsr9 r: r; r uniqr r< r= r> r? rB ) r# r explanationnamingreflistr% r$ rF rG rH rI rJ s r& r` z(IndirectHyperlinks.indirect_target_error s '? 2 vgq 11F7O A AD NN4=155dB?? @ @ @ @- = =B NN4=/33B;; < < < < %= 5 kF5M!$44 4Fm$*** ***KKK9DJ + L L
$$S)):g&& " "C#- e= = =CM((--E OOE " " " S ! ! ! !r( c | d rd}| j j }n | d rd}d }nd S || }|d D ]}| j j |g }|r| | |D ]U}|j r
|d= |||< |r || d|_ t |t j r|
| V|d D ]}| j j |g }|r| | |D ]U}|j r
|d= |||< |r || d|_ t |t j r|
| Vd S ) Nr
r r r% r r5 r rT ) r r r" rg r7 rZ rB r r r rQ rh ) r# r attname call_methodattvalr% rl rH r$ s r& rQ z.IndirectHyperlinks.resolve_indirect_references# s >>' " " G -2KK
^^H
%
% G KK F 7O
:
:Dm,00r::G
5))t)444
:
:< N %G % K$$$ c5<00 :44S999
: -
:
:Bm*..r266G
1))R)000
:
:< L %G % K$$$ c5<00 :44S999
:
:
:r( N) r* r+ r, r- r. r' rP rY r[ r` rQ r/ r( r& rL rL s 0 0d 5 5 5 * * * XG G GK K K .%: %: %: %: %:r( rL c e Zd ZdZdZd ZdS )ExternalTargetsa
Given::
direct external
The "refname" attribute is replaced by the direct "refuri" attribute::
direct external
i c L | j t j D ]~}| d rg|d }|d D ]V}| j j |g }|r| | |D ]}|j r
|d= ||d< d|_ Wd S )Nr r rn r r5 ) r r r r r rg r7 rZ rB )r# r r r% rl rH s r& r' zExternalTargets.apply_ s m++EL99 ) )F~~h''
) ) "7O ) )D "m 4 8 8r B BG = 11t1<<< & ) ) < % $ N(.H
'( ) ) )r( Nr) r/ r( r& rs rs K s5
)
)
)
)
)r( rs c e Zd ZdZd Zd ZdS )InternalTargetsi c | j t j D ]A}| d s*| d s| | Bd S )Nr r
)r r r r r resolve_reference_idsrR s r& r' zInternalTargets.applys si m++EL99 3 3F>>(++
3FNN74K4K
3**6222 3 3r( c |d D ]w}| j j | }| j j |g }|r| | |D ]}|j r
|r|d= ||d< d|_ xdS )a
Given::
direct internal
The "refname" attribute is replaced by "refid" linking to the target's
"id"::
direct internal
r rn r r
r5 N)r rV r7 rg rZ rB )r# r r% r
rl rH s r& rx z%InternalTargets.resolve_reference_idsx s " 7O ! !DM)--d33Em,00r::G
5))t)444
!
!< )I#(CL
! ! !r( N)r* r+ r, r. r' rx r/ r( r& rv rv o s8 3 3 3
! ! ! ! !r( rv c H e Zd ZdZdZdZ g dZd Zd Zd Z d Z
d Z d
Z dS ) Footnotesa
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.