§
    _÷#d=*  ã                   ó~  — d Z ddlZddlmZ ddlmZmZmZmZm	Z	m
Z
 ddlmZ ddlmZ ddlmZ ddlmZmZ dd	lmZ dd
lmZmZ ddlmZ ddlmZ ddlmZ  ej        e ¦  «        Z! G d„ de¦  «        Z"dddœZ#dddœZ$dddœZ%dZ&dZ' G d„ dej(        ¦  «        Z)deddfd„Z*dededdfd „Z+dedee,ef         fd!„Z-dS )"z5Build epub3 files.

Originally derived from epub.py.
é    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                   ó:   — e Zd ZU eed<   eed<   ee         ed<   dS )ÚNavPointÚtextÚrefuriÚchildrenN)Ú__name__Ú
__module__Ú__qualname__ÚstrÚ__annotations__r   r   © ó    ú7/usr/lib/python3/dist-packages/sphinx/builders/epub3.pyr   r      s4   € € € € € € Ø
€I€I�IØ€K€K�KØ�3ŒiÐÐÑÐÐr    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                   ó  ‡ — e Zd ZdZdZ ed¦  «        ZdZ ej	        e
dd¦  «        ZeZeZdZdd
„Zdeeef         fˆ fd„Zdee         dd	fˆ fd„Zdeeeef                  dee         fd„Zdee         deeef         fd„Zdd„Zˆ x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                 ó  — |                       ¦   «          |                      ¦   «          |                      ¦   «          |                      ¦   «          |                      ¦   «          |                      ¦   «          |                      ¦   «          dS )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©Úselfs    r!   Úhandle_finishzEpub3Builder.handle_finishF   s}   € à�Š‰ŒˆØ×ÒÑÔÐØ×ÒÑÔÐØ×ÒÑÔÐØ×!Ò!Ñ#Ô#Ð#Ø�ŠÑÔÐØ�ŠÑÔÐÐÐr    c                 ó  •— | j         j        }t          ¦   «                              ¦   «         }t	          j        | j         j        ¦  «        |d<   t	          j        | j         j        ¦  «        |d<   t           	                    |¦  «        |d<   t           	                    |¦  «        |d<   t	          j        t          dd¬¦  «        ¦  «        |d<   t	          j        | 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Úen©ÚlanguageÚdateÚversionÚepub_version)ÚconfigÚepub_writing_modeÚsuperÚcontent_metadataÚhtmlÚescapeÚepub_descriptionÚepub_contributorÚPAGE_PROGRESSION_DIRECTIONSÚgetÚIBOOK_SCROLL_AXISr   r@   rA   )r5   Úwriting_modeÚmetadataÚ	__class__s      €r!   rE   zEpub3Builder.content_metadataP   sÙ   ø€ ð ”{Ô4ˆå‘7”7×+Ò+Ñ-Ô-ˆÝ"&¤+¨d¬kÔ.JÑ"KÔ"Kˆ�ÑÝ"&¤+¨d¬kÔ.JÑ"KÔ"Kˆ�ÑÝ1L×1PÒ1PÐQ]Ñ1^Ô1^ˆÐ-Ñ.Ý(9×(=Ò(=¸lÑ(KÔ(KˆÐ$Ñ%Ýœ;¥{Ð3GÐRVÐ'WÑ'WÔ'WÑXÔXˆ�ÑÝ"œk¨$¬+Ô*=Ñ>Ô>ˆ�ÑØ#'¤;Ô#;ˆ�Ñ Øˆr    Údocnamesc                 óö   •— t          ¦   «                              |¦  «         | j        j        }t                               |¦  «        | j        d<   | j        | j        d<   | j        | j        d<   d| j        d<   d S )NÚtheme_writing_modeÚhtml_tagÚuse_meta_charsetTÚskip_ua_compatible)	rD   Úprepare_writingrB   rC   ÚTHEME_WRITING_MODESrK   ÚglobalcontextrS   rT   )r5   rP   rM   rO   s      €r!   rV   zEpub3Builder.prepare_writing`   su   ø€ Ý‰Œ×Ò Ñ)Ô)Ð)à”{Ô4ˆÝ3F×3JÒ3JÈ<Ñ3XÔ3XˆÔÐ/Ñ0Ø)-¬ˆÔ˜:Ñ&Ø15Ô1FˆÔÐ-Ñ.Ø37ˆÔÐ/Ñ0Ð0Ð0r    Únavnodesc                 óÈ  — g }|                      t          ddg ¦  «        ¦  «         d}|D �]ª}|d         sŒ|d                              d¦  «        d         }|| j        v rŒ7|d         | j        j        k    rŒNt          |d         |d         g ¦  «        }|d         |k    rJ|                     ¦   «          |d         j                              |¦  «         |                      |¦  «         ŒÁ|d         |dz   k    r<|dz  }|d         j                              |¦  «         |                      |¦  «         �Œ|d         |k     r…|d         t          |¦  «        k     r-|                     ¦   «          |d         t          |¦  «        k     °-|d         }|d         j                              |¦  «         |                      |¦  «         �Œ�t          d	¦  «        ‚|d         j        S )
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_filesrB   Úepub_tocdepthÚpopr   ÚlenÚRuntimeError)r5   rY   Únavstackr]   ÚnodeÚfileÚnavpoints          r!   Úbuild_navlistzEpub3Builder.build_navlisti   sÞ  € ð $&ˆØ�Š�  R¨Ñ,Ô,Ñ-Ô-Ð-ØˆØð 	Rñ 	RˆDØ˜”<ð ØØ˜”>×'Ò'¨Ñ,Ô,¨QÔ/ˆDØ�tÔ)Ð)Ð)ØØ�GŒ}˜tœ{Ô8Ò8Ð8Øå  V¤¨d°8¬n¸bÑAÔAˆHØ�GŒ} Ò%Ð%Ø—’‘”�Ø˜”Ô%×,Ò,¨XÑ6Ô6Ð6Ø—’ Ñ)Ô)Ð)Ð)Ø�g” %¨!¡)Ò+Ð+Ø˜‘
�Ø˜”Ô%×,Ò,¨XÑ6Ô6Ð6Ø—’ Ñ)Ô)Ð)Ñ)Ø�g” Ò&Ð&Ø˜7”m¥c¨(¡m¤mÒ3Ð3Ø—L’L‘N”N�Nð ˜7”m¥c¨(¡m¤mÒ3Ð3à˜Wœ�Ø˜”Ô%×,Ò,¨XÑ6Ô6Ð6Ø—’ Ñ)Ô)Ð)Ñ)å"Ð#PÑQÔQÐQà˜Œ{Ô#Ð#r    Únavlistc                 óš   — i }t          j        | j        j        ¦  «        |d<   t          j        | j        d         ¦  «        |d<   ||d<   |S )z_Create a dictionary with all metadata for the nav.xhtml file
        properly escaped.
        ÚlangÚtocÚ
