}cjq <dZddlZddlZddlZddlmZddlmZmZmZm Z m Z m Z ddl m Z mZmZddlmZddlmZmZddlmZdd lmZdd lmZmZdd lmZdd lmZm Z dd l!m"Z"ddl#m$Z$ddl%m&Z&m'Z' ddl(m)Z)n #e*$rdZ)YnwxYwej+e,Z-dZ.dZ/dZ0dZ1dZ2dZ3dddZ4ddddddd d d!d"d#d$ Z5d%Z6ej7d&Z8Gd'd(e Z9Gd)d*e Z:Gd+d,e Z;Gd-d.e Ze>Z?Gd4d5eZ@dS)7z#Base class of epub2/epub3 builders.N)path)AnyDictList NamedTupleSetTuple) ZIP_DEFLATED ZIP_STOREDZipFile)nodes)ElementNode) smartquotes)addnodes) BuildInfoStandaloneHTMLBuilder)__)loggingstatus_iterator)copy_asset_file) format_date)copyfile ensuredir)Imagezepub-cover.xhtmlz toctree-l%dz [%(uri)s]z#%d Footnotesz link-targetzTable of ContentsCover)toccoverzapplication/xhtml+xmlztext/css image/pngz image/webp image/gif image/svg+xml image/jpegzapplication/x-font-otfzapplication/x-font-ttfzapplication/font-woff) .xhtmlz.cssz.pngz.webpz.gif.svgz.jpgz.jpegz.otfz.ttfz.woff)r%z ([^#:]*#)(.*)c.eZdZUeed<eed<eed<dS) ManifestItemhrefid media_typeN__name__ __module__ __qualname__str__annotations__:lib/python3.11/site-packages/sphinx/builders/_epub_base.pyr'r'Ms+ III GGGOOOOOr2r'c$eZdZUeed<eed<dS)SpineidreflinearN)r,r-r.r/r0boolr1r2r3r5r5Ss" JJJ LLLLLr2r5c.eZdZUeed<eed<eed<dS)GuidetypetitleuriNr+r1r2r3r:r:Xs+ III JJJ HHHHHr2r:cNeZdZUeed<eed<eed<eed<eeed<dS)NavPointnavpoint playordertextrefurichildrenN)r,r-r.r/r0intrrr1r2r3r?r?^sFMMMNNN III KKK3ir2r?entlanguagereturnc|dd}tj|}tj||}|dd}|S)Nz"")replacereducateDashesOldSchool educateQuotes)rGrHs r3sphinx_smarty_pantsrOgsO (C  A*1--A!!X..A #x  A Hr2c BeZdZdZdZgdZdZdZdZdZ dZ dZ dZ e ZeZeZeZeZeZeZdZdZd;fd Zdefd Zde e!e"ffd Z#d e!de!fd Z$d e%de&e"e!e'fde&e"e!e'ffdZ(de&e"e!e'fddfdZ)d;dZ*de&e"e!e'fddfdZ+de!de!de!fdZ,de-j.ddfdZ/dd.e!ddfd/Z:de"e!e'ffd0Z;d;d1Zfd5Z?de&e"e!e'fde&e>fd6Z@d3e=d7e&e>de"e!e'ffd8ZAd;d9ZBd;d:ZCxZDS)@ 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#TrINctd|_d|_d|_d|_i|_|dd|_g|_ dS)Nr$r use_indexepub) superinit out_suffix link_suffixrAtocidid_cacheget_builder_configrTrefnodesself __class__s r3rWzEpubBuilder.initsZ  "# (* 00fEE.0 r2c<t|j|jddgS)NhtmlrU)rconfigtagsr_s r3create_build_infozEpubBuilder.create_build_infosdi&&1ABBBr2c2|jj|jjfSN)rc epub_themeepub_theme_optionsres r3get_theme_configzEpubBuilder.get_theme_configs{%t{'EEEr2namec|j|}|s'd|jdz}||j|<|S)zReturn a unique id for name.zepub-%drU)r[getenv new_serialno)r_rlr)s r3make_idzEpubBuilder.make_idsL]  t $ $ %TX226:::B"$DM$  r2doctreeresultc t|tjr|dr|d}|ds?|ds*|ds|dr|S|jjd}tddd D]l}|j|z|vr^| |tj |ttj | d nmn5t|tjr|D]}|||}|S) z>Collect section titles, their depth in the toc and the refuri.rCzhttp://zhttps://zirc:zmailto:classesrlevelrCrB) isinstancer referencern startswithparent attributesrangetoctree_templateappendrbescapesspastextr get_refnodes)r_rrrsrCruryelems r3rzEpubBuilder.get_refnodessk gu / / 9GKK4I4I 9X&F  ++ v/@/@/L/L ##F++ /5/@/@/K/K  n/ :Gq!R  )E1g=MM!&"&+f"5"5 #DK0@0@$A$A B B## E  / / 9 9 9**488 r2r ct}|D]Y}|d|vr2ttd|ddd>||dZdS)NrCzduplicated ToC entry found: %srUduplicated_toc_entryr;subtype)setloggerwarningradd)r_r appearednodes r3check_refnodeszEpubBuilder.check_refnodess UU - -DH~) -788N2  T(^,,,, - -r2c:|j|jj|dd}||g|_t j|jj}|r|dz }|jD]}||dz|d<||jdS)zwGet the total table of contents, containing the root_doc and pre and post files not managed by sphinx. FTprune_toctrees includehidden/rCN) roget_and_resolve_doctreercroot_docrr]rdirname toc_add_files)r_rr master_diritems r3get_toczEpubBuilder.get_tocs(224;3G37AE3GG))'266 \$+"677  = # J  = =!+d8n!<X 4=)))))r2r]c |ddtj|jj|jzt tj|jj|jj dt|jj D]P\}}|ddtj|t tj|dQ|jj D]O\}}| dtj|t tj|dPdS)zDAdd the root_doc, pre and post files to a list of refnodes. rrxN)insertrbrrcrrXrrotitlesrreversedepub_pre_filesepub_post_filesr)r_r]filerBs r3rzEpubBuilder.toc_add_filessZ k$+"6"HII  45<<>>@@AA     #4;#=>>  JD$ OOA+d++DK--..       +5  JD$ OO+d++DK--..      r2prefixfragmentc4||ddzS)z;Return a href/id attribute with colons replaced by hyphens.:-)rL)r_rrs r3 fix_fragmentzEpubBuilder.fix_fragments((c2222r2treecdtddffd }|tjD]}d|vraj|d}|r?|d|d|d<d|vrd |d|d<|tjD]H}||| d }t|tjr ||I|tj D] }||dS) zReplace colons with hyphens in href and id attributes. Some readers crash because they interpret the part as a transport protocol specification. rrINcg}|dD]1}d|}||vr||2||d<dS)zUpdate IDs of given *node*.idsrRN)rr)rnew_idsnode_idnew_idr_s r3update_node_idz+EpubBuilder.fix_ids..update_node_ids]!#G; + +**2w77(+NN6***!DKKKr2rCrrefidrRT)ascend) rfindallr r{ refuri_rematchrgrouptarget next_noderzrdesc_signature)r_rrr{mrrrs` r3fix_idszEpubBuilder.fix_idss  " "T " " " " " "eo66 O OI9$ TN((8)<==T*.*;*;AGGAJJPQ *S*SIh')# O%)%6%6r9W;M%N%N '"ll5<00 * *F N6 " " "$..d.;;I)U]33 *y)))"ll8+BCC + +N N> * * * * + +r2inline show_urlscdtjdtdtjfd}dtjdtdtdtjfd}dtjdt t tffd}|d krd S|d kr.make_footnote_ref&sJ 3F;;L    5 1 1 2 2 2  % %l 3 3 3 r2r=cHtj|}tj}|tj||||dtjd||||S)z$Create a footnote node with childrenrrR)r footnote paragraphrrrrnote_autofootnote)rrr=rparas r3 make_footnotez4EpubBuilder.add_visible_links..make_footnote-s~c**H?$$D KK 3 ( ( ( OOD ! ! ! OOAu{2u55 6 6 6  ! !( + + +Or2rct|tj}|r,|d}|j|j|dzfS|tjD]X}t|dkrC|tkr&|j|j|dzfcSYt|tj }tj}| tj t| ||||dzfS)zfFind or create a spot to place footnotes. The function returns the tuple (parent, index).rwr)listrr rr}indexrubriclenrFOOTNOTES_RUBRIC_NAMEnextdocumentrr)rfnsfnrrrubs r3 footnote_spotz4EpubBuilder.add_visible_links..footnote_spot7s-t||EN3344C :Wy")//""5"5"999 U\22 D Dt99>Ddkkmm7L&LD; (9(9$(?(?!(CCCCCt||EN3344C,..C JJuz"788 9 9 9 JJsOOO #** *r2noNrrrCrRzhttp:zhttps:zftp:rrurrr)r rr/rrr rrErrrr{rnr|rr}rlink_target_templaterrcss_link_target_classrFOOTNOTE_LABEL_TEMPLATE add_backref)r_rrrrrrfn_spotfn_idxnrrr=idxlinkrrrs r3add_visible_linkszEpubBuilder.add_visible_links#s 5> # %BZ     u~ c       + +5#3F + + + +*    F  " t||EN3344C+mD11OGVBeo6677  D((8R((Cw'' 3>>(+C+C NN6** 034;;==0H k''--1( 3uclBC <S11DO**4+EFFFK&&sD1111*,  3b8E!GB#4#4S%#@#@LK&&sL999,}S%==HNN68444,4UOA,>L)((e) [ [3 3UHd+4U+;+;OO'Q,,T22AO$*$($5$5aggajj!''!**$M$M$Oa4<[[0M=/8/G/G[[+NVT N0066[06040A0A!''!**aggVWjj0Y0Y0[M!,[[ [ [ [r2filenamecHtj|d}|tvS)z=Does the filename extension indicate a vector graphic format?rw)rsplitextVECTOR_GRAPHICS_EXTENSIONS)r_rexts r3is_vector_graphicszEpubBuilder.is_vector_graphicss"mH%%b)000r2c ttj|j|jt |jtddt|j|j j D]Q}|j|} tj tj|j |}n#t$r||s@t tdtj|j | t%tj|j |tj|j|j|nX#t$rK}t tdtj|j ||Yd}~nd}~wwxYwYAwxYw|jjr|jdvr|}|jjdkrF|j\}}|jj}||kr*||z|z }|||ftj} |tj|j|j|#t$rL}t tdtj|j ||Yd}~Kd}~wwxYwdS) zCopy 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... brownz-cannot read image file %r: copying it insteadzcannot copy image file %r: %sN)Przcannot write image file %r: %s)rrjoinoutdirimagedirrimagesrrapp verbosityropensrcdirOSErrorrrrrrcepub_fix_imagesmodeconvertepub_max_image_widthsizeresizeBICUBICsave) r_srcdestimgerrwidthheightnwnhs r3copy_image_files_pilz EpubBuilder.copy_image_files_pils $)DK77888"4;3G0H0H'#&t{#3#3TX5GII A AC;s#D j4;!#>@@@ETYt{C88!Yt{DM4HHJJJJEEENN2&E#F#F#'9T[##>#>EEEEEEEEE {* (8v%(++--C{/!3 >"%([52:> 2+.B**b"Xu}==C A4; tDDEEEE A A Ar"BCC#yc::CAAAAAAAA A; A AsX?,B--AF0 AEF0 F)AF$F0$F))F0/F033I(( J>2AJ99J>cV|jr|jjs |jjrftsIt tdt dS| dSt dSdS)zzCopy image files to destination directory. This overwritten method can use Pillow to convert image files. z&Pillow not found - copying image filesN) rrcr r rrrrrVcopy_image_filesrr^s r3rzEpubBuilder.copy_image_filess ; +{* +dk.N +0NN2&N#O#OPPPGG,,.....--/////((***** + +r2cdSrhr1res r3copy_download_fileszEpubBuilder.copy_download_filess r2 page.htmlpagenameaddctx templatename outfilename event_argc|dr(d|vr$|jsdS||d|j|d<t |||||dS)zCreate a rendered page. This method is overwritten for genindex pages in order to fix href link attributes. genindexgenindexentriesNdoctype)r|rTrr(rV handle_page)r_r r!r"r#r$r`s r3r)zEpubBuilder.handle_pages   z * * 9/@F/J 9>    f%67 8 8 8 Ly HflKSSSSSr2cttdtt j|jd|jdS)z!Write the metainfo file mimetype.zwriting mimetype file...mimetypeN)rinforrrr template_dirrres r3build_mimetypezEpubBuilder.build_mimetypesD B122333 $"3Z@@$+NNNNNr2META-INF/container.xmloutnamecttdtj|jd}t |ttj|jd|dS)z/Write the metainfo file META-INF/container.xml.z&writing META-INF/container.xml file...zMETA-INFz container.xmlN) rr,rrrrrrr-)r_r0rs r3build_containerzEpubBuilder.build_containersc B?@@AAA4; 33& $"3_EEvNNNNNr2ci}tj|jj|d<tj|jj|d<tj|jj|d<tj|jj|d<tj|jj|d<tj|jj|d<tj|jj |d<tj|jj |d<tjtd d |d <g|d <g|d<g|d<|S)zaCreate a dictionary with all metadata for the content.opf file properly escaped. r<authoruidlang publisher copyrightschemer)z%Y-%m-%drF)rHdatemanifest_itemsspinesguides) rbrrc epub_title epub_authorepub_uid epub_languageepub_publisherepub_copyright epub_schemeepub_identifierr)r_metadatas r3content_metadatazEpubBuilder.content_metadatas$& K (>??![)@AA+dk&:;;;t{'@AA $ DK,F G G $ DK,F G G![)@AAT[%@AA;{:'M'M'MNN%'!"r2c ttd|}|jt js|xjt jz c_t|j}g|_ dddddddd d |j j d zg |j j z|_ |js"|j d |jzt j|jD]c\}}}|t'|D]7}t)j|||d }||j vr*t)j|d}||jvr0|dvr+ttd|dd}|t jd}t5t7j|t7j||t7j|j|} |d| |j |9et=} |jD]} d| dvr | d|j vrtAt7j|| dd} |d| | !| d|j"D]} tAt7j|| d|jzd} |d| | !| d|jz|jrutAt7j|d |jzd} |d| | !d |jz|j D]p}|| vrj||jrPtAt7j||d} |d| qd }|j j#r|j j#\}}|t jd}t7j|||d<|rtAt7j||j$d} |d%d| |j$|j vrt)j|j$d}|j |j$t5t7j|j$t7j||j$t7j|j|} |d| t7j||j j&d}|'t)j|j$d||| !|j$d}d}|j j(r|j j(D]\}}}|)dd}||j vr|j ||dkrd}|dkrd}|dtUt7j|t7j|t7j||rN|rL|dtUd|j+dt7j|j$|r_|jrX|dtUd|j+dt7j|jddtYt)j|j-d |j|d S)!zWrite 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.opftoc.ncxr/z Thumbs.dbz ehthumbs.dbz .DS_Storez nav.xhtml.epubr&Nrw)z.jsz.xmlz!unknown mimetype for %s, ignoringrUunknown_project_filesrrr;#rCTr<rFr)imager<rr=z content.opf_t).rr,rrGrendswithosseprfilesrc epub_basenameepub_exclude_files ignored_filesrTrrXwalksortsortedrrr media_typesrrLr'rbrrqrr]r5rdomain_indices epub_covercoverpage_namerprojectr) epub_guidesplitr: guide_titlesrr-)r_rFolenrootdirsrRrrrr spinefilesrefnodespiner,rl html_tmplrNctxauto_add_cover auto_add_tocr;r=r<rs r3 build_contentzEpubBuilder.build_contents  B455666((**{##BF++ " KK26 !KK4; " *J ')A)=+)4;+Dw+NP K * + ~ D   % %j4?&B C C C!#!5!5 , , D$ IIKKKUmm , ,9T2..tuu5t11mH--b1d../1Ur*M'N'NPX,2 9$+dll:3O&P&PQQSWXXE X  % %e , , , NN:7 8 8 8J 1 1D:% 1$--*H*H 1dk$,,t*<*<==uEE"))%000 ; ! 4#{5 E9MM"&#..E $ DLL,?,? @ @HW  4dk$,,t7J*K*KLLdSS"))!U333&dj8<-(;<V d8nb:: :r2c g}|tddddgd}d}|D]}|ds |ddd}||jvr7|d|jjkrN|d|kra|||}||d j|||nJ|d|d zkr|d z }|rA|jj r5|d j|||d |||}|d j|||n|d|kr|dt|kr-||dt|k-|d}|||}|d j|||n|} |djS) zCreate the toc navigation structure. Subelements of a node are nested inside the navpoint. For nested nodes the parent node is reinserted in the subnav. dummyrrRNrBrCrMryrwrF) rr?r_rUrc epub_tocdepthrnpoprD epub_tocdupr)r_r navstackrylastnoderrr@s r3build_navpointszEpubBuilder.build_navpointsesX $&!RR88999  D< >'',,Q/Dt)) G}t{88 G}% ,,T599  %,,X666))))g%!)+  \ 7\RL)001B1B8UTY1Z1Z[[[,,T599 %,,X666))))g& 7mc(mm3#LLNNN7mc(mm3#W ,,T599 %,,X666))))HH{##r2 navpointsc~i}|jj|d<tj|jj|d<||d<||d<|S)z]Create a dictionary with all metadata for the toc.ncx file properly escaped. r5r<ryrw)rcr@rbrr>)r_ryrwrFs r3 toc_metadatazEpubBuilder.toc_metadatasI$&+. K (>??! )r2crttd|jjdkrT|j|jj|dd}||g}| |n|j }| || |}td|j D}t||jj}t!t#j|jd|j|||dS)z Write the metainfo file toc.ncx.zwriting toc.ncx file...defaultFrc3&K|] }|dV dS)ryNr1).0rs r3 z(EpubBuilder.build_toc..s&<&:t,333#3#3333+EN+t++++BB B enB B TXB B B B H,,u~,$,,,,,,[eCeCHo1F,F&G!H[T[[[[$13141111 %A%A%A%AN + + + + + +    LW>B T TC T TS T!$ T8; TGK T T T T T TOOOO OOsO$OOOO$sCx.&m^m^m^m^^::c3h::4:S[::::*$T$sCx.%9*$d8n*$*$*$*$X # $x. T#s(^    ====(UUUUUUUUr2rQ)rF)ArrbrPrertypingrrrrrr zipfiler r r docutilsr docutils.nodesrrdocutils.utilsrsphinxrsphinx.builders.htmlrr sphinx.localer sphinx.utilrrsphinx.util.fileutilrsphinx.util.i18nrsphinx.util.osutilrrPILr ImportError getLoggerr,rrrrrrrrrrcompilerr'r5r:r?r/rOrrQr1r2r3rsM)) ::::::::::::::::5555555555((((((((&&&&&&AAAAAAAA00000000000000((((((22222222 EEE  8 $ $$ ##%   &        $ $ $   ' BJ ' ' : J      J   z  3 #      J UJ UJ UJ UJ U'J UJ UJ UJ UJ Us4A;;BB