| 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/builders/__pycache__/ |
Upload File : |
a
�ab�q � @ s� d Z ddlZddlZddlZddlmZ ddlmZmZmZm Z m
Z
m Z ddl m
Z
mZmZ ddlmZ ddlmZmZ ddlmZ dd lmZ dd
lmZmZ dd l m Z dd l m Z m Z dd
l!m"Z" ddl#m$Z$ ddl%m&Z&m'Z' zddl(m)Z) W n e*�y dZ)Y n0 e �+e,�Z-dZ.dZ/dZ0dZ1dZ2dZ3ddd�Z4ddd d d d d d d!d"d#�
Z5d$Z6e�7d%�Z8G d&d'� d'e �Z9G d(d)� d)e �Z:G d*d+� d+e �Z;G d,d-� d-e �Z<d4e=e=e=d/�d0d1�Z>e>Z?G d2d3� d3e�Z@dS )5z�
sphinx.builders._epub_base
~~~~~~~~~~~~~~~~~~~~~~~~~~
Base class of epub2/epub3 builders.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�Any�Dict�List�
NamedTuple�Set�Tuple)� ZIP_DEFLATED�
ZIP_STORED�ZipFile)�nodes)�Element�Node)� smartquotes)�addnodes)� BuildInfo�StandaloneHTMLBuilder)�__)�logging�status_iterator)�copy_asset_file)� format_date)�copyfile� ensuredir)�Imagezepub-cover.xhtmlz toctree-l%dz
[%(uri)s]z#%dZ Footnotesz link-targetzTable of ContentsZCover)�toc�coverzapplication/xhtml+xmlztext/css� image/png� image/gif�
image/svg+xml�
image/jpegzapplication/x-font-otfzapplication/x-font-ttfzapplication/font-woff)
�.xhtmlz.cssz.pngz.gif�.svgz.jpgz.jpegz.otfz.ttfz.woff)r" z
([^#:]*#)(.*)c @ s& e Zd ZU eed< eed< eed< dS )� ManifestItemZhref�idZ
media_typeN��__name__�
__module__� __qualname__�str�__annotations__� r+ r+ �>/usr/lib/python3.9/site-packages/sphinx/builders/_epub_base.pyr# T s
r# c @ s e Zd ZU eed< eed< dS )�SpineZidrefZlinearN)r& r' r( r) r* �boolr+ r+ r+ r, r- Z s
r- c @ s& e Zd ZU eed< eed< eed< dS )�Guide�type�title�uriNr% r+ r+ r+ r, r/ _ s
r/ c @ s: e Zd ZU eed< eed< eed< eed< ee ed< dS )�NavPoint�navpoint� playorder�text�refuri�childrenN)r& r' r( r) r* �intr r r+ r+ r+ r, r3 e s
r3 �en)�t�language�returnc C s2 | � dd�} t�| �} t�| |�} | � dd�} | S )Nz"�")�replacer ZeducateDashesOldSchoolZ
educateQuotes)r; r< r+ r+ r, �sphinx_smarty_pantsn s
r@ c s� e Zd ZdZdZg d�ZdZdZdZdZ dZ
dZ dZ e
ZeZeZeZeZeZeZdZdZ dd�� fdd � Z e d�d
d �Z e e!e"f d�d d
�Z#e!e!d�dd�Z$e%e&e"e!e'f e&e"e!e'f d�dd�Z(e&e"e!e'f dd�dd�Z)dd�dd�Z*e&e"e!e'f dd�dd�Z+e!e!e!d �d d �Z,e-j.dd �d d!�Z/dNe-j.e!dd#�d$d%�Z0e!e-j.dd&�� fd'd(� Z1e&e e!e&e e!e'f f dd �d)d*�Z2e!e3d+�d,d-�Z4dd�d.d/�Z5dd�� fd0d1� Z6dd�d2d3�Z7dOe!e"e!e!e'dd5�� fd6d7�
Z8dd�d8d9�Z9dPe!dd;�d<d=�Z:e"e!e'f d�d>d?�Z;dd�d@dA�Z<dQe"e!e'f e=e3e>dB�dCdD�Z?e&e"e!e'f e&e> d�dEdF�Z@e=e&e> e"e!e'f dG�dHdI�ZAdd�dJdK�ZBdd�dLdM�ZC� ZDS )R� EpubBuilderz�
Builder that outputs epub files.
It creates the metainfo files container.opf, toc.ncx, mimetype, and
META-INF/container.xml. Afterwards, all necessary files are zipped to an
epub file.
F)r r r r T� N)r= c s@ t � �� d| _d| _d| _d| _i | _| �dd�| _g | _ d S )Nr! r � use_index�epub)
�super�init�
out_suffixZ link_suffixr5 �tocid�id_cacheZget_builder_configrC �refnodes��self�� __class__r+ r, rF � s
zEpubBuilder.initc C s t | j| jddg�S )N�htmlrD )r �config�tagsrK r+ r+ r, �create_build_info� s z EpubBuilder.create_build_infoc C s | j j| j jfS �N)rP Z
epub_themeZepub_theme_optionsrK r+ r+ r, �get_theme_config� s z EpubBuilder.get_theme_config)�namer= c C s. | j �|�}|s*d| j�d� }|| j |< |S )z Return a unique id for name.zepub-%drD )rI �get�envZ new_serialno)rL rU r$ r+ r+ r, �make_id� s
zEpubBuilder.make_id)�doctree�resultr= c
C s� t |tj�r�|�d�r�|d }|�d�sF|�d�sF|�d�sF|�d�rJ|S |jjd }tddd �D ]<}| j| |v rb|� |t
� |�t t
� |�
� ��d
�� q�qbn"t |tj�r�|D ]}| �||�}q�|S ) z>Collect section titles, their depth in the toc and the refuri.r7 zhttp://zhttps://zirc:zmailto:�classes� r �����levelr7 r6 )�
isinstancer � referencerV �
startswith�parentZ
attributes�range�toctree_template�appendrO �escape�ssp�astextr
� get_refnodes)rL rY rZ r7 r[ r_ �elemr+ r+ r, rj � s* �� � zEpubBuilder.get_refnodes)r r= c C sJ t � }|D ]:}|d |v r6tjtd�|d ddd� q
|�|d � q
d S )Nr7 z duplicated ToC entry found: %srD Zduplicated_toc_entry�r0 Zsubtype)�set�logger�warningr �add)rL r Zappeared�noder+ r+ r, �check_refnodes� s �zEpubBuilder.check_refnodesc C sl | j j| jj| ddd�}| �|g �| _t�| jj�}|r\|d7 }| jD ]}||d |d< qF| �| j� dS )zwGet the total table of contents, containing the root_doc
and pre and post files not managed by sphinx.
FT�Zprune_toctreesZ
includehidden�/r7 N) rW �get_and_resolve_doctreerP �root_docrj rJ r �dirname�
toc_add_files)rL rY Z
master_dir�itemr+ r+ r, �get_toc� s �
zEpubBuilder.get_toc)rJ r= c
C s� |� ddt�| jj| j �tt�| jj| jj � � ��d�� t
| jj �D ],\}}|� ddt�|�tt�|��d�� qJ| jj D ]*\}}|�
dt�|�tt�|��d�� q�dS )zDAdd the root_doc, pre and post files to a list of refnodes.
r � r^ N)�insertrO rg rP rv rG rh rW Ztitlesri �reversedZepub_pre_filesZepub_post_filesrf )rL rJ �filer6 r+ r+ r, rx � s& �� �
�zEpubBuilder.toc_add_files)�prefix�fragmentr= c C s ||� dd� S )z;Return a href/id attribute with colons replaced by hyphens.�:�-)r? )rL r r� r+ r+ r, � fix_fragment s zEpubBuilder.fix_fragment��treer= c s� t dd�� fdd� }|�tj�D ]X}d|v r\� j�|d �}|r\� �|�d�|�d��|d< d|v r � �d |d �|d< q |�tj�D ],}||� |j d
d �}t
|tj �r�||� q�|�t j �D ] }||� q�dS ) z�Replace colons with hyphens in href and id attributes.
Some readers crash because they interpret the part as a
transport protocol specification.
N)rq r= c s< g }| d D ]"}� � d|�}||vr |�|� q || d< dS )zUpdate IDs of given *node*.�idsrB N)r� rf )rq Znew_idsZnode_idZnew_idrK r+ r, �update_node_id s z+EpubBuilder.fix_ids.<locals>.update_node_idr7 r{ � �refidrB T)Zascend)
r
�findallr ra � refuri_re�matchr� �group�target� next_noder` r �desc_signature)rL r� r� ra �mr� r� r� r+ rK r, �fix_ids s
zEpubBuilder.fix_ids�inline)r� � show_urlsr= c C s� t jtt jd�dd�}t jttt jd�dd�}t jtttf d�dd �}|d
krTd S |d kr|t|� t j��}||�\}}d
} t
|� t j ��D �] }
|
� dd�} | �
d�s�| �
d�s�| �
d�r�| |
�� vr�|
j�|
�d
} |dk�r | jd| i } t �| | �}
|
d �| j� |
j�| |
� q�|d kr�t| }| d
7 } |||�}|
j�| |� |||| �}|�||� |d d |d< |�|d d � |d
7 }q�d S )z+Add visible link targets for external links)�doc�labelr= c S s( t �d�}|�t �|�� | �|� |S )z.Create a footnote_reference node with childrenz[#]_)r �footnote_referencerf �TextZnote_autofootnote_ref)r� r� � footnote_refr+ r+ r, �make_footnote_ref- s
z8EpubBuilder.add_visible_links.<locals>.make_footnote_ref)r� r� r2 r= c S sN t �|�}t �� }|�t �|�� |�|� |�dt �d|�� | �|� |S )z$Create a footnote node with childrenr rB )r �footnoteZ paragraphrf r� r| r� Znote_autofootnote)r� r� r2 r� Zparar+ r+ r, �
make_footnote4 s
z4EpubBuilder.add_visible_links.<locals>.make_footnoter� c S s� t | �tj��}|r2|d }|j|j�|�d fS | �tj�D ]6}t|�dkr>|�� t kr>|j|j�|�d f S q>t
| �tj ��}t�� }|� t�
t �� |� |� ||�|�d fS )zfFind or create a spot to place footnotes.
The function returns the tuple (parent, index).r] r{ )�listr� r r� rc �indexZrubric�lenri �FOOTNOTES_RUBRIC_NAME�next�documentrf r� )r� Zfns�fnrq r� Zrubr+ r+ r, �
footnote_spot> s
z4EpubBuilder.add_visible_links.<locals>.footnote_spot�noNr� r{ r7 rB zhttp:zhttps:zftp:r� r2 r[ r� r r� )r r� r) r� r� r r
r9 r� r� r� ra rV rb ri rc r� �link_target_templater� rf �css_link_target_classr| �FOOTNOTE_LABEL_TEMPLATEZ add_backref)rL r� r� r� r� r� r� Zfn_spotZfn_idx�nrrq r2 �idx�linkr� r� r� r+ r+ r, �add_visible_links* s@
�
�
z EpubBuilder.add_visible_links)�docnamerY r= c s, | � |� | �|| jj� t� �||� dS )z�Write one document file.
This method is overwritten in order to fix fragment identifiers
and to add visible external links.
N)r� r� rP Zepub_show_urlsrE � write_doc)rL r� rY rM r+ r, r� n s
zEpubBuilder.write_docc
C s� |D ]�\}}|D ]�\}\}}}t |�D ]<\}\}} | j�| �}
|
r&|| �|
�d�|
�d��f||< q&|D ]N\} } t | �D ]<\}\}} | j�| �}
|
rx|| �|
�d�|
�d��f| |< qxqhqqdS )z'Fix href attributes for genindex pages.r{ r� N)� enumerater� r� r� r� )
rL r� Z_key�columnsZ
_entrynameZlinksZsubitems�iZismainr� r� Z
_subentrynameZ
subentrylinksr+ r+ r, � fix_genindexx s �
�zEpubBuilder.fix_genindex)�filenamer= c C s t �|�d }|tv S )z=Does the filename extension indicate a vector graphic format?r] )r �splitext�VECTOR_GRAPHICS_EXTENSIONS)rL r� �extr+ r+ r, �is_vector_graphics� s z EpubBuilder.is_vector_graphicsc C s� t t�| j| j�� t| jtd�dt| j�| j j
�D �]�}| j| }zt � t�| j
|��}W n� ty� | �|�s�t�td�t�| j
|�� z&tt�| j
|�t�| j| j|�� W n@ ty� } z(t�td�t�| j
|�|� W Y d}~n
d}~0 0 Y q4Y n0 | jj�r |jdv �r |�� }| jjdk�rf|j\}}| jj}||k�rf|| | }|�||ft j�}z |�t�| j| j|�� W q4 t�y� } z(t�td�t�| j
|�|� W Y d}~q4d}~0 0 q4dS ) z�Copy images using Pillow, the Python Imaging Library.
The method tries to read and write the files with Pillow, converting
the format and resizing the image if necessary/possible.
zcopying images... Zbrownz-cannot read image file %r: copying it insteadz cannot copy image file %r: %sN)�Pr z cannot write image file %r: %s) r r �join�outdirZimagedirr �imagesr r� Zapp� verbosityr �openZsrcdir�OSErrorr� rn ro r rP �epub_fix_images�modeZconvert�epub_max_image_width�sizeZresizeZBICUBICZsave) rL �src�destZimg�err�widthZheightZnwZnhr+ r+ r, �copy_image_files_pil� sH �
��
�
�z EpubBuilder.copy_image_files_pilc sL | j rH| jjs| jjr>ts4t�td�� t� � � qH| �
� n
t� � � dS )zzCopy image files to destination directory.
This overwritten method can use Pillow to convert image files.
z&Pillow not found - copying image filesN) r� rP r� r� r rn ro r rE �copy_image_filesr� rK rM r+ r, r� � s
z EpubBuilder.copy_image_filesc C s d S rS r+ rK r+ r+ r, �copy_download_files� s z EpubBuilder.copy_download_files� page.html)�pagename�addctx� templatename� outfilename� event_argr= c sL |� d�r*d|v r*| js dS | �|d � | j|d< t� �|||||� dS )z�Create a rendered page.
This method is overwritten for genindex pages in order to fix href link
attributes.
�genindexZgenindexentriesN�doctype)rb rC r� r� rE � handle_page)rL r� r� r� r� r� rM r+ r, r� � s
zEpubBuilder.handle_pagec C s( t �td�� tt�| jd�| j� dS )z!Write the metainfo file mimetype.zwriting mimetype file...�mimetypeN)rn �infor r r r� � template_dirr� rK r+ r+ r, �build_mimetype� s zEpubBuilder.build_mimetype�META-INF/container.xml)�outnamer= c C s< t �td�� t�| jd�}t|� tt�| jd�|� dS )z/Write the metainfo file META-INF/container.xml.z&writing META-INF/container.xml file...zMETA-INFz
container.xmlN) rn r� r r r� r� r r r� )rL r� r� r+ r+ r, �build_container� s zEpubBuilder.build_containerc C s� i }t �| jj�|d< t �| jj�|d< t �| jj�|d< t �| jj�|d< t �| jj�|d< t �| jj�|d< t �| jj �|d< t �| jj
�|d< t �t d ��|d
< g |d < g |d < g |d
< |S )zaCreate a dictionary with all metadata for the content.opf
file properly escaped.
r1 Zauthor�uid�langZ publisher� copyright�schemer$ z%Y-%m-%d�date�manifest_items�spines�guides) rO rg rP �
epub_titleZ epub_author�epub_uidZ
epub_languageZepub_publisherZepub_copyrightZ epub_schemeZepub_identifierr )rL �metadatar+ r+ r, �content_metadata� s z EpubBuilder.content_metadatac C s� t �td�� | �� }| j�tj�s4| jtj7 _t| j�}g | _ dddddddd d
| j
j d g
| j
j | _
| js�| j
�d | j � t�| j�D ]�\}}}|�� t|�D ]�}t�||�|d
� }|| j
v r�q�t�|�d }|| jv�r
|dvr�t jtd�|ddd� q�|�tjd�}tt� |�t� | � |��t� | j| ��} |d �| � | j �|� q�q�t � }
| j D ]b} d| d v �r��ql| d | j
v �r��qlt t� | � | d ��d�} |d �| � |
�!| d � �ql| j"D ]H}
t t� | � |
d | j ��d�} |d �| � |
�!|
d | j � �q�| j�rbt t� | � d | j ��d�} |d �| � |
�!d | j � | j D ]B}||
v�rh|�| j��rht t� | � |��d�} |d �| � �qhd
}| j
j#�r�| j
j#\}}|�tjd�}t� | � |��|d < |�r�t t� | � | j$��d�} |d �%d| � | j$| j v�r~t�| j$�d }| j �| j$� tt� | j$�t� | � | j$��t� | j| ��} |d �| � t� |�| j
j&d �}| �'t�| j$�d ||� |
�!| j$� d}d}| j
j(�rJ| j
j(D ]v\}}}|�)d�d }|| j v�r| j �|� |d k�rd}|d k�r d}|d �t*t� |�t� |�t� |��� �q�|�rz|�rz|d �t*d | j+d t� | j$��� |�r�| j �r�|d �t*d | j+d t� | j d d ��� t,t�| j-d �| j|� d
S )!z�Write the metainfo file content.opf It contains bibliographic data,
a file list and the spine (the reading order).
zwriting content.opf file...z
.buildinfor� � content.opf�toc.ncxr� z Thumbs.dbz ehthumbs.dbz .DS_Storez nav.xhtml�.epubr� Nr] )z.jsz.xmlz!unknown mimetype for %s, ignoringrD Zunknown_project_filesrl rt r� �#r7 Tr� r Fr )�imager1 r r� z
content.opf_t).rn r� r r� r� �endswith�os�sepr� �filesrP �
epub_basenameZepub_exclude_files�
ignored_filesrC rf rG �walk�sort�sortedr r� r� � media_typesro r? r# rO rg rX rm rJ r- rp Zdomain_indicesZ
epub_cover�coverpage_namer| Zprojectr� Z
epub_guide�splitr/ � guide_titlesr r� )rL r� Zolen�root�dirsr� r� r� r� ry Z
spinefilesZrefnodeZspiner� rU Z html_tmplr� �ctxZauto_add_coverZ auto_add_tocr0 r2 r1 r~ r+ r+ r, �
build_content� s�
��
�
�
��
�
� �zEpubBuilder.build_content)rq r_ �incrr= c C s@ |r| j d7 _ | jd7 _td| j | j |d |d g �S )z;Create a new entry in the toc from the node at given level.r{ z
navPoint%dr6 r7 )r5 rH r3 )rL rq r_ r� r+ r+ r, � new_navpointc s �zEpubBuilder.new_navpointc C sx g }|� tddddg �� d}d}|D �]D}|d s6q&|d �d�d }|| jv rTq&|d | jjkrfq&|d |kr�| �||�}|�� |d j� |� |� |� n�|d |d
k�r
|d
7 }|r�| jj r�|d j� | �||d �� | �||�}|d j� |� |� |� n^|d |k �rf|d t
|�k �r6|�� �q|d }| �||�}|d j� |� |� |� n� |}q&|d jS ) z�Create the toc navigation structure.
Subelements of a node are nested inside the navpoint. For nested nodes
the parent node is reinserted in the subnav.
Zdummyr rB Nr6 r7 r� r_ r] r{ F) rf r3 r� r� rP �
epub_tocdepthr� �popr8 Z epub_tocdupr� )rL r Znavstackr_ Zlastnoderq r~ r4 r+ r+ r, �build_navpointsl sD
zEpubBuilder.build_navpoints)r_ � navpointsr= c C s6 i }| j j|d< t�| j j�|d< ||d< ||d< |S )z]Create a dictionary with all metadata for the toc.ncx file
properly escaped.
r� r1 r_ r )rP r� rO rg r� )rL r_ r r� r+ r+ r, � toc_metadata� s zEpubBuilder.toc_metadatac C s� t �td�� | jjdkrJ| jj| jj| ddd�}| �|g �}| � |� n| j
}| � |� | � |�}t
dd� | j
D ��}t|| jj�}tt�| jd�| j| �||�� dS ) z Write the metainfo file toc.ncx.zwriting toc.ncx file...�defaultFrs c s s | ]}|d V qdS )r_ Nr+ )�.0ry r+ r+ r, � <genexpr>� � z(EpubBuilder.build_toc.<locals>.<genexpr>z toc.ncx_tN)rn r� r rP Z
epub_tocscoperW ru rv rj rx rJ rr r �max�minr� r r r� r� r� r )rL rY rJ r r_ r+ r+ r, � build_toc� s �
�zEpubBuilder.build_tocc C s� | j jd }t�td�|� t�| j|�}t|dt ��n}|�
t�| jd�dt � dD ] }|�
t�| j|�|t � qT| j D ] }|�
t�| j|�|t � qxW d � n1 s�0 Y dS )z~Write the epub file.
It is a zip file with the mimetype file stored uncompressed as the first
entry.
r� zwriting %s file...�wr� )r� r� r� N)
rP r� rn r� r r r� r� r r �writer
r� )rL r� Z
epub_filenamerD r� r+ r+ r, �
build_epub� s
zEpubBuilder.build_epub)r� )r� NN)r� )T)Er& r' r( �__doc__Z
copysourceZsupported_image_typesZsupported_remote_imagesZadd_permalinksZallow_sharp_as_current_pathZembeddedZdownload_supportZhtml_scaled_image_link�search�COVERPAGE_NAMEr� �TOCTREE_TEMPLATEre �LINK_TARGET_TEMPLATEr� �CSS_LINK_TARGET_CLASSr� � GUIDE_TITLESr� � MEDIA_TYPESr� � REFURI_REr� r� r� rF r rR r r) r rT rX r r r rj rr rz rx r� r r� r� r� r� r� r. r� r� r� r� r� r� r� r� r� r9 r3 r� r r r r �
__classcell__r+ r+ rM r, rA { sd *
!D
(' ��o , rA )r: )Ar
rO r� �rer �typingr r r r r r �zipfiler r
r Zdocutilsr Zdocutils.nodesr
r Zdocutils.utilsr Zsphinxr Zsphinx.builders.htmlr r Z
sphinx.localer Z sphinx.utilr r Zsphinx.util.fileutilr Zsphinx.util.i18nr Zsphinx.util.osutilr r ZPILr � ImportErrorZ getLoggerr& rn r r r r� r� r r r r� �compiler r# r- r/ r3 r) r@ rh rA r+ r+ r+ r, �<module> sd
��