zi"q HdZddlmZddlZddlZddlZddlZddlmZddlm Z m Z m Z ddl m Z ddlmZmZmZddlmZdd lmZdd lmZdd lmZmZdd lmZdd lmZddlm Z ddl!m"Z"ddl#m$Z$m%Z%m&Z&e rddl'm(Z(m)Z) ddl*m+Z+n #e,$rdZ+YnwxYwej-e.Z/dZ0dZ1dZ2dZ3dZ4dZ5dddZ6ddddd d!d"d"d#d$d%d& Z7d'Z8ej9d(Z:Gd)d*e Z;Gd+d,e Z<Gd-d.e Z=Gd/d0e Z>d9d:d6Z?e?Z@Gd7d8eZAdS);z#Base class of epub2/epub3 builders.) annotationsN)path) TYPE_CHECKINGAny NamedTuple)quote) ZIP_DEFLATED ZIP_STOREDZipFile)nodes) smartquotes)addnodes) BuildInfoStandaloneHTMLBuilder)__)logging)status_iterator)copy_asset_file)copyfile ensuredirrelpath)ElementNode)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/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__e/var/www/tmov.alphamb/tmov_inventario/venv/lib/python3.11/site-packages/sphinx/builders/_epub_base.pyr&r&Ss+ III GGGOOOOOr1r&c$eZdZUded<ded<dS)Spiner'idrefboollinearNr+r0r1r2r4r4Ys"JJJLLLLLr1r4c.eZdZUded<ded<ded<dS)Guider'typetitleuriNr+r0r1r2r9r9^s+ IIIJJJ HHHHHr1r9cBeZdZUded<ded<ded<ded<ded<d S) NavPointr'navpointint playordertextrefurilist[NavPoint]childrenNr+r0r1r2r>r>dsBMMMNNN IIIKKKr1r>entr'languagereturnc|dd}tj|}tj||}|dd}|S)Nz"")replacer educateDashesOldSchool educateQuotes)rGrHs r2sphinx_smarty_pantsrOlsO (C  A*1--A!!X..A #x  A Hr1cXeZdZdZdZgdZdZdZdZdZ dZ dZ dZ e ZeZeZeZeZeZeZdZdZdKfd ZdLd ZdMd ZdNdZ dOdZ!dPdZ"dKdZ#dQdZ$dRdZ%dSdZ&dTdUd"Z'dVfd$ Z(dWd&Z)dXd)Z*dKd*Z+dKfd+ Z,dKd,Z- dYdZfd7 Z.dKd8Z/d[d\d;Z0d]d=Z1dKd>Z2d^d_dDZ3d`dFZ4dadHZ5dKdIZ6dKdJZ7xZ8S)b 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!rr r"TrINonectd|_d|_d|_d|_i|_|dd|_g|_ dS)Nr#r use_indexepub) superinit out_suffix link_suffixrAtocidid_cacheget_builder_configrUrefnodesself __class__s r2rXzEpubBuilder.initsZ  "# (* 00fEE.0 r1rc<t|j|jddgS)NhtmlrV)rconfigtagsr`s r2create_build_infozEpubBuilder.create_build_infosdi&&1ABBBr1tuple[str, dict]c2|jj|jjfSN)rd epub_themeepub_theme_optionsrfs r2get_theme_configzEpubBuilder.get_theme_configs{%t{'EEEr1namer'c|j|}|s'd|jdz}||j|<|S)zReturn a unique id for name.zepub-%drV)r\getenv new_serialno)r`rnr)s r2make_idzEpubBuilder.make_idsL]  t $ $ %TX226:::B"$DM$  r1doctreerresultlist[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.rC)zhttp://zhttps://zirc:zmailto:classesrlevelrCrB) isinstancer referencerp startswithparent attributesrangetoctree_templateappendrcescapesspastextr get_refnodes)r`rtrurCrxr|elems r2rzEpubBuilder.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 r1r ct}|D]Y}|d|vr2ttd|ddd>||dZdS)NrCzduplicated ToC entry found: %srVduplicated_toc_entryr:subtype)setloggerwarningradd)r`r appearednodes r2check_refnodeszEpubBuilder.check_refnodess UU - -DH~))788N2  T(^,,,, - -r1c:|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) rqget_and_resolve_doctreerdroot_docrr^rdirname toc_add_files)r`rt master_diritems r2get_toczEpubBuilder.get_tocs(224;3G37AE3GG))'266 \$+"677  = # J  = =!+d8n!<X 4=)))))r1r^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. rr{N)insertrcrrdrrYrrqtitlesrreversedepub_pre_filesepub_post_filesr)r`r^filerBs r2rzEpubBuilder.toc_add_filessZ k$+"6"HII  45<<>>@@AA     #4;#=>>  JD$ OOA+d++DK--..       +5  JD$ OO+d++DK--..      r1prefixfragmentc4||ddzS)z;Return a href/id attribute with colons replaced by hyphens.:-)rL)r`rrs r2 fix_fragmentzEpubBuilder.fix_fragments((c2222r1treenodes.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. rrrIrScg}|dD]1}d|}||vr||2||d<dS)zUpdate IDs of given *node*.idsrRN)rr)rnew_idsnode_idnew_idr`s r2update_node_idz+EpubBuilder.fix_ids..update_node_ids[!#G; + +**2w77((NN6***!DKKKr1rCrrefidrRT)ascendN)rrrIrS) findallr r~ refuri_rematchrgrouptarget next_noder}rrdesc_signature)r`rrr~mrrrs` r2fix_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> * * * * + +r1inline show_urlscdd}dd }dd }|dkrdS|dkr.make_footnote_ref,sJ 3F;;L    5 1 1 2 2 2  % %l 3 3 3 r1r<nodes.footnotecHtj|}tj}|tj||||dtjd||||S)z$Create a footnote node with childrenrrR)r footnote paragraphrrrrnote_autofootnote)rrr<rparas r2 make_footnotez4EpubBuilder.add_visible_links..make_footnote3s~c**H?$$D KK 3 ( ( ( OOD ! ! ! OOAu{2u55 6 6 6  ! !( + + +Or1rtuple[Element, int]ct|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).rzr)listrr rrindexrubriclenrFOOTNOTES_RUBRIC_NAMEnextdocumentrr)rfnsfnrrrubs r2 footnote_spotz4EpubBuilder.add_visible_links..footnote_spot=s&t||EN3344C :Wy")//""5"5"999 U\22 D Dt99>>dkkmm7L&L&L; (9(9$(?(?!(CCCCCt||EN3344C,..C JJuz"788 9 9 9 JJsOOO #** *r1noNrrrCrR)zhttp:zhttps:zftp:rrxrrr)rrrr'rIr)rrrr'r<r'rIr)rrrIr)rrr rrr~rprrrrlink_target_templaterrcss_link_target_classrFOOTNOTE_LABEL_TEMPLATE add_backref)r`rrrrrrfn_spotfn_idxnrrr<idxlinkrrrs r2add_visible_linkszEpubBuilder.add_visible_links)s         + + + +*    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+4U+;+;OO'Q,,T22AO$*$($5$5aggajj!''!**$M$M$Oa4<[[0M=/8/G/G[[+NVT N0066[06040A0A!''!**aggVWjj0Y0Y0[M!,[[ [ [ [r1filenamer6cHtj|d}|tvS)z=Does the filename extension indicate a vector graphic format?rz)rsplitextVECTOR_GRAPHICS_EXTENSIONS)r`rexts r2is_vector_graphicszEpubBuilder.is_vector_graphicss"mH%%b)000r1c ttj|j|jt |jtddt|j|j j D]^}|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|}|jjdkrS|j\}}|jj}||kr7t3||z|z }|||ftj} |tj|j|j|#t$rL}t tdtj|j ||Yd}~Xd}~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 verbosityropensrcdirOSErrorrrrrrdepub_fix_imagesmodeconvertepub_max_image_widthsizeroundresizeBICUBICsave) r`srcdestimgerrwidthheightnwnhs r2copy_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{/!33"%([52:: u455B**b"Xu}==C A4; tDDEEEE A A Ar"BCC#yc::CAAAAAAAA A; A AsX?,B--AF0 AEF0 F)AF$F0$F))F0/F03I55 K ?AKK 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) r rdrrrrrrrWcopy_image_filesr#r_s r2r%zEpubBuilder.copy_image_filess ; +{* +dk.N +0NN2&N#O#OPPPGG,,.....--/////((***** + +r1cdSrjr0rfs r2copy_download_fileszEpubBuilder.copy_download_filess r1 page.htmlNpagenameaddctxdict templatename outfilename str | None event_argrc|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)rrUrr3rW handle_page)r`r)r*r,r-r/ras r2r4zEpubBuilder.handle_pages   z * * 9/@F/J/J>    f%67 8 8 8 Ly HflKSSSSSr1cttdtt j|jd|jdS)z!Write the metainfo file mimetype.zwriting mimetype file...mimetypeN)rinforrrr  template_dirr rfs r2build_mimetypezEpubBuilder.build_mimetypesD B122333 $"3Z@@$+NNNNNr1META-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) rr7rrr r rrr8)r`r;r s r2build_containerzEpubBuilder.build_containersc B?@@AAA4; 33& $"3_EEvNNNNNr1dict[str, Any]c"tjdx}"tjt |}ntj}i}t j|jj|d<t j|jj |d<t j|jj |d<t j|jj |d<t j|jj |d<t j|jj |d<t j|jj|d <t j|jj|d <t jtjd ||d <g|d <g|d<g|d<|S)zaCreate a dictionary with all metadata for the content.opf file properly escaped. SOURCE_DATE_EPOCHNr;authoruidlang publisher copyrightschemer)z%Y-%m-%ddatemanifest_itemsspinesguides)osgetenvtimegmtimer@rcrrd epub_title epub_authorepub_uid epub_languageepub_publisherepub_copyright epub_schemeepub_identifierstrftime)r`source_date_epoch time_tuplemetadatas r2content_metadatazEpubBuilder.content_metadatasO "$+>!?!? ?  LS):%;%;<??![)@AA+dk&:;;;t{'@AA $ DK,F G G $ DK,F G G![)@AAT[%@AA;t}Z'L'LMM%'!"r1c ttd|}g|_dddddddd d |jjd zg |jjz|_|j s"|j d |j ztj |jD]{\}}}|t!|D]O}t#t%j|||j}||jvr5t%j|d }||jvr0|dvr+ttd|dd|tjd}t3t5jt9|t5j||t5j|j|}|d ||j |Q}t=} |jD]} d| dvr | d|jvrtAt5j|| dd} |d | | !| d|j"D]} tAt5j|| d|j zd} |d | | !| d|j z|j rutAt5j|d |j zd} |d | | !d |j z|jD]p} | | vrj| #|j rPtAt5j|| d} |d | qd}|jj$r|jj$\}}|tjd}t5j|||d<|rtAt5j||j%d} |d&d| |j%|jvrt%j|j%d }|j |j%t3t5j|j%t5j||j%t5j|j|}|d |t5j||jj'd}|(t%j|j%d||| !|j%d}d}|jj)r|jj)D]\}}}|*dd}||jvr|j ||dkrd}|dkrd}|d tWt5j|t5j|t5j||rN|rL|d tWd|j,dt5j|j%|r_|jrX|d tWd|j,dt5j|jddt[t%j|j.d |j|dS)!zWrite the metainfo file content.opf It contains bibliographic data, a file list and the spine (the reading order). zwriting content.opf file...z .buildinfor6 content.opftoc.ncxr:z Thumbs.dbz ehthumbs.dbz .DS_Storez nav.xhtml.epubr1rz)z.jsz.xmlz!unknown mimetype for %s, ignoringrVunknown_project_filesrrrH#rCTrIrFNr)imager;rrJz content.opf_t)/rr7rr[filesrd epub_basenameepub_exclude_files ignored_filesrUrrYrKwalkr sortsortedrrr r media_typesrrLsepr&rcrrrsrr^r4rdomain_indicesendswith epub_covercoverpage_namerprojectr4 epub_guidesplitr9 guide_titlesrr8)r`rZrootdirsrcrrrr spinefilesrefnodespiner7rn html_tmplrbctxauto_add_cover auto_add_tocr:r<r;rs r2 build_contentzEpubBuilder.build_contents  B455666((**!# *J ')A)=+)4;+Dw+NP K * + ~ D   % %j4?&B C C C!#!5!5 , , D$ IIKKKUmm , ,"49T2#6#6 DDt111mH--b1d.../11r*M'N'NPX,2 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-(;<c|r|xjdz c_|xjdz c_td|jz|j|d|dgS)z;Create a new entry in the toc from the node at given level.rz navPoint%drBrC)rAr[r>)r`rr|r~s r2 new_navpointzEpubBuilder.new_navpointdsY  NNa NN a  tz14>V d8nb:: :r1rDc 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. dummyrrRNrBrCrar|rzrF) rr>rrrfrd epub_tocdepthrpoprE epub_tocdupr)r`r navstackr|lastnoderrr?s r2build_navpointszEpubBuilder.build_navpointsmsJ $&!RR88999  D< >'',,Q/Dt)))G}t{888G}%%,,T599  %,,X666))))g%!)++ \ 7\RL)001B1B8UTY1Z1Z[[[,,T599 %,,X666))))g&&7mc(mm33LLNNN7mc(mm33W ,,T599 %,,X666))))HH{##r1 navpointsc~i}|jj|d<tj|jj|d<||d<||d<|S)z]Create a dictionary with all metadata for the toc.ncx file properly escaped. rBr;r|r)rdrQrcrrO)r`r|rrZs r2 toc_metadatazEpubBuilder.toc_metadatasI$&+. K (>??! )r1crttd|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)r|Nr0).0rs r2 z(EpubBuilder.build_toc..s&<)T)rr>r|r@r~r6rIr>)r rvrIrD)r|r@rrDrIr>)9r,r-r.__doc__ copysourcesupported_image_typessupported_remote_imagesadd_permalinksallow_sharp_as_current_pathembeddeddownload_supporthtml_scaled_image_linksearchCOVERPAGE_NAMEroTOCTREE_TEMPLATErLINK_TARGET_TEMPLATErCSS_LINK_TARGET_CLASSr GUIDE_TITLESrs MEDIA_TYPESrj REFURI_RErr8r3rXrgrmrsrrrrrrrrrrr#r%r'r4r9r=r[r}rrrrr __classcell__)ras@r2rQrQys7J+++#N"'H" F#N'/1LKILG 1 1 1 1 1 1CCCCFFFF0 - - - - * * * *,3333++++BA A A A A F,,,,,,[[[[$1111 %A%A%A%AN + + + + + +    LWEI T T T T T T TOOOO OOOOO2j^j^j^j^X:::::*$*$*$*$X    ====(UUUUUUUUr1rQ)rF)rGr'rHr'rIr')Br __future__rrcrKrerMrtypingrrr urllib.parserzipfiler r r docutilsr docutils.utilsr sphinxrsphinx.builders.htmlrr sphinx.localer sphinx.utilrsphinx.util.displayrsphinx.util.fileutilrsphinx.util.osutilrrrdocutils.nodesrrPILr ImportError getLoggerr,rrrrrrrrrrcompilerr&r4r9r>rOrrQr0r1r2rs[))"""""" 11111111115555555555&&&&&&AAAAAAAA//////000000;;;;;;;;;;-,,,,,,,, EEE  8 $ $$ ##%   &             ' BJ ' ' : J      J   z      M UM UM UM UM U'M UM UM UM UM UsBBB