-Pht pdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl mZddlmZmZmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(m)Z)m*Z*e rddl m+Z+ddl,m-Z-m.Z. ddl/m0Z0dZ1n #e2$rdZ1YnwxYwe j3e4Z5dZ6dZ7dZ8dZ9dZ:dZ;ddd Zej?d-Z@Gd.d/e ZAGd0d1e ZBGd2d3e ZCGd4d5e ZDd>d?d;ZEeEZFGd<d=eZGdS)@z#Base class of epub2/epub3 builders.) annotationsN)Path) TYPE_CHECKING NamedTuple)quote) ZIP_DEFLATED ZIP_STOREDZipFile)nodes) smartquotes)addnodes)StandaloneHTMLBuilder) BuildInfo)__)logging)_StrPath)status_iterator)copy_asset_file)copyfile ensuredirrelpath)Any)ElementNode)ImageTFzepub-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/jpegzfont/otfzfont/ttfz font/woff) .xhtmlz.cssz.pngz.webpz.gif.svgz.jpgz.jpegz.otfz.ttfz.woff)r%z ([^#:]*#)(.*)c.eZdZUded<ded<ded<dS) ManifestItemstrhrefid media_typeN__name__ __module__ __qualname____annotations__Z/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/builders/_epub_base.pyr'r'Zs+ III GGGOOOOOr2r'c$eZdZUded<ded<dS)Spiner(idrefboollinearNr,r1r2r3r5r5`s"JJJLLLLLr2r5c.eZdZUded<ded<ded<dS)Guider(typetitleuriNr,r1r2r3r:r:es+ IIIJJJ HHHHHr2r:cBeZdZUded<ded<ded<ded<ded<d S) NavPointr(navpointint playordertextrefurilist[NavPoint]childrenNr,r1r2r3r?r?ksBMMMNNN IIIKKKr2r?entr(languagereturnc|dd}tj|}tj||}|dd}|S)Nz"")replacer educateDashesOldSchool educateQuotes)rHrIs r3sphinx_smarty_pantsrPssO (C  A*1--A!!X..A #x  A Hr2c~eZdZUdZdZgdZdZdZdZdZ dZ dZ dZ e ZeZeZeZeZeZeZeZded<dZdMfd ZdNd Z dOdZ!dPdZ"dQdZ#dRdZ$dMdZ%dSdZ&dTdZ'dUd!Z( dVdWd$Z)dXfd& Z*dYd(Z+dZd+Z,dMd,Z-dMfd- Z.dMd.Z/ d[d0d0d1d\fd:Z0dMd;Z1d]d^d>Z2d_d?Z3dMd@Z4 d`dadFZ5dbdHZ6dcdJZ7dMdKZ8dMdLZ9xZ:S)d EpubBuilderzBuilder 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#Tr template_dirrJNonectd|_d|_d|_d|_i|_|dd|_g|_ dS)Nr$r use_indexepub) superinit out_suffix link_suffixrBtocidid_cacheget_builder_configrWrefnodesself __class__s r3rZzEpubBuilder.initsZ  "# (* 00fEE.0 r2rcVt|j|jtddhS)NhtmlrX)rconfigtags frozensetrbs r3create_build_infozEpubBuilder.create_build_infos%diFF;K1L1LMMMr2'tuple[str, dict[str, str | int | bool]]c2|jj|jjfSN)rf epub_themeepub_theme_optionsris r3get_theme_configzEpubBuilder.get_theme_configs{%t{'EEEr2namer(c|j|}|s'd|jdz}||j|<|S)zReturn a unique id for name.zepub-%drX)r^getenv new_serialno)rbrqr*s r3make_idzEpubBuilder.make_idsL]  t $ $ %TX226:::B"$DM$  r2doctreerresultlist[dict[str, Any]]c .t|tjr|dr|d}|dr|S|jjd}tdddD]l}|j|z|vr^| |tj |ttj | dnmn5t|tjr|D]}|||}|S)z>Collect section titles, their depth in the toc and the refuri.rD)zhttp://zhttps://zirc:zmailto:classesrlevelrDrC) isinstancer referencers startswithparent attributesrangetoctree_templateappendreescapesspastextr get_refnodes)rbrwrxrDr{relems r3rzEpubBuilder.get_refnodess) gu / / 9GKK4I4I 9X&F  !KLL  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)NrDzduplicated ToC entry found: %srXduplicated_toc_entryr;subtype)setloggerwarningradd)rbr appearednodes r3check_refnodeszEpubBuilder.check_refnodess UU - -DH~))788N2  T(^,,,, - -r2cF|j|jj|dd}||g|_t |jjj}|jD]}t||dz |d<| |jdS)zyGet the total table of contents, containing the master_doc and pre and post files not managed by Sphinx. FTprune_toctrees includehiddenrDN) rtget_and_resolve_doctreerf master_docrr`rrr( toc_add_files)rbrw master_diritems r3get_toczEpubBuilder.get_tocs(22 K "Dd3  ))'266 $+0118 M > >D d8n!<==DNN 4=)))))r2r`c |ddtj|jj|jzt tj|jj|jj dt|jj D]P\}}|ddtj|t tj|dQ|jj D]O\}}| dtj|t tj|dPdS)z;Add the root_doc, pre and post files to a list of refnodes.rr~N)insertrerrfroot_docr[rrttitlesrreversedepub_pre_filesepub_post_filesr)rbr`filerCs r3rzEpubBuilder.toc_add_filessR +dk&:T_&LMMK 0D E L L N NOO   #4;#=>>  JD$ OO"k$// D 1 122    +5  JD$ OO+d++DK--..      r2prefixfragmentc4||ddzS)z;Return a href/id attribute with colons replaced by hyphens.:-)rM)rbrrs r3 fix_fragmentzEpubBuilder.fix_fragments((c2222r2treenodes.documentcdfd }|tjD]}d|vraj|d}|r?|d|d|d<d |vrd |d |d <|tjD]H}|||d }t|tj r ||I|tj D] }||d S)zReplace colons with hyphens in href and id attributes. Some readers crash because they interpret the part as a transport protocol specification. rrrJrUcg}|dD]1}d|}||vr||2||d<dS)zUpdate IDs of given *node*.idsrTN)rr)rnew_idsnode_idnew_idrbs r3update_node_idz+EpubBuilder.fix_ids..update_node_ids[!#G; + +**2w77((NN6***!DKKKr2rDrrefidrTT)ascendN)rrrJrU) findallr r refuri_rematchrgrouptarget next_noderrr desc_signature)rbrrrmrrrs` r3fix_idszEpubBuilder.fix_idssm " " " " " "eo66 O OI9$$N((8)<==T*.*;*;AGGAJJPQ *S*SIh')##%)%6%6r9W;M%N%N '"ll5<00 * *F N6 " " "$..d.;;I)U]33 *y)))"ll8+BCC + +N N> * * * * + +r2inline show_urlscdd}dd }dd }|dkrdS|dkr.make_footnote_ref;sL!3F;;L    5 1 1 2 2 2  % %l 3 3 3 r2r=nodes.footnotecHtj|}tj}|tj||||dtjd||||S)z$Create a footnote node with childrenrrT)r footnote paragraphrrrrnote_autofootnote)rrr=rparas r3 make_footnotez4EpubBuilder.add_visible_links..make_footnoteDs~c**H?$$D KK 3 ( ( ( OOD ! ! ! OOAu{2u55 6 6 6  ! !( + + +Or2rtuple[Element, int]ct|tj}|r,|d}|j|j|dzfS|tjD]X}t|dkrC|tkr&|j|j|dzfcSYt|tj }tj}| tj t| ||||dzfS)zsFind or create a spot to place footnotes. The function returns the tuple (parent, index). r}r)listrr rrindexrubriclenrFOOTNOTES_RUBRIC_NAMEnextdocumentrr)rfnsfnrrrubs r3 footnote_spotz4EpubBuilder.add_visible_links..footnote_spotNs&t||EN3344C :Wy")//""5"5"999 U\22 D Dt99>>dkkmm7L&L&L; (9(9$(?(?!(CCCCCt||EN3344C,..C JJuz"788 9 9 9 JJsOOO #** *r2noNrrrDrT)zhttp:zhttps:zftp:rr{rrr)rrrr(rJr)rrrr(r=r(rJr)rrrJr)rrr rrrrsrrrrlink_target_templaterrcss_link_target_classrFOOTNOTE_LABEL_TEMPLATE add_backref)rbrrrrrrfn_spotfn_idxnrrr=idxlinkrrrs r3add_visible_linkszEpubBuilder.add_visible_links6s          + + + +,    F  " "t||EN3344C+mD11OGVBeo6677  D((8R((C~~9:: s$++--?W?Wk''--1((3uclBC <S11DO**4+EFFFK&&sD1111*,,3b8E!GB#4#4S%#@#@LK&&sL999,}S%==HNN68444,4UOA,>L)((e)  3 3UHd)25)9)9UU%A~ N00666qU#)4+<+FD $ 4 4T : ::1 & $ 1 1!''!**aggajj I I0M!,   r2filenamer7c^tj|d}|tvS)z=Does the filename extension indicate a vector graphic format?r})ospathsplitextVECTOR_GRAPHICS_EXTENSIONS)rbrexts r3is_vector_graphicszEpubBuilder.is_vector_graphicss(gx((,000r2ct|j|jz t|jt ddt |j|jjD]}|j|} tj |j |z }n#t$r| |s0tt d|j |z  t!|j |z |j|jz |z dnH#t$r;}tt d|j |z |Yd}~nd}~wwxYwYwxYw|jjr|jdkr|}|jjd krS|j\}}|jj}||kr7t/||z|z }|||ftj} ||j|jz |z #t$r<}tt d |j |z |Yd}~d}~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 insteadTforcezcannot copy image file %r: %sNPrzcannot write image file %r: %s)routdirimagedirrimagesrrapp verbosityropensrcdirOSErrorr rrrrfepub_fix_imagesmodeconvertepub_max_image_widthsizeroundresizeBICUBICsave) rbsrcdestimgerrwidthheightnwnhs r3copy_image_files_pilz EpubBuilder.copy_image_files_pils $+ -..." K # $ $     H    / / C;s#D js!233   ..s33NNJKK c)  c) dm3d:" NN:;; c) % &{* (8s??++--C{/!33"%([52:: u455B**b"Xu}==C t}4t;<<<<   788K#% U/ / sU/B  AE*DE E 1EEE  EE$%H  I1I  IcV|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) rrfrrPILLOW_AVAILABLErrrrYcopy_image_filesr(ras r3r+zEpubBuilder.copy_image_filess ; +{* +dk.N +'0NN2&N#O#OPPPGG,,.....--/////((***** + +r2cdSrmr1ris r3copy_download_fileszEpubBuilder.copy_download_filess r2 page.htmlN outfilename event_argpagenameaddctxdict[str, Any] templatenamer0 Path | Noner1rc|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. genindexgenindexentriesNdoctyper/)rrWrr:rY handle_page)rbr2r3r5r0r1rcs r3r;zEpubBuilder.handle_pages   z * * 9/@F/J/J>    f%67 8 8 8 Ly  fl y      r2cttdt|jdz |jdz ddS)z!Write the metainfo file mimetype.zwriting mimetype file...mimetypeTr N)rinforrrSrris r3build_mimetypezEpubBuilder.build_mimetypesV B122333   * K* $      r2META-INF/container.xmloutnamecttd|jdz }t |t |jdz |dz ddS)z/Write the metainfo file META-INF/container.xml.z&writing META-INF/container.xml file...zMETA-INFz container.xmlTr N)rr>rrrrrS)rbrArs r3build_containerzEpubBuilder.build_containersn B?@@AAAz)&   / _ $      r2ctjdx}"tjt |}ntj}t j|jjt j|jj t j|jj t j|jj t j|jj t j|jj t j|jjt j|jjt jtjd|gggd }|S)zaCreate a dictionary with all metadata for the content.opf file properly escaped. SOURCE_DATE_EPOCHNz%Y-%m-%d) r<authoruidlang publisher copyrightschemer*datemanifest_itemsspinesguides)rgetenvtimegmtimerArerrf epub_title epub_authorepub_uid epub_languageepub_publisherepub_copyright epub_schemeepub_identifierstrftime)rbsource_date_epoch time_tuplemetadatas r3content_metadatazEpubBuilder.content_metadatas"$+>!?!? ?  LS):%;%;<.js.xmlz!unknown mimetype for %s, ignoringrXunknown_project_filesr/rM#rDTrNrFNr)imager<rrOzcontent.opf.jinjacontextr )/rr>rr_filesrf epub_basenameepub_exclude_files ignored_filesrWrr[rwalkrrsortsortedrrr media_typesrrMsepr'rerrrvrr`r5rdomain_indicesendswith epub_covercoverpage_namerprojectr; epub_guidesplitr: guide_titlesrrS)rbr^rootdirsrl root_pathrrrr spinefilesrefnodespiner>rq html_tmplrictxauto_add_cover auto_add_tocr;r=r<rs r3 build_contentzEpubBuilder.build_content*s  B455666((**!#     $     K % /  [ +  ~ D   % %j4?&B C C C!#!5!5 , , D$T I IIKKKUmm , ,"9r>4;??t111g&&x004d.../11BCC$!'$; ' #++BFC88#Kh00K X 6 677K 0 566 )*11$777 !!(++++/ ,4UU } . .Ggh'''x D$666$+dll783D&E&EFFMME X  % %e , , , NN78, - - - -' 6 6D$+dll47T_3L&M&MNNPTUUE X  % %e , , , NN47T_4 5 5 5 5 > 9$+dll:3O&P&PQQSWXXE X  % %e , , , NN:7 8 8 8J 1 1D:%%$--*H*H%dk$,,t*<*<==uEE"))%000 ; ! 4#{5 E9MM"&#..E $ DLL,?,? @ @HW  4dk$,,t7J*K*KLLdSS"))!U333&dj88'**4+>??CCJ%%d&9:::' D$788 DLL1D$E$EFF D$4S$9::D -.55d;;; $ E 2 2T[=PQQ  G$$T%899!SU   r2rEctddddgg}d}d}|D]$}|ds |ddd}||jvr7|d|jjkrN|d|kra|||}||d j|||ng|d|d zkr|d z }|rA|jj r5|d j|||d |||}|d j|||n|d|kr|dt|kr-||dt|k-|d}|||}|d j|||ntd }t||}&|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. dummyrrTNrCrDrhrr}rFznode has an invalid level) r?r{rorf epub_tocdepthrpoprFr epub_tocduprr ValueError) rbr navstackrlastnoderrr@msgs r3build_navpointszEpubBuilder.build_navpointssX %-WaR$D$D#E! ! D< >'',,Q/Dt)))G}t{888G}%%,,T599  %,,X666))))g%!)++  7RL)00))(E5AA ,,T599 %,,X666))))g&&7mc(mm33LLNNN7mc(mm33W ,,T599 %,,X666))))455 oo%HH{##r2 navpointsc`|jjtj|jj||d}|S)z]Create a dictionary with all metadata for the toc.ncx file properly escaped. )rGr<rr)rfrUrerrS)rbrrr^s r3 toc_metadatazEpubBuilder.toc_metadatas7 ;'[!788" $ $  r2cVttd|jjdkrT|j|jj|dd}||g}| |n|j }| || |}td|j D}t||jj}t!|jdz |j|||dd S) z Write the metainfo file toc.ncx.zwriting toc.ncx file...defaultFrc3&K|] }|dV dS)rNr1).0rs r3 z(EpubBuilder.build_toc.. s&<rrf epub_tocscopertrrrrr`rrmaxminrrrSrr)rbrwr`rrs r3 build_toczEpubBuilder.build_tocs/ B011222 ; $ 1 1h66 $d5PU7G(("55H   x ( ( ( (}H H%%%((22 <rrr rwriter rl)rbrA epub_filenamerXrs r3 build_epubzEpubBuilder.build_epubsI ++g5 B+,,g666 g- ]C 6 6 K$ JJt{Z/Z H H HP K K 4;18\JJJJ J K K 4;18\JJJJ K  K K K K K K K K K K K K K K K K K KsAF F F F F P,,,,,,"1111 5555n + + + + + +    (  $(        .          2I I I I X>B      ,$,$,$,$\        0KKKKKKKKr2rR)rG)rHr(rIr(rJr()Hr __future__rreros.pathrerQpathlibrtypingrr urllib.parserzipfilerr r docutilsr docutils.utilsr sphinxr sphinx.builders.htmlr sphinx.builders.html._build_infor sphinx.localer sphinx.utilrsphinx.util._pathlibrsphinx.util.displayrsphinx.util.fileutilrsphinx.util.osutilrrrrdocutils.nodesrrPILrr* ImportError getLoggerr-rrrrrrrrrrcompilerr'r5r:r?rPrrRr1r2r3rs))""""""  ,,,,,,,,5555555555&&&&&&666666666666))))))//////000000;;;;;;;;;;-,,,,,,,,  8 $ $$ ##%   &             ' BJ ' ' : J      J   z      ` K` K` K` K` K'` K` K` K` K` KsBB%$B%