| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/builders/latex/__pycache__/ |
Upload File : |
a
�ab�P � @ s� d Z ddlmZmZmZmZmZmZ ddlm Z ddl
m Z m Z ddl
mZ ddlmZ ddlmZ ddlmZmZmZmZmZ dd lmZ dd
lm Z dd l m Z dd l m Z d
Z!G dd� de �Z"G dd� de �Z#G dd� de �Z$G dd� de j%�Z&G dd� de �Z'G dd� de j%�Z(G dd� de �Z)G d d � d e �Z*G d d � d e �Z+G d d!� d!e �Z,G d"d#� d#e �Z-G d$d%� d%e �Z.eee/ef d&�d'd(�Z0d)S )*z�
sphinx.builders.latex.transforms
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Transforms for LaTeX builder.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�Any�Dict�List�Set�Tuple�cast)�nodes)�Element�Node)�
Substitutions)�addnodes)�Sphinx)�captioned_literal_block� footnotemark� footnotetext�math_reference�thebibliography)�CitationDomain)�SphinxTransform)�SphinxPostTransform)� NodeMatcher)�mailto:zhttp:zhttps:zftp:c @ s0 e Zd ZdZdZejejfZe dd�dd�Z
dS )�FootnoteDocnameUpdaterz5Add docname to footnote and footnote_reference nodes.i� N��kwargs�returnc K s, t | j� }| j�|�D ]}| jj|d< qd S )N�docname)r � TARGET_NODES�document�findall�envr )�selfr �matcher�node� r$ �D/usr/lib/python3.9/site-packages/sphinx/builders/latex/transforms.py�apply" s
z FootnoteDocnameUpdater.apply) �__name__�
__module__� __qualname__�__doc__�default_priorityr �footnote�footnote_referencer r r& r$ r$ r$ r% r s r c @ s. e Zd ZdZejd ZdZedd�dd�ZdS )� SubstitutionDefinitionsRemoverz4Remove ``substitution_definition node from doctrees.� �ZlatexNr c K s( t | j�tj��D ]}|j�|� qd S �N)�listr r r Zsubstitution_definition�parent�remove)r! r r# r$ r$ r% �run/ s z"SubstitutionDefinitionsRemover.run) r' r( r) r* r r+ �formatsr r5 r$ r$ r$ r% r. ( s
r. c @ sv e Zd ZdZdZdZdZedd�dd�Zdd �d
d �Z e
e d �d
d�Z e e e
ejejf d�dd�Zdd �dd�ZdS )�ShowUrlsTransformz�Expand references to inline text or footnotes.
For more information, see :confval:`latex_show_urls`.
.. note:: This transform is used for integrated doctree
� r0 FNr c K sB z4| j j}|j}d|_| �� | jr,| �� W ||_n||_0 d S )N� show_urls)r �settings� id_prefix�expand_show_urls�expanded�renumber_footnotes)r! r r: r; r$ r$ r% r5 A s
zShowUrlsTransform.run)r c C s� | j j}|du s|dkr d S t| j�tj��D ]�}|�dd�}|�t �r.|�d�r^|dd � }|�
� |kr.|j � |�}| �
|�}|dkr�| �||�\}}|j �|d |� |j �|d |� d
| _q.t�d | �}|j �|d |� q.d S ) NF�no�refuri� r � r, r/ � Tz (%s))ZconfigZlatex_show_urlsr2 r r r � reference�get�
startswith� URI_SCHEMES�astextr3 �index�get_docname_for_node�create_footnote�insertr= �Text) r! r9 r# �urirI r �fnZfnrefZtextnoder$ r$ r% r< O s$
z"ShowUrlsTransform.expand_show_urls�r# r c C s@ |r<t |tj�r | j�|d �S t |tj�r4|d S |j}q d S )N�sourcer )�
isinstancer r r Zpath2docr �
start_of_filer3 �r! r# r$ r$ r% rJ f s z&ShowUrlsTransform.get_docname_for_node)rN r r c C s� t jdt �|�|dd�}t j|d|d�}|d �d� |t �dd�7 }|t �dd|�7 }| j�|� t j dd|d d
|d �}|t �d�7 }| j�
|� |� |d d
� ||fS ) NrA T)r@ Z nolinkurlr/ )�autor �names�#z[#]_�idsr )rU �refidr ) r rD rM r, �append�labelZ paragraphr Znote_autofootnoter- Znote_autofootnote_refZ add_backref)r! rN r rD r, Z footnote_refr$ r$ r% rK q s � z!ShowUrlsTransform.create_footnotec C s� t | j�}| j�|� d}|jD ]�}|d7 }t|�|jvr$q>q$ttj|d �}|� t�dt|��� ||d v r�|d �
|� � � |d � t|�� |d }|j
D ]D}||d kr�|d d |d kr�|�
|d � |t�t|��7 }q�q d S )Nr r/ rA rV r rX rY )�FootnoteCollectorr � walkabout�auto_footnotes�str�used_footnote_numbersr r r[ � replace_selfr4 rH rZ �
footnote_refsrM )r! Z collectorZnumr, Z old_labelr �refr$ r$ r% r> � s"
z$ShowUrlsTransform.renumber_footnotes)r' r( r) r* r+ r6 r= r r5 r< r
r_ rJ r r r, r- rK r> r$ r$ r$ r% r7 4 s r7 c sn e Zd ZdZejdd�� fdd� Zedd�dd�Zedd�d d
�Z ej
dd�d d �Z ej dd�d
d�Z
� ZS )r\ z9Collect footnotes and footnote references on the documentN)r r c s$ g | _ t� | _g | _t� �|� d S r1 )r^ �setr` rb �super�__init__)r! r �� __class__r$ r% rf � s zFootnoteCollector.__init__rP c C s d S r1 r$ rT r$ r$ r% �
unknown_visit� s z FootnoteCollector.unknown_visitc C s d S r1 r$ rT r$ r$ r% �unknown_departure� s z#FootnoteCollector.unknown_departurec C s6 |� d�r| j�|� n|d D ]}| j�|� q d S )NrU rV )rE r^ rZ r` �add)r! r# �namer$ r$ r% �visit_footnote� s
z FootnoteCollector.visit_footnotec C s | j �|� d S r1 )rb rZ rT r$ r$ r% �visit_footnote_reference� s z*FootnoteCollector.visit_footnote_reference)r' r( r) r* r r rf r
ri rj r, rm r- rn �
__classcell__r$ r$ rg r% r\ � s r\ c @ s( e Zd ZdZdZdZedd�dd�ZdS )�LaTeXFootnoteTransformaT Convert footnote definitions and references to appropriate form to LaTeX.
* Replace footnotes on restricted zone (e.g. headings) by footnotemark node.
In addition, append a footnotetext node after the zone.
Before::
<section>
<title>
headings having footnotes
<footnote_reference>
1
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
After::
<section>
<title>
headings having footnotes
<footnotemark refid="id1">
1
<footnotetext ids="id1">
<label>
1
<paragraph>
footnote body
* Integrate footnote definitions and footnote references to single footnote node
Before::
blah blah blah
<footnote_reference refid="id1">
1
blah blah blah ...
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
After::
blah blah blah
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
blah blah blah ...
* Replace second and subsequent footnote references which refers same footnote definition
by footnotemark node.
Before::
blah blah blah
<footnote_reference refid="id1">
1
blah blah blah
<footnote_reference refid="id1">
1
blah blah blah ...
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
After::
blah blah blah
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
blah blah blah
<footnotemark refid="id1">
1
blah blah blah ...
* Remove unreferenced footnotes
Before::
<footnote ids="id1">
<label>
1
<paragraph>
Unreferenced footnote!
After::
<!-- nothing! -->
* Move footnotes in a title of table or thead to head of tbody
Before::
<table>
<title>
title having footnote_reference
<footnote_reference refid="id1">
1
<tgroup>
<thead>
<row>
<entry>
header having footnote_reference
<footnote_reference refid="id2">
2
<tbody>
<row>
...
<footnote ids="id1">
<label>
1
<paragraph>
footnote body
<footnote ids="id2">
<label>
2
<paragraph>
footnote body
After::
<table>
<title>
title having footnote_reference
<footnotemark refid="id1">
1
<tgroup>
<thead>
<row>
<entry>
header having footnote_reference
<footnotemark refid="id2">
2
<tbody>
<footnotetext ids="id1">
<label>
1
<paragraph>
footnote body
<footnotetext ids="id2">
<label>
2
<paragraph>
footnote body
<row>
...
iX r0 Nr c K sD t | j�tj��}|D ]}|j�|� qt| j|�}| j�|� d S r1 ) r2 r r r r, r3 r4 �LaTeXFootnoteVisitorr] )r! r � footnotesr# Zvisitorr$ r$ r% r5 ^ s
zLaTeXFootnoteTransform.run�r' r( r) r* r+ r6 r r5 r$ r$ r$ r% rp � s
%rp c s~ e Zd Zejeej dd�� fdd� Zedd�dd�Z edd�dd �Z
e dd�d
d �Z e dd�d d
�Z
ejdd�dd�Zejdd�dd�Zejdd�dd�Zejdd�dd�Zejdd�dd�Zejdd�dd�Zejdd�dd�Zejdd�d d �Zejdd�d d �Zejdd�d d!�Z ej dd�d"d#�Z ejdd�d$d%�Z ejdd�d&d'�Z ej!dd�d(d)�Z"ej!ejd�d*d+�Z#� Z$S ),rq N)r rr r c s0 t � | _|| _g | _g | _d | _t� �|� d S r1 )rd �appearedrr �pendings�table_footnotes�
restrictedre rf )r! r rr rg r$ r% rf h s z LaTeXFootnoteVisitor.__init__rP c C s d S r1 r$ rT r$ r$ r% ri p s z"LaTeXFootnoteVisitor.unknown_visitc C s d S r1 r$ rT r$ r$ r% rj s s z&LaTeXFootnoteVisitor.unknown_departurec C s | j d u r|| _ d S r1 )rw rT r$ r$ r% �restrictv s
z LaTeXFootnoteVisitor.restrictc C sl | j |krhd | _ |j�|�}t| j�D ]:\}}tdg|j�R d|d i�}|j�|| d |� q&g | _d S )NrA rX r/ )rw r3 rI � enumerateru r �childrenrL )r! r# �pos�ir, �fntextr$ r$ r% �
unrestrictz s
z LaTeXFootnoteVisitor.unrestrictc C s | � |� d S r1 �rx rT r$ r$ r% � visit_figure� s z!LaTeXFootnoteVisitor.visit_figurec C s | � |� d S r1 �r~ rT r$ r$ r% �
depart_figure� s z"LaTeXFootnoteVisitor.depart_figurec C s | � |� d S r1 r rT r$ r$ r% �
visit_term� s z LaTeXFootnoteVisitor.visit_termc C s | � |� d S r1 r� rT r$ r$ r% � depart_term� s z LaTeXFootnoteVisitor.depart_termc C s | � |� d S r1 r rT r$ r$ r% �
visit_caption� s z"LaTeXFootnoteVisitor.visit_captionc C s | � |� d S r1 r� rT r$ r$ r% �depart_caption� s z#LaTeXFootnoteVisitor.depart_captionc C s" t |jtjtjf�r | �|� d S r1 )rR r3 r �section�tablerx rT r$ r$ r% � visit_title� s z LaTeXFootnoteVisitor.visit_titlec C sL t |jtj�r| �|� n.t |jtj�rH| j| j7 _g | _| �|� d S r1 )rR r3 r r� r~ r� rv ru rT r$ r$ r% � depart_title� s z!LaTeXFootnoteVisitor.depart_titlec C s | � |� d S r1 r rT r$ r$ r% � visit_thead� s z LaTeXFootnoteVisitor.visit_theadc C s$ | j | j7 _ g | _| �|� d S r1 )rv ru r~ rT r$ r$ r% � depart_thead� s z!LaTeXFootnoteVisitor.depart_theadc C sR t |�tj��}t| j�D ],}tdg|j�R d|d i�}|�d|� qg | _d S )NrA rX r ) �nextr r �tbody�reversedrv r rz rL )r! r# r� r, r} r$ r$ r% � depart_table� s
z!LaTeXFootnoteVisitor.depart_tablec C s | � |� d S r1 r rT r$ r$ r% rm � s z#LaTeXFootnoteVisitor.visit_footnotec C s | � |� d S r1 r� rT r$ r$ r% �depart_footnote� s z$LaTeXFootnoteVisitor.depart_footnotec C s� |� � �� }|d }| jr\td||d d�}|�|� ||f| jvr�| �|�}| j�|� nV||f| jv r�td||d d�}|�|� n*| �|�}| j �
|� |�|� |� | � | j� ||f� t
j�d S )Nr rA rY )rY )rH �striprw r ra rt �get_footnote_by_referenceru rZ rr r4 r] rk r ZSkipNode)r! r# Znumberr Zmarkr, r$ r$ r% rn � s"
z-LaTeXFootnoteVisitor.visit_footnote_referencec C s@ |d }| j D ],}||d kr|d d |d kr| S qd S )Nr rX r rY )rr )r! r# r r, r$ r$ r% r� � s
z.LaTeXFootnoteVisitor.get_footnote_by_reference)%r' r( r) r r r r, rf r
ri rj r rx r~ Zfigurer� r� Ztermr� r� Zcaptionr� r� �titler� r� Ztheadr� r� r� r� rm r� r- rn r� ro r$ r$ rg r% rq g s( rq c @ s( e Zd ZdZdZdZedd�dd�ZdS )�BibliographyTransformaN Gather bibliography entries to tail of document.
Before::
<document>
<paragraph>
blah blah blah
<citation>
...
<paragraph>
blah blah blah
<citation>
...
...
After::
<document>
<paragraph>
blah blah blah
<paragraph>
blah blah blah
...
<thebibliography>
<citation>
...
<citation>
...
i� r0 Nr c K sP t � }t| j�tj��D ]}|j�|� ||7 }qt|�dkrL| j|7 _d S )Nr ) r r2 r r r �citationr3 r4 �len)r! r � citationsr# r$ r$ r% r5 � s
zBibliographyTransform.runrs r$ r$ r$ r% r� � s r� c @ s( e Zd ZdZdZdZedd�dd�ZdS )�CitationReferenceTransformz�Replace pending_xref nodes for citation by citation_reference.
To handle citation reference easily on LaTeX writer, this converts
pending_xref nodes to citation_reference.
� r0 Nr c K s| t t| j�d��}ttjddd�}| j�|�D ]H}|j �
|d d�\}}}|r.t j ddg|j
�R ||d��}|�|� q.d S )Nr� rc )� refdomain�reftype� reftarget)rA rA r rA )r Zrefname)r r r �
get_domainr r � pending_xrefr r r� rE r Zcitation_referencerz ra ) r! r �domainr" r# r Zlabelid�_Z citation_refr$ r$ r% r5 s �z CitationReferenceTransform.runrs r$ r$ r$ r% r� s r� c @ s( e Zd ZdZdZdZedd�dd�ZdS )�MathReferenceTransformz�Replace pending_xref nodes for math by math_reference.
To handle math reference easily on LaTeX writer, this converts pending_xref
nodes to math_reference.
r� r0 Nr c K sv | j �d�jd }| j�tj�D ]P}|d dkr |d dv r |�|d d�\}}|r td||d d �}|� |� q d S )
NZmathZobjectsr� r� )�eqZnumrefr� )NNrA )r �target)
r r� �datar r r r� rE r ra )r! r Z equationsr# r r� Zrefnoder$ r$ r% r5 s zMathReferenceTransform.runrs r$ r$ r$ r% r� s r� c @ s( e Zd ZdZdZdZedd�dd�ZdS )�LiteralBlockTransformzEReplace container nodes for literal_block by captioned_literal_block.r8 r0 Nr c K sH t tjdd�}| j�|�D ](}tdg|j�R i |j��}|�|� qd S )NT)Z
literal_blockrA ) r r � containerr r r rz Z
attributesra )r! r r" r# Znewnoder$ r$ r% r5 , s zLiteralBlockTransform.runrs r$ r$ r$ r% r� ' s r� c @ s( e Zd ZdZdZdZedd�dd�ZdS )�DocumentTargetTransformz5Add :doc label to the first section of each document.r8 r0 Nr c K s6 | j �tj�D ]"}|�tj�}|r|d �d� qd S )NrX z:doc)r r r rS Z next_noder r� rZ )r! r r# r� r$ r$ r% r5 8 s zDocumentTargetTransform.runrs r$ r$ r$ r% r� 3 s r� c @ s( e Zd ZdZdZdZedd�dd�ZdS )� IndexInSectionTitleTransforma� Move index nodes in section title to outside of the title.
LaTeX index macro is not compatible with some handling of section titles
such as uppercasing done on LaTeX side (cf. fncychap handling of ``\chapter``).
Moving the index node to after the title node fixes that.
Before::
<section>
<title>
blah blah <index entries=[...]/>blah
<paragraph>
blah blah blah
...
After::
<section>
<title>
blah blah blah
<index entries=[...]/>
<paragraph>
blah blah blah
...
r8 r0 Nr c K s` t | j�tj��D ]H}t|jtj�rt|�t j
��D ]$\}}|� |� |j� |d |� q4qd S )Nr/ )
r2 r r r r� rR r3 r� ry r rI r4 rL )r! r r# r| rI r$ r$ r% r5 \ s
z IndexInSectionTitleTransform.runrs r$ r$ r$ r% r� ? s r� )�appr c C sp | � t� | �t� | �t� | �t� | �t� | �t� | �t� | �t � | �t
� | �t � dddd�S )NZbuiltinT)�versionZparallel_read_safeZparallel_write_safe) Z
add_transformr Zadd_post_transformr. r� r� r� r� rp r� r� r7 )r� r$ r$ r% �setupe s
�r� N)1r* �typingr r r r r r Zdocutilsr Zdocutils.nodesr r
Z docutils.transforms.referencesr Zsphinxr Zsphinx.applicationr
Zsphinx.builders.latex.nodesr r r r r Zsphinx.domains.citationr Zsphinx.transformsr Z!sphinx.transforms.post_transformsr Zsphinx.util.nodesr rG r r. r7 Z NodeVisitorr\ rp rq r� r� r� r� r� r� r_ r� r$ r$ r$ r% �<module> s4
h 2n+ &