O&iq LdZddlZddlZddlZddlmZddlmZmZmZm Z m Z m Z m Z ddl mZddlmZmZmZddlmZddlmZmZdd lmZdd lmZdd lmZmZdd lm Z dd l!m"Z"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z* ddl+m,Z,n #e-$rdZ,YnwxYwe"j.e/Z0dZ1dZ2dZ3dZ4dZ5dZ6dddZ7dddddd d!d!d"d#d$d% Z8d&Z9ej:d'Z;Gd(d)e Z<Gd*d+e Z=Gd,d-e Z>Gd.d/e Z?d7d1e@d2e@d3e@fd4ZAeAZBGd5d6eZCdS)8z#Base class of epub2/epub3 builders.N)path)AnyDictList NamedTupleOptionalSetTuple)quote) 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__g/home/geonatureadmin/si_en_reseau/tutos/venv/lib/python3.11/site-packages/sphinx/builders/_epub_base.pyr)r)Ns+ III GGGOOOOOr4r)c$eZdZUeed<eed<dS)SpineidreflinearN)r.r/r0r1r2boolr3r4r5r7r7Ts" JJJ LLLLLr4r7c.eZdZUeed<eed<eed<dS)GuidetypetitleuriNr-r3r4r5r<r<Ys+ III JJJ HHHHHr4r<cNeZdZUeed<eed<eed<eed<eeed<dS)NavPointnavpoint playordertextrefurichildrenN)r.r/r0r1r2intrrr3r4r5rArA_sFMMMNNN III KKK3ir4rAentlanguagereturnc|dd}tj|}tj||}|dd}|S)Nz"")replacereducateDashesOldSchool educateQuotes)rIrJs r5sphinx_smarty_pantsrQhsO (C  A*1--A!!X..A #x  A Hr4c NeZdZdZdZgdZdZdZdZdZ 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'ffd0Zd4e3de?fd5Z@de&e"e!e'fde&e?fd6ZAd3e>d7e&e?de"e!e'ffd8ZBd;d9ZCd;d:ZDxZES)@ 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%TrKNctd|_d|_d|_d|_i|_|dd|_g|_ dS)Nr&r use_indexepub) superinit out_suffix link_suffixrCtocidid_cacheget_builder_configrVrefnodesself __class__s r5rYzEpubBuilder.initsZ  "# (* 00fEE.0 r4c<t|j|jddgS)NhtmlrW)rconfigtagsras r5create_build_infozEpubBuilder.create_build_infosdi&&1ABBBr4c2|jj|jjfSN)re epub_themeepub_theme_optionsrgs r5get_theme_configzEpubBuilder.get_theme_configs{%t{'EEEr4namec|j|}|s'd|jdz}||j|<|S)zReturn a unique id for name.zepub-%drW)r]getenv new_serialno)rarnr+s r5make_idzEpubBuilder.make_idsL]  t $ $ %TX226:::B"$DM$  r4doctreeresultc 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.rEzhttp://zhttps://zirc:zmailto:classesrlevelrErD) isinstancer referencerp startswithparent attributesrangetoctree_templateappendrdescapesspastextr get_refnodes)rartrurErwr{elems r5rzEpubBuilder.get_refnodessi 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 r4rct}|D]Y}|d|vr2ttd|ddd>||dZdS)NrEzduplicated ToC entry found: %srWduplicated_toc_entryr=subtype)setloggerwarningradd)rarappearednodes r5check_refnodeszEpubBuilder.check_refnodess UU - -DH~))788N2  T(^,,,, - -r4c:|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/rEN) rqget_and_resolve_doctreereroot_docrr_rdirname toc_add_files)rart master_diritems r5get_toczEpubBuilder.get_tocs(224;3G37AE3GG))'266 \$+"677  = # J  = =!+d8n!<X 4=)))))r4r_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. rrzN)insertrdrrerrZrrqtitlesrreversedepub_pre_filesepub_post_filesr)rar_filerDs r5rzEpubBuilder.toc_add_filessZ k$+"6"HII  45<<>>@@AA     #4;#=>>  JD$ OOA+d++DK--..       +5  JD$ OO+d++DK--..      r4prefixfragmentc4||ddzS)z;Return a href/id attribute with colons replaced by hyphens.:-)rN)rarrs r5 fix_fragmentzEpubBuilder.fix_fragments((c2222r4treecdtddffd }|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. rrKNcg}|dD]1}d|}||vr||2||d<dS)zUpdate IDs of given *node*.idsrTN)rr)rnew_idsnode_idnew_idras r5update_node_idz+EpubBuilder.fix_ids..update_node_id s[!#G; + +**2w77((NN6***!DKKKr4rErrefidrTT)ascend) rfindallrr} refuri_rematchrgrouptarget next_noder|rdesc_signature)rarrr}mrrrs` r5fix_idszEpubBuilder.fix_idss{  " "T " " " " " "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> * * * * + +r4inline 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 r4r?cHtj|}tj}|tj||||dtjd||||S)z$Create a footnote node with childrenrrT)rfootnote paragraphrrrrnote_autofootnote)rrr?rparas r5 make_footnotez4EpubBuilder.add_visible_links..make_footnote.s~c**H?$$D KK 3 ( ( ( OOD ! ! ! OOAu{2u55 6 6 6  ! !( + + +Or4rct|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).ryr)listrrrrindexrubriclenrFOOTNOTES_RUBRIC_NAMEnextdocumentrr)rfnsfnrrrubs r5 footnote_spotz4EpubBuilder.add_visible_links..footnote_spot8s&t||EN3344C :Wy")//""5"5"999 U\22 D Dt99>>dkkmm7L&L&L; (9(9$(?(?!(CCCCCt||EN3344C,..C JJuz"788 9 9 9 JJsOOO #** *r4noNrrrErTzhttp:zhttps:zftp:rrwrrr)rrr1rrr rrGrrrr}rpr~rrrlink_target_templaterrcss_link_target_classrFOOTNOTE_LABEL_TEMPLATE add_backref)rarrrrrrfn_spotfn_idxnrrr?idxlinkrrrs r5add_visible_linkszEpubBuilder.add_visible_links$s 5> # %BZ     u~ c       + +5#3F + + + +*    F  " "t||EN3344C+mD11OGVBeo6677  D((8R((Cw'' 3>>(+C+C NN6** 034;;==0H0Hk''--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!,[[ [ [ [r4filenamecHtj|d}|tvS)z=Does the filename extension indicate a vector graphic format?ry)rsplitextVECTOR_GRAPHICS_EXTENSIONS)rarexts r5is_vector_graphicszEpubBuilder.is_vector_graphicss"mH%%b)000r4c 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 verbosityropensrcdirOSErrorrrrrreepub_fix_imagesmodeconvertepub_max_image_widthsizeresizeBICUBICsave) rasrcdestimgerrwidthheightnwnhs r5copy_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:: 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) rrer rrrrrrXcopy_image_filesrr`s r5rzEpubBuilder.copy_image_filess ; +{* +dk.N +0NN2&N#O#OPPPGG,,.....--/////((***** + +r4cdSrjr3rgs r5copy_download_fileszEpubBuilder.copy_download_filess r4 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~rVrr*rX handle_page)rar"r#r$r%r&rbs r5r+zEpubBuilder.handle_pages   z * * 9/@F/J/J>    f%67 8 8 8 Ly HflKSSSSSr4cttdtt j|jd|jdS)z!Write the metainfo file mimetype.zwriting mimetype file...mimetypeN)rinforrrr template_dirrrgs r5build_mimetypezEpubBuilder.build_mimetypesD B122333 $"3Z@@$+NNNNNr4META-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/)rar2rs r5build_containerzEpubBuilder.build_containersc B?@@AAA4; 33& $"3_EEvNNNNNr4ci}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-%drH)rJdatemanifest_itemsspinesguides) rdrre epub_title epub_authorepub_uid epub_languageepub_publisherepub_copyright epub_schemeepub_identifierr)rametadatas r5content_metadatazEpubBuilder.content_metadatas$& K (>??![)@AA+dk&:;;;t{'@AA $ DK,F G G $ DK,F G G![)@AAT[%@AA;{:'M'M'MNN%'!"r4c ttd|}|jt js|xjt jz c_t|j}g|_ dddddddd d |j j d zg |j j z|_ |js"|j d |jzt j|jD]p\}}}|t'|D]D}t)j|||d }||j vr*t)j|d}||jvr0|dvr+ttd|dd}|t jd}t5t7jt;|t7j||t7j|j|} |d| |j |Frt?} |j D]} d| dvr | d|j vrtCt7j|| dd} |d| | "| d|j#D]} tCt7j|| d|jzd} |d| | "| d|jz|jrutCt7j|d |jzd} |d| | "d |jz|j D]p}|| vrj||jrPtCt7j||d} |d| qd }|j j$r|j j$\}}|t jd}t7j|||d<|rtCt7j||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}|dtWt7j|t7j|t7j||rN|rL|dtWd|j,dt7j|j%|r_|j rX|dtWd|j,dt7j|j ddt[t)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.ncxr1z Thumbs.dbz ehthumbs.dbz .DS_Storez nav.xhtml.epubr(Nry)z.jsz.xmlz!unknown mimetype for %s, ignoringrWunknown_project_filesrrr=#rETr>rFr!)imager>r r?z content.opf_t)/rr.rrIrendswithosseprfilesre epub_basenameepub_exclude_files ignored_filesrVrrZwalksortsortedrrr media_typesrrNr)rdrr rsrr_r7rdomain_indices epub_covercoverpage_namerprojectr+ epub_guidesplitr< guide_titlesrr/)rarHolenrootdirsrTrrrr spinefilesrefnodespiner.rn html_tmplrPctxauto_add_cover auto_add_tocr=r?r>rs r5 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..tuu5t111mH--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-(;<V d8nb:: :r4c 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. dummyrrTNrDrErOr{ryrF) rrArarWre epub_tocdepthrppoprF epub_tocdupr)rarnavstackr{lastnoderrrBs r5build_navpointszEpubBuilder.build_navpointsfsJ $&!RR88999  D< >'',,Q/Dt)))G}t{888G}%%,,T599  %,,X666))))g%!)++ \ 7\RL)001B1B8UTY1Z1Z[[[,,T599 %,,X666))))g&&7mc(mm33LLNNN7mc(mm33W ,,T599 %,,X666))))HH{##r4 navpointsc~i}|jj|d<tj|jj|d<||d<||d<|S)z]Create a dictionary with all metadata for the toc.ncx file properly escaped. r7r>r{ry)rerBrdrr@)rar{ryrHs r5 toc_metadatazEpubBuilder.toc_metadatasI$&+. K (>??! )r4crttd|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{Nr3).0rs r5 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 + + + + + +    LWHL T TC T TS T!)# TBE TQU T T T T T TOOOO OOsO$OOOO$sCx.&m^m^m^m^^::c3h::4:S[::::*$T$sCx.%9*$d8n*$*$*$*$X # $x. T#s(^    ====(UUUUUUUUr4rS)rH)DrrdrRrertypingrrrrrr r urllib.parser zipfiler r rdocutilsrdocutils.nodesrrdocutils.utilsrsphinxrsphinx.builders.htmlrr sphinx.localer sphinx.utilrrsphinx.util.fileutilrsphinx.util.i18nrsphinx.util.osutilrrPILr ImportError getLoggerr.rrrrrrrrrrcompilerr)r7r<rAr1rQrrSr3r4r5rse)) DDDDDDDDDDDDDDDDDD5555555555((((((((&&&&&&AAAAAAAA00000000000000((((((22222222 EEE  8 $ $$ ##%   &        $ $ $   ' BJ ' ' : J      J   z  3 #      J UJ UJ UJ UJ U'J UJ UJ UJ UJ Us<BB  B