-Ph< > d Z ddlmZ ddlmZmZ ddlmZ ddlm Z
ddlm Z ddl m
Z
ddlmZmZ dd lmZ dd
lmZ dd lmZ dd lmZ erdd
lmZ ddlmZ ddl m Z ddl m Z ej e! Z" G d de Z# G d d Z$ G d dee
Z%dS )z5Manual page writer, extended for Sphinx custom nodes. ) annotations)
TYPE_CHECKINGcast)nodes)
Translator)Writer)addnodes)_admonitionlabels)logging)SphinxTranslator) format_date) NodeMatcher)Iterable)Any)Element)Builderc ( e Zd Zd fd ZddZ xZS ) ManualPageWriterbuilderr returnNonec V t || _ d S N)super__init__r )selfr __class__s V/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/writers/manpage.pyr zManualPageWriter.__init__ s$
c : t | j }| | j | j | j }t d| | _ | j | | j | _ d S )NManualPageTranslator)
NestedInlineTransformdocumentapplyr create_translatorr visitor walkaboutastextoutput)r transformr' s r translatezManualPageWriter.translate" s} )$-88 ,00 MM 2G<<
(((l))++ r )r r r r )r r )__name__
__module__ __qualname__r r,
__classcell__r s @r r r sQ , , , , , , , ,r r c " e Zd ZdZd dZd d Zd
S )
r# zFlatten nested inline nodes:
Before:
foo=1
&bar=2
After:
foo=var
&bar=2
r$ nodes.documentr r c || _ d S r )r$ )r r$ s r r z NestedInlineTransform.__init__6 s
r kwargsr c t t j t j t j t | j D ]}t fd|D r|j
| }t t | D ]t}| | | r |j
|dz | A |j dd|fi |j }|j
|dz | ut! | s|j | d S )Nc 3 . K | ]} | V d S r ).0subnodematchers r z.NestedInlineTransform.apply..< s- 88777##888888r )r r literalemphasisstronglistfindallr$ anyparentindexreversedremoveinsertr
attributeslen)r r5 nodeposr: newnoder; s @r r% zNestedInlineTransform.apply9 sF emU^U\JJ 7788 - -D8888488888
-k''-- 'T
3 3 = =GKK((( ww'' = **37G<<<<"0$.R"T"TDO"T"T **37G<<<<4yy -K&&t,,, - -r N)r$ r3 r r )r5 r r r )r- r. r/ __doc__r r% r8 r r r# r# + sF ! ! ! !- - - - - -r r# c e Zd ZU dZi Zded< de fd
Zdfd ZdgdZdgdZ dgdZ
dgdZ dgdZ dgdZ
dgdZdgdZdgdZdgdZdgdZdgdZdgdZdgd Zdgd Zdgd Zdgd Zdgd Zdgd!Zdgd"Zdgd#Z dgd$Z dgd%Z dgd&Z dgd'Z dgd(Z!dgd)Z"dgd*Z#dgd+Z$dgd,Z%dgd-Z&dgd.Z'dgd/Z(dgd0Z)dg fd1 Z*dgd2Z+dg fd3 Z,dgd4Z-dgd5Z.dgd6Z/dgd7Z0dgd8Z1dgd9Z2dgd:Z3dgd;Z4dgd<Z5dgd=Z6dgd>Z7dgd?Z8dgd@Z9dgdAZ:dgdBZ;dgdCZdgdFZ?dgdGZ@dgdHZAdgdIZBdgdJZCdgdKZDdgdLZEdgdMZFdgdNZGdgdOZHdgdPZIdgdQZJdgdRZKdgdSZLdgdTZMdgdUZNdgdVZOdg fdW ZPdg fdX ZQdg fdY ZRdg fdZ ZSdgd[ZTdgd\ZUdgd]ZVdgd^ZWdhd`ZXdhdaZYdidcZZdiddZ[ xZ\S )jr" zCustom man page translator.zdict[str, Any]_docinfor$ r3 r r r r c t || d| _ | j j | j d< | j j | j d< | j j r| j j | j d< | j j | j d< | j d | j d< | j
j r| j
j | j d< n>| j
j pt d }t || j
j | j d< | j
j | j d
< | j
j | j d < | j
j | j d < t' j D ]'\ }}| | | j j |< (d S )
Ntitlesubtitleauthormanual_section title_upperdatez %b %d, %Y)language copyrightversion manual_group)r r
section_levelsettingsrT rQ rU authorssectionupperconfigtoday today_fmtr
r rZ r[ r\ projectr items deunicodelabels)r r$ r re label translationr s r r z ManualPageTranslator.__init__O sw
7+++ "& !4
g $(M$:
j! = <&*m&;DM( #*.-*?
&' (,}W'='C'C'E'E
m$ ; $(K$5DM& ! ! -?; I$/DK$8% % %DM& ! &*[%:
k"#';#6
i (, (;
n% #3"8":": F F E;*...*E*EDM ' ' F Fr strc > d}| j d r|dz
}|| j z S )NzW.TH "%(title_upper)s" "%(manual_section)s" "%(date)s" "%(version)s" "%(manual_group)s"
rU z#.SH NAME
%(title)s \- %(subtitle)s
)rQ )r tmpls r headerzManualPageTranslator.headero s5
=
= $ = < r rq s r visit_desc_returnsz'ManualPageTranslator.visit_desc_returns s r c d S r r8 rq s r depart_desc_returnsz(ManualPageTranslator.depart_desc_returns rs r c H | j d d| _ d S )N(r= r r first_paramrq s r visit_desc_parameterlistz-ManualPageTranslator.visit_desc_parameterlist & r c : | j d d S )N)r rq s r depart_desc_parameterlistz.ManualPageTranslator.depart_desc_parameterlist r r c H | j d d| _ d S )N[r= r rq s r visit_desc_type_parameter_listz3ManualPageTranslator.visit_desc_type_parameter_list r r c : | j d d S N]r rq s r depart_desc_type_parameter_listz4ManualPageTranslator.depart_desc_type_parameter_list r r c Z | j s | j d d S d| _ d S )N, r )r r r rq s r visit_desc_parameterz)ManualPageTranslator.visit_desc_parameter s7 ! I T " " " " " D r c d S r r8 rq s r depart_desc_parameterz*ManualPageTranslator.depart_desc_parameter rs r c 0 | | d S r )r rq s r visit_desc_type_parameterz.ManualPageTranslator.visit_desc_type_parameter s !!$'''''r c 0 | | d S r )r rq s r depart_desc_type_parameterz/ManualPageTranslator.depart_desc_type_parameter ry r c : | j d d S )Nr r rq s r visit_desc_optionalz(ManualPageTranslator.visit_desc_optional r r c : | j d d S r r rq s r depart_desc_optionalz)ManualPageTranslator.depart_desc_optional r r c d S r r8 rq s r visit_desc_annotationz*ManualPageTranslator.visit_desc_annotation rs r c d S r r8 rq s r depart_desc_annotationz+ManualPageTranslator.depart_desc_annotation rs r c 0 | | d S r )visit_paragraphrq s r visit_versionmodifiedz*ManualPageTranslator.visit_versionmodified T"""""r c 0 | | d S r )depart_paragraphrq s r depart_versionmodifiedz+ManualPageTranslator.depart_versionmodified r r c t | t j r | j d d S t
| d S N
)rD rC r rA r r r r r rL r s r r z ManualPageTranslator.visit_term s[ t||EL)) * * % I T " " " " " GG t $ $ $ $ $r c t j r r SkipNoderq s r
visit_commentz"ManualPageTranslator.visit_comment
n r c r | t | d S r )
ensure_eolr visit_footnoter s r r z#ManualPageTranslator.visit_footnote s1
t$$$$$r c | t | dk r| dt d hv rc| j d| | z dz t j | j d d S )Nr= Footnotes.SH r .sp
)
r rK r) r
r r rh rb r r rq s r visit_rubricz!ManualPageTranslator.visit_rubric s t99>>dkkmm Q{^^/L L L I VdnnT[[]]&C&C&I&I&K&K Kd R S S S. !!!!!r c : | j d d S r r rq s r
depart_rubricz"ManualPageTranslator.depart_rubric s r c 2 | |d d S )Nseealso)visit_admonitionrq s r
visit_seealsoz"ManualPageTranslator.visit_seealso s dI.....r c 0 | | d S r )depart_admonitionrq s r depart_seealsoz#ManualPageTranslator.depart_seealso r r c b | | j d d S )Nz.sp
.nf
r r r rq s r visit_productionlistz)ManualPageTranslator.visit_productionlist . &&&&&r c : | j d d S )Nz
.fi
r rq s r depart_productionlistz*ManualPageTranslator.depart_productionlist s #####r c d S r r8 rq s r visit_productionz%ManualPageTranslator.visit_production rs r c d S r r8 rq s r depart_productionz&ManualPageTranslator.depart_production rs r c d|j v r3| j t d |d z dz | j t d dz t j )Naltz [image: %s]r z[image])rJ r r r
r r rq s r visit_imagez ManualPageTranslator.visit_image sd DO # # I Q} - -U ;d B C C C 9 ,---n r c | dd }| d }|r | j d| d | j | j d d | | | j | j d d |r| d sz| j j rn| |k rV| d
}| j
d | j d d || j d d d
g |r| j d t j )Nrefurir> )mailto:zhttp:zhttps:zftp:z
\X'tty: link ' referencer r= #r z z
\X'tty: link')
get
startswithr r defs
visit_Textrc
man_show_urlsr) removeprefixextendr r )r rL uriis_safe_to_clicks r visit_referencez$ManualPageTranslator.visit_reference& sf hhx$$ >>*PQQ 6 I 4c 4 4 4 5 5 5 ;/2333
;/2333
s~~c**
{(
T[[]]c-A-A&&y11 Ih'*Ih'* " / I - . . .n r c t j | dd }| | t j )NrT r )r Textr r r )r rL texts r visit_number_referencez+ManualPageTranslator.visit_number_referenceC s9 z$((7C0011 n r c b | | j d d S )Nz.sp
.ce
r rq s r visit_centeredz#ManualPageTranslator.visit_centeredH r r c : | j d d S )Nz
.ce 0
r rq s r depart_centeredz$ManualPageTranslator.depart_centeredL s %%%%%r c d S r r8 rq s r visit_compact_paragraphz,ManualPageTranslator.visit_compact_paragraphO rs r c d S r r8 rq s r depart_compact_paragraphz-ManualPageTranslator.depart_compact_paragraphR rs r c d S r r8 rq s r visit_download_referencez-ManualPageTranslator.visit_download_referenceU rs r c d S r r8 rq s r depart_download_referencez.ManualPageTranslator.depart_download_referenceX rs r c t j r r rq s r
visit_toctreez"ManualPageTranslator.visit_toctree[ r r c t j r r rq s r visit_indexz ManualPageTranslator.visit_index^ r r c t j r r rq s r visit_tabular_col_specz+ManualPageTranslator.visit_tabular_col_speca r r c d S r r8 rq s r visit_glossaryz#ManualPageTranslator.visit_glossaryd rs r c d S r r8 rq s r depart_glossaryz$ManualPageTranslator.depart_glossaryg rs r c t d|d }t d| }| t d|d }t d| }| j d d |D dz | j d t
j )Nznodes.bullet_listr zIterable[nodes.list_item]r c 3 > K | ]}| V d S r )r) )r9 ns r r< z2ManualPageTranslator.visit_acks..p s* "B"B!188::"B"B"B"B"B"Br .r )r r r r joinr r )r rL bullet_list
list_itemss r
visit_acksz ManualPageTranslator.visit_acksj s .Q88 5{CC
.Q88 5{CC
"B"Bz"B"B"BBBSHIII n r c 0 | | d S r )visit_bullet_listrq s r visit_hlistz ManualPageTranslator.visit_hlistt r r c 0 | | d S r )depart_bullet_listrq s r depart_hlistz!ManualPageTranslator.depart_hlistw s %%%%%r c d S r r8 rq s r visit_hlistcolz#ManualPageTranslator.visit_hlistcolz rs r c d S r r8 rq s r depart_hlistcolz$ManualPageTranslator.depart_hlistcol} rs r c , | | S r )visit_emphasisrq s r visit_literal_emphasisz+ManualPageTranslator.visit_literal_emphasis s ""4(((r c , | | S r )depart_emphasisrq s r depart_literal_emphasisz,ManualPageTranslator.depart_literal_emphasis s ##D)))r c , | | S r visit_strongrq s r visit_literal_strongz)ManualPageTranslator.visit_literal_strong &&&r c , | | S r
depart_strongrq s r depart_literal_strongz*ManualPageTranslator.depart_literal_strong !!$'''r c d S r r8 rq s r visit_abbreviationz'ManualPageTranslator.visit_abbreviation rs r c d S r r8 rq s r depart_abbreviationz(ManualPageTranslator.depart_abbreviation rs r c , | | S r r< rq s r
visit_manpagez"ManualPageTranslator.visit_manpage r? r c , | | S r rA rq s r depart_manpagez#ManualPageTranslator.depart_manpage rD r c t |j t j r6|j d r | j d d S t | d S )N
literal_blockr )
isinstancerE r containerr r r r
visit_captionr s r rQ z"ManualPageTranslator.visit_caption sk t{EO 4 4 ( 00 (
I W % % % % % GG ! !$ ' ' ' ' 'r c t |j t j r6|j d r | j d d S t | d S )NrN r ) rO rE r rP r r r r depart_captionr s r rS z#ManualPageTranslator.depart_caption sk t{EO 4 4 ) 00 )
I T " " " " " GG " "4 ( ( ( ( (r c t |j t j r | j d d S t |j t j r| j dk r t j | j dk ra| j d|
| d t j t | S )Nz.IP "r r= r r )rO rE r r r r r ra r^ r rh r) rb r visit_titler s r rU z ManualPageTranslator.visit_title s dk8#3 4 4 % I W % % %4
U]
3
3 %!Q&&n$#q(( !Qt{{}}7J7J7L7L(M(M!Q!Q!QRRRn$ww""4(((r c t |j t j r | j d d S t
| S )Nz"
)rO rE r r r r r depart_titler s r rW z!ManualPageTranslator.depart_title sM dk8#3 4 4 I U # # #4ww##D)))r c d| dd v r,| j | t
j )Nmanpageformatr> )r splitr r r) r r rq s r visit_rawz ManualPageTranslator.visit_raw sM 2..4466 6 6 I T[[]] + + +n r c t j r r rq s r
visit_metaz ManualPageTranslator.visit_meta r r c d S r r8 rq s r visit_inlinez!ManualPageTranslator.visit_inline rs r c d S r r8 rq s r
depart_inlinez"ManualPageTranslator.depart_inline rs r
nodes.mathc d S r r8 rq s r
visit_mathz ManualPageTranslator.visit_math rs r c d S r r8 rq s r depart_mathz ManualPageTranslator.depart_math rs r nodes.math_blockc 0 | | d S r )r rq s r visit_math_blockz%ManualPageTranslator.visit_math_block s D!!!!!r c 0 | | d S r )r rq s r depart_math_blockz&ManualPageTranslator.depart_math_block r r )r$ r3 r r r r )r rl )rL r r r )rL rc r r )rL rh r r )]r- r. r/ rO rQ __annotations__r ro rr ru rx 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 r r" r* r- r0 r2 r4 r7 r: r> rC rF rH rJ rL rQ rS rU rW r\ r^ r` rb re rg rj rl r0 r1 s @r r" r" J s= %% !H!!!! F F F F F F@$ $ $ $
) ) ) )* * * *
$ $ $ $% % % %
! ! ! !
! ! ! !
( ( ( () ) ) )
# # # #$ $ $ $% % % % % % % % % % % %
" " " " / / / /% % % %' ' ' '$ $ $ $
:
' ' ' '& & & &
% % % %& & & &
) ) ) )* * * *' ' ' '( ( ( (
' ' ' '( ( ( (( ( ( ( ( () ) ) ) ) ) ) ) ) ) ) )* * * * * *
" " " "# # # # # # # #r r" N)&rO
__future__r typingr r docutilsr docutils.writers.manpager BaseTranslatorr sphinxr
sphinx.localer
r sphinx.utilr sphinx.util.docutilsr
sphinx.util.i18nr sphinx.util.nodesr collections.abcr r docutils.nodesr sphinx.buildersr getLoggerr- loggerr r# r" r8 r r r~ s ; ; " " " " " " & & & & & & & & A A A A A A + + + + + + - - - - - - - - 1 1 1 1 1 1 ( ( ( ( ( ( ) ) ) ) ) ) (((((((&&&&&&'''''' 8 $ $ , , , , ,v , , , - - - - - - - ->M# M# M# M# M#+^ M# M# M# M# M#r