3
T'íc³" ã
@ sî d dl Z d dlZd dl mZ d dlmZmZmZmZmZm Z m
Z
d dl m Z d dl
mZmZmZ d dlmZ d dlmZmZ d dlmZ d d lmZ d d
lmZ d d l m Z d d l m Z d d
l m!Z! d dl"m#Z# d dl$m%Z% d dl&m'Z' d dl(m)Z)m*Z*m+Z+ d dl,m-Z- yd dl.m/Z0 W n" e1k
r: d dl2m/Z0 Y nX erNd dl3m4Z4 e#j5e6Z7G dd dej8Z8G dd de0e%Z/G dd dej9Z9G dd d ej:Z:G d d d ej;Z;G d d d e%Z<G d!d" d"e%Z=d#ee>ef d$d%d&Z?dS )'é N)Úpath)Ú
TYPE_CHECKINGÚAnyÚDictÚListÚSequenceÚTupleÚcast)Únodes)ÚNodeÚmake_idÚsystem_message)Ú
directives)ÚimagesÚtables)Ú set_classes)Úaddnodes)ÚRemovedInSphinx60Warning)Ú optional_int)Ú
MathDomain)Ú__)Úlogging)ÚSphinxDirective)Úset_source_info)ÚSEPÚos_pathÚrelpath)Ú
OptionSpec)ÚMeta)ÚSphinxc s* e Zd ZdZee d fdd Z ZS )ÚFigureziThe figure directive which applies `:name:` option to the figure node
instead of the image node.
)Úreturnc s¤ | j jdd }t j }t|dks4t|d tjr8|S t|dksHtt tj
|d }|rp|| j d< | j | |j d krt|dkrt tj
|d }|j |_ |gS )NÚnameé r é )ÚoptionsÚpopÚsuperÚrunÚlenÚ
isinstancer
r
ÚAssertionErrorr ÚfigureÚadd_nameÚlineÚcaption)Úselfr" ÚresultZ figure_noder/ )Ú __class__© ú;/tmp/pip-build-gk9425m9/sphinx/sphinx/directives/patches.pyr( ) s
z
Figure.run)Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r r( Ú
__classcell__r3 r3 )r2 r4 r $ s r c s& e Zd Zee d fdd Z ZS )r )r! c sx t j }xh|D ]`}t|tjrt|jd d tjr|jd d }| jj | jj
|_ | j |_
|d |_tj|_qW |S )Nr
r Úcontent)r' r( r* r
ÚpendingÚdetailsr Z
docutils_metaÚenvÚdoc2pathÚdocnameÚsourceÚlinenor. Z
rawcontentÚmetar2 )r0 r1 ÚnoderB )r2 r3 r4 r( ? s
zMeta.run)r5 r6 r7 r r r( r9 r3 r3 )r2 r4 r > s r c sJ e Zd ZdZee d fdd Zeej ee
f d fdd Z Z S )ÚRSTTablezxThe table directive which sets source and line information to its caption.
Only for docutils-0.13 or older version.)r! c s t jdt t j S )NzRSTTable is deprecated.)ÚwarningsÚwarnr r' r( )r0 )r2 r3 r4 r( V s z RSTTable.runc s$ t j \}}|r t| | ||fS )N)r' Ú
make_titler )r0 ÚtitleÚmessage)r2 r3 r4 rG [ s
zRSTTable.make_title)
r5 r6 r7 r8 r r r( r r
rH r
rG r9 r3 r3 )r2 r4 rD Q s rD c s* e Zd ZdZee d fdd Z ZS )ÚCSVTablezThe csv-table directive which searches a CSV file from Sphinx project's source
directory when an absolute path is given via :file: option.
)r! c s¨ d| j kr| j d jttjfr| jjjj}| j d }t j
|r\t j t
d|j| jfd nBt j|jt| j d dd
}t j|j|j}t||| j d< t j S )NÚfilez":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.)Úlocationr$ )r% Ú
startswithr ÚosÚsepÚstateÚdocumentÚsettingsr= r ÚexistsÚloggerÚwarningr r? rA ÚjoinÚsrcdirr Údirnamer> r r' r( )r0 r= ÚfilenameÚabspathZdocdir)r2 r3 r4 r( h s
z CSVTable.run)r5 r6 r7 r8 r r r( r9 r3 r3 )r2 r4 rJ c s rJ c sJ e Zd ZdZee d fdd Zeej ee
f d fdd Z Z S )Ú ListTablez}The list-table directive which sets source and line information to its caption.
Only for docutils-0.13 or older version.)r! c s t jdt t j S )NzListTable is deprecated.)rE rF r r' r( )r0 )r2 r3 r4 r( ~ s z
ListTable.runc s$ t j \}}|r t| | ||fS )N)r' rG r )r0 rH rI )r2 r3 r4 rG s
zListTable.make_title)
r5 r6 r7 r8 r r r( r r
rH r
rG r9 r3 r3 )r2 r4 r[ y s r[ c @ sD e Zd ZU dZdZejejeje dZ
e
dZ e
e dddZdS ) ÚCodezqParse and mark up content of a code block.
This is compatible with docutils' :rst:dir:`code` directive.
r$ )ÚclassÚforcer" z number-linesT)r! c C s¸ | j t| j dj| j}tj||| jjdg d| jki d}| j| t | | | j
rl| j
d |d< n| j j jd| j
j|d< d| jkr²d |d
< | jd r²| jd |d d < |gS )
NÚ
Úclassesr^ )r` r^ Úhighlight_argsr ÚlanguageÚhighlight_languagez number-linesTZlinenosra Z linenostart)Zassert_has_contentr r% rV r: r
Z
literal_blockÚgetr- r Ú argumentsr= Z temp_dataÚconfigrc )r0 ÚcoderC r3 r3 r4 r( s$
zCode.runN)r5 r6 r7 r8 Úoptional_argumentsr Ú class_optionÚflagÚ unchangedr Ú option_specr Ú has_contentr r r( r3 r3 r3 r4 r\ s
r\ c @ s^ e Zd ZU dZdZdZdZejejej ej
dZ e e
e dddZe
e dd d
d ZdS ) Ú
MathDirectiveTr r$ )Úlabelr" r] Únowrap)r! c C s dj | j}| jr.| jd r.| jd d | }| jjd| jjd}tj||| jjdg | jjd |d| jkd}| j | | j
| |g}| j | |S ) Nr_ r z
ro r" r] rp )r` r? Únumberro rp ) rV r: re r% rd r
Ú
math_blockr= r? r- r Ú
add_target)r0 Zlatexro rC Úretr3 r3 r4 r( Å s
zMathDirective.runN)rt r! c C sÖ t tj|d }|d dks.| jjrN|d rN| jjd}d| jj|f |d< |d sZd S t t| jj d}|j
| jj|d |d |j |d |d< t d |d }tj
dd|gd
}| jjj| |jd| d S ) Nr ro Ú zsphinx.ext.math#equationsz%s:%dÚmath)rL rq z equation-%s)Úids)r r
rr rf Zmath_number_allr= Z new_serialnor? r Z
get_domainZ
note_equationZget_equation_number_forr ÚtargetrP rQ Znote_explicit_targetÚinsert)r0 rt rC ÚseqÚdomainZnode_idrx r3 r3 r4 rs × s zMathDirective.add_target)r5 r6 r7 rm Zrequired_argumentsrh Zfinal_argument_whitespacer rk ri rj rl r r r r( rs r3 r3 r3 r4 rn ¹ s
rn r )Úappr! c C sH t jdt t jdt t jdt t jdt t jdt ddddS ) Nr, rB z csv-tablerg rv ÚbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe)r Zregister_directiver r rJ r\ rn )r| r3 r3 r4 Úsetupï s r )@rN rE r Útypingr r r r r r r Zdocutilsr
Zdocutils.nodesr r r
Zdocutils.parsers.rstr Z docutils.parsers.rst.directivesr r Zdocutils.parsers.rst.rolesr Zsphinxr Zsphinx.deprecationr Zsphinx.directivesr Zsphinx.domains.mathr Z
sphinx.localer Z sphinx.utilr Zsphinx.util.docutilsr Zsphinx.util.nodesr Zsphinx.util.osutilr r r Zsphinx.util.typingr Z$docutils.parsers.rst.directives.miscr ZMetaBaseÚ ImportErrorZ$docutils.parsers.rst.directives.htmlZsphinx.applicationr Ú getLoggerr5 rT r rD rJ r[ r\ rn Ústrr r3 r3 r3 r4 Ú<module> sB $
.6