B .ÛKc=*ã@s<dZddlZddlmZddlmZmZmZmZm Z m Z ddl m Z ddl mZddlmZddlmZmZdd lmZdd lmZmZdd lmZdd lmZdd lmZe e ¡Z!Gdd„deƒZ"dddœZ#dddœZ$dddœZ%dZ&dZ'Gdd„dej(ƒZ)eddœdd„Z*eeddœd d!„Z+eee,efdœd"d#„Z-dS)$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@s*eZdZUeed<eed<eeed<dS)ÚNavPointÚtextÚrefuriÚchildrenN)Ú__name__Ú __module__Ú __qualname__ÚstrÚ__annotations__rr©rrú4lib/python3.7/site-packages/sphinx/builders/epub3.pyrs rZltrZrtl)Ú horizontalÚverticalr rz vertical-rlz horizontal-tb)r rzzUcsÈeZdZdZdZedƒZdZe  e dd¡Z e Z eZdZdd œd d „Zeeefd œ‡fd d „ Zeeddœ‡fdd„ Zeeeefeedœdd„Zeeeeefdœdd„Zdd œdd„Z‡ZS)Ú 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. ÚepubzThe ePub file is in %(outdir)s.FZ templatesZepub3TN)ÚreturncCs<| ¡| ¡| ¡| ¡| ¡| ¡| ¡dS)z/Create the metainfo files and finally the epub.N)Zget_tocZbuild_mimetypeZbuild_containerZ build_contentÚbuild_navigation_docZ build_tocZ build_epub)ÚselfrrrÚ handle_finishFszEpub3Builder.handle_finishcsŠ|jj}tƒ ¡}t |jj¡|d<t |jj¡|d<t  |¡|d<t   |¡|d<t t ddd¡|d<t |jj ¡|d <|jj |d <|S) zaCreate a dictionary with all metadata for the content.opf file properly escaped. Ú descriptionZ contributorZpage_progression_directionZibook_scroll_axisz%Y-%m-%dT%H:%M:%SZÚen)ÚlanguageZdateÚversionÚ epub_version)ÚconfigÚepub_writing_modeÚsuperÚcontent_metadataÚhtmlÚescapeÚepub_descriptionÚepub_contributorÚPAGE_PROGRESSION_DIRECTIONSÚgetÚIBOOK_SCROLL_AXISrr*r+)r%Ú writing_modeÚmetadata)Ú __class__rrr/Ps  zEpub3Builder.content_metadata)Údocnamesr#csJtƒ |¡|jj}t |¡|jd<|j|jd<|j|jd<d|jd<dS)NZtheme_writing_modeÚhtml_tagÚuse_meta_charsetTZskip_ua_compatible) r.Úprepare_writingr,r-ÚTHEME_WRITING_MODESr5Z globalcontextr;r<)r%r:r7)r9rrr=`s    zEpub3Builder.prepare_writing)Únavnodesr#cCsBg}| tddgƒ¡d}x|D]}|ds2q"|d d¡d}||jkrPq"|d|jjkrbq"t|d|dgƒ}|d|kr¦| ¡|dj |¡| |¡q"|d|dkrÚ|d7}|dj |¡| |¡q"|d|kr,x|dt|ƒkr| ¡qêW|d}|dj |¡| |¡q"t d ƒ‚q"W|djS) acCreate 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. Úrrrú#Úleveléÿÿÿÿéz+Should never reach here. It might be a bug.) ÚappendrÚsplitZ ignored_filesr,Ú epub_tocdepthÚpoprÚlenÚ RuntimeError)r%r?ZnavstackrBZnodeÚfileZnavpointrrrÚ build_navlistis8        zEpub3Builder.build_navlist)Únavlistr#cCs6i}t |jj¡|d<t |jd¡|d<||d<|S)z_Create a dictionary with all metadata for the nav.xhtml file properly escaped. ÚlangZtocZ toc_localerM)r0r1r,Ú epub_languageZ guide_titles)r%rMr8rrrÚnavigation_doc_metadata“s z$Epub3Builder.navigation_doc_metadatacCs’t tdƒ¡|jjdkrJ|jj|jj|ddd}| |g¡}|  |¡n|j }|  |¡}t t  |jd¡|j| |¡ƒd|jkrŽ|j d¡dS)z"Write the metainfo file nav.xhtml.zwriting nav.xhtml file...ÚdefaultF)Zprune_toctreesZ includehiddenz nav.xhtml_tz nav.xhtmlN)ÚloggerÚinforr,Ú epub_tocscopeÚenvZget_and_resolve_doctreeZroot_docZ get_refnodesZ toc_add_filesÚrefnodesrLrrÚjoinÚ template_dirZoutdirrPÚfilesrE)r%ZdoctreerVrMrrrr$s       z!Epub3Builder.build_navigation_doc)rrrÚ__doc__ÚnamerÚepilogZsupported_remote_imagesrrWr rXÚDOCTYPEZdoctypeÚHTML_TAGr;r<r&rrrr/rr=rrrLrPr$Ú __classcell__rr)r9rr!4s  * r!)Úappr#cCsø|jjdkrdS|jjs&t tdƒ¡tƒ |jj ¡sDt tdƒ¡|jj sZt tdƒ¡|jj spt tdƒ¡|jj s†t tdƒ¡|jj sœt tdƒ¡|jjs²t tdƒ¡|jjsÈt td ƒ¡|jjsÞt td ƒ¡|jjsôt td ƒ¡dS) 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)Zbuilderr[r,rOrRÚwarningrrÚmatchÚepub_uidÚ epub_titleÚ epub_authorr3r2Úepub_publisherÚepub_copyrightÚepub_identifierr*)r`rrrÚvalidate_config_values³s, ri)r`r,r#c Cszg}xj|jD]`}t|tƒr*| |if¡q y|\}}| ||f¡Wq tk rjt tdƒ|¡w Yq Xq W||_dS)z?This converts string styled epub_css_files to tuple styled one.zinvalid css_file: %r, ignoredN)Úepub_css_filesÚ isinstancerrEÚ ExceptionrRrar)r`r,rjÚentryÚfilenameZattrsrrrÚconvert_epub_css_filesÚs   rocCsâ| t¡| ddd„d¡| ddd¡| ddd¡| d id¡| d d d„d¡| d d d„d¡| ddd„d¡| ddd„d¡| ddd„d¡| ddd¡| ddd¡| ddd¡| ddd¡| ddd¡| dgd¡| dgd¡| ddd„d¡| d gd¡| d!d"d¡| d#d$d¡| d%d&d¡| d'dd¡| d(d)d¡| d*d+d¡| d,d-d„d¡| d.dd¡| d/dd¡| d0d1dtd1d2ƒ¡|jd3td4d5| d6t¡d7d$d$d8œS)9NZ epub_basenamecSs t|jƒS)N)rÚproject)r%rrrÚïózsetup..Fr+g@r"Z epub_themeZepub_theme_optionsrdcSs|jS)N)rp)r%rrrrqórrrecSs|jS)N)Úauthor)r%rrrrqôrrrOcSs |jpdS)Nr()r))r%rrrrqõrrrfcSs|jS)N)rs)r%rrrrqörrrgcSs|jS)N)Ú copyright)r%rrrrq÷rrrhÚunknownZ epub_schemercrUZ epub_coverrZ epub_guideZepub_pre_filesZepub_post_filesrjcSs|jS)N)Zhtml_css_files)r,rrrrqÿrrZepub_exclude_filesrGéZ epub_tocdupTrTrQZepub_fix_imagesZepub_max_image_widthrZepub_show_urlsZinlineZepub_use_indexcSs|jS)N)Zhtml_use_index)r%rrrrqrrr2r3r-rr z config-initedi )Úpriorityzbuilder-initedZbuiltin)r*Zparallel_read_safeZparallel_write_safe)Z add_builderr!Zadd_config_valuer Zconnectrori)r`rrrÚsetupësF    rx).rZr0ÚosrÚtypingrrrrrrZsphinxr Zsphinx.applicationr Zsphinx.buildersr Z sphinx.configr r Z sphinx.localerZ sphinx.utilrrZsphinx.util.fileutilrZsphinx.util.i18nrZsphinx.util.osutilrZ getLoggerrrRrr4r6r>r]r^Z EpubBuilderr!rirorrxrrrrÚs4           '