File: //usr/lib/python3/dist-packages/sphinx/builders/__pycache__/epub3.cpython-310.pyc
o
�$�a�* � @ sD d Z ddlZddlmZ ddlmZmZmZmZm Z m
Z
ddl m Z ddl
mZ ddlmZ ddlmZmZ dd lmZ dd
lmZmZ dd lmZ dd lm Z dd
l m Z e� e �Z!G dd� de�Z"ddd�Z#ddd�Z$ddd�Z%dZ&dZ'G dd� dej(�Z)d ed dfd d �Z*d ed ed dfd!d"�Z+d ed ee,ef fd#d$�Z-dS )%z�
sphinx.builders.epub3
~~~~~~~~~~~~~~~~~~~~~
Build epub3 files.
Originally derived from epub.py.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�Any�Dict�List�
NamedTuple�Set�Tuple)� package_dir)�Sphinx)�
_epub_base)�ENUM�Config)�__)�logging�xmlname_checker)�copy_asset_file)� format_date)�
make_filenamec @ s* e Zd ZU eed< eed< ee ed< dS )�NavPoint�text�refuri�childrenN)�__name__�
__module__� __qualname__�str�__annotations__r r � r r �7/usr/lib/python3/dist-packages/sphinx/builders/epub3.pyr s
r �ltr�rtl)�
horizontal�verticalr" r! z vertical-rlz
horizontal-tb)r" r! z<!DOCTYPE html>zU<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops">c s� e Zd ZdZdZed�ZdZe� e
dd�Z e Z
eZdZdd
d �Zdef� fd d
� Zdee dd f� fdd� Zdeeeef dee fdd�Zdee defdd�Zddd�Z � Z S )� Epub3Builderz�
Builder that outputs epub3 files.
It creates the metainfo files content.opf, nav.xhtml, toc.ncx, mimetype,
and META-INF/container.xml. Afterwards, all necessary files are zipped to
an epub file.
�epubz The ePub file is in %(outdir)s.F� templates�epub3T�returnNc C s< | � � | �� | �� | �� | �� | �� | �� dS )z/Create the metainfo files and finally the epub.N)�get_toc�build_mimetype�build_container�
build_content�build_navigation_doc� build_toc�
build_epub��selfr r r �
handle_finishL s zEpub3Builder.handle_finishc s� | j j}t� �� }t�| j j�|d< t�| j j�|d< t� |�|d< t
� |�|d< t�t d��|d< t�| j j �|d< | j j
|d< |S ) zaCreate a dictionary with all metadata for the content.opf
file properly escaped.
� description� contributor�page_progression_direction�ibook_scroll_axisz%Y-%m-%dT%H:%M:%SZ�date�version� epub_version)�config�epub_writing_mode�super�content_metadata�html�escape�epub_description�epub_contributor�PAGE_PROGRESSION_DIRECTIONS�get�IBOOK_SCROLL_AXISr r7 r8 )r0 � writing_mode�metadata�� __class__r r r< V s
z Epub3Builder.content_metadata�docnamesc sJ t � �|� | jj}t�|�| jd< | j| jd< | j| jd< d| jd< d S )N�theme_writing_mode�html_tag�use_meta_charsetT�skip_ua_compatible) r; �prepare_writingr9 r: �THEME_WRITING_MODESrB �
globalcontextrJ rK )r0 rH rD rF r r rM f s z Epub3Builder.prepare_writing�navnodesc C s> g }|� tddg �� d}|D ]�}|d sq|d �d�d }|| jv r%q|d | jjkr.qt|d |d g �}|d |krP|�� |d j� |� |� |� q|d |d krj|d7 }|d j� |� |� |� q|d |k r�|d t|�k r�|�� |d t|�k sx|d }|d j� |� |� |� qt d ��|d jS )
ac Create the toc navigation structure.
This method is almost same as build_navpoints method in epub.py.
This is because the logical navigation structure of epub3 is not
different from one of epub2.
The difference from build_navpoints method is templates which are used
when generating navigation documents.
� r r r �#�level���� z+Should never reach here. It might be a bug.)
�appendr �split�
ignored_filesr9 �
epub_tocdepth�popr �len� RuntimeError)r0 rP �navstackrS �node�file�navpointr r r �
build_navlisto s:
�
zEpub3Builder.build_navlist�navlistc C s6 i }t �| jj�|d< t �| jd �|d< ||d< |S )z_Create a dictionary with all metadata for the nav.xhtml file
properly escaped.
�lang�toc�
toc_localerb )r= r> r9 �
epub_language� guide_titles)r0 rb rE r r r �navigation_doc_metadata� s
z$Epub3Builder.navigation_doc_metadatac C s� t �td�� | jjdkr%| jj| jj| ddd�}| �|g �}| � |� n| j
}| � |�}t t
�| jd�| j| �|�� d| jvrI| j�d� dS dS )z"Write the metainfo file nav.xhtml.zwriting nav.xhtml file...�defaultF)�prune_toctrees�
includehiddenz nav.xhtml_tz nav.xhtmlN)�logger�infor r9 �
epub_tocscope�env�get_and_resolve_doctree�root_doc� get_refnodes�
toc_add_files�refnodesra r r �join� template_dir�outdirrh �filesrV )r0 �doctreert rb r r r r, � s �
�
�z!Epub3Builder.build_navigation_doc)r' N) r r r �__doc__�namer �epilog�supported_remote_imagesr ru r rv �DOCTYPE�doctype�HTML_TAGrJ rK r1 r r< r r rM r r r ra rh r, �
__classcell__r r rF r r# : s
" *
r# �appr' c C s� | j jdkrd S | jjst�td�� t� �| jj �s"t�td�� | jj
s-t�td�� | jj s8t�td�� | jj sCt�td�� | jj
sNt�td�� | jjsYt�td�� | jjsdt�td �� | jjsot�td
�� | jjs|t�td �� d S d S ) Nr$ zHconf value "epub_language" (or "language") should not be empty for EPUB3z2conf value "epub_uid" should be XML NAME for EPUB3zGconf value "epub_title" (or "html_title") should not be empty for EPUB3z6conf value "epub_author" should not be empty for EPUB3z;conf value "epub_contributor" should not be empty for EPUB3z;conf value "epub_description" should not be empty for EPUB3z9conf value "epub_publisher" should not be empty for EPUB3zIconf value "epub_copyright" (or "copyright")should not be empty for EPUB3z:conf value "epub_identifier" should not be empty for EPUB3z2conf value "version" should not be empty for EPUB3)�builderr{ r9 rf rl �warningr r �match�epub_uid�
epub_title� epub_authorr@ r? �epub_publisher�epub_copyright�epub_identifierr7 �r� r r r �validate_config_values� s. �r� r9 c C sp g }|j D ]-}t|t�r|�|i f� qz
|\}}|�||f� W q ty2 t�td�|� Y qw ||_ dS )z?This converts string styled epub_css_files to tuple styled one.z invalid css_file: %r, ignoredN)�epub_css_files�
isinstancer rV � Exceptionrl r� r )r� r9 r� �entry�filename�attrsr r r �convert_epub_css_files� s
�
r� c C s� | � t� | �ddd� d � | �ddd� | �ddd� | �di d� | �d d
d� d� | �d d d� d� | �d
dd� d� | �ddd� d� | �ddd� d� | �ddd� | �ddd� | �ddd� | �ddd� | �ddd� | �dg d� | �d g d� | �d d d� d� | �d g d� | �d d!d� | �d"d#d� | �d$d%d� | �d&d'd� | �d(d)d� | �d*d+d� | �d,d-d� d� | �d.dd� | �d/dd� | �d0d1dtd1d2�� | jd3td4d5� | �d6t� d7d#d#d8�S )9N�
epub_basenamec S s
t | j�S �N)r �projectr/ r r r �<lambda>� �
zsetup.<locals>.<lambda>r8 g @r$ �
epub_theme�epub_theme_optionsr� c S � | j S r� )r� r/ r r r r� � � r� c S r� r� ��authorr/ r r r r� � r� rf c S s
| j pdS )N�en)�languager/ r r r r� � r� r� c S r� r� r� r/ r r r r� � r� r� c S r� r� )� copyrightr/ r r r r� � r� r� �unknown� epub_schemer� ro �
epub_coverr �
epub_guide�epub_pre_files�epub_post_filesr� c S r� r� )�html_css_files)r9 r r r r� r� �epub_exclude_filesrY � � epub_tocdupTrn ri �epub_fix_imagesF�epub_max_image_widthr �epub_show_urls�inline�epub_use_indexc S r� r� )�html_use_indexr/ r r r r�
r� r? r@ r: r! r" z
config-initedi )�priorityzbuilder-inited�builtin)r7 �parallel_read_safe�parallel_write_safe)� add_builderr# �add_config_valuer �connectr� r� r� r r r �setup� sJ
� �r� ).rz r= �osr �typingr r r r r r �sphinxr �sphinx.applicationr
�sphinx.buildersr �
sphinx.configr r
�
sphinx.localer � sphinx.utilr r �sphinx.util.fileutilr �sphinx.util.i18nr �sphinx.util.osutilr � getLoggerr rl r rA rC rN r~ r� � EpubBuilderr# r� r� r r� r r r r �<module> s>
����'