toc_localerl   )rF   rG   rB   Úepub_languageÚguide_titles)r5   rl   rN   s      r!   Únavigation_doc_metadataz$Epub3Builder.navigation_doc_metadata“   sM   € ð ˆÝœ; t¤{Ô'@ÑAÔAˆ�ÑÝ!%¤¨TÔ->¸uÔ-EÑ!FÔ!Fˆ�ÑØ%ˆ�ÑØˆr    c                 ó   — t                                t          d¦  «        ¦  «         | j        j        dk    rT| j                             | j        j        | dd¬¦  «        }|                      |g ¦  «        }|  	                    |¦  «         n| j
        }|                      |¦  «        }t          t          j        | j        d¦  «        | j        |                      |¦  «        ¦  «         d| j        vr| j                             d¦  «         dS dS )z"Write the metainfo file nav.xhtml.zwriting nav.xhtml file...ÚdefaultF)Úprune_toctreesÚincludehiddenznav.xhtml_tz	nav.xhtmlN)ÚloggerÚinfor   rB   Úepub_tocscopeÚenvÚget_and_resolve_doctreeÚroot_docÚget_refnodesÚtoc_add_filesÚrefnodesrk   r   r   ÚjoinÚtemplate_dirÚoutdirrs   Úfilesr`   )r5   Údoctreer€   rl   s       r!   r1   z!Epub3Builder.build_navigation_doc�   s  € å�Š•BÐ2Ñ3Ô3Ñ4Ô4Ð4àŒ;Ô$¨	Ò1Ð1Ø”h×6Ò6Ø”Ô$ dØ$°Eð 7ñ ;ô ;ˆGð ×(Ò(¨°"Ñ5Ô5ˆHØ×Ò˜xÑ(Ô(Ð(Ð(ð ”}ˆHØ×$Ò$ XÑ.Ô.ˆÝ�œ	 $Ô"3°]ÑCÔCÀTÄ[Ø×4Ò4°WÑ=Ô=ñ	?ô 	?ð 	?ð ˜dœjÐ(Ð(ØŒJ×Ò˜kÑ*Ô*Ð*Ð*Ð*ð )Ð(r    )r+   N)r   r   r   Ú__doc__Únamer   ÚepilogÚsupported_remote_imagesr   r�   r
   r‚   ÚDOCTYPEÚdoctypeÚHTML_TAGrS   rT   r6   r   r   r   rE   r   rV   r   r   rk   rs   r1   Ú__classcell__)rO   s   @r!   r'   r'   4   sR  ø€ € € € € ðð ð €DØˆRÐ1Ñ2Ô2€Fà#ÐØ�4”9˜[¨+°wÑ?Ô?€LØ€GØ€HØÐðð ð ð ð $ s¨C x¤.ð ð ð ð ð ð ð 8¨¨C¬ð 8°Tð 8ð 8ð 8ð 8ð 8ð 8ð($ d¨4°°S°¬>Ô&:ð ($¸tÀH¼~ð ($ð ($ð ($ð ($ðT¨t°H¬~ð À$ÀsÈCÀxÄ.ð ð ð ð ð+ð +ð +ð +ð +ð +ð +ð +r    r'   Úappr+   c                 óh  — | j         j        dk    rd S | j        j        s't                               t          d¦  «        ¦  «         t          ¦   «                              | j        j	        ¦  «        s't                               t          d¦  «        ¦  «         | j        j
        s't                               t          d¦  «        ¦  «         | j        j        s't                               t          d¦  «        ¦  «         | j        j        s't                               t          d¦  «        ¦  «         | j        j        s't                               t          d¦  «        ¦  «         | j        j        s't                               t          d¦  «        ¦  «         | j        j        s't                               t          d	¦  «        ¦  «         | j        j        s't                               t          d
¦  «        ¦  «         | j        j        s)t                               t          d¦  «        ¦  «         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‡   rB   rq   rx   Úwarningr   r   ÚmatchÚepub_uidÚ
epub_titleÚepub_authorrI   rH   Úepub_publisherÚepub_copyrightÚepub_identifierr@   ©rŽ   s    r!   Úvalidate_config_valuesrš   ³   s   € Ø
„{Ô˜6Ò!Ð!Øˆð Œ:Ô#ð <Ý�Š•rð :ñ ;ô ;ñ 	<ô 	<ð 	<õ ÑÔ×"Ò" 3¤:Ô#6Ñ7Ô7ð QÝ�Š•rÐNÑOÔOÑPÔPÐPàŒ:Ô ð <Ý�Š•rð :ñ ;ô ;ñ 	<ô 	<ð 	<ð Œ:Ô!ð UÝ�Š•rÐRÑSÔSÑTÔTÐTàŒ:Ô&ð ZÝ�Š•rÐWÑXÔXÑYÔYÐYàŒ:Ô&ð ZÝ�Š•rÐWÑXÔXÑYÔYÐYàŒ:Ô$ð XÝ�Š•rÐUÑVÔVÑWÔWÐWàŒ:Ô$ð <Ý�Š•rð :ñ ;ô ;ñ 	<ô 	<ð 	<ð Œ:Ô%ð YÝ�Š•rÐVÑWÔWÑXÔXÐXàŒ:Ôð QÝ�Š•rÐNÑOÔOÑPÔPÐPÐPÐPðQð Qr    rB   c                 ó0  — g }|j         D ]„}t          |t          ¦  «        r|                     |i f¦  «         Œ/	 |\  }}|                     ||f¦  «         ŒM# t          $ r+ t
                               t          d¦  «        |¦  «         Y Œ�w xY w||_         dS )z?This converts string styled epub_css_files to tuple styled one.zinvalid css_file: %r, ignoredN)Úepub_css_filesÚ
