o
Ni? @ s d Z ddlmZ ddlmZ ddlmZmZmZ ddl m
Z
ddl m Z
ddl mZ ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lmZ er^ddl m Z ddl m Z e e!Z"G dd deZ#G dd dZ$G dd dee
Z%dS )z5Manual page writer, extended for Sphinx custom nodes. ) annotations)Iterable)
TYPE_CHECKINGAnycast)nodes)
Translator)Writer)addnodes)_admonitionlabels)logging)SphinxTranslator) format_date) NodeMatcher)Element)Builderc s( e Zd Zd fdd Zd
ddZ ZS ) ManualPageWriterbuilderr returnNonec s t || _d S N)super__init__r )selfr __class__ J/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/writers/manpage.pyr s
zManualPageWriter.__init__c C sL t | j}| | j| j| j}tt|| _| j| | j | _
d S r ) NestedInlineTransformdocumentapplyr create_translatorr ManualPageTranslatorvisitor walkaboutastextoutput)r transformr$ r r r translate s
zManualPageWriter.translate)r r r r )r r )__name__
__module__ __qualname__r r)
__classcell__r r r r r s r c @ s$ e Zd ZdZd
ddZdd
d Zd S )r a
Flatten nested inline nodes:
Before:
foo=1
&bar=2
After:
foo=var
&bar=2
r nodes.documentr r c C s
|| _ d S r )r )r r r r r r 5
z NestedInlineTransform.__init__kwargsr c s t tjtjtj t | jD ]N}t fdd|D r_|j
|}t t|D ]*}| | |r?|j
|d | q*|jdd|fi |j}|j
|d | q*t|s_|j | qd S )Nc 3 s | ]} |V qd S r r ).0subnodematcherr r ; z.NestedInlineTransform.apply.. )r r literalemphasisstronglistfindallr anyparentindexreversedremoveinsertr
attributeslen)r r0 nodeposr2 newnoder r3 r r! 8 s
zNestedInlineTransform.applyN)r r. r r )r0 r r r )r* r+ r, __doc__r r! r r r r r ) s
r c s e Zd ZU dZi Zded< d fd
d Zdd
dZdddZdddZ dddZ
dddZ dddZ ddd Z
dd d Zdd d Zdd!d"Zdd#d$Zdd%d&Zdd'd(Zdd)d*Zdd+d,Zdd-d.Zdd/d0Zdd1d2Zdd3d4Zdd5d6Zdd7d8Zdd9d:Z dd;d<Z dd=d>Z dd?d@Z ddAdBZ ddCdDZ!ddEdFZ"ddGdHZ#ddIdJZ$ddKdLZ%ddMdNZ&ddOdPZ'ddQdRZ(ddSdTZ)d fdUdV Z*ddWdXZ+d fdYdZ Z,dd[d\Z-dd]d^Z.dd_d`Z/ddadbZ0ddcddZ1ddedfZ2ddgdhZ3ddidjZ4ddkdlZ5ddmdnZ6ddodpZ7ddqdrZ8ddsdtZ9ddudvZ:ddwdxZ;ddydzZdddZ?dddZ@dddZAdddZBdddZCdddZDdddZEdddZFdddZGdddZHdddZIdddZJdddZKdddZLdddZMdddZNd fdd ZOd fdd ZPd fdd ZQd fdd ZRdddZSdddZTdddZUdddZVdddZWdddZXdddZYdddZZ Z[S )r# z%
Custom man page translator.
zdict[str, Any]_docinfor r. r r r r c s t || d| _d| _| jj| jd< | jj| jd< | jjr&| jj| jd< | jj | jd< | jd
| jd< | j j rC| j j | jd< n| j j
pJtd }t|| j jd
| jd< | j j| jd < | j j| jd < | j j| jd
< t D ]
\}}| || jj|< qod S )Nr titlesubtitleauthormanual_section title_upperdatez %b %d, %Y)language copyrightversion manual_group)r r in_productionlist
section_levelsettingsrL rJ rM authorssectionupperconfigtoday today_fmtr r rR rS rT projectr items deunicodelabels)r r r r^ label translationr r r r P s* z ManualPageTranslator.__init__strc C s d}| j d r |d7 }|| j S )NzW.TH "%(title_upper)s" "%(manual_section)s" "%(date)s" "%(version)s" "%(manual_group)s"
rM z#.SH NAME
%(title)s \- %(subtitle)s
)rJ )r tmplr r r headerr s
zManualPageTranslator.headerrF r c C d S r r r rF r r r visit_start_of_file{ z(ManualPageTranslator.visit_start_of_filec C rh r r ri r r r depart_start_of_file~ rk z)ManualPageTranslator.depart_start_of_filec C | | d S r )visit_definition_listri r r r
visit_desc z ManualPageTranslator.visit_descc C rm r )depart_definition_listri r r r depart_desc rp z ManualPageTranslator.depart_descc C s | | | | d S r )visit_definition_list_item
visit_termri r r r visit_desc_signature s
z)ManualPageTranslator.visit_desc_signaturec C rm r ) depart_termri r r r depart_desc_signature rp z*ManualPageTranslator.depart_desc_signaturec C rh r r ri r r r visit_desc_signature_line rk z.ManualPageTranslator.visit_desc_signature_linec C | j d d S )N bodyappendri r r r depart_desc_signature_line z/ManualPageTranslator.depart_desc_signature_linec C rm r )visit_definitionri r r r visit_desc_content rp z'ManualPageTranslator.visit_desc_contentc C rm r )depart_definitionri r r r depart_desc_content rp z(ManualPageTranslator.depart_desc_contentc C rh r r ri r r r visit_desc_inline rk z&ManualPageTranslator.visit_desc_inlinec C rh r r ri r r r depart_desc_inline rk z'ManualPageTranslator.depart_desc_inlinec C rh r r ri r r r visit_desc_name rk z$ManualPageTranslator.visit_desc_namec C rh r r ri r r r depart_desc_name rk z%ManualPageTranslator.depart_desc_namec C rh r r ri r r r visit_desc_addname rk z'ManualPageTranslator.visit_desc_addnamec C rh r r ri r r r depart_desc_addname rk z(ManualPageTranslator.depart_desc_addnamec C rh r r ri r r r visit_desc_type rk z$ManualPageTranslator.visit_desc_typec C rh r r ri r r r depart_desc_type rk z%ManualPageTranslator.depart_desc_typec C ry )Nz -> r{ ri r r r visit_desc_returns r z'ManualPageTranslator.visit_desc_returnsc C rh r r ri r r r depart_desc_returns rk z(ManualPageTranslator.depart_desc_returnsc C | j d d| _d S )N(r7 r| r} first_paramri r r r visit_desc_parameterlist
z-ManualPageTranslator.visit_desc_parameterlistc C ry )N)r{ ri r r r depart_desc_parameterlist r z.ManualPageTranslator.depart_desc_parameterlistc C r )N[r7 r ri r r r visit_desc_type_parameter_list r z3ManualPageTranslator.visit_desc_type_parameter_listc C ry N]r{ ri r r r depart_desc_type_parameter_list r z4ManualPageTranslator.depart_desc_type_parameter_listc C s | j s | jd d S d| _ d S )N, r )r r| r} ri r r r visit_desc_parameter s
z)ManualPageTranslator.visit_desc_parameterc C rh r r ri r r r depart_desc_parameter rk z*ManualPageTranslator.depart_desc_parameterc C rm r )r ri r r r visit_desc_type_parameter rp z.ManualPageTranslator.visit_desc_type_parameterc C rm r )r ri r r r depart_desc_type_parameter rp z/ManualPageTranslator.depart_desc_type_parameterc C ry )Nr r{ ri r r r visit_desc_optional r z(ManualPageTranslator.visit_desc_optionalc C ry r r{ ri r r r depart_desc_optional r z)ManualPageTranslator.depart_desc_optionalc C rh r r ri r r r visit_desc_annotation rk z*ManualPageTranslator.visit_desc_annotationc C rh r r ri r r r depart_desc_annotation rk z+ManualPageTranslator.depart_desc_annotationc C rm r )visit_paragraphri r r r visit_versionmodified rp z*ManualPageTranslator.visit_versionmodifiedc C rm r )depart_paragraphri r r r depart_versionmodified rp z+ManualPageTranslator.depart_versionmodifiedc s0 t |tjr| jd d S t | d S N
)r> r= r r; r| r} r rt ri r r r rt s z ManualPageTranslator.visit_termc C t jr r SkipNoderi r r r
visit_comment z"ManualPageTranslator.visit_commentc s | t | d S r )
ensure_eolr visit_footnoteri r r r r z#ManualPageTranslator.visit_footnotec C s` | t|dkr(| dtdfv r(| jd| | d tj | jd d S )Nr7 Footnotes.SH r .sp
)
r rE r& r r| r} ra r[ r r ri r r r visit_rubric s
"z!ManualPageTranslator.visit_rubricc C ry r r{ ri r r r
depart_rubric r z"ManualPageTranslator.depart_rubricc C s | |d d S )Nseealso)visit_admonitionri r r r
visit_seealso r z"ManualPageTranslator.visit_seealsoc C rm r )depart_admonitionri r r r depart_seealso rp z#ManualPageTranslator.depart_seealsoc C s | | jd7 _| jd tttj |}dd |D }tdd |D }d }|D ]N}|d r`|d |}| j| j
d d | j| | | j| j
d d | jd n|d urp| jd
d t | |
| | jd q-| jd
| jd8 _tj)Nr7 z.sp
.nf
c s s | ]}|d V qdS ) tokennameNr )r1
productionr r r r5 r6 z.c s s | ]}t |V qd S r )rE )r1 namer r r r5 r6 r r; r z ::= z%s rz r z
.fi
)r rV r| r} r r r
r maxljustdefsra rE r% r r )r rF productionlistnamesmaxlenlastnamer r r r visit_productionlist s*
z)ManualPageTranslator.visit_productionlistc C rh r r ri r r r visit_production+ rk z%ManualPageTranslator.visit_productionc C rh r r ri r r r depart_production. rk z&ManualPageTranslator.depart_productionc C s@ d|j v r| jtd|d d | jtdd tj)Naltz [image: %s]r z[image])rD r| r} r r r ri r r r visit_image2 s
z ManualPageTranslator.visit_imagec C s | dd}|d}|r| jd| d | j| jd d | | | j| jd d |r]|d s]| jjr]| |kr]| d
}| j
d | jd d || jd d d
g |re| jd t j )Nrefurir8 )mailto:zhttp:zhttps:zftp:z
\X'tty: link ' referencer r7 #r z z
\X'tty: link')
get
startswithr| r} r
visit_Textr\
man_show_urlsr& removeprefixextendr r )r rF uriis_safe_to_clickr r r visit_reference9 s(
z$ManualPageTranslator.visit_referencec C s" t |dd}| | t j)NrL r )r Textr r r )r rF textr r r visit_number_referenceV s
z+ManualPageTranslator.visit_number_referencec C s | | jd d S )Nz.sp
.ce
)r r| r} ri r r r visit_centered[ r z#ManualPageTranslator.visit_centeredc C ry )Nz
.ce 0
r{ ri r r r depart_centered_ r z$ManualPageTranslator.depart_centeredc C rh r r ri r r r visit_compact_paragraphb rk z,ManualPageTranslator.visit_compact_paragraphc C rh r r ri r r r depart_compact_paragraphe rk z-ManualPageTranslator.depart_compact_paragraphc C rh r r ri r r r visit_download_referenceh rk z-ManualPageTranslator.visit_download_referencec C rh r r ri r r r depart_download_referencek rk z.ManualPageTranslator.depart_download_referencec C r r r ri r r r
visit_toctreen r z"ManualPageTranslator.visit_toctreec C r r r ri r r r visit_indexq r z ManualPageTranslator.visit_indexc C r r r ri r r r visit_tabular_col_spect r z+ManualPageTranslator.visit_tabular_col_specc C rh r r ri r r r visit_glossaryw rk z#ManualPageTranslator.visit_glossaryc C rh r r ri r r r depart_glossaryz rk z$ManualPageTranslator.depart_glossaryc C sz t tj|d }t ttj |}| t tj|d }t ttj |}| jddd |D d | jd tj )Nr r c s s | ]}| V qd S r )r& )r1 nr r r r5 r6 z2ManualPageTranslator.visit_acks...r )
r r bullet_listr list_itemr r| r} joinr )r rF r
list_itemsr r r
visit_acks} s z ManualPageTranslator.visit_acksc C rm r )visit_bullet_listri r r r visit_hlist rp z ManualPageTranslator.visit_hlistc C rm r )depart_bullet_listri r r r depart_hlist rp z!ManualPageTranslator.depart_hlistc C rh r r ri r r r visit_hlistcol rk z#ManualPageTranslator.visit_hlistcolc C rh r r ri r r r depart_hlistcol rk z$ManualPageTranslator.depart_hlistcolc C
| |S r )visit_emphasisri r r r visit_literal_emphasis r/ z+ManualPageTranslator.visit_literal_emphasisc C r r )depart_emphasisri r r r depart_literal_emphasis r/ z,ManualPageTranslator.depart_literal_emphasisc C r r visit_strongri r r r visit_literal_strong r/ z)ManualPageTranslator.visit_literal_strongc C r r
depart_strongri r r r depart_literal_strong r/ z*ManualPageTranslator.depart_literal_strongc C rh r r ri r r r visit_abbreviation rk z'ManualPageTranslator.visit_abbreviationc C rh r r ri r r r depart_abbreviation rk z(ManualPageTranslator.depart_abbreviationc C r r r ri r r r
visit_manpage r/ z"ManualPageTranslator.visit_manpagec C r r r ri r r r depart_manpage r/ z#ManualPageTranslator.depart_manpagec : t |jtjr|jdr| jd d S t | d S )N
literal_blockr )
isinstancer? r containerr r| r} r
visit_captionri r r r r
z"ManualPageTranslator.visit_captionc r )Nr r ) r r? r r r r| r} r depart_captionri r r r r
r z#ManualPageTranslator.depart_captionc sz t |jtjr| jd d S t |jtjr7| jdkr tj | jdkr7| jd|
| d tj t
|S )Nz.IP "r r7 r r )r r? r
r r| r} r rZ rW r ra r& r[ r visit_titleri r r r r s
" z ManualPageTranslator.visit_titlec s* t |jtjr| jd d S t |S )Nz"
)r r? r
r r| r} r depart_titleri r r r r s z!ManualPageTranslator.depart_titlec C s* d| dd v r| j| tj)Nmanpageformatr8 )r splitr| r} r& r r ri r r r visit_raw s z ManualPageTranslator.visit_rawc C r r r ri r r r
visit_meta r z ManualPageTranslator.visit_metac C rh r r ri r r r visit_inline rk z!ManualPageTranslator.visit_inlinec C rh r r ri r r r
depart_inline rk z"ManualPageTranslator.depart_inlinec C rh r r ri r r r
visit_math rk z ManualPageTranslator.visit_mathc C rh r r ri r r r depart_math rk z ManualPageTranslator.depart_mathc C rm r )r ri r r r visit_math_block rp z%ManualPageTranslator.visit_math_blockc C rm r )r ri r r r depart_math_block rp z&ManualPageTranslator.depart_math_block)r r. r r r r )r re )rF r r r )\r* r+ r, rI rJ __annotations__r rg rj rl ro rr ru rw 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 rt 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# I s
"
r# N)&rI
__future__r collections.abcr typingr r r docutilsr docutils.writers.manpager BaseTranslatorr sphinxr
sphinx.localer r sphinx.utilr
sphinx.util.docutilsr sphinx.util.i18nr sphinx.util.nodesr docutils.nodesr sphinx.buildersr getLoggerr* loggerr r r# r r r r s(