| 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/writers/__pycache__/ |
Upload File : |
a
�abT= � @ s� d dl mZmZmZmZ d dlmZ d dlmZm Z d dl
m Z d dl
m
Z
d dlmZ d dlmZ d dlmZmZ d d lmZ d d
lmZ d d lmZ d d lm Z e� e �Z G d
d� de
�Z G dd� d�Z!G dd� dee �Z"dS )� )�Any�Dict�Iterable�cast)�nodes)�Element� TextElement)�
Translator)�Writer)�addnodes)�Builder)�_�admonitionlabels)�logging)�SphinxTranslator)� format_date)� NodeMatcherc s2 e Zd Zedd�� fdd� Zdd�dd�Z� ZS )�ManualPageWriterN)�builder�returnc s t � �� || _d S �N)�super�__init__r )�selfr �� __class__� �:/usr/lib/python3.9/site-packages/sphinx/writers/manpage.pyr s
zManualPageWriter.__init__�r c C sL t | j�}|�� | j�| j| j�}tt|�| _| j�|� | j� � | _
d S r ) �NestedInlineTransform�document�applyr Zcreate_translatorr �ManualPageTranslator�visitor� walkabout�astext�output)r Z transformr# r r r � translate" s
zManualPageWriter.translate)�__name__�
__module__� __qualname__r r r' �
__classcell__r r r r r s r c @ s. e Zd Zejdd�dd�Zedd�dd�ZdS )r N)r r c C s
|| _ d S r )r )r r r r r r 6 s z NestedInlineTransform.__init__)�kwargsr c s� t tjtjtj�� t| j�� ��D ]�}t� fdd�|D ��r"|j �
|�}t t|��D ]T}|� |� � |�r~|j �
|d |� qT|jdd|fi |j��}|j �
|d |� qTt|�s"|j � |� q"d S )Nc 3 s | ]}� |�V qd S r r )�.0�subnode�Zmatcherr r � <genexpr>< � z.NestedInlineTransform.apply.<locals>.<genexpr>� � )r r �literalZemphasis�strong�listr �findall�any�parent�index�reversed�remove�insertr �
attributes�len)r r, �node�posr. Znewnoder r/ r r! 9 s
zNestedInlineTransform.apply)r( r) r* r r r r r! r r r r r + s r c sT e Zd ZU i Zeeef ed< ej e
dd�� fdd� Z ed�dd�Z e
dd �d
d �Ze
dd �d d
�Ze
dd �dd�Ze
dd �dd�Ze
dd �dd�Ze
dd �dd�Ze
dd �dd�Ze
dd �dd�Ze
dd �dd�Ze
dd �d d �Ze
dd �d d �Ze
dd �d d!�Ze
dd �d"d#�Ze
dd �d$d%�Ze
dd �d&d'�Z e
dd �d(d)�Z e
dd �d*d+�Z e
dd �d,d-�Z e
dd �d.d/�Z e
dd �d0d1�Z!e
dd �d2d3�Z"e
dd �d4d5�Z#e
dd �d6d7�Z$e
dd �d8d9�Z%e
dd �d:d;�Z&e
dd �d<d=�Z'e
dd �d>d?�Z(e
dd �d@dA�Z)e
dd �dBdC�Z*e
dd �dDdE�Z+e
dd �� fdFdG� Z,e
dd �dHdI�Z-e
dd �� fdJdK� Z.e
dd �dLdM�Z/e
dd �dNdO�Z0e
dd �dPdQ�Z1e
dd �dRdS�Z2e
dd �dTdU�Z3e
dd �dVdW�Z4e
dd �dXdY�Z5e
dd �dZd[�Z6e
dd �d\d]�Z7e
dd �d^d_�Z8e
dd �d`da�Z9e
dd �dbdc�Z:e
dd �ddde�Z;e
dd �dfdg�Z<e
dd �dhdi�Z=e
dd �djdk�Z>e
dd �dldm�Z?e
dd �dndo�Z@e
dd �dpdq�ZAe
dd �drds�ZBe
dd �dtdu�ZCe
dd �dvdw�ZDe
dd �dxdy�ZEe
dd �dzd{�ZFe
dd �d|d}�ZGe
dd �d~d�ZHe
dd �d�d��ZIe
dd �d�d��ZJe
dd �d�d��ZKe
dd �d�d��ZLe
dd �d�d��ZMe
dd �d�d��ZNe
dd �d�d��ZOe
dd �d�d��ZPe
dd �� fd�d�� ZQe
dd �� fd�d�� ZRe
dd �� fd�d�� ZSe
dd �� fd�d�� ZTe
dd �d�d��ZUe
dd �d�d��ZVe
dd �d�d��ZWe
dd �d�d��ZXe
dd �d�d��ZYe
dd �d�d��ZZe
dd �d�d��Z[e
dd �d�d��Z\� Z]S )�r" �_docinfoN)r r r c s� t � �||� d| _d| _| jj| jd< | jj| jd< | jjrL| jj| jd< | jj | jd< | jd �
� | jd< | j j r�| j j | jd< n"t
| j jp�td �| j jd
�| jd< | j j| jd < | j j| jd < | j j| jd
< t�� D ]\}}| �|�| jj|< q�d S )Nr ����title�subtitleZauthorZmanual_sectionZ title_upper�datez %b %d, %Y)�language� copyright�versionZ manual_group)r r �in_productionlist�
section_levelZsettingsrD rB rE Zauthors�section�upper�configZtodayr Z today_fmtr
rG rH rI Zprojectr �items� deunicode�labels)r r r Zlabel� translationr r r r Q s& � z ManualPageTranslator.__init__r c C s d}| j d r|d7 }|| j S )NzW.TH "%(title_upper)s" "%(manual_section)s" "%(date)s" "%(version)s" "%(manual_group)s"
rE z#.SH NAME
%(title)s \- %(subtitle)s
)rB )r Ztmplr r r �headerq s
zManualPageTranslator.header)r@ r c C s d S r r �r r@ r r r �visit_start_of_filey s z(ManualPageTranslator.visit_start_of_filec C s d S r r rT r r r �depart_start_of_file| s z)ManualPageTranslator.depart_start_of_filec C s | � |� d S r )Zvisit_definition_listrT r r r �
visit_desc� s z ManualPageTranslator.visit_descc C s | � |� d S r )Zdepart_definition_listrT r r r � depart_desc� s z ManualPageTranslator.depart_descc C s | � |� | �|� d S r )Zvisit_definition_list_item�
visit_termrT r r r �visit_desc_signature� s
z)ManualPageTranslator.visit_desc_signaturec C s | � |� d S r )Z depart_termrT r r r �depart_desc_signature� s z*ManualPageTranslator.depart_desc_signaturec C s d S r r rT r r r �visit_desc_signature_line� s z.ManualPageTranslator.visit_desc_signature_linec C s | j �d� d S )N� ��body�appendrT r r r �depart_desc_signature_line� s z/ManualPageTranslator.depart_desc_signature_linec C s | � |� d S r )Zvisit_definitionrT r r r �visit_desc_content� s z'ManualPageTranslator.visit_desc_contentc C s | � |� d S r )Zdepart_definitionrT r r r �depart_desc_content� s z(ManualPageTranslator.depart_desc_contentc C s d S r r rT r r r �visit_desc_inline� s z&ManualPageTranslator.visit_desc_inlinec C s d S r r rT r r r �depart_desc_inline� s z'ManualPageTranslator.depart_desc_inlinec C s d S r r rT r r r �visit_desc_name� s z$ManualPageTranslator.visit_desc_namec C s d S r r rT r r r �depart_desc_name� s z%ManualPageTranslator.depart_desc_namec C s d S r r rT r r r �visit_desc_addname� s z'ManualPageTranslator.visit_desc_addnamec C s d S r r rT r r r �depart_desc_addname� s z(ManualPageTranslator.depart_desc_addnamec C s d S r r rT r r r �visit_desc_type� s z$ManualPageTranslator.visit_desc_typec C s d S r r rT r r r �depart_desc_type� s z%ManualPageTranslator.depart_desc_typec C s | j �d� d S )Nz -> r^ rT r r r �visit_desc_returns� s z'ManualPageTranslator.visit_desc_returnsc C s d S r r rT r r r �depart_desc_returns� s z(ManualPageTranslator.depart_desc_returnsc C s | j �d� d| _d S )N�(r2 )r_ r` � first_paramrT r r r �visit_desc_parameterlist� s z-ManualPageTranslator.visit_desc_parameterlistc C s | j �d� d S )N�)r^ rT r r r �depart_desc_parameterlist� s z.ManualPageTranslator.depart_desc_parameterlistc C s | j s| j�d� nd| _ d S )N�, r )ro r_ r` rT r r r �visit_desc_parameter� s z)ManualPageTranslator.visit_desc_parameterc C s d S r r rT r r r �depart_desc_parameter� s z*ManualPageTranslator.depart_desc_parameterc C s | j �d� d S )N�[r^ rT r r r �visit_desc_optional� s z(ManualPageTranslator.visit_desc_optionalc C s | j �d� d S )N�]r^ rT r r r �depart_desc_optional� s z)ManualPageTranslator.depart_desc_optionalc C s d S r r rT r r r �visit_desc_annotation� s z*ManualPageTranslator.visit_desc_annotationc C s d S r r rT r r r �depart_desc_annotation� s z+ManualPageTranslator.depart_desc_annotationc C s | � |� d S r )Zvisit_paragraphrT r r r �visit_versionmodified� s z*ManualPageTranslator.visit_versionmodifiedc C s | � |� d S r )Zdepart_paragraphrT r r r �depart_versionmodified� s z+ManualPageTranslator.depart_versionmodifiedc s. t |�tj��r | j�d� n t� �|� d S �N�
)r8 r7 r r5 r_ r` r rY rT r r r rY � s z ManualPageTranslator.visit_termc C s
t j�d S r �r �SkipNoderT r r r �
visit_comment� s z"ManualPageTranslator.visit_commentc s | � � t� �|� d S r )�
ensure_eolr �visit_footnoterT r r r r� � s z#ManualPageTranslator.visit_footnotec C sb | � � t|�dkrR|�� dtd�fv rR| j�d| �|�� ��� d � tj �n | j�d� d S )Nr2 Z Footnotesz.SH r �.sp
)
r� r? r% r
r_ r` rP rM r r� rT r r r � visit_rubric� s
"z!ManualPageTranslator.visit_rubricc C s | j �d� d S r~ r^ rT r r r �
depart_rubric� s z"ManualPageTranslator.depart_rubricc C s | � |d� d S )N�seealso)Zvisit_admonitionrT r r r �
visit_seealso s z"ManualPageTranslator.visit_seealsoc C s | � |� d S r )Zdepart_admonitionrT r r r �depart_seealso s z#ManualPageTranslator.depart_seealsoc C s* | � � g }| jd7 _| j�d� tttj |�}|D ]}|�|d � q:tdd� |D ��}d }|D ]�}|d r�|d � |�}| j�| j
d d � | j�| � |�� | j�| j
d d � | j�d� n |d ur�| j�d d
t |� � |�
| � | j�d � qh| j�d � | jd8 _tj�d S )
Nr2 z.sp
.nf
Z tokennamec s s | ]}t |�V qd S r )r? )r- �namer r r r0 r1 z<ManualPageTranslator.visit_productionlist.<locals>.<genexpr>r5 r z ::= z%s r] r z
.fi
)r� rJ r_ r` r r r �
production�max�ljust�defsrP r? r$ r r� )r r@ �namesZproductionlistr� �maxlenZlastnamer r r �visit_productionlist s.
z)ManualPageTranslator.visit_productionlistc C s d S r r rT r r r �visit_production s z%ManualPageTranslator.visit_productionc C s d S r r rT r r r �depart_production" s z&ManualPageTranslator.depart_productionc C sD d|j v r&| j�td�|d d � | j�td�d � tj�d S )NZaltz [image: %s]r z[image])r> r_ r` r
r r� rT r r r � visit_image& s
z ManualPageTranslator.visit_imagec C s� | j �| jd d � | �|� | j �| jd d � |�dd�}|�d�sj|�d�sj|�d�sj|�d �r�| jjr�|�� |kr�|�d�r�|d
d � }| j � d | jd d || jd d d
g� t
j �d S )NZ referencer r2 Zrefurir3 zmailto:zhttp:zhttps:zftp:� z <r5 �>) r_ r` r� �
visit_Text�get�
startswithrN Z
man_show_urlsr% �extendr r� )r r@ Zurir r r �visit_reference- s$
��
�z$ManualPageTranslator.visit_referencec C s& t �|�dd��}| �|� t j�d S )NrD �#)r �Textr� r� r� )r r@ �textr r r �visit_number_referenceA s
z+ManualPageTranslator.visit_number_referencec C s | � � | j�d� d S )Nz.sp
.ce
)r� r_ r` rT r r r �visit_centeredF s z#ManualPageTranslator.visit_centeredc C s | j �d� d S )Nz
.ce 0
r^ rT r r r �depart_centeredJ s z$ManualPageTranslator.depart_centeredc C s d S r r rT r r r �visit_compact_paragraphM s z,ManualPageTranslator.visit_compact_paragraphc C s d S r r rT r r r �depart_compact_paragraphP s z-ManualPageTranslator.depart_compact_paragraphc C s d S r r rT r r r �visit_download_referenceS s z-ManualPageTranslator.visit_download_referencec C s d S r r rT r r r �depart_download_referenceV s z.ManualPageTranslator.depart_download_referencec C s
t j�d S r r� rT r r r �
visit_toctreeY s z"ManualPageTranslator.visit_toctreec C s
t j�d S r r� rT r r r � visit_index\ s z ManualPageTranslator.visit_indexc C s
t j�d S r r� rT r r r �visit_tabular_col_spec_ s z+ManualPageTranslator.visit_tabular_col_specc C s d S r r rT r r r �visit_glossaryb s z#ManualPageTranslator.visit_glossaryc C s d S r r rT r r r �depart_glossarye s z$ManualPageTranslator.depart_glossaryc C s~ t tj|d �}t ttj |�}| �� t tj|d �}t ttj |�}| j�d�dd� |D ��d � | j�d� tj �d S )Nr rs c s s | ]}|� � V qd S r )r% )r- �nr r r r0 n r1 z2ManualPageTranslator.visit_acks.<locals>.<genexpr>�.r )
r r � bullet_listr Z list_itemr� r_ r` �joinr� )r r@ r� Z
list_itemsr r r �
visit_acksh s z ManualPageTranslator.visit_acksc C s | � |� d S r )Zvisit_bullet_listrT r r r � visit_hlistr s z ManualPageTranslator.visit_hlistc C s | � |� d S r )Zdepart_bullet_listrT r r r � depart_hlistu s z!ManualPageTranslator.depart_hlistc C s d S r r rT r r r �visit_hlistcolx s z#ManualPageTranslator.visit_hlistcolc C s d S r r rT r r r �depart_hlistcol{ s z$ManualPageTranslator.depart_hlistcolc C s
| � |�S r )Zvisit_emphasisrT r r r �visit_literal_emphasis~ s z+ManualPageTranslator.visit_literal_emphasisc C s
| � |�S r )Zdepart_emphasisrT r r r �depart_literal_emphasis� s z,ManualPageTranslator.depart_literal_emphasisc C s
| � |�S r �Z visit_strongrT r r r �visit_literal_strong� s z)ManualPageTranslator.visit_literal_strongc C s
| � |�S r �Z
depart_strongrT r r r �depart_literal_strong� s z*ManualPageTranslator.depart_literal_strongc C s d S r r rT r r r �visit_abbreviation� s z'ManualPageTranslator.visit_abbreviationc C s d S r r rT r r r �depart_abbreviation� s z(ManualPageTranslator.depart_abbreviationc C s
| � |�S r r� rT r r r �
visit_manpage� s z"ManualPageTranslator.visit_manpagec C s
| � |�S r r� rT r r r �depart_manpage� s z#ManualPageTranslator.depart_manpagec s8 t |jtj�r(|j�d�r(| j�d� n t� �|� d S )N�
literal_blockr� ) �
isinstancer9 r � containerr� r_ r` r �
visit_captionrT r r r r� � s z"ManualPageTranslator.visit_captionc s8 t |jtj�r(|j�d�r(| j�d� n t� �|� d S )Nr� r ) r� r9 r r� r� r_ r` r �depart_captionrT r r r r� � s z#ManualPageTranslator.depart_captionc sx t |jtj�r | j�d� d S t |jtj�rl| jdkr>tj �n.| jdkrl| j�d| �
|� � � � � � tj �t
� �|�S )Nz.IP "r r2 z.SH %s
)r� r9 r r� r_ r` r rL rK r� rP r% rM r � visit_titlerT r r r r� � s
�z ManualPageTranslator.visit_titlec s* t |jtj�r | j�d� d S t� �|�S )Nz"
)r� r9 r r� r_ r` r � depart_titlerT r r r r� � s z!ManualPageTranslator.depart_titlec C s. d|� dd��� v r$| j�|�� � tj�d S )NZmanpage�formatr3 )r� �splitr_ r` r% r r� rT r r r � visit_raw� s z ManualPageTranslator.visit_rawc C s
t j�d S r r� rT r r r �
visit_meta� s z ManualPageTranslator.visit_metac C s d S r r rT r r r � visit_inline� s z!ManualPageTranslator.visit_inlinec C s d S r r rT r r r �
depart_inline� s z"ManualPageTranslator.depart_inlinec C s d S r r rT r r r �
visit_math� s z ManualPageTranslator.visit_mathc C s d S r r rT r r r � depart_math� s z ManualPageTranslator.depart_mathc C s | � |� d S r )r� rT r r r �visit_math_block� s z%ManualPageTranslator.visit_math_blockc C s | � |� d S r )r� rT r r r �depart_math_block� s z&ManualPageTranslator.depart_math_block)^r( r) r* rB r �strr �__annotations__r r r r rS r rU rV rW rX rZ r[ r\ ra rb rc rd re rf rg rh ri rj rk rl rm rp rr rt ru rw ry rz r{ r| r} rY r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r+ r r r r r" J s�
r" N)#�typingr r r r Zdocutilsr Zdocutils.nodesr r Zdocutils.writers.manpager ZBaseTranslatorr
Zsphinxr Zsphinx.buildersr Z
sphinx.localer
r Z sphinx.utilr Zsphinx.util.docutilsr Zsphinx.util.i18nr Zsphinx.util.nodesr Z getLoggerr( �loggerr r r" r r r r �<module> s