isinstancer   r`   Ú	Exceptionrx   r‘   r   )rŽ   rB   rœ   ÚentryÚfilenameÚattrss         r!   Úconvert_epub_css_filesr¢   Ú   s½   € à79€NØÔ&ð 	ð 	ˆÝ�e�SÑ!Ô!ð 	Ø×!Ò! 5¨" +Ñ.Ô.Ð.Ð.ðØ"'‘�˜%Ø×%Ò% x°Ð&7Ñ8Ô8Ð8Ð8øÝð ð ð Ý—’�rÐ"AÑBÔBÀEÑJÔJÐJØ�ðøøøð +€FÔÐÐs   ºAÁ2BÂBc           	      óè  — |                       t          ¦  «         |                      dd„ d¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      di d¦  «         |                      d	d
„ d¦  «         |                      dd„ d¦  «         |                      dd„ d¦  «         |                      dd„ d¦  «         |                      dd„ d¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      dg d¦  «         |                      dg 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d¦  «         |                      d.dd¦  «         |                      d/d0dt          d0d1¦  «        ¦  «         |                      d2t
          d3¬4¦  «         |                      d5t          ¦  «         d6d#d#d7œS )8NÚepub_basenamec                 ó*   — t          | j        ¦  «        S ©N)r   Úprojectr4   s    r!   ú<lambda>zsetup.<locals>.<lambda>ï   s   € µ}ÀTÄ\Ñ7RÔ7R€ r    FrA   g      @r(   Ú
epub_themeÚepub_theme_optionsr”   c                 ó   — | j         S r¦   )r§   r4   s    r!   r¨   zsetup.<locals>.<lambda>ó   s   € °D´L€ r    r•   c                 ó   — | j         S r¦   ©Úauthorr4   s    r!   r¨   zsetup.<locals>.<lambda>ô   s   € °T´[€ r    rq   c                 ó   — | j         pdS )Nr<   r=   r4   s    r!   r¨   zsetup.<locals>.<lambda>õ   s   € °t´}Ð7LÈ€ r    r–   c                 ó   — | j         S r¦   r­   r4   s    r!   r¨   zsetup.<locals>.<lambda>ö   s   € ¸¼€ r    r—   c                 ó   — | j         S r¦   )Ú	copyrightr4   s    r!   r¨   zsetup.<locals>.<lambda>÷   s   € ¸¼€ r    r˜   ÚunknownÚepub_schemer“   r{   Ú
epub_coverr   Ú
epub_guideÚepub_pre_filesÚepub_post_filesrœ   c                 ó   — | j         S r¦   )Úhtml_css_files)rB   s    r!   r¨   zsetup.<locals>.<lambda>ÿ   s	   € ¸&Ô:O€ r    Úepub_exclude_filesrc   é   Úepub_tocdupTrz   ru   Úepub_fix_imagesÚepub_max_image_widthr   Úepub_show_urlsÚinlineÚepub_use_indexc                 ó   — | j         S r¦   )Úhtml_use_indexr4   s    r!   r¨   zsetup.<locals>.<lambda>  s	   € ¸Ô8K€ r    rH   rI   rC   r$   r%   zconfig-initedi   )Úpriorityzbuilder-initedÚbuiltin)r@   Úparallel_read_safeÚparallel_write_safe)Úadd_builderr'   Úadd_config_valuer   Úconnectr¢   rš   r™   s    r!   ÚsetuprÌ   ë   sE  € Ø‡O‚O•LÑ!Ô!Ð!ð ×Ò˜Ð*RÐ*RÐTYÑZÔZÐZØ×Ò˜¨¨fÑ5Ô5Ð5Ø×Ò˜ v¨vÑ6Ô6Ð6Ø×ÒÐ-¨r°6Ñ:Ô:Ð:Ø×Ò˜Ð'@Ð'@À&ÑIÔIÐIØ×Ò˜Ð(@Ð(@À&ÑIÔIÐIØ×Ò˜Ð*LÐ*LÈfÑUÔUÐUØ×ÒÐ)Ð+CÐ+CÀVÑLÔLÐLØ×ÒÐ)Ð+FÐ+FÈÑOÔOÐOØ×ÒÐ*¨I°vÑ>Ô>Ð>Ø×Ò˜¨	°6Ñ:Ô:Ð:Ø×Ò˜ Y°Ñ6Ô6Ð6Ø×Ò˜ r¨5Ñ1Ô1Ð1Ø×Ò˜ r¨5Ñ1Ô1Ð1Ø×ÒÐ)¨2¨uÑ5Ô5Ð5Ø×ÒÐ*¨B°Ñ6Ô6Ð6Ø×ÒÐ)Ð+OÐ+OÐQWÑXÔXÐXØ×ÒÐ-¨r°5Ñ9Ô9Ð9Ø×Ò˜¨!¨UÑ3Ô3Ð3Ø×Ò˜¨¨eÑ4Ô4Ð4Ø×Ò˜¨)°UÑ;Ô;Ð;Ø×ÒÐ*¨E°5Ñ9Ô9Ð9Ø×ÒÐ/°°EÑ:Ô:Ð:Ø×ÒÐ)¨8°VÑ<Ô<Ð<Ø×ÒÐ)Ð+KÐ+KÈVÑTÔTÐTØ×ÒÐ+¨Y¸Ñ?Ô?Ð?Ø×ÒÐ+¨Y¸Ñ?Ô?Ð?Ø×ÒÐ,¨l¸FÝ˜l¨JÑ7Ô7ñ9ô 9ð 9ð ‡K‚K�Õ!7À#€KÑFÔFÐFØ‡K‚KÐ Õ"8Ñ9Ô9Ð9ð Ø"Ø#ðð ð r    ).r†   rF   Ú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   rx   r   rJ   rL   rW   rŠ   rŒ   ÚEpubBuilderr'   rš   r¢   r   rÌ   r   r    r!   ú<module>rÚ      sR  ððð ð
 €€€Ø Ð Ð Ð Ð Ð Ø :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :Ð :à Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %Ø &Ð &Ð &Ð &Ð &Ð &Ø &Ð &Ð &Ð &Ð &Ð &Ð &Ð &Ø Ð Ð Ð Ð Ð Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø (Ð (Ð (Ð (Ð (Ð (Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,à	ˆÔ	˜8Ñ	$Ô	$€ðð ð ð ð ˆzñ ô ð ð Øðð Ð ð
 Øðð Ð ð
 Ø!ðð Ð ð
  €ð1ð 	ð|+ð |+ð |+ð |+ð |+�:Ô)ñ |+ô |+ð |+ð~$Q ð $Q¨4ð $Qð $Qð $Qð $QðN+ ð +°ð +¸4ð +ð +ð +ð +ð"*ˆvð *˜$˜s C˜xœ.ð *ð *ð *ð *ð *ð *r    