| 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 Z ddlmZmZmZmZ ddlmZ ddlm Z m
Z
ddl m Z
ddl mZ ddlmZ ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
l m Z e� e �Z G dd� de�Z!G dd� d�Z"G dd� dee
�Z#dS )z�
sphinx.writers.manpage
~~~~~~~~~~~~~~~~~~~~~~
Manual page writer, extended for Sphinx custom nodes.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�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 @ s2 e Zd ZdZejdd�dd�Zedd�dd�ZdS ) r a
Flatten nested inline nodes:
Before:
<strong>foo=<emphasis>1</emphasis>
&bar=<emphasis>2</emphasis></strong>
After:
<strong>foo=</strong><emphasis>var</emphasis>
<strong>&bar=</strong><emphasis>2</emphasis>
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* �__doc__r r r r r! r r r r r + s
r c sX e Zd ZU dZi Zeeef ed< e j
e dd�� fdd� Z ed�dd �Z
edd
�d d �Zedd
�d
d�Zedd
�dd�Zedd
�dd�Zedd
�dd�Zedd
�dd�Zedd
�dd�Zedd
�dd�Zedd
�dd �Zedd
�d d �Zedd
�d d �Zedd
�d!d"�Zedd
�d#d$�Zedd
�d%d&�Z edd
�d'd(�Z edd
�d)d*�Z edd
�d+d,�Z edd
�d-d.�Z edd
�d/d0�Z!edd
�d1d2�Z"edd
�d3d4�Z#edd
�d5d6�Z$edd
�d7d8�Z%edd
�d9d:�Z&edd
�d;d<�Z'edd
�d=d>�Z(edd
�d?d@�Z)edd
�dAdB�Z*edd
�dCdD�Z+edd
�dEdF�Z,edd
�� fdGdH� Z-edd
�dIdJ�Z.edd
�� fdKdL� Z/edd
�dMdN�Z0edd
�dOdP�Z1edd
�dQdR�Z2edd
�dSdT�Z3edd
�dUdV�Z4edd
�dWdX�Z5edd
�dYdZ�Z6edd
�d[d\�Z7edd
�d]d^�Z8edd
�d_d`�Z9edd
�dadb�Z:edd
�dcdd�Z;edd
�dedf�Z<edd
�dgdh�Z=edd
�didj�Z>edd
�dkdl�Z?edd
�dmdn�Z@edd
�dodp�ZAedd
�dqdr�ZBedd
�dsdt�ZCedd
�dudv�ZDedd
�dwdx�ZEedd
�dydz�ZFedd
�d{d|�ZGedd
�d}d~�ZHedd
�dd��ZIedd
�d�d��ZJedd
�d�d��ZKedd
�d�d��ZLedd
�d�d��ZMedd
�d�d��ZNedd
�d�d��ZOedd
�d�d��ZPedd
�d�d��ZQedd
�� fd�d�� ZRedd
�� fd�d�� ZSedd
�� fd�d�� ZTedd
�� fd�d�� ZUedd
�d�d��ZVedd
�d�d��ZWedd
�d�d��ZXedd
�d�d��ZYedd
�d�d��ZZedd
�d�d��Z[edd
�d�d��Z\edd
�d�d��Z]� Z^S )�r" z%
Custom man page translator.
�_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_levelZsettingsrE rC rF Zauthors�section�upper�configZtodayr Z today_fmtr
rH rI rJ 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"
rF z#.SH NAME
%(title)s \- %(subtitle)s
)rC )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 rU r r r �depart_start_of_file| s z)ManualPageTranslator.depart_start_of_filec C s | � |� d S r )Zvisit_definition_listrU r r r �
visit_desc� s z ManualPageTranslator.visit_descc C s | � |� d S r )Zdepart_definition_listrU r r r � depart_desc� s z ManualPageTranslator.depart_descc C s | � |� | �|� d S r )Zvisit_definition_list_item�
visit_termrU r r r �visit_desc_signature� s
z)ManualPageTranslator.visit_desc_signaturec C s | � |� d S r )Z depart_termrU r r r �depart_desc_signature� s z*ManualPageTranslator.depart_desc_signaturec C s d S r r rU r r r �visit_desc_signature_line� s z.ManualPageTranslator.visit_desc_signature_linec C s | j �d� d S )N� ��body�appendrU r r r �depart_desc_signature_line� s z/ManualPageTranslator.depart_desc_signature_linec C s | � |� d S r )Zvisit_definitionrU r r r �visit_desc_content� s z'ManualPageTranslator.visit_desc_contentc C s | � |� d S r )Zdepart_definitionrU r r r �depart_desc_content� s z(ManualPageTranslator.depart_desc_contentc C s d S r r rU r r r �visit_desc_inline� s z&ManualPageTranslator.visit_desc_inlinec C s d S r r rU r r r �depart_desc_inline� s z'ManualPageTranslator.depart_desc_inlinec C s d S r r rU r r r �visit_desc_name� s z$ManualPageTranslator.visit_desc_namec C s d S r r rU r r r �depart_desc_name� s z%ManualPageTranslator.depart_desc_namec C s d S r r rU r r r �visit_desc_addname� s z'ManualPageTranslator.visit_desc_addnamec C s d S r r rU r r r �depart_desc_addname� s z(ManualPageTranslator.depart_desc_addnamec C s d S r r rU r r r �visit_desc_type� s z$ManualPageTranslator.visit_desc_typec C s d S r r rU r r r �depart_desc_type� s z%ManualPageTranslator.depart_desc_typec C s | j �d� d S )Nz -> r_ rU r r r �visit_desc_returns� s z'ManualPageTranslator.visit_desc_returnsc C s d S r r rU r r r �depart_desc_returns� s z(ManualPageTranslator.depart_desc_returnsc C s | j �d� d| _d S )N�(r2 )r` ra � first_paramrU r r r �visit_desc_parameterlist� s z-ManualPageTranslator.visit_desc_parameterlistc C s | j �d� d S )N�)r_ rU r r r �depart_desc_parameterlist� s z.ManualPageTranslator.depart_desc_parameterlistc C s | j s| j�d� nd| _ d S )N�, r )rp r` ra rU r r r �visit_desc_parameter� s z)ManualPageTranslator.visit_desc_parameterc C s d S r r rU r r r �depart_desc_parameter� s z*ManualPageTranslator.depart_desc_parameterc C s | j �d� d S )N�[r_ rU r r r �visit_desc_optional� s z(ManualPageTranslator.visit_desc_optionalc C s | j �d� d S )N�]r_ rU r r r �depart_desc_optional� s z)ManualPageTranslator.depart_desc_optionalc C s d S r r rU r r r �visit_desc_annotation� s z*ManualPageTranslator.visit_desc_annotationc C s d S r r rU r r r �depart_desc_annotation� s z+ManualPageTranslator.depart_desc_annotationc C s | � |� d S r )Zvisit_paragraphrU r r r �visit_versionmodified� s z*ManualPageTranslator.visit_versionmodifiedc C s | � |� d S r )Zdepart_paragraphrU 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` ra r rZ rU r r r rZ � s z ManualPageTranslator.visit_termc C s
t j�d S r �r �SkipNoderU r r r �
visit_comment� s z"ManualPageTranslator.visit_commentc s | � � t� �|� d S r )�
ensure_eolr �visit_footnoterU 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` ra rQ rN r r� rU r r r � visit_rubric� s
"z!ManualPageTranslator.visit_rubricc C s | j �d� d S r r_ rU r r r �
depart_rubric� s z"ManualPageTranslator.depart_rubricc C s | � |d� d S )N�seealso)Zvisit_admonitionrU r r r �
visit_seealso s z"ManualPageTranslator.visit_seealsoc C s | � |� d S r )Zdepart_admonitionrU 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� rK r` ra r r r �
production�max�ljust�defsrQ r? r$ r r� )r r@ �namesZproductionlistr� �maxlenZlastnamer r r �visit_productionlist s.
z)ManualPageTranslator.visit_productionlistc C s d S r r rU r r r �visit_production s z%ManualPageTranslator.visit_productionc C s d S r r rU 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` ra r
r r� rU 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` ra r� �
visit_Text�get�
startswithrO 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 )NrE �#)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` ra rU r r r �visit_centeredF s z#ManualPageTranslator.visit_centeredc C s | j �d� d S )Nz
.ce 0
r_ rU r r r �depart_centeredJ s z$ManualPageTranslator.depart_centeredc C s d S r r rU r r r �visit_compact_paragraphM s z,ManualPageTranslator.visit_compact_paragraphc C s d S r r rU r r r �depart_compact_paragraphP s z-ManualPageTranslator.depart_compact_paragraphc C s d S r r rU r r r �visit_download_referenceS s z-ManualPageTranslator.visit_download_referencec C s d S r r rU r r r �depart_download_referenceV s z.ManualPageTranslator.depart_download_referencec C s
t j�d S r r� rU r r r �
visit_toctreeY s z"ManualPageTranslator.visit_toctreec C s
t j�d S r r� rU r r r � visit_index\ s z ManualPageTranslator.visit_indexc C s
t j�d S r r� rU r r r �visit_tabular_col_spec_ s z+ManualPageTranslator.visit_tabular_col_specc C s d S r r rU r r r �visit_glossaryb s z#ManualPageTranslator.visit_glossaryc C s d S r r rU 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 rt 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` ra �joinr� )r r@ r� Z
list_itemsr r r �
visit_acksh s z ManualPageTranslator.visit_acksc C s | � |� d S r )Zvisit_bullet_listrU r r r � visit_hlistr s z ManualPageTranslator.visit_hlistc C s | � |� d S r )Zdepart_bullet_listrU r r r � depart_hlistu s z!ManualPageTranslator.depart_hlistc C s d S r r rU r r r �visit_hlistcolx s z#ManualPageTranslator.visit_hlistcolc C s d S r r rU r r r �depart_hlistcol{ s z$ManualPageTranslator.depart_hlistcolc C s
| � |�S r )Zvisit_emphasisrU r r r �visit_literal_emphasis~ s z+ManualPageTranslator.visit_literal_emphasisc C s
| � |�S r )Zdepart_emphasisrU r r r �depart_literal_emphasis� s z,ManualPageTranslator.depart_literal_emphasisc C s
| � |�S r �Z visit_strongrU r r r �visit_literal_strong� s z)ManualPageTranslator.visit_literal_strongc C s
| � |�S r �Z
depart_strongrU r r r �depart_literal_strong� s z*ManualPageTranslator.depart_literal_strongc C s d S r r rU r r r �visit_abbreviation� s z'ManualPageTranslator.visit_abbreviationc C s d S r r rU r r r �depart_abbreviation� s z(ManualPageTranslator.depart_abbreviationc C s
| � |�S r r� rU r r r �
visit_manpage� s z"ManualPageTranslator.visit_manpagec C s
| � |�S r r� rU 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` ra r �
visit_captionrU 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` ra r �depart_captionrU 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` ra r rM rL r� rQ r% rN r � visit_titlerU 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` ra r � depart_titlerU r r r r� � s z!ManualPageTranslator.depart_titlec C s. d|� dd��� v r$| j�|�� � tj�d S )NZmanpage�formatr3 )r� �splitr` ra r% r r� rU r r r � visit_raw� s z ManualPageTranslator.visit_rawc C s
t j�d S r r� rU r r r �
visit_meta� s z ManualPageTranslator.visit_metac C s d S r r rU r r r � visit_inline� s z!ManualPageTranslator.visit_inlinec C s d S r r rU r r r �
depart_inline� s z"ManualPageTranslator.depart_inlinec C s d S r r rU r r r �
visit_math� s z ManualPageTranslator.visit_mathc C s d S r r rU r r r � depart_math� s z ManualPageTranslator.depart_mathc C s | � |� d S r )r� rU r r r �visit_math_block� s z%ManualPageTranslator.visit_math_blockc C s | � |� d S r )r� rU r r r �depart_math_block� s z&ManualPageTranslator.depart_math_block)_r( r) r* rB rC r �strr �__annotations__r r r r rT r rV rW rX rY r[ r\ r] rb rc rd re rf rg rh ri rj rk rl rm rn rq rs ru rv rx rz r{ r| r} r~ rZ 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)$rB �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