pax_global_header00006660000000000000000000000064134135033230014507gustar00rootroot0000000000000052 comment=20b3f3766ac1b4f6b26d587896a7cc4acdf2c22b ebooklib-0.17.1/000077500000000000000000000000001341350332300133635ustar00rootroot00000000000000ebooklib-0.17.1/.gitignore000066400000000000000000000024611341350332300153560ustar00rootroot00000000000000#ignore these in git listings *~ .emacs* .DS_Store .swp *.swp \#*# .#* \#* ### Python template # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/ sdist/ var/ wheels/ *.egg-info/ .installed.cfg *.egg MANIFEST # PyInstaller # Usually these files are written by a python script from a template # before PyInstaller builds the exe, so as to inject date/other infos into it. *.manifest *.spec # Installer logs pip-log.txt pip-delete-this-directory.txt # Unit test / coverage reports htmlcov/ .tox/ .coverage .coverage.* .cache nosetests.xml coverage.xml *.cover .hypothesis/ # Translations *.mo *.pot # Django stuff: *.log .static_storage/ .media/ local_settings.py # Flask stuff: instance/ .webassets-cache # Scrapy stuff: .scrapy # Sphinx documentation docs/_build/ # PyBuilder target/ # Jupyter Notebook .ipynb_checkpoints # pyenv .python-version # celery beat schedule file celerybeat-schedule # SageMath parsed files *.sage.py # Environments .env .venv env/ venv/ ENV/ env.bak/ venv.bak/ # Spyder project settings .spyderproject .spyproject # Rope project settings .ropeproject # mkdocs documentation /site # mypy .mypy_cache/ ### JetBrains template .idea/ ebooklib-0.17.1/AUTHORS.txt000066400000000000000000000016111341350332300152500ustar00rootroot00000000000000Listed in in chronological order: Aleksandar Erkalovic Borko Jandras the-happy-hippo Daniel James Mikhail Gusarov Raymond Yee Chris Grice Fernando Wime Andy Roberts Tom McLean Travis L Helmy Giacoman clach04 Edward Betts Kennyl Oleg Pshenichniy clach04 Olivier Le Thanh Duong Michael Storm Sergey Markelov Laurent Laporte Deborah Kaplan Willem van der Walt ebooklib-0.17.1/CHANGES.txt000066400000000000000000000000001341350332300151620ustar00rootroot00000000000000ebooklib-0.17.1/LICENSE.txt000066400000000000000000001033301341350332300152060ustar00rootroot00000000000000 GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU Affero General Public License is a free, copyleft license for software and other kinds of works, specifically designed to ensure cooperation with the community in the case of network server software. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, our General Public Licenses are intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. Developers that use our General Public Licenses protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software. A secondary benefit of defending all users' freedom is that improvements made in alternate versions of the program, if they receive widespread use, become available for other developers to incorporate. Many developers of free software are heartened and encouraged by the resulting cooperation. However, in the case of software used on network servers, this result may fail to come about. The GNU General Public License permits making a modified version and letting the public access it on a server without ever releasing its source code to the public. The GNU Affero General Public License is designed specifically to ensure that, in such cases, the modified source code becomes available to the community. It requires the operator of a network server to provide the source code of the modified version running there to the users of that server. Therefore, public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version. An older license, called the Affero General Public License and published by Affero, was designed to accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has released a new version of the Affero GPL which permits relicensing under this license. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU Affero General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Remote Network Interaction; Use with the GNU General Public License. Notwithstanding any other provision of this License, if you modify the Program, your modified version must prominently offer all users interacting with it remotely through a computer network (if your version supports such interaction) an opportunity to receive the Corresponding Source of your version by providing access to the Corresponding Source from a network server at no charge, through some standard or customary means of facilitating copying of software. This Corresponding Source shall include the Corresponding Source for any work covered by version 3 of the GNU General Public License that is incorporated pursuant to the following paragraph. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the work with which it is combined will remain governed by version 3 of the GNU General Public License. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU Affero General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU Affero General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU Affero General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU Affero General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If your software can interact with users remotely through a computer network, you should also make sure that it provides a way for users to get its source. For example, if your program is a web application, its interface could display a "Source" link that leads users to an archive of the code. There are many ways you could offer source, and different solutions will be better for different programs; see section 13 for the specific requirements. You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU AGPL, see . ebooklib-0.17.1/MANIFEST.in000066400000000000000000000003221341350332300151160ustar00rootroot00000000000000include *.txt include *.md recursive-include docs *.py recursive-include docs *.rst recursive-include docs Makefile recursive-include samples *.jpg recursive-include samples *.md recursive-include samples *.py ebooklib-0.17.1/README.md000066400000000000000000000047611341350332300146520ustar00rootroot00000000000000About EbookLib ============== EbookLib is a Python library for managing EPUB2/EPUB3 and Kindle files. It's capable of reading and writing EPUB files programmatically (Kindle support is under development). The API is designed to be as simple as possible, while at the same time making complex things possible too. It has support for covers, table of contents, spine, guide, metadata and etc. EbookLib is used in [Booktype](https://github.com/sourcefabric/Booktype/) from Sourcefabric, as well as [sprits-it!](https://github.com/the-happy-hippo/sprits-it), [fanfiction2ebook](https://github.com/ltouroumov/fanfiction2ebook), [viserlalune](https://github.com/vjousse/viserlalune) and [Telemeta](https://github.com/Parisson/Telemeta). Packages of EbookLib for GNU/Linux are available in [Debian](https://packages.debian.org/python-ebooklib) and [Ubuntu](http://packages.ubuntu.com/python-ebooklib). Sphinx documentation is generated from the templates in the docs/ directory and made available at http://ebooklib.readthedocs.io Usage ===== Reading ------- :: import ebooklib from ebooklib import epub book = epub.read_epub('test.epub') for image in book.get_items_of_type(ebooklib.ITEM_IMAGE): print image Writing ------- :: from ebooklib import epub book = epub.EpubBook() # set metadata book.set_identifier('id123456') book.set_title('Sample book') book.set_language('en') book.add_author('Author Authorowski') book.add_author('Danko Bananko', file_as='Gospodin Danko Bananko', role='ill', uid='coauthor') # create chapter c1 = epub.EpubHtml(title='Intro', file_name='chap_01.xhtml', lang='hr') c1.content=u'

Intro heading

Zaba je skocila u baru.

' # add chapter book.add_item(c1) # define Table Of Contents book.toc = (epub.Link('chap_01.xhtml', 'Introduction', 'intro'), (epub.Section('Simple book'), (c1, )) ) # add default NCX and Nav file book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # define CSS style style = 'BODY {color: white;}' nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) # add CSS file book.add_item(nav_css) # basic spine book.spine = ['nav', c1] # write to the file epub.write_epub('test.epub', book, {}) License ======= EbookLib is licensed under the AGPL license. Authors ======= Full list of authors is in AUTHORS.txt file. ebooklib-0.17.1/VERSION.txt000066400000000000000000000000161341350332300152460ustar00rootroot00000000000000EbookLib 0.17 ebooklib-0.17.1/docs/000077500000000000000000000000001341350332300143135ustar00rootroot00000000000000ebooklib-0.17.1/docs/Makefile000066400000000000000000000127041341350332300157570ustar00rootroot00000000000000# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = sphinx-build PAPER = BUILDDIR = _build # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " latexpdf to make LaTeX files and run them through pdflatex" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" clean: -rm -rf $(BUILDDIR)/* html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." dirhtml: $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." singlehtml: $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml @echo @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." pickle: $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle @echo @echo "Build finished; now you can process the pickle files." json: $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json @echo @echo "Build finished; now you can process the JSON files." htmlhelp: $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in $(BUILDDIR)/htmlhelp." qthelp: $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp @echo @echo "Build finished; now you can run "qcollectiongenerator" with the" \ ".qhcp project file in $(BUILDDIR)/qthelp, like this:" @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/EbookLib.qhcp" @echo "To view the help file:" @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/EbookLib.qhc" devhelp: $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp @echo @echo "Build finished." @echo "To view the help file:" @echo "# mkdir -p $$HOME/.local/share/devhelp/EbookLib" @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/EbookLib" @echo "# devhelp" epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." @echo "Run \`make' in that directory to run these through (pdf)latex" \ "(use \`make latexpdf' here to do that automatically)." latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @echo @echo "Build finished. The text files are in $(BUILDDIR)/text." man: $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man @echo @echo "Build finished. The manual pages are in $(BUILDDIR)/man." texinfo: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." @echo "Run \`make' in that directory to run these through makeinfo" \ "(use \`make info' here to do that automatically)." info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale @echo @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." changes: $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes @echo @echo "The overview file is in $(BUILDDIR)/changes." linkcheck: $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in $(BUILDDIR)/linkcheck/output.txt." doctest: $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." ebooklib-0.17.1/docs/_static/000077500000000000000000000000001341350332300157415ustar00rootroot00000000000000ebooklib-0.17.1/docs/_static/README000066400000000000000000000001151341350332300166160ustar00rootroot00000000000000For some reason, readthedocs.org expects a docs/_static/ directory to exist. ebooklib-0.17.1/docs/_static/ebooklib1.gif000066400000000000000000000304541341350332300203050ustar00rootroot00000000000000GIF89a,,;]][11/YYWNNM//-zzy??>ttsKKIյ==;lljDDffe""33UUffwwLLJ--+YYX%%#RRPUUT##!))'hhgJJH886"" ! NETSCAPE2.0! XMP DataXMP ~}|{zyxwvutsrqponmlkjihgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGFEDCBA@?>=<;:9876543210/.-,+*)('&%$#"!  !;,,,@pH,Ȥrl:ШtJZجvzxL.zn|N~ H*\ȰÇ#JHŋ3jdC Ird ,pܳ %cu |ɳ8lQTUљ@uˢ#(]Zfӧ$Pdr+ 2@0 va` bQ ~l IvRadY ZEd7@`fϐdCdB彧*Q[4ǁo Y*2$ge2w|dlX1X^u' |}40#W$?GmIwY{\W^yIA߄{}`D10FFu'iEWF1(^3p! ܤQIU؅>a#Q( @#I6A J.m`v, @,yM85q2P>l;\!qOGRFCR_SE9Fy[!=@w {' $$IGdr <߂^G2J&2-9i"w3YclȯN2$ q&] /srW(FRwpwRĩ#,Hxʓ@LHJ""tcG)Tx4b2iQMd ԁI}s % BK(4V$ up"$!уa>lP9Fa\>JX,)rh7%TTLD *A8$,*y6I@!G*q,@YЫBp<4a X]-:5&4 j-$`D0_**B$Dp)AE-BgIW^Ѳ<'*h 8|UG8;͎. jp ,95OUm@m ;DO\qe| +"1H}R1@"eKIȬJ&Y Ktԙ 9#0+K G %V {k61P"3sB$'6Q86׿> jGyT6Ǧ՗{@mF[d$mTЀMnt`׳HT $ُp4Xk+4rOA% Fk%@w,*_߃#T0T&`r`  LMo@L2'ńtPf%D_KaxkbVݒ2nhHIp \X$%$&Dgtq:;@p \=O:“@nB:  1VpRlG7ׇpp;!VABZMn4vK >nqT  74$ؓU=lixNϟrs zn1߁&j_|ꡰqdXoy&U=.XBpcC{F8ruPGAHQOKP}OIR`NoJ@`Jk'{O`H@뀂VG['#5(7HM?n3HF`ꀃϤpNM Mpwl"FH|gZpPvQlT(sHeQhN`r~G@v`8WZq'9GnÖ~AsZ5i~k$w8Zx(e(Vw|I@j wuo{fxekHZIVsGr'džC*7BB$CIPyq6}C{\EHBN]<'BqF|& l E00%l>2Ѷ\&]0Do8 p֨:y NjDWpP>u`Ej{A_J@~Xl|H~&{;k"树3&cQa"3aDYDyBp'ЉC@(c@y"JI*\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy٘9Yyٙ9Yyٚ9Yyٛ9YٚA!;,)Pdb@pH,Ȥrl:ШtJZجvnp74u18P |N x> !vuy`[ U rxde` Kl Tv f!r xvRr!JuQ! NP:x Fԙ M qBӅB 癑M !{:,W*"ڱBY-hq1J"f10@Kj/l)&g%Uɲc&)&sh>)3ēƄc:%O;۞,0dKD-,ɂ)HC*zEc').]RM3d6$4f_tUص Ɛ06dʹٷȘK@yGPcm K· T;w3|泔={bW9 @DP!€pepmZ!i!Z5f _C>gKԬC,PY b؝#=71x"Ƽho0@EFmA/.m88A<+`Q A!;,)Td^@pH,Ȥrl:ШtJZجvzxL.zn@?~?ms9i hffedĺcʷϽbӱaثݲ᫡  L80A"D(p[, ~"p_)8\B r0E(T5 0!DZ3Ta C3ppAΝBH)IC$D[H :JMlڵQ.(Xʵ_` 5ԐQnikPCp͋h]sK6-CRHP\2]9WʰRhPAB< p!RqOH$.[h{H.Rא;ߥuiR H0EŅ]rCHA@hv9h D%X%܍e` H_ܕX"Ʌ;ɹ(``yY p%G(BLKaIHLUdb v@)@K6P@جfϪNغ6F+-^Fڢmf| .+F悁n^;D!;,*UCd@pH,䂑3XШtz䮘uRCwL>9Fy]Ơs|Ήxhݐ~S ui qBJn !E LD!: g:_{Qhh d~Vo OuWcyhwesurr`}sk`sW~pxl9} CA4| jF>(5agRo(VDMF< &PfUro"dl,т7M,LUxh7-FO얢3R &Z*Q7WTL0> 0āN('3՘sf~(]<Ђ`Á׮ mꉯ`;͆ |E8ǂ^4 fl pqD#Fyh0Ŏ,Po" P"!LpJJN){P84%zGQ\,B-`p VP!50@[LPJsCD]`V A#}\lS"^8RB,qoo2:L— [X\hWGms}u%D9I\JX]mD ])yDMg"eTvÍĜ ["! Bb0pq[2jVILOׁש2rhd*^%CBq)p}D~bIAWdiPP,Z06ʯeX-i1K*ߜͻb ox0ng/JMG!;,,&`@pH,ȤrY( IZ؅'톰 nU^ |'Z ujz}p Nt a ]TC_Cf\ B P\ ]m\Æ{i:X!!9K uH!]8OZ 㰢@Ň# A9 ‰1ϤEL+p)QRO`BaiJҴT [!v`9xFϩEF*Z5F0[/9=c;ܭd7Uk|V8[ TIƎ?.=322ˁ*}`*! 'i:f\SsnfJ2P=19d͂7%g^0I;%}<~WH-V4.%tV"̂Hl!Ѓ6 ( yLVgT1XvQSH YB!q5DKW]jEP7dE"LYDɬ`,ōy fLxi$p9fni*mmVJEZYȅA 0!|'@u@@2@ @ٙK@E\`|eXx u80D4@@".aAP9x(j(@qwaP (LzDvED2V D9JuP1GZs갮2ѐKqkq/KS`{qw"1Ju.4@Bó**<&Y F9ʅD4ET MtbW ECH @ ̄`#uąJ@S4p3U5u5d+vxD$<r WT L9c:\j('4}#2=7:H08#2W$JH*"a/P(-e1G[ & "}o&]\DKjECBwB~E Ī]C91DlEWľzj,%Dj`A.ׅUBX%FӅ DB&ie$Aa3.܊=%*uTnDCp'U`qPF }\a: 1=PB":$D`^x8>҂¹F  `H9+p @Q*wK*_("IB7Z8fneFkXB(Ґ3bOaɤ]lla$wj%&BHX1h@_ZH-H(X)7)*5@!$*c8'Pkx,7mZ_vt y*w@1AQ:X}:!B>_2NDÅ[ƃq{4^jC&pWP4@: #aF@Y\<ڊ!,AS@5BC K$(}u-6p V@_Be sU/WxjA,pհMZk:,2لuzT*oZV|);F!e{hX 1|=?de1/@#T&v (#GlY9QR{a;HwDrP  o'c$4 : y+1&Ze DhlcPɴŖ<!;,,&`@pH,Ȥrl:ШtJZجvzxL.zn|N~B!! 99 jj ʮjhigi 駶F pZ/ػ8 ( pf ,hiQc[G寀n>s`V!i)11[6;@2NJ+|UTTWU#]͡J` +%X60D(@/f^#paWxH /C \h@W)*n}) _pga>|~H_,5cltNv'/R r}l(!ʕmPJu"_Dʵ|RP8]5  )_]2<&E/Nqԃ.`Ѕu @~8iHɱ4PtƏmGH`+(6mUk5!,"a#+ 41]՘CkGPJMIdQD9Q$cᕮ܋9Ƅ9nua|LrxbdQF=&@Lj8!AZlV ( c%;NҪ$ W iR_\jKt̙X M|bA(`t)ny)Yw!^{^m~Uq[vTy}TED{Dtpr:`G!kCk jźjʹjϴ|i؞h ݘhh!a ja Gkr9,肰fsAFO! |AK@Eb.j\IGZtc!kP RLU0NR9<-@͠@OV5KM4S0c@PI()i@ RPXL l*ئ0l(6qx2&TJq/=Y {ae]?ଌtf,9\fEۏhToFȩh AFcc뒾پp\Ga{0=/Ae!^ze/uu|~~'DܥCW] H\q mZo~)rCā%n5 0-za bRiXHZ$)Evq׎~@XJ:[&Ya_ ԤweN; pƘe酚ia y[YQ7'\B(V:碚2"iU~ RQMJrJa/ji]ȕ˫1$)EZjl6lzR9 [D98.lyj $>kmߒr_9hEXȼ*W!;,*AOs@pH,Ȥrl:ШtJZجvzp1(ˠ`ȹ tk0jBz8e@a1카1Z`6bC٢ ]lX` \ , ݇o[i+`Q.),Ξu |)J(jlt2֬BK9Dٶ-Z EmLli" eN[ PP.tDz\w#/WUV+7q3FjJ˙ƣbF$6hGqV-FV>@ǝb *; O;IXer9iD4gowoa5gMu79Ze mH%M׷gw8[mc;98vG^y&ZM\K/Z)Zbo%= ׊Y&0.&ax`5.f@qJtn;Oj @87`/ HI`<Ept"̟7Їi~]!H"/iJ/bt.wc5\ҖCM!r @CRJF\H#PBRU UƈW@D'슔@1ډJi8Sx_J< (;ebooklib-0.17.1/docs/conf.py000066400000000000000000000221411341350332300156120ustar00rootroot00000000000000# -*- coding: utf-8 -*- # # EbookLib documentation build configuration file, created by # sphinx-quickstart on Fri Apr 25 11:49:49 2014. # # This file is execfile()d with the current directory set to its containing dir. # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default. import sys, os # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. sys.path.insert(0, os.path.abspath('..')) # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. #needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.viewcode'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # General information about the project. project = u'EbookLib' copyright = u'2014, Aleksandar Erkalovic' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. version = '0.17' # The full version, including alpha/beta/rc tags. release = '0.17' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. #language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. #today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = ['_build'] # The reST default role (used for this markup: `text`) to use for all documents. #default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. #add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). #add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. #show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = [] # -- Options for HTML output --------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = 'default' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. #html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. #html_theme_path = [] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None # A shorter title for the navigation bar. Default is the same as html_title. #html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. #html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. #html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. #html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. #html_use_smartypants = True # Custom sidebar templates, maps document names to template names. #html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. #html_additional_pages = {} # If false, no module index is generated. #html_domain_indices = True # If false, no index is generated. #html_use_index = True # If true, the index is split into individual pages for each letter. #html_split_index = False # If true, links to the reST sources are added to the pages. #html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. #html_show_sphinx = True # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. #html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. #html_use_opensearch = '' # This is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = None # Output file base name for HTML help builder. htmlhelp_basename = 'EbookLibdoc' # -- Options for LaTeX output -------------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). #'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). #'pointsize': '10pt', # Additional stuff for the LaTeX preamble. #'preamble': '', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass [howto/manual]). latex_documents = [ ('index', 'EbookLib.tex', u'EbookLib Documentation', u'Aleksandar Erkalovic', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. #latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. #latex_use_parts = False # If true, show page references after internal links. #latex_show_pagerefs = False # If true, show URL addresses after external links. #latex_show_urls = False # Documents to append as an appendix to all manuals. #latex_appendices = [] # If false, no module index is generated. #latex_domain_indices = True # -- Options for manual page output -------------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ ('index', 'ebooklib', u'EbookLib Documentation', [u'Aleksandar Erkalovic'], 1) ] # If true, show URL addresses after external links. #man_show_urls = False # -- Options for Texinfo output ------------------------------------------------ # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ ('index', 'EbookLib', u'EbookLib Documentation', u'Aleksandar Erkalovic', 'EbookLib', 'Python library for EPUB and Kindle formats.', 'Miscellaneous'), ] # Documents to append as an appendix to all manuals. #texinfo_appendices = [] # If false, no module index is generated. #texinfo_domain_indices = True # How to display URL addresses: 'footnote', 'no', or 'inline'. #texinfo_show_urls = 'footnote' # -- Options for Epub output --------------------------------------------------- # Bibliographic Dublin Core info. epub_title = u'EbookLib' epub_author = u'Aleksandar Erkalovic' epub_publisher = u'Aleksandar Erkalovic' epub_copyright = u'2014, Aleksandar Erkalovic' # The language of the text. It defaults to the language option # or en if the language is not set. #epub_language = '' # The scheme of the identifier. Typical schemes are ISBN or URL. #epub_scheme = '' # The unique identifier of the text. This can be a ISBN number # or the project homepage. #epub_identifier = '' # A unique identification for the text. #epub_uid = '' # A tuple containing the cover image and cover page html template filenames. #epub_cover = () # HTML files that should be inserted before the pages created by sphinx. # The format is a list of tuples containing the path and title. #epub_pre_files = [] # HTML files shat should be inserted after the pages created by sphinx. # The format is a list of tuples containing the path and title. #epub_post_files = [] # A list of files that should not be packed into the epub file. #epub_exclude_files = [] # The depth of the table of contents in toc.ncx. #epub_tocdepth = 3 # Allow duplicate toc entries. #epub_tocdup = True # Example configuration for intersphinx: refer to the Python standard library. intersphinx_mapping = {'http://docs.python.org/': None} ebooklib-0.17.1/docs/ebooklib.plugins.rst000066400000000000000000000013721341350332300203160ustar00rootroot00000000000000plugins Package =============== :mod:`base` Module ------------------ .. automodule:: ebooklib.plugins.base :members: :undoc-members: :show-inheritance: :mod:`booktype` Module ---------------------- .. automodule:: ebooklib.plugins.booktype :members: :undoc-members: :show-inheritance: :mod:`sourcecode` Module ------------------------ .. automodule:: ebooklib.plugins.sourcecode :members: :undoc-members: :show-inheritance: :mod:`standard` Module ---------------------- .. automodule:: ebooklib.plugins.standard :members: :undoc-members: :show-inheritance: :mod:`tidyhtml` Module ---------------------- .. automodule:: ebooklib.plugins.tidyhtml :members: :undoc-members: :show-inheritance: ebooklib-0.17.1/docs/ebooklib.rst000066400000000000000000000007451341350332300166410ustar00rootroot00000000000000ebooklib Package ================ :mod:`ebooklib` Package ----------------------- .. automodule:: ebooklib :members: :undoc-members: :show-inheritance: :mod:`epub` Module ------------------ .. automodule:: ebooklib.epub :members: :undoc-members: :show-inheritance: :mod:`utils` Module ------------------- .. automodule:: ebooklib.utils :members: :undoc-members: :show-inheritance: Subpackages ----------- .. toctree:: ebooklib.plugins ebooklib-0.17.1/docs/faq.rst000066400000000000000000000031371341350332300156200ustar00rootroot00000000000000Frequently asked questions ========================== How can I contribute? --------------------- Easily! We don't have any special procedure for contributions. Just send us bug reports, suggestions or Pull Requests! * Find bugs and report them here - https://github.com/aerkalov/ebooklib/issues * Have a suggestions or idea for a feature? Write it here - https://github.com/aerkalov/ebooklib/issues * Clone and send us Pull Requests - https://github.com/aerkalov/ebooklib/ Read and save does not work --------------------------- At the moment you can not use ebooklib to read EPUB file, write it down using ebooklib and expect to get file identical to the original. This is because ebooklib is opinionated when it comes to directory names, content it saves and etc. Different EPUB files will place style sheet files, images, fonts and html files to different directories than ebooklib. Ebooklib is also trying to produce valid EPUB3 output files, which is not always the case with all input files. A lot of times input files will not pass epubcheck validation. Because of that we we suggest that you read EPUB file using ebooklib, create new book instance using ebooklib and transfer only things you care about. It is also up to you to change the paths for the links inside (to style sheets, images and other html files). When you are done just write it down. What happened to the MOBI support? ---------------------------------- We used to have branch with basic MOBI support. We stopped working on it as for our workflow KindleGen app (converting EPUB->MOBI) was more than enough and we never needed to parse MOBI files.ebooklib-0.17.1/docs/index.rst000066400000000000000000000016401341350332300161550ustar00rootroot00000000000000.. EbookLib documentation master file, created by sphinx-quickstart on Fri Apr 25 11:49:49 2014. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Welcome to EbookLib's documentation! ==================================== .. image:: _static/ebooklib1.gif EbookLib is a Python library for managing EPUB2/EPUB3 files. It's capable of reading and writing EPUB files programmatically. The API is designed to be as simple as possible, while at the same time making complex things possible too. It has support for covers, table of contents, spine, guide, metadata, SMIL, pagebreaks and more. EbookLib works with Python 2.7 and Python 3.3. Homepage: https://github.com/aerkalov/ebooklib/ .. toctree:: :maxdepth: 2 tutorial plugins faq ebooklib Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` ebooklib-0.17.1/docs/plugins.rst000066400000000000000000000066051341350332300165350ustar00rootroot00000000000000Plugins ======= Plugins can be used to automate some of the workflow. For instance :mod:`ebooklib.plugins.tidyhtml` plugins automatically cleans HTML output for you. FootnotePlugin for instance rewrites custom footnotes into EPUB3 kind of footnotes. Without these plugins you would need to do wanted transformations before setting or getting content from your chapters. There is a :class:`ebooklib.plugins.base.BasePlugin` class which you need to extend. These are the methods you can override. ================= ============= ================================== Method Arguments Description ================= ============= ================================== before_write book Processing before book save after_write book Processing after book save before_read book Processing before book read after_read book Processing after book read item_after_read book, item Process general item after read item_before_write book, item Process general item before write html_after_read book, chapter Processing HTML before read html_before_write book, chapter Processing HTML before save ================= ============= ================================== Custom plugin ------------- This is our use case. We have online WYSIWYG editing system for editing content of our books. In the editor to link to our other page we use this syntax *Our page* but in the EPUB book we would need to link to *page.xhtml* file for instance. We could do the transformations manually or we could write a plugin which does all of the work for us. We override *html_before_write* method. We parse the content of our chapter, find all links, replace them with new href and finally set new content to the chapter. :: try: from urlparse import urlparse, urljoin except ImportError: from urllib.parse import urlparse, urljoin from lxml import etree from ebooklib.plugins.base import BasePlugin from ebooklib.utils import parse_html_string class MyeLinks(BasePlugin): NAME = 'My Links' def html_before_write(self, book, chapter): try: tree = parse_html_string(chapter.content) except: return root = tree.getroottree() if len(root.find('body')) != 0: body = tree.find('body') for _link in body.xpath('//a'): _u = urlparse(_link.get('href', '')) # Let us care only for internal links at the moment if _u.scheme == '': if _u.path != '': _link.set('href', '%s.xhtml' % _u.path) if _u.fragment != '': _link.set('href', urljoin(_link.get('href'), '#%s' % _u.fragment)) if _link.get('name') != None: _link.set('id', _link.get('name')) etree.strip_attributes(_link, 'name') chapter.content = etree.tostring(tree, pretty_print=True, encoding='utf-8') When you want to use it just pass the list of plugins you want to use as extra option to the write_epub method (also to read_epub method). Plugins will be executed in the order they are defined in the list. :: epub.write_epub('test.epub', book, {"plugins": [MyLinks()]}) ebooklib-0.17.1/docs/tutorial.rst000066400000000000000000000223401341350332300167110ustar00rootroot00000000000000Tutorial ======== Introduction ------------ Ebooklib is used to manage EPUB2/EPUB3 files. Reading EPUB ------------ :: import ebooklib from ebooklib import epub book = epub.read_epub('test.epub') There is a :func:`ebooklib.epub.read_epub` function used for reading EPUB files. It accepts full file path to the EPUB file as argument. It will return instance of :class:`ebooklib.epub.EpubBook` class. Metadata ++++++++ Method :meth:`ebooklib.epub.EpubBook.get_metadata` is used for fetching metadata. It accepts 2 arguments. First argument is name of the namespace ('DC' for Dublin Core and 'OPF' for custom metadata). Second argument is name of the key. It always returns a list. List will be empty if nothing is defined for that key. Minimal required metadata from Dublic Core set (for EPUB3) is: * DC:identifier * DC:title * DC:language 'DC' namespace is used when accessing Dublin Core metadata. :: >>> book.get_metadata('DC', 'title') [('Ratio', {})] >>> book.get_metadata('DC', 'creator') [('Firstname Lastname ', {})] >>> book.get_metadata('DC', 'identifier') [('9781416566120', {'id': 'isbn_9781416566120'})] Optional metadata from the Dublic Core set is: * DC:creator * DC:contributor * DC:publisher * DC:rights * DC:coverage * DC:date * DC:description This is how Dublin Core metadata is defined inside of content.opf file. :: en 9781416566120 You can also have custom metadata. For instance this is how custom metadata is defined in content.opf file. You can define same key more then once. 2 :: When accessing custom metadata you will use namespace 'OPF'. Notice you will get more then one result now. :: >>> book.get_metadata('OPF', 'cover') [(None, {'content': 'my-cover-image', 'name': 'cover'}), (None, {'content': 'cover-image', 'name': 'cover'})] Check the official documentation for more info: * http://www.idpf.org/epub/30/spec/epub30-publications.html#sec-opf-dcmes-optional. * http://www.idpf.org/epub/30/spec/epub30-publications.html * http://dublincore.org/documents/dces/ Items +++++ All of the resources (style sheets, images, videos, sounds, scripts and html files) are items. :: images = book.get_items_of_type(ebooklib.ITEM_IMAGE) Fetch items by their type with :meth:`ebooklib.epub.EpubBook.get_items_of_type`. Here is a list of current item types you can use: * ITEM_UNKNOWN * ITEM_IMAGE * ITEM_STYLE * ITEM_SCRIPT * ITEM_NAVIGATION * ITEM_VECTOR * ITEM_FONT * ITEM_VIDEO * ITEM_AUDIO * ITEM_DOCUMENT * ITEM_COVER * ITEM_SMIL :: cover_image = book.get_item_with_id('cover-image') Fetch items by their id (if you know it) with :meth:`ebooklib.epub.EpubBook.get_item_with_id`. :: index = book.get_item_with_href('index.xhtml') Fetch them by their filename with :meth:`ebooklib.epub.EpubBook.get_item_with_href`. :: items = book.get_items_of_media_type('image/png') Fetch them by their media type with :meth:`ebooklib.epub.EpubBook.get_items_of_type`. :: all_items = book.get_items() Return all of the items with :meth:`ebooklib.epub.EpubBook.get_items`. This is what you are going to use most of the times when handling unknown EPUB files. **Important to remember!** Methods *get_item_with_id*, *get_item_with_href* will return item object. Methods *get_items_of_type*, *get_items_of_type* and *get_items* will return iterator (and not list). To get a content from existing item (regarding if it is image, style sheet or html file) you use :meth:`ebooklib.epub.EpubItem.get_content`. For HTML items you also have :meth:`ebooklib.epub.EpubHtml.get_body_content`. What is the difference? Get_content always return entire content of the file while get_body_content only returns whatever is in the part of the HTML document. :: for item in book.get_items(): if item.get_type() == ebooklib.ITEM_DOCUMENT: print('==================================') print('NAME : ', item.get_name()) print('----------------------------------') print(item.get_content()) print('==================================') Creating EPUB ------------- :: from ebooklib import epub book = epub.EpubBook() EPUB has some minimal metadata requirements which you need to fulfil. You need to define unique identifier, title of the book and language used inside. When it comes to language code recommended best practice is to use a controlled vocabulary such as RFC 4646 - http://www.ietf.org/rfc/rfc4646.txt. :: book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') You can also add custom metadata. First one is from the Dublic Core namespace and second one is purely custom. :: book.add_metadata('DC', 'description', 'This is description for my book') book.add_metadata(None, 'meta', '', {'name': 'key', 'content': 'value'}) This is how our custom metadata will end up in the *content.opf* file. :: This is description for my book Chapters are represented by :class:`ebooklib.epub.EpubHtml`. You must define the *file_name* and *title*. In our case title is going to be used when generating Table of Contents. When defining content you can define it as valid HTML file or just parts of HTML elements you have as a content. It will ignore whatever you have in element. :: # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='en') c1.set_content(u'

Introduction

Introduction paragraph.

') # about chapter c2 = epub.EpubHtml(title='About this book', file_name='about.xhtml') c2.set_content('

About this book

This is a book.

') Do some basic debugging to see what kind of content will end up in the book. In this case we have inserted title of the chapter and language definition. It would also add links to the style sheet files if we have attached them to this chapter. :: >>> print(c1.get_content()) b'\n\n\n \n Introduction\n \n \n

Introduction

\n

Introduction paragraph.

\n \n\n' Any kind of item (style sheet, image, HTML file) must be added to the book. :: book.add_item(c1) book.add_item(c2) You can add any kind of file to the book. For instance, in this case we are adding style sheet file. We define filename, unique id, media_type and content for it. Just like the chapter files you need to add it to the book. Style sheet files could also be added to the chapter. In that case links would be automatically added to the chapter HTML. :: style = 'body { font-family: Times, Times New Roman, serif; }' nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) book.add_item(nav_css) Table of the contents must be defined manually. ToC is a tuple/list of elements. You can either define link manually with :class:`ebooklib.epub.Link` or just insert item object inside. When you manually insert you can define different title in the ToC than in the chapter. If you just insert item object it will use whatever title you defined for that item when creating it. Sections are just tuple with two values. First one is title of the section and 2nd is tuple/list with subchapters. :: book.toc = (epub.Link('intro.xhtml', 'Introduction', 'intro'), ( epub.Section('Languages'), (c1, c2) ) ) So as the Spine. You can use unique id for the item or just add instance of it to the spine. :: book.spine = ['nav', c1, c2] At the end we need to add NCX and Navigation tile. They will not be added automatically. :: book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) At the end write down your book. You need to specify full path to the book, you can not write it down to the File Object or something else. :: epub.write_epub('test.epub', book) It also accepts some of the options. ================= ==================================== Option Default value ================= ==================================== epub2_guide True epub3_landmark True epub3_pages True landmark_title "Guide" pages_title "Pages" spine_direction True package_direction False play_order {'enabled': False, 'start_from': 1} ================= ==================================== Example when overriding default options: :: epub.write_epub('test.epub', book, {"epub3_pages": False}) Samples ------- Further examples are available in https://github.com/aerkalov/ebooklib/tree/master/samples ebooklib-0.17.1/ebooklib/000077500000000000000000000000001341350332300151515ustar00rootroot00000000000000ebooklib-0.17.1/ebooklib/__init__.py000066400000000000000000000027451341350332300172720ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . # Version of ebook library VERSION = (0, 17, 1) # LIST OF POSSIBLE ITEMS ITEM_UNKNOWN = 0 ITEM_IMAGE = 1 ITEM_STYLE = 2 ITEM_SCRIPT = 3 ITEM_NAVIGATION = 4 ITEM_VECTOR = 5 ITEM_FONT = 6 ITEM_VIDEO = 7 ITEM_AUDIO = 8 ITEM_DOCUMENT = 9 ITEM_COVER = 10 ITEM_SMIL = 11 # EXTENSION MAPPER EXTENSIONS = {ITEM_IMAGE: ['.jpg', '.jpeg', '.gif', '.tiff', '.tif', '.png'], ITEM_STYLE: ['.css'], ITEM_VECTOR: ['.svg'], ITEM_FONT: ['.otf', '.woff', '.ttf'], ITEM_SCRIPT: ['.js'], ITEM_NAVIGATION: ['.ncx'], ITEM_VIDEO: ['.mov', '.mp4', '.avi'], ITEM_AUDIO: ['.mp3', '.ogg'], ITEM_COVER: ['.jpg', '.jpeg', '.png'], ITEM_SMIL: ['.smil'] } ebooklib-0.17.1/ebooklib/epub.py000066400000000000000000001566731341350332300165000ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . import zipfile import six import logging import uuid import posixpath as zip_path import os.path from collections import OrderedDict try: from urllib.parse import unquote except ImportError: from urllib import unquote from lxml import etree import ebooklib from ebooklib.utils import parse_string, parse_html_string, guess_type, get_pages_for_items # Version of EPUB library VERSION = (0, 17, 1) NAMESPACES = {'XML': 'http://www.w3.org/XML/1998/namespace', 'EPUB': 'http://www.idpf.org/2007/ops', 'DAISY': 'http://www.daisy.org/z3986/2005/ncx/', 'OPF': 'http://www.idpf.org/2007/opf', 'CONTAINERNS': 'urn:oasis:names:tc:opendocument:xmlns:container', 'DC': 'http://purl.org/dc/elements/1.1/', 'XHTML': 'http://www.w3.org/1999/xhtml'} # XML Templates CONTAINER_PATH = 'META-INF/container.xml' CONTAINER_XML = ''' ''' NCX_XML = six.b(''' ''') NAV_XML = six.b('''''') CHAPTER_XML = six.b('''''') COVER_XML = six.b(''' ''') IMAGE_MEDIA_TYPES = ['image/jpeg', 'image/jpg', 'image/png', 'image/svg+xml'] # TOC and navigation elements class Section(object): def __init__(self, title, href=''): self.title = title self.href = href class Link(object): def __init__(self, href, title, uid=None): self.href = href self.title = title self.uid = uid # Exceptions class EpubException(Exception): def __init__(self, code, msg): self.code = code self.msg = msg def __str__(self): return repr(self.msg) # Items class EpubItem(object): """ Base class for the items in a book. """ def __init__(self, uid=None, file_name='', media_type='', content=six.b(''), manifest=True): """ :Args: - uid: Unique identifier for this item (optional) - file_name: File name for this item (optional) - media_type: Media type for this item (optional) - content: Content for this item (optional) - manifest: Manifest for this item (optional) """ self.id = uid self.file_name = file_name self.media_type = media_type self.content = content self.is_linear = True self.manifest = manifest self.book = None def get_id(self): """ Returns unique identifier for this item. :Returns: Returns uid number as string. """ return self.id def get_name(self): """ Returns name for this item. By default it is always file name but it does not have to be. :Returns: Returns file name for this item. """ return self.file_name def get_type(self): """ Guess type according to the file extension. Might not be the best way how to do it, but it works for now. Items can be of type: - ITEM_UNKNOWN = 0 - ITEM_IMAGE = 1 - ITEM_STYLE = 2 - ITEM_SCRIPT = 3 - ITEM_NAVIGATION = 4 - ITEM_VECTOR = 5 - ITEM_FONT = 6 - ITEM_VIDEO = 7 - ITEM_AUDIO = 8 - ITEM_DOCUMENT = 9 - ITEM_COVER = 10 We map type according to the extensions which are defined in ebooklib.EXTENSIONS. :Returns: Returns type of the item as number. """ _, ext = zip_path.splitext(self.get_name()) ext = ext.lower() for uid, ext_list in six.iteritems(ebooklib.EXTENSIONS): if ext in ext_list: return uid return ebooklib.ITEM_UNKNOWN def get_content(self, default=six.b('')): """ Returns content of the item. Content should be of type 'str' (Python 2) or 'bytes' (Python 3) :Args: - default: Default value for the content if it is not already defined. :Returns: Returns content of the item. """ return self.content or default def set_content(self, content): """ Sets content value for this item. :Args: - content: Content value """ self.content = content def __str__(self): return '' % self.id class EpubNcx(EpubItem): "Represents Navigation Control File (NCX) in the EPUB." def __init__(self, uid='ncx', file_name='toc.ncx'): super(EpubNcx, self).__init__(uid=uid, file_name=file_name, media_type='application/x-dtbncx+xml') def __str__(self): return '' % self.id class EpubCover(EpubItem): """ Represents Cover image in the EPUB file. """ def __init__(self, uid='cover-img', file_name=''): super(EpubCover, self).__init__(uid=uid, file_name=file_name) def get_type(self): return ebooklib.ITEM_COVER def __str__(self): return '' % (self.id, self.file_name) class EpubHtml(EpubItem): """ Represents HTML document in the EPUB file. """ _template_name = 'chapter' def __init__(self, uid=None, file_name='', media_type='', content=None, title='', lang=None, direction=None, media_overlay=None, media_duration=None): super(EpubHtml, self).__init__(uid, file_name, media_type, content) self.title = title self.lang = lang self.direction = direction self.media_overlay = media_overlay self.media_duration = media_duration self.links = [] self.properties = [] self.pages = [] def is_chapter(self): """ Returns if this document is chapter or not. :Returns: Returns book value. """ return True def get_type(self): """ Always returns ebooklib.ITEM_DOCUMENT as type of this document. :Returns: Always returns ebooklib.ITEM_DOCUMENT """ return ebooklib.ITEM_DOCUMENT def set_language(self, lang): """ Sets language for this book item. By default it will use language of the book but it can be overwritten with this call. """ self.lang = lang def get_language(self): """ Get language code for this book item. Language of the book item can be different from the language settings defined globaly for book. :Returns: As string returns language code. """ return self.lang def add_link(self, **kwgs): """ Add additional link to the document. Links will be embeded only inside of this document. >>> add_link(href='styles.css', rel='stylesheet', type='text/css') """ self.links.append(kwgs) def get_links(self): """ Returns list of additional links defined for this document. :Returns: As tuple return list of links. """ return (link for link in self.links) def get_links_of_type(self, link_type): """ Returns list of additional links of specific type. :Returns: As tuple returns list of links. """ return (link for link in self.links if link.get('type', '') == link_type) def add_item(self, item): """ Add other item to this document. It will create additional links according to the item type. :Args: - item: item we want to add defined as instance of EpubItem """ if item.get_type() == ebooklib.ITEM_STYLE: self.add_link(href=item.get_name(), rel='stylesheet', type='text/css') if item.get_type() == ebooklib.ITEM_SCRIPT: self.add_link(src=item.get_name(), type='text/javascript') def get_body_content(self): """ Returns content of BODY element for this HTML document. Content will be of type 'str' (Python 2) or 'bytes' (Python 3). :Returns: Returns content of this document. """ try: html_tree = parse_html_string(self.content) except: return '' html_root = html_tree.getroottree() if len(html_root.find('body')) != 0: body = html_tree.find('body') tree_str = etree.tostring(body, pretty_print=True, encoding='utf-8', xml_declaration=False) # this is so stupid if tree_str.startswith(six.b('')): n = tree_str.rindex(six.b('')) return tree_str[6:n] return tree_str return '' def get_content(self, default=None): """ Returns content for this document as HTML string. Content will be of type 'str' (Python 2) or 'bytes' (Python 3). :Args: - default: Default value for the content if it is not defined. :Returns: Returns content of this document. """ tree = parse_string(self.book.get_template(self._template_name)) tree_root = tree.getroot() tree_root.set('lang', self.lang or self.book.language) tree_root.attrib['{%s}lang' % NAMESPACES['XML']] = self.lang or self.book.language # add to the head also # try: html_tree = parse_html_string(self.content) except: return '' html_root = html_tree.getroottree() # create and populate head _head = etree.SubElement(tree_root, 'head') if self.title != '': _title = etree.SubElement(_head, 'title') _title.text = self.title for lnk in self.links: if lnk.get('type') == 'text/javascript': _lnk = etree.SubElement(_head, 'script', lnk) # force _lnk.text = '' else: _lnk = etree.SubElement(_head, 'link', lnk) # this should not be like this # head = html_root.find('head') # if head is not None: # for i in head.getchildren(): # if i.tag == 'title' and self.title != '': # continue # _head.append(i) # create and populate body _body = etree.SubElement(tree_root, 'body') if self.direction: _body.set('dir', self.direction) body = html_tree.find('body') if body is not None: for i in body.getchildren(): _body.append(i) tree_str = etree.tostring(tree, pretty_print=True, encoding='utf-8', xml_declaration=True) return tree_str def __str__(self): return '' % (self.id, self.file_name) class EpubCoverHtml(EpubHtml): """ Represents Cover page in the EPUB file. """ def __init__(self, uid='cover', file_name='cover.xhtml', image_name='', title='Cover'): super(EpubCoverHtml, self).__init__(uid=uid, file_name=file_name, title=title) self.image_name = image_name self.is_linear = False def is_chapter(self): """ Returns if this document is chapter or not. :Returns: Returns book value. """ return False def get_content(self): """ Returns content for cover page as HTML string. Content will be of type 'str' (Python 2) or 'bytes' (Python 3). :Returns: Returns content of this document. """ self.content = self.book.get_template('cover') tree = parse_string(super(EpubCoverHtml, self).get_content()) tree_root = tree.getroot() images = tree_root.xpath('//xhtml:img', namespaces={'xhtml': NAMESPACES['XHTML']}) images[0].set('src', self.image_name) images[0].set('alt', self.title) tree_str = etree.tostring(tree, pretty_print=True, encoding='utf-8', xml_declaration=True) return tree_str def __str__(self): return '' % (self.id, self.file_name) class EpubNav(EpubHtml): """ Represents Navigation Document in the EPUB file. """ def __init__(self, uid='nav', file_name='nav.xhtml', media_type='application/xhtml+xml'): super(EpubNav, self).__init__(uid=uid, file_name=file_name, media_type=media_type) def is_chapter(self): """ Returns if this document is chapter or not. :Returns: Returns book value. """ return False def __str__(self): return '' % (self.id, self.file_name) class EpubImage(EpubItem): """ Represents Image in the EPUB file. """ def __init__(self): super(EpubImage, self).__init__() def get_type(self): return ebooklib.ITEM_IMAGE def __str__(self): return '' % (self.id, self.file_name) class EpubSMIL(EpubItem): def __init__(self, uid=None, file_name='', content=None): super(EpubSMIL, self).__init__(uid=uid, file_name=file_name, media_type='application/smil+xml', content=content) def get_type(self): return ebooklib.ITEM_SMIL def __str__(self): return '' % (self.id, self.file_name) # EpubBook class EpubBook(object): def __init__(self): self.EPUB_VERSION = None self.reset() # we should have options here def reset(self): "Initialises all needed variables to default values" self.metadata = {} self.items = [] self.spine = [] self.guide = [] self.pages = [] self.toc = [] self.bindings = [] self.IDENTIFIER_ID = 'id' self.FOLDER_NAME = 'EPUB' self._id_html = 0 self._id_image = 0 self._id_static = 0 self.title = '' self.language = 'en' self.direction = None self.templates = { 'ncx': NCX_XML, 'nav': NAV_XML, 'chapter': CHAPTER_XML, 'cover': COVER_XML } self.add_metadata('OPF', 'generator', '', { 'name': 'generator', 'content': 'Ebook-lib %s' % '.'.join([str(s) for s in VERSION]) }) # default to using a randomly-unique identifier if one is not specified manually self.set_identifier(str(uuid.uuid4())) # custom prefixes and namespaces to be set to the content.opf doc self.prefixes = [] self.namespaces = {} def set_identifier(self, uid): """ Sets unique id for this epub :Args: - uid: Value of unique identifier for this book """ self.uid = uid self.set_unique_metadata('DC', 'identifier', self.uid, {'id': self.IDENTIFIER_ID}) def set_title(self, title): """ Set title. You can set multiple titles. :Args: - title: Title value """ self.title = title self.add_metadata('DC', 'title', self.title) def set_language(self, lang): """ Set language for this epub. You can set multiple languages. Specific items in the book can have different language settings. :Args: - lang: Language code """ self.language = lang self.add_metadata('DC', 'language', lang) def set_direction(self, direction): """ :Args: - direction: Options are "ltr", "rtl" and "default" """ self.direction = direction def set_cover(self, file_name, content, create_page=True): """ Set cover and create cover document if needed. :Args: - file_name: file name of the cover page - content: Content for the cover image - create_page: Should cover page be defined. Defined as bool value (optional). Default value is True. """ # as it is now, it can only be called once c0 = EpubCover(file_name=file_name) c0.content = content self.add_item(c0) if create_page: c1 = EpubCoverHtml(image_name=file_name) self.add_item(c1) self.add_metadata(None, 'meta', '', OrderedDict([('name', 'cover'), ('content', 'cover-img')])) def add_author(self, author, file_as=None, role=None, uid='creator'): "Add author for this document" self.add_metadata('DC', 'creator', author, {'id': uid}) if file_as: self.add_metadata(None, 'meta', file_as, {'refines': '#' + uid, 'property': 'file-as', 'scheme': 'marc:relators'}) if role: self.add_metadata(None, 'meta', role, {'refines': '#' + uid, 'property': 'role', 'scheme': 'marc:relators'}) def add_metadata(self, namespace, name, value, others=None): "Add metadata" if namespace in NAMESPACES: namespace = NAMESPACES[namespace] if namespace not in self.metadata: self.metadata[namespace] = {} if name not in self.metadata[namespace]: self.metadata[namespace][name] = [] self.metadata[namespace][name].append((value, others)) def get_metadata(self, namespace, name): "Retrieve metadata" if namespace in NAMESPACES: namespace = NAMESPACES[namespace] return self.metadata[namespace].get(name, []) def set_unique_metadata(self, namespace, name, value, others=None): "Add metadata if metadata with this identifier does not already exist, otherwise update existing metadata." if namespace in NAMESPACES: namespace = NAMESPACES[namespace] if namespace in self.metadata and name in self.metadata[namespace]: self.metadata[namespace][name] = [(value, others)] else: self.add_metadata(namespace, name, value, others) def add_item(self, item): """ Add additional item to the book. If not defined, media type and chapter id will be defined for the item. :Args: - item: Item instance """ if item.media_type == '': (has_guessed, media_type) = guess_type(item.get_name().lower()) if has_guessed: if media_type is not None: item.media_type = media_type else: item.media_type = has_guessed else: item.media_type = 'application/octet-stream' if not item.get_id(): # make chapter_, image_ and static_ configurable if isinstance(item, EpubHtml): item.id = 'chapter_%d' % self._id_html self._id_html += 1 # If there's a page list, append it to the book's page list self.pages += item.pages elif isinstance(item, EpubImage): item.id = 'image_%d' % self._id_image self._id_image += 1 else: item.id = 'static_%d' % self._id_image self._id_image += 1 item.book = self self.items.append(item) return item def get_item_with_id(self, uid): """ Returns item for defined UID. >>> book.get_item_with_id('image_001') :Args: - uid: UID for the item :Returns: Returns item object. Returns None if nothing was found. """ for item in self.get_items(): if item.id == uid: return item return None def get_item_with_href(self, href): """ Returns item for defined HREF. >>> book.get_item_with_href('EPUB/document.xhtml') :Args: - href: HREF for the item we are searching for :Returns: Returns item object. Returns None if nothing was found. """ for item in self.get_items(): if item.get_name() == href: return item return None def get_items(self): """ Returns all items attached to this book. :Returns: Returns all items as tuple. """ return (item for item in self.items) def get_items_of_type(self, item_type): """ Returns all items of specified type. >>> book.get_items_of_type(epub.ITEM_IMAGE) :Args: - item_type: Type for items we are searching for :Returns: Returns found items as tuple. """ return (item for item in self.items if item.get_type() == item_type) def get_items_of_media_type(self, media_type): """ Returns all items of specified media type. :Args: - media_type: Media type for items we are searching for :Returns: Returns found items as tuple. """ return (item for item in self.items if item.media_type == media_type) def set_template(self, name, value): """ Defines templates which are used to generate certain types of pages. When defining new value for the template we have to use content of type 'str' (Python 2) or 'bytes' (Python 3). At the moment we use these templates: - ncx - nav - chapter - cover :Args: - name: Name for the template - value: Content for the template """ self.templates[name] = value def get_template(self, name): """ Returns value for the template. :Args: - name: template name :Returns: Value of the template. """ return self.templates.get(name) def add_prefix(self, name, uri): """ Appends custom prefix to be added to the content.opf document >>> epub_book.add_prefix('bkterms', 'http://booktype.org/') :Args: - name: namespave name - uri: URI for the namespace """ self.prefixes.append('%s: %s' % (name, uri)) class EpubWriter(object): DEFAULT_OPTIONS = { 'epub2_guide': True, 'epub3_landmark': True, 'epub3_pages': True, 'landmark_title': 'Guide', 'pages_title': 'Pages', 'spine_direction': True, 'package_direction': False, 'play_order': { 'enabled': False, 'start_from': 1 } } def __init__(self, name, book, options=None): self.file_name = name self.book = book self.options = dict(self.DEFAULT_OPTIONS) if options: self.options.update(options) self._init_play_order() def _init_play_order(self): self._play_order = { 'enabled': False, 'start_from': 1 } try: self._play_order['enabled'] = self.options['play_order']['enabled'] self._play_order['start_from'] = self.options['play_order']['start_from'] except KeyError: pass def process(self): # should cache this html parsing so we don't do it for every plugin for plg in self.options.get('plugins', []): if hasattr(plg, 'before_write'): plg.before_write(self.book) for item in self.book.get_items(): if isinstance(item, EpubHtml): for plg in self.options.get('plugins', []): if hasattr(plg, 'html_before_write'): plg.html_before_write(self.book, item) def _write_container(self): container_xml = CONTAINER_XML % {'folder_name': self.book.FOLDER_NAME} self.out.writestr(CONTAINER_PATH, container_xml) def _write_opf_metadata(self, root): # This is really not needed # problem is uppercase/lowercase # for ns_name, values in six.iteritems(self.book.metadata): # if ns_name: # for n_id, ns_url in six.iteritems(NAMESPACES): # if ns_name == ns_url: # nsmap[n_id.lower()] = NAMESPACES[n_id] nsmap = {'dc': NAMESPACES['DC'], 'opf': NAMESPACES['OPF']} nsmap.update(self.book.namespaces) metadata = etree.SubElement(root, 'metadata', nsmap=nsmap) el = etree.SubElement(metadata, 'meta', {'property': 'dcterms:modified'}) if 'mtime' in self.options: mtime = self.options['mtime'] else: import datetime mtime = datetime.datetime.now() el.text = mtime.strftime('%Y-%m-%dT%H:%M:%SZ') for ns_name, values in six.iteritems(self.book.metadata): if ns_name == NAMESPACES['OPF']: for values in values.values(): for v in values: if 'property' in v[1] and v[1]['property'] == 'dcterms:modified': continue try: el = etree.SubElement(metadata, 'meta', v[1]) if v[0]: el.text = v[0] except ValueError: logging.error('Could not create metadata.') else: for name, values in six.iteritems(values): for v in values: try: if ns_name: el = etree.SubElement(metadata, '{%s}%s' % (ns_name, name), v[1]) else: el = etree.SubElement(metadata, '%s' % name, v[1]) el.text = v[0] except ValueError: logging.error('Could not create metadata "{}".'.format(name)) def _write_opf_manifest(self, root): manifest = etree.SubElement(root, 'manifest') _ncx_id = None # mathml, scripted, svg, remote-resources, and switch # nav # cover-image for item in self.book.get_items(): if not item.manifest: continue if isinstance(item, EpubNav): etree.SubElement(manifest, 'item', {'href': item.get_name(), 'id': item.id, 'media-type': item.media_type, 'properties': 'nav'}) elif isinstance(item, EpubNcx): _ncx_id = item.id etree.SubElement(manifest, 'item', {'href': item.file_name, 'id': item.id, 'media-type': item.media_type}) elif isinstance(item, EpubCover): etree.SubElement(manifest, 'item', {'href': item.file_name, 'id': item.id, 'media-type': item.media_type, 'properties': 'cover-image'}) else: opts = {'href': item.file_name, 'id': item.id, 'media-type': item.media_type} if hasattr(item, 'properties') and len(item.properties) > 0: opts['properties'] = ' '.join(item.properties) if hasattr(item, 'media_overlay') and item.media_overlay is not None: opts['media-overlay'] = item.media_overlay if hasattr(item, 'media_duration') and item.media_duration is not None: opts['duration'] = item.media_duration etree.SubElement(manifest, 'item', opts) return _ncx_id def _write_opf_spine(self, root, ncx_id): spine_attributes = {'toc': ncx_id or 'ncx'} if self.book.direction and self.options['spine_direction']: spine_attributes['page-progression-direction'] = self.book.direction spine = etree.SubElement(root, 'spine', spine_attributes) for _item in self.book.spine: # this is for now # later we should be able to fetch things from tuple is_linear = True if isinstance(_item, tuple): item = _item[0] if len(_item) > 1: if _item[1] == 'no': is_linear = False else: item = _item if isinstance(item, EpubHtml): opts = {'idref': item.get_id()} if not item.is_linear or not is_linear: opts['linear'] = 'no' elif isinstance(item, EpubItem): opts = {'idref': item.get_id()} if not item.is_linear or not is_linear: opts['linear'] = 'no' else: opts = {'idref': item} try: itm = self.book.get_item_with_id(item) if not itm.is_linear or not is_linear: opts['linear'] = 'no' except: pass etree.SubElement(spine, 'itemref', opts) def _write_opf_guide(self, root): # - http://www.idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.6 if len(self.book.guide) > 0 and self.options.get('epub2_guide'): guide = etree.SubElement(root, 'guide', {}) for item in self.book.guide: if 'item' in item: chap = item.get('item') if chap: _href = chap.file_name _title = chap.title else: _href = item.get('href', '') _title = item.get('title', '') if _title is None: _title = '' ref = etree.SubElement(guide, 'reference', {'type': item.get('type', ''), 'title': _title, 'href': _href}) def _write_opf_bindings(self, root): if len(self.book.bindings) > 0: bindings = etree.SubElement(root, 'bindings', {}) for item in self.book.bindings: etree.SubElement(bindings, 'mediaType', item) def _write_opf_file(self, root): tree_str = etree.tostring(root, pretty_print=True, encoding='utf-8', xml_declaration=True) self.out.writestr('%s/content.opf' % self.book.FOLDER_NAME, tree_str) def _write_opf(self): package_attributes = {'xmlns': NAMESPACES['OPF'], 'unique-identifier': self.book.IDENTIFIER_ID, 'version': '3.0'} if self.book.direction and self.options['package_direction']: package_attributes['dir'] = self.book.direction root = etree.Element('package', package_attributes) prefixes = ['rendition: http://www.idpf.org/vocab/rendition/#'] + self.book.prefixes root.attrib['prefix'] = ' '.join(prefixes) # METADATA self._write_opf_metadata(root) # MANIFEST _ncx_id = self._write_opf_manifest(root) # SPINE self._write_opf_spine(root, _ncx_id) # GUIDE self._write_opf_guide(root) # BINDINGS self._write_opf_bindings(root) # WRITE FILE self._write_opf_file(root) def _get_nav(self, item): # just a basic navigation for now nav_xml = parse_string(self.book.get_template('nav')) root = nav_xml.getroot() root.set('lang', self.book.language) root.attrib['{%s}lang' % NAMESPACES['XML']] = self.book.language nav_dir_name = os.path.dirname(item.file_name) head = etree.SubElement(root, 'head') title = etree.SubElement(head, 'title') title.text = self.book.title # for now this just handles css files and ignores others for _link in item.links: _lnk = etree.SubElement(head, 'link', { 'href': _link.get('href', ''), 'rel': 'stylesheet', 'type': 'text/css' }) body = etree.SubElement(root, 'body') nav = etree.SubElement(body, 'nav', { '{%s}type' % NAMESPACES['EPUB']: 'toc', 'id': 'id', 'role': 'doc-toc', }) content_title = etree.SubElement(nav, 'h2') content_title.text = self.book.title def _create_section(itm, items): ol = etree.SubElement(itm, 'ol') for item in items: if isinstance(item, tuple) or isinstance(item, list): li = etree.SubElement(ol, 'li') if isinstance(item[0], EpubHtml): a = etree.SubElement(li, 'a', {'href': os.path.relpath(item[0].file_name, nav_dir_name)}) elif isinstance(item[0], Section) and item[0].href != '': a = etree.SubElement(li, 'a', {'href': os.path.relpath(item[0].href, nav_dir_name)}) elif isinstance(item[0], Link): a = etree.SubElement(li, 'a', {'href': os.path.relpath(item[0].href, nav_dir_name)}) else: a = etree.SubElement(li, 'span') a.text = item[0].title _create_section(li, item[1]) elif isinstance(item, Link): li = etree.SubElement(ol, 'li') a = etree.SubElement(li, 'a', {'href': os.path.relpath(item.href, nav_dir_name)}) a.text = item.title elif isinstance(item, EpubHtml): li = etree.SubElement(ol, 'li') a = etree.SubElement(li, 'a', {'href': os.path.relpath(item.file_name, nav_dir_name)}) a.text = item.title _create_section(nav, self.book.toc) # LANDMARKS / GUIDE # - http://www.idpf.org/epub/30/spec/epub30-contentdocs.html#sec-xhtml-nav-def-types-landmarks if len(self.book.guide) > 0 and self.options.get('epub3_landmark'): # Epub2 guide types do not map completely to epub3 landmark types. guide_to_landscape_map = { 'notes': 'rearnotes', 'text': 'bodymatter' } guide_nav = etree.SubElement(body, 'nav', {'{%s}type' % NAMESPACES['EPUB']: 'landmarks'}) guide_content_title = etree.SubElement(guide_nav, 'h2') guide_content_title.text = self.options.get('landmark_title', 'Guide') guild_ol = etree.SubElement(guide_nav, 'ol') for elem in self.book.guide: li_item = etree.SubElement(guild_ol, 'li') if 'item' in elem: chap = elem.get('item', None) if chap: _href = chap.file_name _title = chap.title else: _href = elem.get('href', '') _title = elem.get('title', '') guide_type = elem.get('type', '') a_item = etree.SubElement(li_item, 'a', { '{%s}type' % NAMESPACES['EPUB']: guide_to_landscape_map.get(guide_type, guide_type), 'href': os.path.relpath(_href, nav_dir_name) }) a_item.text = _title # PAGE-LIST if self.options.get('epub3_pages'): inserted_pages = get_pages_for_items([item for item in self.book.get_items_of_type(ebooklib.ITEM_DOCUMENT) \ if not isinstance(item, EpubNav)]) if len(inserted_pages) > 0: pagelist_nav = etree.SubElement( body, 'nav', { '{%s}type' % NAMESPACES['EPUB']: 'page-list', 'id': 'pages', 'hidden': 'hidden', } ) pagelist_content_title = etree.SubElement(pagelist_nav, 'h2') pagelist_content_title.text = self.options.get( 'pages_title', 'Pages' ) pages_ol = etree.SubElement(pagelist_nav, 'ol') for filename, pageref, label in inserted_pages: li_item = etree.SubElement(pages_ol, 'li') _href = u'{}#{}'.format(filename, pageref) _title = label a_item = etree.SubElement(li_item, 'a', { 'href': os.path.relpath(_href, nav_dir_name), }) a_item.text = _title tree_str = etree.tostring(nav_xml, pretty_print=True, encoding='utf-8', xml_declaration=True) return tree_str def _get_ncx(self): # we should be able to setup language for NCX as also ncx = parse_string(self.book.get_template('ncx')) root = ncx.getroot() head = etree.SubElement(root, 'head') # get this id uid = etree.SubElement(head, 'meta', {'content': self.book.uid, 'name': 'dtb:uid'}) uid = etree.SubElement(head, 'meta', {'content': '0', 'name': 'dtb:depth'}) uid = etree.SubElement(head, 'meta', {'content': '0', 'name': 'dtb:totalPageCount'}) uid = etree.SubElement(head, 'meta', {'content': '0', 'name': 'dtb:maxPageNumber'}) doc_title = etree.SubElement(root, 'docTitle') title = etree.SubElement(doc_title, 'text') title.text = self.book.title # doc_author = etree.SubElement(root, 'docAuthor') # author = etree.SubElement(doc_author, 'text') # author.text = 'Name of the person' # For now just make a very simple navMap nav_map = etree.SubElement(root, 'navMap') def _add_play_order(nav_point): nav_point.set('playOrder', str(self._play_order['start_from'])) self._play_order['start_from'] += 1 def _create_section(itm, items, uid): for item in items: if isinstance(item, tuple) or isinstance(item, list): section, subsection = item[0], item[1] np = etree.SubElement(itm, 'navPoint', { 'id': section.get_id() if isinstance(section, EpubHtml) else 'sep_%d' % uid }) if self._play_order['enabled']: _add_play_order(np) nl = etree.SubElement(np, 'navLabel') nt = etree.SubElement(nl, 'text') nt.text = section.title # CAN NOT HAVE EMPTY SRC HERE href = '' if isinstance(section, EpubHtml): href = section.file_name elif isinstance(section, Section) and section.href != '': href = section.href elif isinstance(section, Link): href = section.href nc = etree.SubElement(np, 'content', {'src': href}) uid = _create_section(np, subsection, uid + 1) elif isinstance(item, Link): _parent = itm _content = _parent.find('content') if _content is not None: if _content.get('src') == '': _content.set('src', item.href) np = etree.SubElement(itm, 'navPoint', {'id': item.uid}) if self._play_order['enabled']: _add_play_order(np) nl = etree.SubElement(np, 'navLabel') nt = etree.SubElement(nl, 'text') nt.text = item.title nc = etree.SubElement(np, 'content', {'src': item.href}) elif isinstance(item, EpubHtml): _parent = itm _content = _parent.find('content') if _content is not None: if _content.get('src') == '': _content.set('src', item.file_name) np = etree.SubElement(itm, 'navPoint', {'id': item.get_id()}) if self._play_order['enabled']: _add_play_order(np) nl = etree.SubElement(np, 'navLabel') nt = etree.SubElement(nl, 'text') nt.text = item.title nc = etree.SubElement(np, 'content', {'src': item.file_name}) return uid _create_section(nav_map, self.book.toc, 0) tree_str = etree.tostring(root, pretty_print=True, encoding='utf-8', xml_declaration=True) return tree_str def _write_items(self): for item in self.book.get_items(): if isinstance(item, EpubNcx): self.out.writestr('%s/%s' % (self.book.FOLDER_NAME, item.file_name), self._get_ncx()) elif isinstance(item, EpubNav): self.out.writestr('%s/%s' % (self.book.FOLDER_NAME, item.file_name), self._get_nav(item)) elif item.manifest: self.out.writestr('%s/%s' % (self.book.FOLDER_NAME, item.file_name), item.get_content()) else: self.out.writestr('%s' % item.file_name, item.get_content()) def write(self): # check for the option allowZip64 self.out = zipfile.ZipFile(self.file_name, 'w', zipfile.ZIP_DEFLATED) self.out.writestr('mimetype', 'application/epub+zip', compress_type=zipfile.ZIP_STORED) self._write_container() self._write_opf() self._write_items() self.out.close() class EpubReader(object): DEFAULT_OPTIONS = {} def __init__(self, epub_file_name, options=None): self.file_name = epub_file_name self.book = EpubBook() self.zf = None self.opf_file = '' self.opf_dir = '' self.options = dict(self.DEFAULT_OPTIONS) if options: self.options.update(options) def process(self): # should cache this html parsing so we don't do it for every plugin for plg in self.options.get('plugins', []): if hasattr(plg, 'after_read'): plg.after_read(self.book) for item in self.book.get_items(): if isinstance(item, EpubHtml): for plg in self.options.get('plugins', []): if hasattr(plg, 'html_after_read'): plg.html_after_read(self.book, item) def load(self): self._load() return self.book def read_file(self, name): # Raises KeyError name = zip_path.normpath(name) return self.zf.read(name) def _load_container(self): meta_inf = self.read_file('META-INF/container.xml') tree = parse_string(meta_inf) for root_file in tree.findall('//xmlns:rootfile[@media-type]', namespaces={'xmlns': NAMESPACES['CONTAINERNS']}): if root_file.get('media-type') == 'application/oebps-package+xml': self.opf_file = root_file.get('full-path') self.opf_dir = zip_path.dirname(self.opf_file) def _load_metadata(self): container_root = self.container.getroot() # get epub version self.book.version = container_root.get('version', None) # get unique-identifier if container_root.get('unique-identifier', None): self.book.IDENTIFIER_ID = container_root.get('unique-identifier') # get xml:lang # get metadata metadata = self.container.find('{%s}%s' % (NAMESPACES['OPF'], 'metadata')) nsmap = metadata.nsmap nstags = dict((k, '{%s}' % v) for k, v in six.iteritems(nsmap)) default_ns = nstags.get(None, '') nsdict = dict((v, {}) for v in nsmap.values()) def add_item(ns, tag, value, extra): if ns not in nsdict: nsdict[ns] = {} values = nsdict[ns].setdefault(tag, []) values.append((value, extra)) for t in metadata: if not etree.iselement(t) or t.tag is etree.Comment: continue if t.tag == default_ns + 'meta': name = t.get('name') others = dict((k, v) for k, v in t.items()) if name and ':' in name: prefix, name = name.split(':', 1) else: prefix = None add_item(t.nsmap.get(prefix, prefix), name, t.text, others) else: tag = t.tag[t.tag.rfind('}') + 1:] if (t.prefix and t.prefix.lower() == 'dc') and tag == 'identifier': _id = t.get('id', None) if _id: self.book.IDENTIFIER_ID = _id others = dict((k, v) for k, v in t.items()) add_item(t.nsmap[t.prefix], tag, t.text, others) self.book.metadata = nsdict titles = self.book.get_metadata('DC', 'title') if len(titles) > 0: self.book.title = titles[0][0] for value, others in self.book.get_metadata('DC', 'identifier'): if others.get('id') == self.book.IDENTIFIER_ID: self.book.uid = value def _load_manifest(self): for r in self.container.find('{%s}%s' % (NAMESPACES['OPF'], 'manifest')): if r is not None and r.tag != '{%s}item' % NAMESPACES['OPF']: continue media_type = r.get('media-type') _properties = r.get('properties', '') if _properties: properties = _properties.split(' ') else: properties = [] # people use wrong content types if media_type == 'image/jpg': media_type = 'image/jpeg' if media_type == 'application/x-dtbncx+xml': ei = EpubNcx(uid=r.get('id'), file_name=unquote(r.get('href'))) ei.content = self.read_file(zip_path.join(self.opf_dir, ei.file_name)) if media_type == 'application/smil+xml': ei = EpubSMIL(uid=r.get('id'), file_name=unquote(r.get('href'))) ei.content = self.read_file(zip_path.join(self.opf_dir, ei.file_name)) elif media_type == 'application/xhtml+xml': if 'nav' in properties: ei = EpubNav(uid=r.get('id'), file_name=unquote(r.get('href'))) ei.content = self.read_file(zip_path.join(self.opf_dir, r.get('href'))) elif 'cover' in properties: ei = EpubCoverHtml() ei.content = self.read_file(zip_path.join(self.opf_dir, unquote(r.get('href')))) else: ei = EpubHtml() ei.id = r.get('id') ei.file_name = unquote(r.get('href')) ei.media_type = media_type ei.media_overlay = r.get('media-overlay', None) ei.media_duration = r.get('duration', None) ei.content = self.read_file(zip_path.join(self.opf_dir, ei.get_name())) ei.properties = properties elif media_type in IMAGE_MEDIA_TYPES: if 'cover-image' in properties: ei = EpubCover(uid=r.get('id'), file_name=unquote(r.get('href'))) ei.media_type = media_type ei.content = self.read_file(zip_path.join(self.opf_dir, ei.get_name())) else: ei = EpubImage() ei.id = r.get('id') ei.file_name = unquote(r.get('href')) ei.media_type = media_type ei.content = self.read_file(zip_path.join(self.opf_dir, ei.get_name())) else: # different types ei = EpubItem() ei.id = r.get('id') ei.file_name = unquote(r.get('href')) ei.media_type = media_type ei.content = self.read_file(zip_path.join(self.opf_dir, ei.get_name())) self.book.add_item(ei) def _parse_ncx(self, data): tree = parse_string(data) tree_root = tree.getroot() nav_map = tree_root.find('{%s}navMap' % NAMESPACES['DAISY']) def _get_children(elems, n, nid): label, content = '', '' children = [] for a in elems.getchildren(): if a.tag == '{%s}navLabel' % NAMESPACES['DAISY']: label = a.getchildren()[0].text if a.tag == '{%s}content' % NAMESPACES['DAISY']: content = a.get('src', '') if a.tag == '{%s}navPoint' % NAMESPACES['DAISY']: children.append(_get_children(a, n + 1, a.get('id', ''))) if len(children) > 0: if n == 0: return children return (Section(label, href=content), children) else: return Link(content, label, nid) self.book.toc = _get_children(nav_map, 0, '') def _parse_nav(self, data, base_path, navtype='toc'): html_node = parse_html_string(data) if navtype == 'toc': # parsing the table of contents nav_node = html_node.xpath("//nav[@*='toc']")[0] else: # parsing the list of pages _page_list = html_node.xpath("//nav[@*='page-list']") if len(_page_list) == 0: return nav_node = _page_list[0] def parse_list(list_node): items = [] for item_node in list_node.findall('li'): sublist_node = item_node.find('ol') link_node = item_node.find('a') if sublist_node is not None: title = item_node[0].text children = parse_list(sublist_node) if link_node is not None: href = zip_path.normpath(zip_path.join(base_path, link_node.get('href'))) items.append((Section(title, href=href), children)) else: items.append((Section(title), children)) elif link_node is not None: title = link_node.text href = zip_path.normpath(zip_path.join(base_path, link_node.get('href'))) items.append(Link(href, title)) return items if navtype == 'toc': self.book.toc = parse_list(nav_node.find('ol')) elif nav_node is not None: # generate the pages list if there is one self.book.pages = parse_list(nav_node.find('ol')) # generate the per-file pages lists # because of the order of parsing the files, this can't be done # when building the EpubHtml objects htmlfiles = dict() for htmlfile in self.book.items: if isinstance(htmlfile, EpubHtml): htmlfiles[htmlfile.file_name] = htmlfile for page in self.book.pages: try: (filename, idref) = page.href.split('#') except ValueError: filename = page.href if filename in htmlfiles: htmlfiles[filename].pages.append(page) def _load_spine(self): spine = self.container.find('{%s}%s' % (NAMESPACES['OPF'], 'spine')) self.book.spine = [(t.get('idref'), t.get('linear', 'yes')) for t in spine] toc = spine.get('toc', '') self.book.set_direction(spine.get('page-progression-direction', None)) # should read ncx or nav file if toc: try: ncxFile = self.read_file(zip_path.join(self.opf_dir, self.book.get_item_with_id(toc).get_name())) except KeyError: raise EpubException(-1, 'Can not find ncx file.') self._parse_ncx(ncxFile) def _load_guide(self): guide = self.container.find('{%s}%s' % (NAMESPACES['OPF'], 'guide')) if guide is not None: self.book.guide = [{'href': t.get('href'), 'title': t.get('title'), 'type': t.get('type')} for t in guide] def _load_opf_file(self): try: s = self.read_file(self.opf_file) except KeyError: raise EpubException(-1, 'Can not find container file') self.container = parse_string(s) self._load_metadata() self._load_manifest() self._load_spine() self._load_guide() # read nav file if found # nav_item = next((item for item in self.book.items if isinstance(item, EpubNav)), None) if nav_item: if not self.book.toc: self._parse_nav( nav_item.content, zip_path.dirname(nav_item.file_name), navtype='toc' ) self._parse_nav( nav_item.content, zip_path.dirname(nav_item.file_name), navtype='pages' ) def _load(self): try: self.zf = zipfile.ZipFile(self.file_name, 'r', compression=zipfile.ZIP_DEFLATED, allowZip64=True) except zipfile.BadZipfile as bz: raise EpubException(0, 'Bad Zip file') except zipfile.LargeZipFile as bz: raise EpubException(1, 'Large Zip file') # 1st check metadata self._load_container() self._load_opf_file() self.zf.close() # WRITE def write_epub(name, book, options=None): """ Creates epub file with the content defined in EpubBook. >>> ebooklib.write_epub('book.epub', book) :Args: - name: file name for the output file - book: instance of EpubBook - options: extra opions as dictionary (optional) """ epub = EpubWriter(name, book, options) epub.process() try: epub.write() except IOError: pass # READ def read_epub(name, options=None): """ Creates new instance of EpubBook with the content defined in the input file. >>> book = ebooklib.read_epub('book.epub') :Args: - name: full path to the input file - options: extra options as dictionary (optional) :Returns: Instance of EpubBook. """ reader = EpubReader(name, options) book = reader.load() reader.process() return book ebooklib-0.17.1/ebooklib/plugins/000077500000000000000000000000001341350332300166325ustar00rootroot00000000000000ebooklib-0.17.1/ebooklib/plugins/__init__.py000066400000000000000000000000001341350332300207310ustar00rootroot00000000000000ebooklib-0.17.1/ebooklib/plugins/base.py000066400000000000000000000030121341350332300201120ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . class BasePlugin(object): def before_write(self, book): "Processing before save" return True def after_write(self, book): "Processing after save" return True def before_read(self, book): "Processing before save" return True def after_read(self, book): "Processing after save" return True def item_after_read(self, book, item): "Process general item after read." return True def item_before_write(self, book, item): "Process general item before write." return True def html_after_read(self, book, chapter): "Processing HTML before read." return True def html_before_write(self, book, chapter): "Processing HTML before save." return True ebooklib-0.17.1/ebooklib/plugins/booktype.py000066400000000000000000000104071341350332300210420ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . from ebooklib.plugins.base import BasePlugin from ebooklib.utils import parse_html_string class BooktypeLinks(BasePlugin): NAME = 'Booktype Links' def __init__(self, booktype_book): self.booktype_book = booktype_book def html_before_write(self, book, chapter): from lxml import etree try: from urlparse import urlparse, urljoin except ImportError: from urllib.parse import urlparse, urljoin try: tree = parse_html_string(chapter.content) except: return root = tree.getroottree() if len(root.find('body')) != 0: body = tree.find('body') # should also be aware to handle # ../chapter/ # ../chapter/#reference # ../chapter#reference for _link in body.xpath('//a'): # This is just temporary for the footnotes if _link.get('href', '').find('InsertNoteID') != -1: _ln = _link.get('href', '') i = _ln.find('#') _link.set('href', _ln[i:]) continue _u = urlparse(_link.get('href', '')) # Let us care only for internal links at the moment if _u.scheme == '': if _u.path != '': _link.set('href', '%s.xhtml' % _u.path) if _u.fragment != '': _link.set('href', urljoin(_link.get('href'), '#%s' % _u.fragment)) if _link.get('name') != None: _link.set('id', _link.get('name')) etree.strip_attributes(_link, 'name') chapter.content = etree.tostring(tree, pretty_print=True, encoding='utf-8') class BooktypeFootnotes(BasePlugin): NAME = 'Booktype Footnotes' def __init__(self, booktype_book): self.booktype_book = booktype_book def html_before_write(self, book, chapter): from lxml import etree from ebooklib import epub try: tree = parse_html_string(chapter.content) except: return root = tree.getroottree() if len(root.find('body')) != 0: body = tree.find('body') # 1 #
  1. prvi footnote ^
    2. # 1

    # for footnote in body.xpath('//span[@class="InsertNoteMarker"]'): footnote_id = footnote.get('id')[:-8] a = footnote.getchildren()[0].getchildren()[0] footnote_text = body.xpath('//li[@id="%s"]' % footnote_id)[0] a.attrib['{%s}type' % epub.NAMESPACES['EPUB']] = 'noteref' ftn = etree.SubElement(body, 'aside', {'id': footnote_id}) ftn.attrib['{%s}type' % epub.NAMESPACES['EPUB']] = 'footnote' ftn_p = etree.SubElement(ftn, 'p') ftn_p.text = footnote_text.text old_footnote = body.xpath('//ol[@id="InsertNote_NoteList"]') if len(old_footnote) > 0: body.remove(old_footnote[0]) chapter.content = etree.tostring(tree, pretty_print=True, encoding='utf-8') ebooklib-0.17.1/ebooklib/plugins/sourcecode.py000066400000000000000000000046611341350332300213460ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . from ebooklib.plugins.base import BasePlugin from ebooklib.utils import parse_html_string class SourceHighlighter(BasePlugin): def __init__(self): pass def html_before_write(self, book, chapter): from lxml import etree, html from pygments import highlight from pygments.formatters import HtmlFormatter from ebooklib import epub try: tree = parse_html_string(chapter.content) except: return root = tree.getroottree() had_source = False if len(root.find('body')) != 0: body = tree.find('body') # check for embeded source for source in body.xpath('//pre[contains(@class,"source-")]'): css_class = source.get('class') source_text = (source.text or '') + ''.join([html.tostring(child) for child in source.iterchildren()]) if 'source-python' in css_class: from pygments.lexers import PythonLexer # _text = highlight(source_text, PythonLexer(), HtmlFormatter(linenos="inline")) _text = highlight(source_text, PythonLexer(), HtmlFormatter()) if 'source-css' in css_class: from pygments.lexers import CssLexer _text = highlight(source_text, CssLexer(), HtmlFormatter()) _parent = source.getparent() _parent.replace(source, etree.XML(_text)) had_source = True if had_source: chapter.add_link(href="style/code.css", rel="stylesheet", type="text/css") chapter.content = etree.tostring(tree, pretty_print=True, encoding='utf-8') ebooklib-0.17.1/ebooklib/plugins/standard.py000066400000000000000000000303661341350332300210140ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . import six from ebooklib.plugins.base import BasePlugin from ebooklib.utils import parse_html_string # TODO: # - should also look for the _required_ elements # http://www.w3.org/html/wg/drafts/html/master/tabular-data.html#the-table-element ATTRIBUTES_GLOBAL = ['accesskey', 'class', 'contenteditable', 'contextmenu', 'dir', 'draggable', 'dropzone', 'hidden', 'id', 'inert', 'itemid', 'itemprop', 'itemref', 'itemscope', 'itemtype', 'lang', 'spellcheck', 'style', 'tabindex', 'title', 'translate', 'epub:type'] # Remove for now from here DEPRECATED_TAGS = ['acronym', 'applet', 'basefont', 'big', 'center', 'dir', 'font', 'frame', 'frameset', 'isindex', 'noframes', 's', 'strike', 'tt'] def leave_only(item, tag_list): for _attr in six.iterkeys(item.attrib): if _attr not in tag_list: del item.attrib[_attr] class SyntaxPlugin(BasePlugin): NAME = 'Check HTML syntax' def html_before_write(self, book, chapter): from lxml import etree try: tree = parse_html_string(chapter.content) except: return root = tree.getroottree() # delete deprecated tags # i should really have a list of allowed tags for tag in DEPRECATED_TAGS: etree.strip_tags(root, tag) head = tree.find('head') if head is not None and len(head) != 0: for _item in head: if _item.tag == 'base': leave_only(_item, ATTRIBUTES_GLOBAL + ['href', 'target']) elif _item.tag == 'link': leave_only(_item, ATTRIBUTES_GLOBAL + ['href', 'crossorigin', 'rel', 'media', 'hreflang', 'type', 'sizes']) elif _item.tag == 'title': if _item.text == '': head.remove(_item) elif _item.tag == 'meta': leave_only(_item, ATTRIBUTES_GLOBAL + ['name', 'http-equiv', 'content', 'charset']) # just remove for now, but really should not be like this head.remove(_item) elif _item.tag == 'script': leave_only(_item, ATTRIBUTES_GLOBAL + ['src', 'type', 'charset', 'async', 'defer', 'crossorigin']) elif _item.tag == 'source': leave_only(_item, ATTRIBUTES_GLOBAL + ['src', 'type', 'media']) elif _item.tag == 'style': leave_only(_item, ATTRIBUTES_GLOBAL + ['media', 'type', 'scoped']) else: leave_only(_item, ATTRIBUTES_GLOBAL) if len(root.find('body')) != 0: body = tree.find('body') for _item in body.iter(): # it is not # if _item.tag == 'a': leave_only(_item, ATTRIBUTES_GLOBAL + ['href', 'target', 'download', 'rel', 'hreflang', 'type']) elif _item.tag == 'area': leave_only(_item, ATTRIBUTES_GLOBAL + ['alt', 'coords', 'shape', 'href', 'target', 'download', 'rel', 'hreflang', 'type']) elif _item.tag == 'audio': leave_only(_item, ATTRIBUTES_GLOBAL + ['src', 'crossorigin', 'preload', 'autoplay', 'mediagroup', 'loop', 'muted', 'controls']) elif _item.tag == 'blockquote': leave_only(_item, ATTRIBUTES_GLOBAL + ['cite']) elif _item.tag == 'button': leave_only(_item, ATTRIBUTES_GLOBAL + ['autofocus', 'disabled', 'form', 'formaction', 'formenctype', 'formmethod', 'formnovalidate', 'formtarget', 'name', 'type', 'value', 'menu']) elif _item.tag == 'canvas': leave_only(_item, ATTRIBUTES_GLOBAL + ['width', 'height']) elif _item.tag == 'canvas': leave_only(_item, ATTRIBUTES_GLOBAL + ['width', 'height']) elif _item.tag == 'del': leave_only(_item, ATTRIBUTES_GLOBAL + ['cite', 'datetime']) elif _item.tag == 'details': leave_only(_item, ATTRIBUTES_GLOBAL + ['open']) elif _item.tag == 'embed': leave_only(_item, ATTRIBUTES_GLOBAL + ['src', 'type', 'width', 'height']) elif _item.tag == 'fieldset': leave_only(_item, ATTRIBUTES_GLOBAL + ['disable', 'form', 'name']) elif _item.tag == 'details': leave_only(_item, ATTRIBUTES_GLOBAL + ['accept-charset', 'action', 'autocomplete', 'enctype', 'method', 'name', 'novalidate', 'target']) elif _item.tag == 'iframe': leave_only(_item, ATTRIBUTES_GLOBAL + ['src', 'srcdoc', 'name', 'sandbox', 'seamless', 'allowfullscreen', 'width', 'height']) elif _item.tag == 'img': _src = _item.get('src', '').lower() if _src.startswith('http://') or _src.startswith('https://'): if 'remote-resources' not in chapter.properties: chapter.properties.append('remote-resources') # THIS DOES NOT WORK, ONLY VIDEO AND AUDIO FILES CAN BE REMOTE RESOURCES # THAT MEANS I SHOULD ALSO CATCH # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . import six import subprocess from ebooklib.plugins.base import BasePlugin from ebooklib.utils import parse_html_string # Recommend usage of # - https://github.com/w3c/tidy-html5 def tidy_cleanup(content, **extra): cmd = [] for k, v in six.iteritems(extra): if v: cmd.append('--%s' % k) cmd.append(v) else: cmd.append('-%s' % k) # must parse all other extra arguments try: p = subprocess.Popen(['tidy']+cmd, shell=False, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, close_fds=True) except OSError: return (3, None) p.stdin.write(content) (cont, p_err) = p.communicate() # 0 - all ok # 1 - there were warnings # 2 - there were errors # 3 - exception return (p.returncode, cont) class TidyPlugin(BasePlugin): NAME = 'Tidy HTML' OPTIONS = {'char-encoding': 'utf8', 'tidy-mark': 'no' } def __init__(self, extra = {}): self.options = dict(self.OPTIONS) self.options.update(extra) def html_before_write(self, book, chapter): if not chapter.content: return None (_, chapter.content) = tidy_cleanup(chapter.content, **self.options) return chapter.content def html_after_read(self, book, chapter): if not chapter.content: return None (_, chapter.content) = tidy_cleanup(chapter.content, **self.options) return chapter.content ebooklib-0.17.1/ebooklib/utils.py000066400000000000000000000060431341350332300166660ustar00rootroot00000000000000# This file is part of EbookLib. # Copyright (c) 2013 Aleksandar Erkalovic # # EbookLib is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # EbookLib is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with EbookLib. If not, see . import io import mimetypes from lxml import etree mimetype_initialised = False def debug(obj): import pprint pp = pprint.PrettyPrinter(indent=4) pp.pprint(obj) def parse_string(s): try: tree = etree.parse(io.BytesIO(s.encode('utf-8'))) except: tree = etree.parse(io.BytesIO(s)) return tree def parse_html_string(s): from lxml import html utf8_parser = html.HTMLParser(encoding='utf-8') html_tree = html.document_fromstring(s, parser=utf8_parser) return html_tree def guess_type(extenstion): global mimetype_initialised if not mimetype_initialised: mimetypes.init() mimetypes.add_type('application/xhtml+xml', '.xhtml') mimetype_initialised = True return mimetypes.guess_type(extenstion) def create_pagebreak(pageref, label=None, html=True): from ebooklib.epub import NAMESPACES pageref_attributes = { '{%s}type' % NAMESPACES['EPUB']: 'pagebreak', 'title': u'{}'.format(pageref), 'id': u'{}'.format(pageref), } pageref_elem = etree.Element('span', pageref_attributes, nsmap={'epub': NAMESPACES['EPUB']}) if label: pageref_elem.text = label if html: return etree.tostring(pageref_elem, encoding='unicode') return pageref_elem def get_headers(elem): for n in range(1, 7): headers = elem.xpath('./h{}'.format(n)) if len(headers) > 0: text = headers[0].text_content().strip() if len(text) > 0: return text return None def get_pages(item): body = parse_html_string(item.get_body_content()) pages = [] for elem in body.iter(): if 'epub:type' in elem.attrib: if elem.get('id') is not None: _text = None if elem.text is not None and elem.text.strip() != '': _text = elem.text.strip() if _text is None: _text = elem.get('aria-label') if _text is None: _text = get_headers(elem) pages.append((item.get_name(), elem.get('id'), _text or elem.get('id'))) return pages def get_pages_for_items(items): pages_from_docs = [get_pages(item) for item in items] return [item for pages in pages_from_docs for item in pages] ebooklib-0.17.1/samples/000077500000000000000000000000001341350332300150275ustar00rootroot00000000000000ebooklib-0.17.1/samples/01_basic_create/000077500000000000000000000000001341350332300177335ustar00rootroot00000000000000ebooklib-0.17.1/samples/01_basic_create/README.md000066400000000000000000000001211341350332300212040ustar00rootroot00000000000000Basic create ============ Simple EPUB3 creation. ## Start python create.pyebooklib-0.17.1/samples/01_basic_create/create.py000066400000000000000000000036551341350332300215610ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='en') c1.content=u'

    Introduction

    Introduction paragraph where i explain what is happening.

    ' # about chapter c2 = epub.EpubHtml(title='About this book', file_name='about.xhtml') c2.content='

    About this book

    Helou, this is my book! There are many books, but this one is mine.

    ' # add chapters to the book book.add_item(c1) book.add_item(c2) # create table of contents # - add section # - add auto created links to chapters book.toc = (epub.Link('intro.xhtml', 'Introduction', 'intro'), (epub.Section('Languages'), (c1, c2)) ) # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # define css style style = ''' @namespace epub "http://www.idpf.org/2007/ops"; body { font-family: Cambria, Liberation Serif, Bitstream Vera Serif, Georgia, Times, Times New Roman, serif; } h2 { text-align: left; text-transform: uppercase; font-weight: 200; } ol { list-style-type: none; } ol > li:first-child { margin-top: 0.3em; } nav[epub|type~='toc'] > ol > li > ol { list-style-type:square; } nav[epub|type~='toc'] > ol > li > ol > li { margin-top: 0.3em; } ''' # add css file nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) book.add_item(nav_css) # create spine book.spine = ['nav', c1, c2] # create epub file epub.write_epub('test.epub', book, {}) ebooklib-0.17.1/samples/02_cover_create/000077500000000000000000000000001341350332300177715ustar00rootroot00000000000000ebooklib-0.17.1/samples/02_cover_create/README.md000066400000000000000000000001411341350332300212440ustar00rootroot00000000000000Cover support ============= Create simple EPUB3 with cover page. ## Start python create.pyebooklib-0.17.1/samples/02_cover_create/cover.jpg000066400000000000000000002530541341350332300216220ustar00rootroot00000000000000*ExifMM*bj(1 r2i ' 'Adobe Photoshop CS6 (Macintosh)2013:02:09 13:28:28N"*(2HH XICC_PROFILE HLinomntrRGB XYZ  1acspMSFTIEC sRGB-HP cprtP3desclwtptbkptrXYZgXYZ,bXYZ@dmndTpdmddvuedLview$lumimeas $tech0 rTRC< gTRC< bTRC< textCopyright (c) 1998 Hewlett-Packard CompanydescsRGB IEC61966-2.1sRGB IEC61966-2.1XYZ QXYZ XYZ o8XYZ bXYZ $descIEC http://www.iec.chIEC http://www.iec.chdesc.IEC 61966-2.1 Default RGB colour space - sRGB.IEC 61966-2.1 Default RGB colour space - sRGBdesc,Reference Viewing Condition in IEC61966-2.1,Reference Viewing Condition in IEC61966-2.1view_. \XYZ L VPWmeassig CRT curv #(-27;@EJOTY^chmrw| %+28>ELRY`gnu| &/8AKT]gqz !-8COZfr~ -;HUcq~ +:IXgw'7HYj{+=Oat 2FZn  % : O d y  ' = T j " 9 Q i  * C \ u & @ Z t .Id %A^z &Ca~1Om&Ed#Cc'Ij4Vx&IlAe@e Ek*Qw;c*R{Gp@j>i  A l !!H!u!!!"'"U"""# #8#f###$$M$|$$% %8%h%%%&'&W&&&''I'z''( (?(q(())8)k))**5*h**++6+i++,,9,n,,- -A-v--..L.../$/Z///050l0011J1112*2c223 3F3334+4e4455M555676r667$7`7788P8899B999:6:t::;-;k;;<' >`>>?!?a??@#@d@@A)AjAAB0BrBBC:C}CDDGDDEEUEEF"FgFFG5G{GHHKHHIIcIIJ7J}JK KSKKL*LrLMMJMMN%NnNOOIOOP'PqPQQPQQR1R|RSS_SSTBTTU(UuUVV\VVWDWWX/X}XYYiYZZVZZ[E[[\5\\]']x]^^l^__a_``W``aOaabIbbcCccd@dde=eef=ffg=ggh?hhiCiijHjjkOkklWlmm`mnnknooxop+ppq:qqrKrss]sttptu(uuv>vvwVwxxnxy*yyzFz{{c{|!||}A}~~b~#G k͂0WGrׇ;iΉ3dʋ0cʍ1fΏ6n֑?zM _ɖ4 uL$h՛BdҞ@iءG&vVǥ8nRĩ7u\ЭD-u`ֲK³8%yhYѹJº;.! zpg_XQKFAǿ=ȼ:ɹ8ʷ6˶5̵5͵6ζ7ϸ9к<Ѿ?DINU\dlvۀ܊ݖޢ)߯6DScs 2F[p(@Xr4Pm8Ww)Km Adobe_CMAdobed            ~"?   3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TT&$״piΙ jݝ#m`H5R7"}cߥ#vN!;Xm`';R\f|Xrm5$nGwDk44!?H֊9@CE]NOǭ,vkADJ{k7hL;MR'Ye$BHo١2uJI)#i7ԏp3M.vd8CAjJCQ.(hnG6FI$TI%<,\F۩eCUh.a_7s>LU3ԱvִUO?z~n龻"}\}se]@Z朻w[[GF-6- 2>)J eQʴFپ{j.wJk[^Lzczz_YjgQ=Ӄ˽eCku/kMVz,XS>Up[68ۛQuV>ͭuRf< o Onju6o԰sVCq{#5rO\ܗ6N$l{G;מu31"rא_ZS=*XqztYi鹛ѽ3?H1}e揣Oq*:}1el/n0Ĕ]UKca{W#oַ[dR*WY{]vGf]?JZZ\45W"eigj8gxk޴;yqku~='eo{H- 5Mr=t< zu.~=-7u{?-??a\2Qa]c! 2xGSyjDb?Vzsqj X]tn36_P+ƽwUU52Xꭡֵk7ֵ\COU.lI%_TI%8[03Ldcc5[]k}l7Y?Vz>+XXUeIzSjgGHL\9_M5zw5eU]3m{ie{+bVݭ=w {?vq#q>$?N+[r}F-=C3B\w[sW TT~·g}4)X,M=o%sF^=OBCz5/wty[e#sh?jT+I~ӾR9"L?U8ٟTzO֪fUkS}JY=\OMվוּ`/bZUim~{mg޳zm]/Qݕnm]/.ԯNA_ *Q<0D7T㾸^3cZgWMnԯ3?Y}'o_o77;:sne{(Wmj]H}/DŽccCUSIe?99Uh ѓYE1rp2q^C@-V;վu^EꏯP+GwYV}7އrK$8G_G~ꪶk/Wo+Ey}?H޾̻"$.C$KyHI1OTI%)$IJI$RL5.q hԓVt̛=<|.cev1Θ.۵?ԔI$RI$I%)$IOTI%)$IJI$Ss;}'c< 529տd?EWk쎏I e%h4Ss6nغ>8CϜ ,ߵcuQ]Z %C cZ 3~%7~  '-+k>+YeM `C[GnŤI$$I)I$JTI%)$IL-V \}`s1FNAoYC2wM~lЇuZN]./+thFݻcl+r*mQLnl`wwV,l2K} q5v?+;Xs)Yǵlſ!ζRm8/m/[__ëiy2DOYpEu6Sىsqye[GlS.`5w ^׊ "5KWMKl[ɧvVVKs&ouǵ5huj!SNkzL9}? u?~"7/&CJEF{[[Yؽ ^{quW($IJI$STI%)$IM, jy1oZB>adzOk_ӁTכëN+)}.vW_}E 7XZ5 ׁs j㱮sxo%svD2ݍhѕ>vwk}yog[{o\^\-gG?W &ZZzUkqkWv;q~KrC[I$I$TI%)$IJT:t>Ŏ @]FtVc%<eĂƀL( uOP@!L GaL:r's̡II,%^ y^qiѕy J{4]O2׿zjdEmd]]?D Dfy8&ZIUt;ڱz?Mn&6Jo0:atI)I$JRI$TI%)$IJY_Z4Xַ3 ߵj8fHr1/t>J|tdlqm&V]6۶"\[~oekr:}o0= ;m0~S:zu^jw{u%=sS6j`X a;u\dg])hX/ezmi~\f9AkZ^ӡ}߼׵j( 3\_k]nsMv=/QO$N6k/ǺVCK1oܵ)GCϩ8V1v)I$JRI$'Photoshop 3.08BIMZ%GZ%G8BIM%]tn۾9y\8BIM: printOutputPstSboolInteenumInteClrmprintSixteenBitbool printerNameTEXTprintProofSetupObjc Proof Setup proofSetupBltnenum builtinProof proofCMYK8BIM;-printOutputOptionsCptnboolClbrboolRgsMboolCrnCboolCntCboolLblsboolNgtvboolEmlDboolIntrboolBckgObjcRGBCRd doub@oGrn doub@oBl doub@oBrdTUntF#RltBld UntF#RltRsltUntF#Pxl@R vectorDataboolPgPsenumPgPsPgPCLeftUntF#RltTop UntF#RltScl UntF#Prc@YcropWhenPrintingboolcropRectBottomlong cropRectLeftlong cropRectRightlong cropRectToplong8BIMHH8BIM&?8BIM x8BIM8BIM 8BIM' 8BIMH/fflff/ff2Z5-8BIMp8BIM@@8BIM8BIM]NThe-binary-chronicesNnullboundsObjcRct1Top longLeftlongBtomlongRghtlongNslicesVlLsObjcslicesliceIDlonggroupIDlongoriginenum ESliceOrigin autoGeneratedTypeenum ESliceTypeImg boundsObjcRct1Top longLeftlongBtomlongRghtlongNurlTEXTnullTEXTMsgeTEXTaltTagTEXTcellTextIsHTMLboolcellTextTEXT horzAlignenumESliceHorzAligndefault vertAlignenumESliceVertAligndefault bgColorTypeenumESliceBGColorTypeNone topOutsetlong leftOutsetlong bottomOutsetlong rightOutsetlong8BIM( ?8BIM8BIM  ~| XICC_PROFILE HLinomntrRGB XYZ  1acspMSFTIEC sRGB-HP cprtP3desclwtptbkptrXYZgXYZ,bXYZ@dmndTpdmddvuedLview$lumimeas $tech0 rTRC< gTRC< bTRC< textCopyright (c) 1998 Hewlett-Packard CompanydescsRGB IEC61966-2.1sRGB IEC61966-2.1XYZ QXYZ XYZ o8XYZ bXYZ $descIEC http://www.iec.chIEC http://www.iec.chdesc.IEC 61966-2.1 Default RGB colour space - sRGB.IEC 61966-2.1 Default RGB colour space - sRGBdesc,Reference Viewing Condition in IEC61966-2.1,Reference Viewing Condition in IEC61966-2.1view_. \XYZ L VPWmeassig CRT curv #(-27;@EJOTY^chmrw| %+28>ELRY`gnu| &/8AKT]gqz !-8COZfr~ -;HUcq~ +:IXgw'7HYj{+=Oat 2FZn  % : O d y  ' = T j " 9 Q i  * C \ u & @ Z t .Id %A^z &Ca~1Om&Ed#Cc'Ij4Vx&IlAe@e Ek*Qw;c*R{Gp@j>i  A l !!H!u!!!"'"U"""# #8#f###$$M$|$$% %8%h%%%&'&W&&&''I'z''( (?(q(())8)k))**5*h**++6+i++,,9,n,,- -A-v--..L.../$/Z///050l0011J1112*2c223 3F3334+4e4455M555676r667$7`7788P8899B999:6:t::;-;k;;<' >`>>?!?a??@#@d@@A)AjAAB0BrBBC:C}CDDGDDEEUEEF"FgFFG5G{GHHKHHIIcIIJ7J}JK KSKKL*LrLMMJMMN%NnNOOIOOP'PqPQQPQQR1R|RSS_SSTBTTU(UuUVV\VVWDWWX/X}XYYiYZZVZZ[E[[\5\\]']x]^^l^__a_``W``aOaabIbbcCccd@dde=eef=ffg=ggh?hhiCiijHjjkOkklWlmm`mnnknooxop+ppq:qqrKrss]sttptu(uuv>vvwVwxxnxy*yyzFz{{c{|!||}A}~~b~#G k͂0WGrׇ;iΉ3dʋ0cʍ1fΏ6n֑?zM _ɖ4 uL$h՛BdҞ@iءG&vVǥ8nRĩ7u\ЭD-u`ֲK³8%yhYѹJº;.! zpg_XQKFAǿ=ȼ:ɹ8ʷ6˶5̵5͵6ζ7ϸ9к<Ѿ?DINU\dlvۀ܊ݖޢ)߯6DScs 2F[p(@Xr4Pm8Ww)Km Adobe_CMAdobed            ~"?   3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TT&$״piΙ jݝ#m`H5R7"}cߥ#vN!;Xm`';R\f|Xrm5$nGwDk44!?H֊9@CE]NOǭ,vkADJ{k7hL;MR'Ye$BHo١2uJI)#i7ԏp3M.vd8CAjJCQ.(hnG6FI$TI%<,\F۩eCUh.a_7s>LU3ԱvִUO?z~n龻"}\}se]@Z朻w[[GF-6- 2>)J eQʴFپ{j.wJk[^Lzczz_YjgQ=Ӄ˽eCku/kMVz,XS>Up[68ۛQuV>ͭuRf< o Onju6o԰sVCq{#5rO\ܗ6N$l{G;מu31"rא_ZS=*XqztYi鹛ѽ3?H1}e揣Oq*:}1el/n0Ĕ]UKca{W#oַ[dR*WY{]vGf]?JZZ\45W"eigj8gxk޴;yqku~='eo{H- 5Mr=t< zu.~=-7u{?-??a\2Qa]c! 2xGSyjDb?Vzsqj X]tn36_P+ƽwUU52Xꭡֵk7ֵ\COU.lI%_TI%8[03Ldcc5[]k}l7Y?Vz>+XXUeIzSjgGHL\9_M5zw5eU]3m{ie{+bVݭ=w {?vq#q>$?N+[r}F-=C3B\w[sW TT~·g}4)X,M=o%sF^=OBCz5/wty[e#sh?jT+I~ӾR9"L?U8ٟTzO֪fUkS}JY=\OMվוּ`/bZUim~{mg޳zm]/Qݕnm]/.ԯNA_ *Q<0D7T㾸^3cZgWMnԯ3?Y}'o_o77;:sne{(Wmj]H}/DŽccCUSIe?99Uh ѓYE1rp2q^C@-V;վu^EꏯP+GwYV}7އrK$8G_G~ꪶk/Wo+Ey}?H޾̻"$.C$KyHI1OTI%)$IJI$RL5.q hԓVt̛=<|.cev1Θ.۵?ԔI$RI$I%)$IOTI%)$IJI$Ss;}'c< 529տd?EWk쎏I e%h4Ss6nغ>8CϜ ,ߵcuQ]Z %C cZ 3~%7~  '-+k>+YeM `C[GnŤI$$I)I$JTI%)$IL-V \}`s1FNAoYC2wM~lЇuZN]./+thFݻcl+r*mQLnl`wwV,l2K} q5v?+;Xs)Yǵlſ!ζRm8/m/[__ëiy2DOYpEu6Sىsqye[GlS.`5w ^׊ "5KWMKl[ɧvVVKs&ouǵ5huj!SNkzL9}? u?~"7/&CJEF{[[Yؽ ^{quW($IJI$STI%)$IM, jy1oZB>adzOk_ӁTכëN+)}.vW_}E 7XZ5 ׁs j㱮sxo%svD2ݍhѕ>vwk}yog[{o\^\-gG?W &ZZzUkqkWv;q~KrC[I$I$TI%)$IJT:t>Ŏ @]FtVc%<eĂƀL( uOP@!L GaL:r's̡II,%^ y^qiѕy J{4]O2׿zjdEmd]]?D Dfy8&ZIUt;ڱz?Mn&6Jo0:atI)I$JRI$TI%)$IJY_Z4Xַ3 ߵj8fHr1/t>J|tdlqm&V]6۶"\[~oekr:}o0= ;m0~S:zu^jw{u%=sS6j`X a;u\dg])hX/ezmi~\f9AkZ^ӡ}߼׵j( 3\_k]nsMv=/QO$N6k/ǺVCK1oܵ)GCϩ8V1v)I$JRI$8BIM!UAdobe PhotoshopAdobe Photoshop CS68BIMhttp://ns.adobe.com/xap/1.0/ B45851E6EC9E130BE35D35FB857AB355 XICC_PROFILE HLinomntrRGB XYZ  1acspMSFTIEC sRGB-HP cprtP3desclwtptbkptrXYZgXYZ,bXYZ@dmndTpdmddvuedLview$lumimeas $tech0 rTRC< gTRC< bTRC< textCopyright (c) 1998 Hewlett-Packard CompanydescsRGB IEC61966-2.1sRGB IEC61966-2.1XYZ QXYZ XYZ o8XYZ bXYZ $descIEC http://www.iec.chIEC http://www.iec.chdesc.IEC 61966-2.1 Default RGB colour space - sRGB.IEC 61966-2.1 Default RGB colour space - sRGBdesc,Reference Viewing Condition in IEC61966-2.1,Reference Viewing Condition in IEC61966-2.1view_. \XYZ L VPWmeassig CRT curv #(-27;@EJOTY^chmrw| %+28>ELRY`gnu| &/8AKT]gqz !-8COZfr~ -;HUcq~ +:IXgw'7HYj{+=Oat 2FZn  % : O d y  ' = T j " 9 Q i  * C \ u & @ Z t .Id %A^z &Ca~1Om&Ed#Cc'Ij4Vx&IlAe@e Ek*Qw;c*R{Gp@j>i  A l !!H!u!!!"'"U"""# #8#f###$$M$|$$% %8%h%%%&'&W&&&''I'z''( (?(q(())8)k))**5*h**++6+i++,,9,n,,- -A-v--..L.../$/Z///050l0011J1112*2c223 3F3334+4e4455M555676r667$7`7788P8899B999:6:t::;-;k;;<' >`>>?!?a??@#@d@@A)AjAAB0BrBBC:C}CDDGDDEEUEEF"FgFFG5G{GHHKHHIIcIIJ7J}JK KSKKL*LrLMMJMMN%NnNOOIOOP'PqPQQPQQR1R|RSS_SSTBTTU(UuUVV\VVWDWWX/X}XYYiYZZVZZ[E[[\5\\]']x]^^l^__a_``W``aOaabIbbcCccd@dde=eef=ffg=ggh?hhiCiijHjjkOkklWlmm`mnnknooxop+ppq:qqrKrss]sttptu(uuv>vvwVwxxnxy*yyzFz{{c{|!||}A}~~b~#G k͂0WGrׇ;iΉ3dʋ0cʍ1fΏ6n֑?zM _ɖ4 uL$h՛BdҞ@iءG&vVǥ8nRĩ7u\ЭD-u`ֲK³8%yhYѹJº;.! zpg_XQKFAǿ=ȼ:ɹ8ʷ6˶5̵5͵6ζ7ϸ9к<Ѿ?DINU\dlvۀ܊ݖޢ)߯6DScs 2F[p(@Xr4Pm8Ww)KmAdobed         NJ  s!1AQa"q2B#R3b$r%C4Scs5D'6Tdt& EFVU(eufv7GWgw8HXhx)9IYiy*:JZjzm!1AQa"q2#BRbr3$4CS%cs5DT &6E'dtU7()󄔤euFVfvGWgw8HXhx9IYiy*:JZjz ?N*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثV#1 4TU,~^P/rMqƣ*SnZ9*,إUVUEOlUBO0H-O$?ZbiY<3>*/R5VI T"}4UU;m帙 45 4=*]sJm6=IgRcR4wIs=^́p(~v5qT=ܭ ܪquON-Vw?kR_3hh.$riDUU,Aìq"-WIȋBhVJ6~,Umavш,4r5FAh(G~X1 W+8+dtXTRTv*suok\8]A@MIبI"s4J$v<1TKv(ց4$9bþyKg#Ħ) V2(t4e䑲}Tv*m4NR6ux.抡P3O*Uy#KHGE ДQ*[.X`&"F'e -?lUk\w&!È9H + Uͮ.-ĀKh+T#E=V쯭ًYyG *<W]m2u;1GTe 'X`D@[7mq(V4-lS`VTTwq4WsT3g5f cV>=Zf&u;C4rBI 1ZV[kze3w"b'N?[6*oLh%B+v2dI":qUukD׷Ee yO|U "Ҿ.Uك4v%bܒ28qW'f/*B&xЙMF'}U%wٴ3G4JcDL6n_⩟Ն05բ'Hq/qV?i%Ռ$ZSR[r(l2@~+qY*U'/zw/H[z U{ m`jpWkzNv'?LR60E+<_Sfbv*HtA !9}AB@+QKQ̋=LT1*d}27"?o=?yoХ~=Oxb&P~zY~=kU C|֫-}K-yUAY[E-+[#j}*}_w}_BONyp4qToOO犻GTmG[6wCO%G+,[Y6*U!/z$TW lU-7r%Ɲt/4*3FiKqoS*7~ѧIVzWֿk<:Î*s_ݐ=[xdA"I^ER=ogZki-\WePvbl,խ{8EhPP^ JE)QO`b- S|:C mefI(Cr##ETmG[6wCכIpVXcqZ l+I(O/OV^ a(@h)4LUhV:.lch3,0NaBS}GQ0LUj֫m )ڎ[,ڔpy[pyK"+BaN)SLUq$ӮQJGC^#Vb_[[s=FoZee0ci[oQyG ߗ #]R[تmv*UثN*UثWb"^-SJLqUiQ t^cəBzrFlm):ǒ:#bKHc12ʲ$SڕJتż76̼9UXPB\ZUͥdq_F⫮]:S,ѷ7P :,6Q _*goq%1#֜" W#F*>G$MŮ>J"7Әe`8pzdK8Y$FBHwlUmahb0X@nZ0BUPhh_LG\8hK1v,<ѯ\UP${VU;[{(z I H2<$c df2l9b:Ns}m}4<9}^Z+c 7,Uتf<1Wbk:PAtWYj , I^hyWY$ByɯUmZγAW@DA# HR*j.MKsqz;Dg劫ekH"'ANG*ՍONK,|,jx'쏇DbP6&m: %]9GzqVYZ1iw MxJU}jD-Yᄫ#vHN6bqW\heO,$iT;r&HՄrRekܷQ%z:6qU;m*K8bm)rrb?y *8"^1D#ZEQ@*w銬N5yuvTqT#yM3:IpލAr+SP*BIc5'oQ=Kyj>jATmtKYD=e %īCD2vTqT5ևL--=eY$DX$mbhuH%G謐4'ӯ.?tڸD-1dh3}+ *ߵ|Xidnr;3;RܳX⨌UتVV]OuR{g<`ؚ r=1U .fYhcIbXX#LTbǣؤI-Yie*/5}U~m߯pJR\J^ثvvS piܚP>t)gMDeԓ^b^zኢ (7Nd,&QPgZ?eX۴s"9^H|*&%d5FiEp($g2&تigSR ;5:ry 9j*]v*UN*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*Uث?>8ZMK%Ēί*dHEsqx%#? &-:c%ᵙRRduU$FͿ+gC4 XEUwc<6͗6? >d:y hd[+eEg *KOª 9 (8c䑻էX9e%+?×Iy⿢Uk? 6~Ty!u=u Fař>(eTͦg'ɉ ~e jזt%O ɖ'vSVmB|o\y :Ls4۴^Aj)\ҭoy5<Y3桛Wb]v*U%󥶧wmFL/R/X ;Jw1 Py1o2y&Bsm2_i]̶Oj`fGdfPxz|?4A>;xx_A!?-|{zyyWUseQ?6ɓg81><(X"Ͷw͟.ieuDK3z.=N3!Ŋ2OC7b]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWN*UثWb]v*UثWba]z% uH6f O4Gϋ 9JBr'?u5+?77ʬXVe;cdZ/4h0 }:OKPQ"RD%8~<~u݉2d8kTy9vh3;1j z˓<&b?JJR[cJs0aun13@U)?43鍦kviwjǒdqtu#{˰j'\P<%[̇אתou#._Wa?ʟf窨}L|0+C˾VӿGVIgnO) ՞FGj5:NL,(KWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*N*UثWb]v*UثWb?:?4|?z)@h{%ͅfn?wPSfgo79|9-m\C.a,6rzڬju$5}:?gY:9r|ٯ况]aZ "5>^4>o5}~~?cot.I-t6vq0D;" 9dg#)}Rov*ӺrTUXKk_ʰE ,fVhF.fGpKz ʳ .]]Ysw4vR+E3J124I<'yC"0M9+2kQ\>. b$Ad%l\hҼ7BZԎ`}7ggɼa/?Gԝy C%l#R?^0˴}{D֭_62[H|xc9p$UثW$gVdh(O̲H>i6vegH2 'N|?O֕>Fg(#'?5J-.n_[%ocs661rHdyb]_kZ8RvEN}epO!"iwãyJUѮ~B92ԩ*u 8Q6V4|ɬj /@ |5_˳HQ/g 2^r&[yj4SP.$xG Ewx~5]OU{J[۹>HڬNپǎ0>yMO_jr{ɞF}67̪ޞSDG[`vxw'&}rK1JX#)FvI_\:i>+b-Kqm>&okIȇز'9hD@l;JҿJJ`i2Ɗ\ ͷ/7ii81!0Pjw`xzY16?&6O]Rjm#xpWY*5s _bgsWæ}_ %tz>z6p:^4 XHUO,9JFMlο_:qo[2K3+ k7Xpc16e0I/>\i_Q:g)Z}_[afn]v*UثWb]N*UثWb]v*UثWb:iybG\'Z.l'6,^ lhQO}kn)T泶IYŔ9Ώc:7Y-p~SDu#R G?zmM,i a+<1vc.1?WyλgHhRxl~Lc-3Նo'Zy;#BUԂ #61z "$moHpƬis_3M\Ywf&C)BV\ ]NFr/?QQmӌ,c_>WV[s.RXrwS^+^]Nnԃ|i}=u,Z}ڙl.IJ#i#OV';^׍L.e-201dgڶ?ԟǛ!h~\YAL즶ӢQ'J:rJ7fV4KF"y5ud[GS@M<(~%IxqGi"e!^{{8g!#_g1y}%h^Qa4un(=I$Չ??esεZ癔u{>PJMObQ K͏&E<_i6ŏ#V*׃r;D<{/ާ<z {` Qi?A0pu3>qη^SՌ}"Y:HǺƏ?NfcGgv.K31$I';)/&Q2W2A̼=M=9VM41;w+>+gW ǜOKVGJ{cJMwQ?IޚG?C,[;|â}veS=ưNc@FQ?QIJol BbS B/j:u}=-oyj8+;N3MĴjcmSzlk;[aɿg9|is#*QV5PݷЗ犷 ϫ懴Yx<[<0aRY6`5t<EQfhq|?Qᗼy :tAJ]K(dJSS9OQ>)|?':giwzez<HM=10dzFiNAOZ:2LrqKr{_μ-<ߨh7-T 9%?s /lPU柘@Aӷah`Fa;ł1<שǑ_ o&wucX svH2+ >#l?ߎvƳC6Pz^jYv*UثWb]v*UثN*UثWb]v*UثWb9?>bƋ_4K ̓?_mqeosov*մ [L5WqS OIBBQQRc~Z>iԴ)&Hzd\6(qȢBגHD^2A4ך?o5ݧD~FT_i+(e!T8WYFMk#'#/1jd_?0mkLq?\ܦΏϮk:֦Es ֱ]wcVyːUhCk&uLEܥC'ILy:rXɅ&0NNo3_sIp8b$I4rN*/;@y~Zң JôqQsolw#ÏXCoKQmGGOccXXɥn'&|yCCǎ{OqfTyO.OR"Uzɸp?츿Q(͛~B~mh\$Y,fpM_,TDge'7fc6;h\}g۝v*Ŀ5h˧VLd,>!鞆*_Qg? =Lr)yh=/ש&?(<3yrrR.ng!?15/X?cMs SXywQFTa"#i;cWf }dfWb]v*UثWb]N*UثWb]v*UثWb6ߟ_J?M?zfxUǗ6#zsAlwP'86b_.T+Ltf<}˝̏ކ-b?$пVg?Yjf|[ɜf?+u /$|GgEk:Es ֱ]wcVyːUhCk&uL yP9#㑏^d~|9z\3ы_6泶?guP;8&b?*-?0Mv^p'7fc6;h\}g۝v*Uw_z1' +:t9%(GO4+ &kVZio9H󓒈ȫ+u kCO_۝K#|뚙٧b3]?)7y.CWW/kɣ''̙׵2u/=/?M'o- ٢\<|Vgj}+T6R[a8Q\v>!=Lo}_X;ƄȓE<<bBz[&Fck8f%#!2b{7SY_򦔺pmEQ&G@g\0&DO,yLt,i+Os"x**%OcvvL1 5IY Eyc:[Et88$EN9.&rDғO6_]yb^q 彍CS/Oew ^mNCW۠/VHKP4Q?e?sypO`ȓkX5=jp,/Xqe!Sż{9?7Ÿdaic}szPA;7&{Z wc2\B[uTl6!'(/FwoZ&o;՚>A U3fM8t9=Y?8|K[.Zl1êL NS5J6ffl3?K> =rOd4umAŝc,Yۏ9VX0'F͓iE_&y Z7H.%%uSOi|&#&9Rikq4g+o(q"IȆ2EFjHfv*Ui6Ƒ{^/+[dw"${ba!!'H|iWZF{]763o(9FIiQ !C,w9izG+VlM_KYDY}( b]v*UثWb]v*UثN*UثWb]v*Uث4o;hjOs=*Hn"ӋVY=l/\zڐo/56?Qy?U/o'K-|0V{[>??t>R_ (K8_KWSÙTkfGt?я -UT9uL,eaߍ땱>ˤoؾ>qKKOxbI&W/h?/&8[bXM~k"ҹ2P4CѭX[C-H<@~y˚y ș2ثהAjsVDDh 漤n6:>˧8h/SR4gQ-q4̃ڏGTk= cU qȍ_S?W(?0"mI5CD䇴|u!s#g;XKkgTp(ݕ8~kjȋaQ2Yp?T\G+ *Ư ]7U qɅ^U8G*MY"\uHM!'OV[5^FoyX4:Ćm맧$½_SbQ3~YOjǷJBaJz?7U qɆޯ{Qo%H;obxU'0$M4jNi"3#X9zڜ^T-᳙ "UߊI])Bk($: GrWa8`5 j{us:Gc#jZeL}$&uezVj5].qS!P C7qDԼv4{ؼ֌홎RO4T\vx1f qSέqUcFPă62 m^k+$7UR֊: "!Ww/hQ6F4~\WMsFnϒ9@B<5/ڃP8dx[E?G|ү_BaJzuL˺^?,H+Uy?-ͨM~b"_ZLғl`Wb]Nm,?1ݗi@K"k˞viI䡪PJ5Fl-/mL#;Yll3v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UثWb]hqDv4 *I>h+Xo󙘆q?7==:ڀZE4ے4ZOW-,Z~(45 (@ n]]v*UثWb]v*UثWbN*UثWb]v*UثW=R;;l:oÝ9S% _O+C@ta:*y?.|xe?9o,&JwQK-C3[!+^8bhﺼqu|-kSVbc"ᗊ?|s|# q02ҳv*UثWb]v*UثWb]v*UثWb]v*Uy?AZMG]-W.nIe?N?gd/?yuhoQFOb'>١fUثWb]v*UثWb]v*N*UثWb]v*UتQo(:}ԖD Mr\Qy0sh,A}O^6]Y9=[4hљYJb74oGrޛ}AbYcۏDjKoKu^.WL%+yU=~iZ[ $t,r%y0edtxj"qTݛVuyv׷hǑ;NQ~.kr&1dy<|tW˚Mһ J*'deY?wYY~f6M,R8=_lA$2y|ߪk~t;d"I5U1vHS!M,8|i=Ħ }SW:eS3Ewޡ%FHa1x4<|6ipc@ף?I!G#qu,EY\0 CK$^1#m'KCŒ3$OLb_/>hm.OO^C6Ja$'r'|d8^B;]bT򽶱][ܹUVB7d ba3ˆ\?elg{aFkwK HHbZ6fvC_DM4S\֡Gy-˛x{ArNebi8>|WIpXd FQqO\K)j6~pNSH?1)oL_LJCX0X8T9Y"Oɩ/]-ݓ*f4[/-z]㴸-BFD}`M*>Q rà ǒ9x|Nc)oK9$[O_ >PfvO7'F@׿av/?q$ϓ+?#0Sъ?f"rI.">_Α]=OL23C\=~<\\|].)G?2Ģ;\_O_VtDGd&bX'+*aYC1FRYJ14ʽ.I XkZeMKB!jƹv'/c%Fe̟/esɱdk2L/B^q6REoD5k"Tt4`w9f<$KvnO엘"_{[SU~_S̬l,-c(!Eʪ9&&5YCW1wmu&.~.c >pw3Ao-ռk@.a!4HB @͕y0XR-g cD]%VOUb}oW2qx<<<_ǐs浏F k;qidXjF&ol#/яHc˺&!w-n`D7NQȤ:*ǚpV)V۟^Գ]A5(_yɨcPXzV>b򟘯-*wpnC,h<. DFu1[ZG5& #S{>i BUyly14$>OCV^F햆]CB"[i z EOq$xx<<2ZRs%΋m5iTӓr񴆟>.QS QGUb(E!rxZ6jpf8c/O~Jb ak]JJ[;+FugFfNe~sVU-D!"x?c%g_tLv0_4ӍBrS0i+2VvidžF>)8BU6垴?do*dqKm_b2܄kV1UϥD~CSyȧb 1WO~ayϦG\Ogu~UH銻v*UثWb]v*UثWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثW$'|9mG49Ğ]䬳nb0Sߓ&*(䓉Q@ݶ?F*6~h+O}TB򾧪Z@ұہU䯘f=])0ynD􅷤JEk]1TkI,G߮M324UtK-<(eb-uJ>L®;bF*{P(*kS5[G[pŨYCx$"EԵ-A׸^WyV]>oJP!TuHfJ@?U7R}/T-z'22է%>WWb]v*UثWb]v*UثWb]v*UثWb]v*UثWbN*UثWb]v*UثWb]v*UثWb]v*UثWƿjӵ̑cfE템_w2HElUQ€cO|k{QK+aVoUN*KHe5#3{@{mvqU9.95w?~KBN!LUYG@c Wyw#"'Zj*# oGxf;BZNthB?(yʾ{Ӽ-VmPg;(zۉS1WxWb]v*UثWb]v*UثWb]v*UثWb]v*UثWbN*UثWb]v*UثWb]v*UثWb]v*UثWpX~m-= /^j{Y迳tRiV/}Mwuv )zbU;/R1O׻pe;?s Z}1(dA\YElԍƽB⨸bBQqV=2]RȱV?6zv*yyUMeK?{zMs3H"oImU\'㗏1WO 9*#8UثWb]v*UثWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثWb%PE%ǫU~Wy^o k~\@ӯ>I1ut^A+U<劲mV]>йe^ CUyOEU }6"ej$l%?S[RƧ[\Uv*Uث g#mũ$*JJm>U*E*O֏>YkU`AUf=4 uaN*c`7֮\ekSFϱ*!Zvߵ)\c tUZȱsi1WZ7%F*|=H"%y#Փ-*=`4meȋ H|s;.*tу#j;[]v*UثWb]v*UثWb]v*UثWb]v*UثN*UثWb]v*UثWb]v*UثWbv?湙"ˑ^=KbnoZWT78@#ԑI6*g}qNaD Tee=*iQV YF<$nNzSPJBӯm1T5Vt튾z_0~iZ_n?sW:dORh?ҡATWh^kֿFȬ^̟m.*]v*UثWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثV쟖*u_5,bBnnFޔdPKc>hnF*gqRⲳ%f$Ҧo`oAE⬓J5nQ O*l// [ID6ƛ> qTwݩU_P,tY.#rycEf bh'Z7/gc yFf_Q~bƲkKcm17^\UMPf ܑXN۳Џ;'.*ȼhaNl0*LJD)޷3[bCuhE uo>ޤ[iIO^o]Dթت!|jaTLmHT(튫r~xQ]WZ|l(qW ䷄Los; K _b S3,:͛T-}[8I ɏp.~'*yu=S E) [bգ,16C}5/繰ӭQlU :mܲBY[3#O}Fr1UyYS4SzbAyŭ%ο # ⬿\[ٝ{I1=Zrط 4_nK#yQ~*m+::\U4]v*UثWb]v*UثWb]v*UثWb_N*UثWb]v*UثWb]v*UثV0_OmRO/q*:3X|Q#ġhI0ͿZ]Vmu8)_q=>\oe>PgKY-FCTJ$n4:⇠2m9Ձ$±+ѽswt,K3_Y'v :vvs\U'sUMGLU~vrP}s(EI*o*} i+E rd)q2/J&SN*ke[#*(̂$>OO;). v$+RZ0ҋ7Gz6xʁh*!=j{Oġ5ZX[ast%aŸE76><7_*C*~j7-AeLioLlt+7ت}:im2)qaonh~վ(QqU[.Xu74K$eqhVEJ2jWY;5?Pm?nvtJCアK숮~{R,i,L9du )Uv*UثWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*Uث`Rmfx1_84OFSb!wھ8%JtTJ~#R0@?׊w*M67d:)|8μUy{>`qAq:9ѣܡ|UyZ=Z񯡶6UIPF~=&xoX#[cwnFJțYF*ƵW&WJUfsP:Yʎ*j7vGa`QV_ <~xkPq]$ԛ|l8r/bl5Ӣ$zE5+&ziqUa 5d@I/5%YLĬ$q>?z6k{4V-]tdjtXߜ<4WEgC{biSwz~'WrIe>i4+Qg2 ȪX> |1BiZmzˬi+cITn7eJR=(.ulHZ*[7UDwhK0KqOjs娖AHi)4ؙo5'qV îEc+C^j-pWullvZuKwufXʻuc M?IN4sJ-/RrbO{ dO+w {jiҞ%? CRqUl:c Wکi[ X.mdJ'b[woRBu+Jg J[z^obn]v*UثWb]v*UثWb]v*UثWN*UثWb]v*UثWb]v*Ur;XvڵTd IS]g3Xk]SO~5r U }_"(%GIqTqIQxWF* @*:nz֞>=1UZ%ޢ8*銳>8֔;U~c^B-t4q}k$s XI7̒:!W ,%[K]a*^mm2~8TϦ]qed努y#N{ve-ZQǧZ(vWM+zB4 7#ŊT^!FB()lP,cHHPw?oj];{m-[w}~IR3ڶSѲ0 mc$t%䶵klUui{m-K&TI.nI_Mg"ƛYFRVIذ_U N% R$}ث}k;_5 1D¶?-I3\8^g*)_88yB&lcǵOӊ6z>n|mO¿v*?'$m"ztm]KH}^CyVuRյ F[9ftJGD^gx/Պ3ėiM{yRk[?`QzMC04c7'PskTzvW=N7Sj~;A+݌#!7Q}f6f r'noݫU|P$6!1U3i$z+A{nM{M{c%D:)BekVO^4Jjxj IXJ}J7-Jg$zKU-tr?%z/1jRT &.?\UzY:WrQQxt;0Q:ڢ@-eueb=+ UV?^)5ҊuIסSAN=as<;׵טC*!M>+֏.~CAj,M\9Z^[Fv?HMhx`g v܏Dˊ`4[[H̱{6T ~la۷u+w}+6*"Gz` qEO+X*3~Ү4h¦苕?ﯬ*A]v*UثWb]v*UثWb]v*UثN*UثWb]v*UثWb]v*UتKJt}WRҘ,sTQ*zby V|qT4:l9$ƒ`ߙVT$MĮ#^)*B/E^Aky^XζIԼ0t,^@y)$9~W>*Fֻv3'4rߵ7gh-OJY_roXf }Bܿ{#ӁIԥU$Ks\U~dLoo0}Wː6۔څ첾l; Λ&81}@HjRkqgr-qT Ip sAKy? uU+vi#PG6cAӗi:z}Yܱ+im0 +uϲˬ l{xa? ;}WˮWwl[^mN?ЭSbrH-ZMY6`OZuˉTx[ct e'tR?N*%a[Y%}M5Sax*;ǣXs_MC4sCѰhPáV_v*UثWb]v*UثWb]v*UثN*UثWb]v*UثWb]v*UثT$4T-TwԳ#eW`l*Tf|UUu:/e{{hFbIn-a_ٵvUӪɣaj(roEԶ/g?Q^HI'ߚkb[˗PSWQp[֢CnoU0#V#u1. &3.{7*ӮQçR s߷<PQlPZgNջM{wo'SSg1U>_<jc,P˨yZ"/hֽnN*hmtԝ+}|r[ifUplWWX'PI7qm_TL!n/+%*ոjm4mvk7 Uٝn4DQΒjP?bLjz9,/.?[WSeeV"|4chn#цi( )c'RnثYKfՊ/.tEuzb:}9VR-P9,)n/4 Xd1,QF bGev?̅ld?g:\w2-^Ӹoun8 >(B? :YX]Ȳy[/p6W1w+ _eY6*UثWb]v*UثWb]v*UثWbN*UثWb]v*UثWb]v*UثT#)Y$8tV4 ߊK?WvC%Crfbz(|jc̞_i&m$\OE?,U,!]P,𡧧 <{M=?⩏픰\ T4lB@{ XӼ ۱ՒP bHWL1;qT=;[K~[5ԟ=Y%*͢0"\@GJS 8bW e=]k&*x7fk\\UOC-%ȚKvWMP&OS=fY1U'R+G,>)'o )!xز2bJAzZaٟ#DkS[)؝RVXNW&<801 cFg}&V;\F&bm=4BKn=F*j[@ 6y}ݾ.*~/p"'B|Pw-Tn?[ѣ<.n光Lb [7stOi0zx2+J5ERUy4Fn22V^4`@raG=i\mqT&3muύ 5K*,`ki 5< n$C PZOCJت$!W:v֣dU($UԕH QQ^6zbӴWTZwn阪WEנ)l&HV HSлo$^{hVW>QY]fVTM)g ON蓜W\U[j"V)-PFRk]GLD_7vښ".#Ti"kUvp#i`Ѣ,IKtlU/V59e13Gmxbƍ,z7 2oۈ.".U1Zs̋"|WU]v*UثWb]v*UثWb]v*N*UثWb]v*UثWb]v*UثWb;FrOxGT&q5JS6XO-ZMRXW/ceB'^^⯙/R!%fm!dS|[动ջef 7nq\:iQʵ;5CRӛգO0]7\UGMUKkOU V2 -?Oy}kUH5dtv6VkjiBu+ڒg:{;nELт MsuVȈH_Ot!.4r)O߹_8[\,X}gt^9{y)bQyZU$Uw;"vroE~^]Er3F<#soK%Tykyǜ1-VXvӚ]<k{ٕOqW66[e' #?mjO&ѷت)"tQ x⨛yip8ڻտgH˧j/8.9n3oqAug#$BI-,XcYN*UثWb]v*UثWb]v*UثWN*UثWb]v*UثWb]v*UثT>0bh"޿8ҁcoM1VA@* ;vXe\UfUߗ[nK\@@y$6>?qY,3vC7 eki5.m=fQHO8XObڲ4 <##OZI/5?*?$%@фm],U._X(nԨqﱿ[IH]4zmfS+t+Π}zPjڄ_ePvMZ*{ gjixA{kzC?8MaZG}I=K4=¡Rٶ.,4čɾךR>|U63 ?ޖQ勆IfMq5{|Wڌ] v6rü*%ZKS6o!n/oQ/?RV_#.kuE2]V:PŊii`*;OhqUkxg"7zXT9$ yBBE *zm6)YOI>߹xPc\HfH~,:qo/*p.L"Ͷk)`(~V*[fͤC=S+ƪس,IY1bTn;UVE, WRtXR3۩y4*rrc[X]$Y[G+"*v?g_:E3"}MHeiV^v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثTO88GRLU$D]ȡ/c:SrV1|XCYDKk'25?O!~/S>=vqU+HP"1TY@ BR;4O-?bd.Tq3l>ghc˩b&Ju#`?hqWξdLɴsܻ-;|)ty#/8Va乍3925Ѷ=kX]wU<6zoj5 ?].?Zܟ ?#HǍ.RQHWBnVqO檒Rܶ|3犪~B[[L5}TqTmunaXVHRp_{R9o^ ME:aPGъ]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثTB]1z!>ЃJxb1+^Ku$%I8/ȍYn'H! Ŭ1c*ُ)",ꋨyv[KxͽYe(RIZ{sok'/䘪*R H&I9 0I 3fpea,}[L-KXڀIc'[ah"oێ0vp犣v6֋|Io]OSUh! P (XC;MfҖ{y$"h)UZxq,݆0\wKxOnm@-[OJ40<C 5~6eW[k(X-۸tnz {b9an(ɈR5ۥ#|K[Oy.1T[5kRKgKK!$ ⫭0 \{l~*֍356jWYH*\$QYI>?۟1Wi \P;Rk?UtG/FŏNiwW'uR-&11)DrhB6P7Bm$2)g[i$a oڲ1TOuui"0[@Cs"?!!o|˧KDx> wG\U^OEE{~-{sZr.\Uڼfȣ >/eyKAG:M̰7z͞fE*f*zv(1T ,b'zx-_홱W_L%3\LcjۙA"kWGB {1B7Q54jzrɹݞ:[ۭzUnh,cFT<ޢ "$nƹkmQ2qBjVCj:XTѤdtÄwPkYtHI1W[ײVH"0ЎNMGSb{[F6Zv=lURXn-U'?z}>HHB~,+?ض*26.xpk=cy@w,yr;b =ѕdvxWo/O=*s^=Ii+}^CQ6T*Ͽ/=es5/f/qVsRkNB[$oۛG8&q*%0 iNJkg%ycF|?das_R'_HXN'(a`~ҭ~U>FlqU@E(6P y7IkxZFe.$|}"(fxfY\qT{Qw+R'.50'3V}[Ѵt^op-[1+Đ\eFʜӏ}ecU^t4iR5x#:qH7֮i6*fKb*%ma04?Xy-$aіS_bqTZQԎ:5X&=wmޛl@vdzk?b[}dYB62'%\P}\f&ޛukhO╶Y-֦}VaҮ*ôVSqok,;dƥƎt$',[GWmL6tc$j1ml~.&1ԝНʛYw8nA#z} 8>V+[t@S]@)z:U*Q)#oQ>+ PkRBvTI!zlCJa\,iⵉ`I Z}5;2xG_M?*4-y;/=Fyf_/qW~|iȚq7o(_Guϊ׮KIUSlUv #Gn> aZyCSNoM4Y/df L6ڿT2*j,hm9J@{RYqT ΠSR[Ɨ :XP\UqMo<" m-<@ZBm_J⬳z.=+YOx#aq,2*&œ("^يv*UثWb]v*UثWb]v*N*UثWb]v*UثWb]v*UثWb>ӐḌU=R譶b38>CISWwACCXTv b12rhMF) A(U"ΩO+y N)wy KQ_FoR(Դ<ɧX$-ȁ@(zbk˱ eiC7v+Ul+^Gnl6Ci[wv%nO=>qSy(q4VIѼ^-?,p?^İݥO1^*\"U wWd3mJƊ(~*Zq6k[m,zNL:}7^to8%rzOKw~bVUB!4iK#bn8jav?UR K!8 ?`X)"nkK1_bj"FmK<*q޾QT{my}buӒm dLUmKo,ToMXԧ_1 R,B4D^EGJ GF.*6 !n%;/oZ"(K?:V',.4EM=HрݤX&3ppǁ(>* q#VDI1(܃~늲 ĠG/02> IKo"ኧYniY+HӛkbO  x~?8MVmz^uP֕^S![j3ƿ'⯣qWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثWbۅM%Ġ|?ajlU$ 銨IV'~!Cr7wpXD qH>-*x`+<'_R,UP\VK){y-:;Ae֩iy4xK~i=?Kf-,w_7ڣזyU⪒e eҮA&g0 "W($|Ws[2A T)~*,y-FэhXۼkھmfpth:Ԛ^/'= kө&"1TNoj% jֶ,U iVW {0b2:9_%fܲƘŧ tUjW3*K`گK]ݶ%*+k7 ~[mY^gSD,BOn+C_i:Ahu+Ů/o6 8DFF+bxYTwCNH#GqmKsE %F\Zay~Ti,$*K!YXw/)$,ڬ)qUe[dݶ6*| (­5h)sUir\ Z1F~GXYlHv;R^^Db4,riEG#vi*KD(ǧ}౺n*manTkhc=CV= k {Z-2t** ]]4M0 ,:ю]fI?s5.!VC;TkӋ)o9f 59>µduStFr,.ik* %-'uEmW^xZ>C@kȿYI*`8Ԥ5*$׺W⬷v*UثWb]v*UثWb]v*UثN*UثWb]v*UثWb]v*UثWbRG'wezʵG?6BqWY[˖nMI0?5[SLUثT< s(>{/CKxىZQnzvQE(9Qv1MOb?lU :wF4uy=Xq_w?ݱTR4m9'rOF' m I`,7ܲIj\Rn ޛ8W1 5H7R6 -ɼU,Dohy/yRy9% D1ﮉ߷"*F64}9lUhmq%LQYiQgIP=>Aa)[(U[TȚcbR%_sXx\ȠgᆧyY6*F=}arz! FXncTlE>Wvl_@Aͧ:3 gzVjTP 髱FYVU@AE@b>*Isdܨ+;c O䖄U#5U ѦޡICb$^?*[ZۋM*t+^)8\+LUtט1(kaGXrW1ZKJ+YZ AUWԍݡ'?FVԄ-BߕmWqT=B4~І+fj7ɼUV;Tʕոf?D3bn&K߬kPbhlEȎ Z7>G1MZc銢-cyjA훥wتIRm1Kq* VIV1Z _/v/xxI2eRA1oWvP#EZ<gV*յPAQ]=b$X bn^MOa\U@Fl+;eQ6%\8st:@;Q&<b`Ԙnt:tت=\Jg۴5Į(fb3^eӕar]iF⨭BI. Hn*HBzL4KSz4īb!˥E>G(Ed>9$JQ2 U$U~tWG5581cڣ*Ij~[_0c9JϬ2h#n$ %Q31+> miUIIFUbEtVj,OuJMBux]GkJ>6>U{IK}e/_8"A5?JĊbv]AߗGp]KbCPVѠ";qBȮ)":G~J⪪( CSO һ-k*bMM(Qz?6)ygtêG"wJ?⸏𩊾cS1T4 \拸>j_bA]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*Uث?=I9i\HcvH|U,"y$SY.X ,Bc$Y3pIҴ$⭥]%nc]8FdVI6;`Q>Bgjc㐑—vwv 3:|PC@kVwxOLUUfIn i\uK co$v⮾21}ZdԮg>qTlʺYJu![Ԟvsv &vኬ:NJrn'SUثWb]v*UثWb]v*UثWb_N*UثWb]v*UثWb]v*UثWb]v*Uث?ڧaʍA%X$*ǸX|n'ۚP-mꍀFeš'hnI Yx O&NYidlPŷ1ǺPnªb+Jj:Ү~R$M:5n3=Pކ~Sbި^d Ӗ*V5\Z7?ZޯR[N9hIK#SּV$@FƗ5R'mZ' HjquɊPRii10\wǤ'Z}9PѶ(d߭JoM A]r݉ݸݸzJAk9bUvXC=-&#V Al&J ]cRUt-]_\j`ѡ#1TSodʁHn2UE;SNˊ lĘԈ#BhLeWz\fKxX% -4!DjBj3qi1U"X^jҏnz+*1Wb]v*UثWb]v*UثWb]v*N*UثWb]v*UثWb]v*UثWb]v*Uث?io 2lbee?ݖsyΛV 8*0b gxм㐊!xHŊe^ ?/ cVE Iw !D$+Ə(.L۪Ziu(Z e5ܽ+-PZnx֠, $*V}B $z=$"m{Fg,W,My(܆>_S}%y4K"ƍITC+Gr<*w0̿qTXu5@]X0]MyH[1y'v;⨜UثWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثWb]v*Uث?! /v.EҞ늼g a*JդoɿqB<:s3}mOO'*EG2QJj1TN GmQ5S_c%sqZ҇/ЈZ_Nm4ZǷy[U5 {Qd,.A-kfYo>{ T㊫@~]gſWVjHf1^JPVQ>ت[J.Ĉ-?ZQN-əZb'&z廌qe=7:6bm z1Xz &EO;إMĖRagq'^4lPI:rV 2jEZ8,)hm^9X$PP=7|*#]d[NHIPM_c- .)CN [D*?ӤO"b42Y,jZ GZqa@ݤ֥IrO4C4Nsn>'Q6-_F{Awí#.øYhE%zׯ)>*EMWb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*Uث=&y#_J?$a FD.V?8Jִ8ULw<O6~劦:enf9TWK)4uAoت6fh 3b8kX8˩U;f@[,>NET,V0W:Iƕ5|8 U1%/kcK1=Z^@~𸪌ܘPk닖ϧ<hS-n{_gC?wݷkP֯(//$UZaAP~vf, U]*xzԵKk"9G$G*Wb]v*UثWb]v*UثWb]v*UN*UثWb]v*UثWb]v*UثWb]v*UثϤV(X, ӚJ1S6<?U1Po-e9s^fKL4icР$'sdٱKF\PPs{_J]w{LUe2w2Q흝T©"K#W ?.IqT[E(zvѸbӭ}YJ,%[71#ҦӕBԆ]B):u踫'EO/TP/oaZPVr,ߧO\.y, =mnklݿtVՙi{)AZiQjQVVZp81ZUDf ֖vCt֒ pyJ-eQv]Crս~'}Vj:[nZOȁ-/\Vgcfe!D((^Pz\Uk*ER=&sZ+R?\}DQSݿ\Ub]v*UثWb]v*UثWb]v*UثWN*UثWb]v*UثWb]v*UثWb]v*Uث!X<{Yc kȒÈ/b$suHvbO(Gi []HG[N*&P9:YO +Kؾ)F wQ+N'=Rh?|A S"H2$uR?eSc&Boe+IO䘮*QxߠјJVXwFif=CA-H%u[wlU ehɧY/#Zڨ$c nDRGk Iҧj=+:o:2Mz-=]G4=uJoZm&]Tqq,V~aP15EVZd|JbŵEKz jm_Xib~w:{Urp}>k7t5WTaS]Mvɿ\UGTvkJVb$$~֝<1V-yhYm &'*|écBDq% ܀Hx&O9/$ .SS5t{kwt0KO#/QğX>;k}&lUr޳BX]܊xtVKtb(oSKJؓ!UWb]v*UثWb]v*UثWb]v*UثN*UثWb]v*UثWb]v*UثWb]v*Uث91tx4`׸*hFSD\m?DEWK)?a2PΠ΋^[H+?/ŸM3]е٤uOQq%Qn/.8d}aԆPyWSkE6ؒD#wvMxKذ\[j#iqT,Hz𴸆?6zv{c4>qh{(.x[JSKu5w?] UKH4@"ӫ{!gU ?G 3hRQUuh̿oڷSتY pkj)*阬p܉S\J5[}5buݡJ.s:<96*tk}'K[r!B(e+?k{//_gHTX*91٦=F>/^J52IPgSIx.m%nRYf^1//WyͿ^K]QWO҃.7xYI?^)edXۈS,cP=mFX6/͟6,f#Y#Ho0h\Uk7hmq= ]?懜nn8VZ!UTn<+G`[8Z>WŊk3s!4 !$O+UUqVa8h:~ʷfh$+sUw1xc,z.tB4(b&Zpm4;E/sz恘);q?ib3>dht . soD(\W^Xտ<٪˞`qX)=Fz"xa]v*UثWb]v*UثWb]v*UثWb_N*UثWb]v*UثWb]v*UثWb]v*Uث/(M-O\K_*=9X@2Ҿ4*8tcVwwEPv?{ILڋ" Z~biiwZ=M#_Jum[\JJ6z=qJ\!hh(5fN,U>(5he3/eKbfHnbz;'eVSǑZ[byT℻#hٹM Js@8d(jԟ#6(TԜ4JIӁ )o˜+{0K0-o9&h,9U9.0^*\XwpܼcF p Xq6Ȇd~U^el-.<+DžMDt3XU7տ8$LҋKJqvN8󎽯4y4|1!®*bYb }?*'q~hf$gM.*'v*UثWb]v*UثWb]v*UثWb]N*UثWb]v*UثWb]v*UثWb]v*UثxV^ r&qW鳬RG*@biQoY;ҡRips߳&(Mm!wzV-v*(ϔxOwY1yۨTeTS 1T ң_NK4R}6nV+cK[o@؎J*]LUN7YVX~"+U1TEn]17=O*\y  WJ*wS;h"DG7⦿È[eP1 M?Uc[Gx~EU{)MԞxvhPTӯ v:>< DC9':JtlU=-#Y%y3z8\U40^IVqYT1Vd0TTU.d.yR;?)=K2n9TN ~^8tWo]2' 0_Rb]v*UثWb]v*UثWb]v*UثWbN*UثWb]v*UثWb]v*UثWb]v*Uث ou |1]ڱ |U󭀡zLUi|b9>$еJ`v ֞u(b %@OiUoWڥ=(DdDCoYU/Pi"ӯ._qTK=[ YoR45\U~ԉTqu&nGb̷3Gm u$|GU8+bZ[=KdrzTEv=qJK;ȤQ"N木z bxhUWNlqTQbv/_J MtM=T֬ ?,U-gp}\UPM=}65I ]v*UثWb]v*UثWb]v*UثWb_N*UثWb]v*UثWb]v*UثWb]v*UتYOupW>b> |UX__T>>b8bMX 5ܞcx  ncC iT,ғljVaqLU/ԹV9sSMKAxҋrk%W,UoIc2}^jHP|P<)u)bKV'@68ij'cN7Qm&TH^D@G'q_\V%bX"F1 uSRB9J!4_^E45,޲kh~x=5,kdQM=CɌL#ys,bƼCi]y6jÓzV>إiǜ l$弄sWM[%eԘJ„zvX=/JN];*&~p?D[6_f]v*UثWb]v*UثWb]v*UثWbebooklib-0.17.1/samples/02_cover_create/create.py000066400000000000000000000041601341350332300216070ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') # add cover image book.set_cover("image.jpg", open('cover.jpg', 'rb').read()) # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='hr') c1.content=u'

    Introduction

    Introduction paragraph where i explain what is happening.

    ' # about chapter c2 = epub.EpubHtml(title='About this book', file_name='about.xhtml') c2.content='

    About this book

    Helou, this is my book! There are many books, but this one is mine.

    Cover Image

    ' # add chapters to the book book.add_item(c1) book.add_item(c2) # create table of contents # - add manual link # - add section # - add auto created links to chapters book.toc = (epub.Link('intro.xhtml', 'Introduction', 'intro'), (epub.Section('Languages'), (c1, c2)) ) # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # define css style style = ''' @namespace epub "http://www.idpf.org/2007/ops"; body { font-family: Cambria, Liberation Serif, Bitstream Vera Serif, Georgia, Times, Times New Roman, serif; } h2 { text-align: left; text-transform: uppercase; font-weight: 200; } ol { list-style-type: none; } ol > li:first-child { margin-top: 0.3em; } nav[epub|type~='toc'] > ol > li > ol { list-style-type:square; } nav[epub|type~='toc'] > ol > li > ol > li { margin-top: 0.3em; } ''' # add css file nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) book.add_item(nav_css) # create spin, add cover page as first page book.spine = ['cover', 'nav', c1, c2] # create epub file epub.write_epub('test.epub', book, {}) ebooklib-0.17.1/samples/03_advanced_create/000077500000000000000000000000001341350332300204215ustar00rootroot00000000000000ebooklib-0.17.1/samples/03_advanced_create/README.md000066400000000000000000000002011341350332300216710ustar00rootroot00000000000000Advanced create =============== Create simple EPUB3 using some of advanced features of EbookLib. ## Start python create.pyebooklib-0.17.1/samples/03_advanced_create/create.py000066400000000000000000000045141341350332300222420ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='hr') c1.content=u'

    Introduction

    Introduction paragraph where i explain what is happening.

    ' # defube style style = '''BODY { text-align: justify;}''' default_css = epub.EpubItem(uid="style_default", file_name="style/default.css", media_type="text/css", content=style) book.add_item(default_css) # about chapter c2 = epub.EpubHtml(title='About this book', file_name='about.xhtml') c2.content='

    About this book

    Helou, this is my book! There are many books, but this one is mine.

    ' c2.set_language('hr') c2.properties.append('rendition:layout-pre-paginated rendition:orientation-landscape rendition:spread-none') c2.add_item(default_css) # add chapters to the book book.add_item(c1) book.add_item(c2) # create table of contents # - add manual link # - add section # - add auto created links to chapters book.toc = (epub.Link('intro.xhtml', 'Introduction', 'intro'), (epub.Section('Languages'), (c1, c2)) ) # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # define css style style = ''' @namespace epub "http://www.idpf.org/2007/ops"; body { font-family: Cambria, Liberation Serif, Bitstream Vera Serif, Georgia, Times, Times New Roman, serif; } h2 { text-align: left; text-transform: uppercase; font-weight: 200; } ol { list-style-type: none; } ol > li:first-child { margin-top: 0.3em; } nav[epub|type~='toc'] > ol > li > ol { list-style-type:square; } nav[epub|type~='toc'] > ol > li > ol > li { margin-top: 0.3em; } ''' # add css file nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) book.add_item(nav_css) # create spine book.spine = ['nav', c1, c2] # create epub file epub.write_epub('test.epub', book, {}) ebooklib-0.17.1/samples/04_markdown_parse/000077500000000000000000000000001341350332300203465ustar00rootroot00000000000000ebooklib-0.17.1/samples/04_markdown_parse/README.md000066400000000000000000000004101341350332300216200ustar00rootroot00000000000000# epub2markdown This is just a simple example and not utility script you should use for converting your ebooks. ## Usage epub2markdown my_ebook.epub ## Dependencies You need to install [Pandoc](http://johnmacfarlane.net/pandoc/) for this script to work. ebooklib-0.17.1/samples/04_markdown_parse/epub2markdown.py000077500000000000000000000023471341350332300235110ustar00rootroot00000000000000#!/usr/bin/env python import os.path import subprocess import sys from ebooklib import epub # This is just a basic example which can easily break in real world. if __name__ == '__main__': # read epub book = epub.read_epub(sys.argv[1]) # get base filename from the epub base_name = os.path.basename(os.path.splitext(sys.argv[1])[0]) for item in book.items: # convert into markdown if this is html if isinstance(item, epub.EpubHtml): proc = subprocess.Popen(['pandoc', '-f', 'html', '-t', 'markdown', '-'], stdin=subprocess.PIPE, stdout=subprocess.PIPE) content, error = proc.communicate(item.content) file_name = os.path.splitext(item.file_name)[0] + '.md' else: file_name = item.file_name content = item.content # create needed directories dir_name = '{0}/{1}'.format(base_name, os.path.dirname(file_name)) if not os.path.exists(dir_name): os.makedirs(dir_name) print('>> {0}'.format(file_name)) # write content to file with open('{0}/{1}'.format(base_name, file_name), 'w') as f: f.write(content) ebooklib-0.17.1/samples/05_plugins_create/000077500000000000000000000000001341350332300203375ustar00rootroot00000000000000ebooklib-0.17.1/samples/05_plugins_create/README.md000066400000000000000000000001211341350332300216100ustar00rootroot00000000000000Plugins ======= How to make your useless plugin. ## Start python create.pyebooklib-0.17.1/samples/05_plugins_create/create.py000066400000000000000000000056311341350332300221610ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub from ebooklib.plugins.base import BasePlugin class SamplePlugin(BasePlugin): NAME = 'Sample Plugin' # Very useless but example of what can be done def html_before_write(self, book, chapter): if chapter.content is None: return try: from urlparse import urlparse, urljoin except ImportError: from urllib.parse import urlparse, urljoin from lxml import html, etree utf8_parser = html.HTMLParser(encoding='utf-8') tree = html.document_fromstring(chapter.content, parser=utf8_parser) root = tree.getroottree() if len(root.find('body')) != 0: body = tree.find('body') for _link in body.xpath("//a[@class='test']"): _link.set('href', 'http://www.binarni.net/') chapter.content = etree.tostring(tree, pretty_print=True, encoding='utf-8') if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='en') c1.content=u'

    Introduction

    Introduction paragraph with a link where i explain what is happening.

    ' # about chapter c2 = epub.EpubHtml(title='About this book', file_name='about.xhtml') c2.content='

    About this book

    Helou, this is my book! There are many books, but this one is mine.

    ' # add chapters to the book book.add_item(c1) book.add_item(c2) # create table of contents # - add section # - add auto created links to chapters book.toc = (epub.Link('intro.xhtml', 'Introduction', 'intro'), (epub.Section('Languages'), (c1, c2)) ) # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # define css style style = ''' @namespace epub "http://www.idpf.org/2007/ops"; body { font-family: Cambria, Liberation Serif, Bitstream Vera Serif, Georgia, Times, Times New Roman, serif; } h2 { text-align: left; text-transform: uppercase; font-weight: 200; } ol { list-style-type: none; } ol > li:first-child { margin-top: 0.3em; } nav[epub|type~='toc'] > ol > li > ol { list-style-type:square; } nav[epub|type~='toc'] > ol > li > ol > li { margin-top: 0.3em; } ''' # add css file nav_css = epub.EpubItem(uid="style_nav", file_name="style/nav.css", media_type="text/css", content=style) book.add_item(nav_css) # create spine book.spine = ['nav', c1, c2] opts = {'plugins': [SamplePlugin()]} # create epub file epub.write_epub('test.epub', book, opts) ebooklib-0.17.1/samples/06_parse/000077500000000000000000000000001341350332300164465ustar00rootroot00000000000000ebooklib-0.17.1/samples/06_parse/README.md000066400000000000000000000001251341350332300177230ustar00rootroot00000000000000Plugins ======= How to parse EPUB file. ## Start python parse.py my-book.epub ebooklib-0.17.1/samples/06_parse/parse.py000066400000000000000000000005001341350332300201250ustar00rootroot00000000000000import sys import ebooklib from ebooklib import epub from ebooklib.utils import debug book = epub.read_epub(sys.argv[1]) debug(book.metadata) debug(book.spine) debug(book.toc) for x in book.get_items_of_type(ebooklib.ITEM_IMAGE): debug(x) for x in book.get_items_of_type(ebooklib.ITEM_DOCUMENT): debug(x) ebooklib-0.17.1/samples/07_pagebreaks/000077500000000000000000000000001341350332300174415ustar00rootroot00000000000000ebooklib-0.17.1/samples/07_pagebreaks/README.md000066400000000000000000000002001341350332300207100ustar00rootroot00000000000000Advanced create =============== Create simple EPUB3 with both visible and invisible pagebreaks ## Start python create.py ebooklib-0.17.1/samples/07_pagebreaks/create.py000066400000000000000000000035601341350332300212620ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub from ebooklib.plugins import standard from ebooklib.utils import create_pagebreak if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_author('Aleksandar Erkalovic') # build the chapter HTML and add the page break c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='en') c1.content = u'

    Introduction

    1This chapter has a visible page number.

    2Something else now.

    ' c2 = epub.EpubHtml(title='Chapter the Second', file_name='chap02.xhtml', lang='en') c2.content = u'

    Chapter the Second

    This chapter has two page breaks, both with invisible page numbers.

    ' # Add invisible page numbers that match the printed text, for accessibility c2.content += create_pagebreak("2") # You can add more content after the page break c2.content += u'

    This is the second page in the second chapter, after the invisible page break.

    ' # Add invisible page numbers that match the printed text, for accessibility c2.content += create_pagebreak("3", label="Page 3") # close the chapter c2.content += u'' # add chapters to the book book.add_item(c1) book.add_item(c2) # create table of contents # - add manual link # - add section # - add auto created links to chapters book.toc = ((c1, c2, )) # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # create spine book.spine = ['nav', c1, c2, ] # create epub file opts = {'plugins': [standard.SyntaxPlugin()]} epub.write_epub('test.epub', book, opts) ebooklib-0.17.1/samples/08_SMIL/000077500000000000000000000000001341350332300161025ustar00rootroot00000000000000ebooklib-0.17.1/samples/08_SMIL/chapter1_audio.mp3000066400000000000000000002737661341350332300214400ustar00rootroot00000000000000ID3TIT21 Minute of SilenceTPE1Anar Software LLCTALB Blank AudioAPICimage/jpegPNG  IHDR88lbKGD pHYs==UtIME 1ov IDATx{Ue0 7/(ꀉW,S42oV*5MQ3iy-54 CYy)dra[ sΞ9g<3Zzkg?{߳pηg]NJN$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$O$OAlbĉ1tPh*"^h {g|ѿ?`47hA TVVO~=ztA:ꨘ1c,SNq 7ĨQ fΜ91bĈXz[T( /0>L'>dfEu'_ܬm׬Y#F7|S!kb)?&NtҢ(v}{-K_R+ @Ŷj;nDD7NQ ZSNq}^{U>3L̟?_(~zQÍ8A#DUUU=3,Yeҭ[Kn @A4o}I1j( 27J=#dRUU^zi]ti29c>g}shѢ9E /ѣGyE#<2/^SNm~Ȑ!v)>9 8(7l͊3<ƍ5kDDɓ[ ӧO;h-]4Ǝuuu][oŬY1b 'ַ{.Zgyf; ? }]$ I'TnFiӦ5XVUU' Mpرc[nEwߍ/fjtfǞ{i hHN1jԨӟ4>m! W% +_x㍘2eJvÆ 34IAN#G,Z_?яbݺuy=ӱjժ m&%Iqg}6{챂ڮ^:^|?O%I{wlE뢋.W^il=0(4JA9䐢#s=i_~%Q;w:[..56c204JAg۷ox73okE}} ``hFぞ+VYۮ^: u޽( 폀F-㦛nŋ7{K6X6#QC ik׮_-cٲe M8hO>-zXdIh,08h`-7"">4FAkf͊{E4FA-}SɤIroye@c4В˖-x(DZf5XֳgO@ӧOХKݻw;w6@4 ࠁfmW__wygQa+о 8h`ʕn1gΜrp@sb?ȼܹs',j?:p@sfpL<9>âjr[ThpEѣG?(8hܹs555-ϸqr4FA 8^cO?=6@c4[T/_ޢ}\yѭ[Lۘ@c4j޼yy۴$8bĈpИJ@c lٲf=p 2of͚x Ъ***,kB_n]|g=N;ʅ[[aZymmm[Hv}ܹs}UTTĘ1cGgq'\e\j)]Ju5\筭Ǫ\ϵc޾8WE|]\>OG}4"&L&LP)q)q5ϫ@lߡ:8 ƍN}:d"4o޼X|y 89>|xQw䝚xhv*B^fq|48cرEUbԩpNE+s88W]uU{GMM:|6Y 'WvEeeet=nٳg;i$:$38Spt%㪫mӟW^Q|Cpd"5wܜ\~qu7xf"z饗\uO=TL6M;,yGÚ(uJ1[.?|:4d"$׫boٳg+8С 8S 38/^?٩y7cŊ%ǥ^a#;/\_|Ÿ{ 86$@qז>Ə Eo㪪o1:蠒c޼yq'Fmme޽{ǔ)SJnDD|d@3l&9 8t /cV_k=Tݻw{ｱ뮻>$NEڹnݺwKW|-ґS(G;ֹs馛ӟt{vM7 4٩H;UQQ?bk<T +>fΜ555Mw} @38Svhq)t=\x׿6pTVV*G8ڙ/~qgtj{챱rxl[ǠA @F28p`?/>w8c /l9ٹE%;i'uzkl%ǢE⨣ wYm* 8Sv/!C8ꨣbΜ9,w㭷jr})ݢ"h&J?>8−_[[|꫍5_~% ^ګ\8D Ҷ{_\׭[zjnT/Wa|Cu%ڨ*IqgO<]7Dx(@s5c 5Qt?>>qm7k֬Xn]k0U]]]? kivmc%?yvm]jUkM޽{ :ԠdJGҥKI_~ymݦ9xG6 =_J\7|3ƍqÇǏ㈈dMb=]v%}'V\K,ŋŋΝ3f̈e˖v[Tp$wq> oDMMMm_|Ŝwm~ԧ znHϞ=c7ot]]]]<Ǵi7pa펇f#H̹niI>8gqF~ٱbŊٳgtGydQ2kkϏ7|3{챸c….]0#IȠAc)I\sM<-Q*nm~1s?~|ɞMК٨HBN9唒\OmQs91cƌ8]0@٨H"6x=zt}7[V懊.>`\}ձ[Ev[{ｱ;x$yJ6DwqѣGX8f=TW^q~6lXYlcG!٨HO.z7|s[po~>|=wx>#ܢ~EoΜ9qeӟt<#۷_2uʖfY [gM|ߍUVdL:][\uUq駻kj*y1g^|qt8=]m1!(ṕlMQ?oq 0h85jT5*38v=CvV9Vb-cl0oL[(6G##;)d IDAT^m„ ^' @[pa 38W_s6X=SMGÆ +0ϟ/Bcs7b3vk׮<-[Vq+eۦZ|Ԡ\ǹus3͹ߕŹN[O?ު>ĠA\@pd"e_XjUvx`SSS{ntAβxsƉ''NlbTTTıD#BѠJP~ZzO?M~bn>~g?٘4iR5frʜQqM7!k=zWmBj($oY_{q 'ĢErٳgl%_|1/@7d8\@,Bݐy_nmڵkc̘1qM#m* 8"}{̘1c.yMgF5ŋ&oY_߾}3}f5A[ouѣ{gs=Wc=\@pdehɒ%7(]>}2{ƤI2O1xf5kf,\dN;E]@pde%?e-7x yJsoS 'k֬)xt9vm7&Ъ٨Fj-*8,Y'|r^Yo|MK!L!ܦ6FQ &oݢdp#{}ID|Gsߌ^ 8Psgp|1w܂;oy?)՛TsM7dLv}w&Ъܢj7k+Vĺu jtҼmL71,D:vZ͜93^~墏Iև#(C/rAG-[˹~ݺuq=|:uۮh+,.]0V%F5"~3o|%Oի&=;uL*++*FQf̘y,Ggu-ڹ,X mp]6nY@k2#(S 8yʂ z>&К٨F׿gδM]]]mݢR[<̙s}1ﰧ%mL PG6QƲׯ_mgϞ+-*%fm)z yG?@+pdͦ'>KQSSY -9ڜǑGo}Q$\26hСCOy9_@R>Q7@;zDD2ۄ b„ @o_VgGKo4XSozn#F(!K,ӧg:+K9Ɩ瞱;4y555CfvXٳ{=Ċ+Rj۔r=,gAJ=rnSb,sks˲e]'pBGIW[nd_m7.XlY}1} 77~ǿØ1c .hr}׮]~?.9믿w\@lT#>`Sg?^{-{C7t56|G-cƌ.@?/#FW_`I'T*bIeѽ{#B]]] O=Tv_f͊ɓ'olC=h?mw߽}Y&:d袋^?Y},_M bŊXdI6pUVV'F5+}ݗ駟ݺuw7X[gQ7o^lMUwm38Q]qQ[[o{lg̘~˖.]ZcpkGcvkQ/pm38Q-X ƍ]vø{z뭢{!_WZ;#֬YD[T***i=D]wu-g1Ӭф bҤIf͚h|V[mU#lk֬;ӅF5nݺwc7nsύ!C /PwJUUUl-ǠAbjQwumFj$^+2gW_}|zs-ѣ[4Ukڵq 76%F5_"lǩZǻ`Xvm6-yJ^u[~ٳ]\@pd?3bժU9۝{EymjK}GKfpL0!6tfo?{x(｜?C 7gΜ8s_ѻw6?|hTvq8餓Z㬳;5xMl6NL2%&O6lS=c/Ν;7&M= (  86?K.M?b2r>|x饗^.E dڵkfכtIq7F.]8ݢfeow6\̙sL\E d;cƌul7rȘ:uj<# ~Ajbԩ7X.\GydPQQQHpC3Jڂgpdɓsnw~8vaV;X|y6nS޽{y1xfÊ+NW_}%F5ڱ_ 71f̘jckɃF SLC6ks̉|+?E-F5ڹI&r+.1cF%?|GS38=И>}z|ӟn~g̘x`.jt&M; I&ů~e]JvLϹ38z7pCp ~0M7{lcʁ# n8 n>Ĵi'?I׶" Oơڬ}cĉyx G6ۢ".袂w)>׿O=Tw'x"-Zcp <8N;8ꨣbo~x rI[ߏ.(zU6]v/o>MӦM^{Y\Y ?ώ3gt Il=O=T\q/})Ӷ1t:ths91gΜx㥗^9sܹsΖ]V^^{m\f $KZ`A}-Euuu4hPr),[re,X VZWڨڪ诣Sƍ7o/ਨP8:?|9rd7. >{m]MMML4)nXd 38puuu<SOÇG{y,\0n喸;cŊhw8<0Fg"XbEL>=}xG=chrplHA{ｘ m˹G@AڜJAYvmm"Pm>֬Yz38(6z&י@) MEE@\38w@DApTUUEUU"Wg%h?b]ww=>G޽K.ѵkרsƼygW^y,9WѥKG;0x8_ztڵm<rK,_͎=38""jkk 0yE%a[lE~1cƌ8 7"">Yg3gΌ?! 5kD]] /GFOp$#¡Z}=%"⥗^2yxLwWb]Z/c]UE֢uoTmA"%I~1Kfq]*=sΙs9u p@F +UBBBܺ {Jpx^xAŊ{".Q[o/HIIÇ9!p˗bvwa#+66Ė]dIοTR6hp+Z[vl:{ }.]fفpx8w ܾ}mPXXղh۷p{m3\ycl͚5JJJbFY"5ǎsۼu0/N!p~"˽{l)S7ojΝxS8<ܶm۞r7oެxW 4ZvZݿp ;s.^]b]fM<y ]ޑ#Gj*ͿUVVhp8 `Μ9JIIɰ i$ݿ H30NuI|._(U-[ wV&M2tӇÀyfy'OTDD\lڴƌL2Y-Wjtyv* ]hb@С4TÆ nkر4ipCƎKp jpol۶MmڴQRR[֩D}|||~Ϟ={*22e3gN}j׮]k.EDD(!!p IC ui]zU5k֔C)X5kg̙3Z~``:tٳg_VOVDDܹ 585kԔ)S-[6wQM@wf܊O`_vJvȑ#o>v Cp<^|E 6Lۖm۶iΜ9ڲe 8!%JPƍոqc)R$KJJΝ;|r^Z111ldAzWԸqc-[V Thhf,))):w>ÇСC:|0#p@`ʞ=n߾۷o+66VoVLLݻdžx$`xl`t8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x| IDAT8p#G ϗMY*88X~bcc†Cp8~~~j޼^yݽ{W{ʕ+AAAʖ-5kVir @_WjTJ5ݻvZmٲEoNu͚5ӻ+I9svԺeϞ]-[TҥuE\R'Npjʖ-fj:^w,Y̦oݺU˖-x4/I1m۶f}  >%$$DS2e̦o۶M۷׽{8xsUŊ n믿.Iʕ+oq*UԩS|ݻBCCzobb.]fUD ]V޽{k/tҚ;w (`v= 8Сs믿Q~~~N}ɓ'kԨQ F <d͝;3_ƎknH;ＣO?T#G} ˗P߿L2tcx75n8YݼyS/_֍7ɓGr咗H˖-ոqc͞=[&M2iӦ"GkfFÇuaq:(8JJJŋͦ)O(((M7vFL`ծ]fyF8ڳgΝ;˗/KŊӻPYgϞUbb˧B jժرcN*TYcjӦFavٳgkӦM:qfrYjժjժ[ѣի]BTRTŋ>^sIMѣGpCt}wjѢ6ljg!8sp)-[6Vڵ5a}?^?/VÍe˖F?~%Ke'OT}vvl,ܸz6liӦ9}Ȉ#[%Lj :S?hĉ0`x۷n \_VXa5Bq-`ҥO,Y}jw^5l0KΞ=BAM~iv_5kT5n8v/_^G6VZ ԨQ#]t4V۷o׭[l\2]?Z4H8ƺtyѣ Ԟx?-[L_n&Māw,>}Z۷WBBCJF3OǏow {58b]y{k„ f['Ot?Fv_Lׯ?6yԌ3zt70 III۷^{5 34q7nSٲeu]ٳǥ5fd:߿]*&&扭ۀoZÑnRBB(LM4s=g{ZvKqeuE/K.gA*UUVzu[Nvr:[ O0 >Ӝ9ș? MT]xql;wN8D-11QC ܹs-!~b G|ٴ-ڽ{K :j3MT|rMxD@֭h,xYq-}W~6lЎ;,;RP\9)RwBBn͚5lhV 1o.pΪo I`$jp,Zڤٳ-9ZZjf_t)~#99YC Zl`VZe184x8NIIѼy:\,MTqqqVw]rʐڵ]D dbŊ9M <  8>z1ӿ 8# ԩS3d87M \@eʔq=f͚YfYtNѣ5 <ɓ'M!>>^W\Z;hΜ9ʝ;[р/8UVu=wzfj,Y(k֬ZpT ty8qB))).&^^^ʔ)2gl_rEk׮ur˕+:u(<<\yQHH|}}ׯҥKڲe~7ݻwׅDJJJҩSկ_jYjoiZhYGϮry }:]z>|lٲiʕtY`AIu9rD UN(QByQhhgϮݸqCǎӞ={믿lmoJ**Tͫק~5klK7nܹs3g-iӦ:teй1**J_,N:رx 󈉉͛5a TΝդIvz\%I*URΝ hڴiN (O?Tuֵ9[M۷o͟?_ӧO7`8y)GDznݺ)gΜ#$$Dm۶Uf4zhvjgϞ!=4iA)44Ԣsww̘1Nm hƌzwճgOoRe˖c_߿m۶ĉTsϩz-/N6mhfz<5tP}{={JHHo_U;wԉ'oeΜY>C!%%E{W*SL SZLp 6LZgϞT%K3%KpnZ}Q޼y:{jРf̘#Gcƍ5h SdS͗9r(44Դԭ[75kL}ц ^wﮞ={ZDo>۷OW\)5j(O+vܩ  2eʤm:.6mEtR A?դIҞ={Ծ}{qV%ԳgOm޼YWV۶mTٖYW7|cn۷ϩpCzb1ccs׀ipc֬YZ,Ybu;whѢEVNEճg4mÑ#GZ;nHLkW^vg:ԩS˗իW/C Qxx8'' Uҥ{lAF5^֬Yս{w5lP)))ׯ&OГΝSm3o޼^̅5*TP>},oڴ)MhȑӋ+͸8M4jY\[o{=/z1c(sJIIQϞ=5gw-ӈ>ִh|{lQ<>>qɓ'[ShQuJ۷oWjմ}v-\r3fvڥ;<*-ڹsgURb35=jgt33glVѶm[uM4a <ءԪU+ݽ{jy-ԤIGqTl ׯo͛[3lذ4 UemڴlZL4i$y{s;xk_ZNeaZ`S=x'3gh'Kcǎz7a„4_~ѣG-7mTCt e}QۣOJ׬Y .E L8!U/\`I[hhAG/_jS9M>KBvlI\͛CX ըQdSi]_OZLߵkC}bώ*UqwQ\\ղ/hܸqNŋmvT#Gyrrӵ_4i̙3[- T|,iӏ?͛7yYq|]6'6f,Y"E襗^R۶m`tܹ4w|6w\7OORխV=q8pBeU}(>>fӡʕ+륗^Jg"ߑ8C ,0YQn`O׮]N_ti>Og}81~zըQC[ZkZnKaOԩS'5{mݺ$KK7nЀ۬̾n߾Վd7mdv-uֵ[nm6mX]~zݻDԩ''JNNVtt6mڤ}rnSLIssA]xjfݻ[eXSJÉfSk8*{즀ȑ#ڻw/_H7ߤy(ћ7o ^|EQpa7<ڽ{w>ۉ'>zRRReuA*TutP-]T*Tx̙3]vVǞ8}Ԯ]e5̙Z߭(Z`?-M,Q׹ș ickyJ*9U 8'V6mUnݺt:tRX1Emۖ_tf֭[;4͟?jY1m˖-MM Ο?7{gkǵmjǏ:ܣ#-̙jFpU?QDD^xuEK,o$4c 4jyҥKuVokիW/~Gs7nl3H[V^mժUj8 }l p@{G͛N۷oW|||akG/ڰ8ӾzƌV{{{:sڷo/˗@۶mKw`:((ȡ:N]5Iʕ3/^zW^o޽{kѢEO7o^M2#:v~c/r}a]eԹZǬ҃(-ѣv~zu7ړ++I`nrwwJO'o llȞ|McccvSNY^hQ+zͶ-Zp*Uj~<_`+?I˚5ͦ,9ֱ4޼_Zx>p} IDAT>UTIʕS׮]5gwyتEc;ύkإbŊViZϫnݺڲe޽۷okݺuYy\rOMx&O.oÝVǎK|x7S֬Y } _m8w΍:vE $/nEz_,Y4vX!|@9xjԨyҵOo_f};w\{O}z8e#Z]v:ujh׮dt.l ߑCo߾io``C7&9r_ 4޽ambb[YFSbŬ[wjҤI.V}}UP!o~pf]Q"=yi~QBRi$;)@ => EB=/\Q5!{aЎ;vڹsg͜9MZj%Ax'Rت_rcGLK/iϫ~Zb͚j`'}nw}]~Μ9 {Dd6 5]Yibo [y9:ţLb5ȓ'7onwF)W\ݼ$&&Vͮ2kaR۶mi&eɒŢ_ѢEzj;vT#БWV-ގ;jܸqڿڴiÏ4t#<رcvFa[JJOnѡvӪjժV:tH[nug9s!__Zjyl+ O?kBL5]R2s{> 2ez" VZAVhbҥK/^\J.^l=]4iڵkUZUJLLԼypڽ{j[o'ٲeرcM>jpi4o<Νmț7:wl6mܸq>2e |eh„ ~!&M摬<իWm]EUV5p{#GСC`S Ǐ7 >s4cnݺi׮]:}N8ٳg{PXX.\'O?Ν;լY3/K;wΝ;ɓ3gBBB8сMx:<ݻlTnFiW^io ThQ;w[7-[%'',_֓Oޞ}jm0n8ʕ+]ϒ%fϞyJV\UVf.\X?E)9rNz0Ȓ%Kڵkmv<`tגyn+WNt͘1%ǝ7:u>Ks=ziXqY}Ν;mٳ^~to/Ro$?~|7m4}*R-[6խ[Wk׮uk/֯_*U(K,RXX&Nh7]&M_ fͪڵkk}$)\}!ChȑkmbsWgo 'ŋkٲek֬7xe͚U~5uM))).]_~YN碎4fdϞfжʞ=󈋋S׮]V ĉM;+GZx… ۷ᎫRJi͚5z7]:N:ԱcG%%%95[2xp;/=.%%E~nݺe\7mڴ4i9s)۷ս{wN<7f˖ϟנAlΜ9ij*W_ٳg֯_o={իWn)S̴,'NTN$=A?LÛf͚$2d[~#4yde͚jy߾}>qƍ=.44TC,ٜVfʹ}vu5;D-k[իWZ!Yӣ]4m454rCIII֭ܲ8p@ {gD ]Ͳ%K;̱+\>{l9p fzZlS{l2͛7ձcGX:w9W\Zh>t#F߻wO:u˗_Ŋm y=e˦_|jYݺu /]^zY _x^D|4|SHt=uE(Q;{nlw套^z,X@-gΜ1>>>0`Zh!>}}Ott>Cֆk͚5No͞=[M65G?#?~ZpZrostͫ#Fh׮]@bb:wlwҖW^yESNYAiEш#l>YaÆ90@6llܸQիWo֯_o6*g}gϦ{?T||EYhh~g {Æ z-͚5MWRRl٢ӧO˺~ϯpW_5EΝ;k޽65kV~~~ʗ/~/^j19fjժ4h|}}/_>e˖c֭[45Mjڴ<҃V.]lʕ+Zv/EFF*o޼zUti-["d5ژ`?ڏھ}?˗/ڵk Uxx7kuZ&-Zdw+W9X|ZrOw͛gfJTT~%l<J.dʔɡ$Uoϑ9sf'.4G#I.)O7nPӦMջwouts5kVO}ٳgΝ;*X+fbu6lvc8pT Y6[l.>+VrҢDN7h S(\pwy5kZd={V׿~.;99Y/֐!Ctmg#G43fhʕѣ"""L7 TǎձcGݻwOW^յkL sV޼y4gM8ѡ߲ãK,X0򲨅Z۷oWݺu5tPM8|||TF oذAOw'͟1 黵Z-ٳgOsa6O{d :TҠAvɗ/_3`4Q &-7O7oy9R+W֊+zs=jժ~*W oJJvڥ {n=X}75l0MIIѦMTV4]tI]vUz믿˚]:tP]nHҜ9sl֨>^ ApJJulvyMgMTx[MTƏʚ5UڵkhѢʓ'iRtt] .hڸq:MM|k.kҥfmw*Rj֬ʕ+@ Q\XEFF5k֘5tSNn߾?j%[ .~[*URMԂhEGGիڽ{~7;v#-= ɣ5jZj*Tɣ`y{{+..Nׯ_סC~YF.]b=xRٲeUzum#Gݿ_111:}vء+W._\r_XXi|}}umݸqCցvZWϞ=ՠA+22R7o֗_~8^zI}ʖ-L2?~K=zQF*Z"##uV >P!3@Я_?bz>}Mq$=zڵk'IS:'駶 z1~::&MRAX 8~g󇇇iӦh@*hXzӨ#DSNbˠAL.1p ?~jJ ݻn:ݺu5*]ٴǏk݆j, ~Z}]I҆ sN C+Z`gnvխ[׬W_}U+V0{o׮]rJC}PرC3g6~eJLLxnݪ0%$$F:s v>>> IzաCio+V0\!IE!=Rxqׯ$="pp s=gqƦgΜYk׮i̅ r͛7W%I;v̙39p'pp|,+WJ.-oooG!!!G۷͛7 /eW^?ݻ&L IpႺvd t2 5_]tI?$)11Q;v ݫyyyYC{Q%ajruo^7nD'2ĦMTTT_w%C{5g:ttkϜ96mح6IC m޽jܸ'&&jɒ%ԩΞ=T|;v(gΜz饗mE{4m4SQQQ(@Q@ RΝUlY*THwCiź~SK*Mx Sll.]m۶i҉#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G 0<`x8p#G ׎`Op{'8= `OIDATp{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{'8= `Op{ؗpIENDB`TCMP0TPE2Anar Software LLC ZGI/1?]BBJÁyooԸhw: b KEN3*UYTAFirܦ/Y2aN=  T" 3w") C^ GH/,FdESTǪ޾oRI2.? bMIbnGE(V0 /||.١0J!] VN #f L׭y=c)01{Ȯ$ZXt?ɧK%S!9Kd cj SN$HʻHc/6{6o';#]merL^X=@qy f(Nh_O*w:5! QG%/?B |~tO<_ď #b M_ٹ&Z=rYf ֒(RF>'?Rۿ5̪ġ j MJDmi1 j9˥7SLaգ8 ,T0,1-hoykb$SIΦDL.N Y*@PH饨8Ҙ` *QmE^½p+bSIiRu6=)œ4lL2 b SI ): nQ]l/G f$0a2K\V}D!+|)M {j MH9LI,ߕq)xq+je!wQ=:g<܊۹KGcjۣ.Ktzҙ-ESSQLˎN ׷KT[9 aKG b8MIw*"Ŝ׫MD3g5or s GIDh3.Hm I7j$SHoSTLS0.[ׯFrL-΃\NMjm7"E}cI(ciL@rVWaVє fM,%/b1HE!晄N7 ?5L* a[ :cfSHLh%&TOY^_jjWHJjHB2 dH aJjj4}eV[f HCob״YS"Rr#)&NιU2wDbI?+ޱH`&н4qKQhV-n|9&TozQjEca>vQ)!pR6 bMIr!vHIpoUV\_ jR #PQn46قk{? pP#b -ȣ?$7yuUwKE8 kj(MHx0)CTAutB髧ɚl#%'Tk_Vp Uf SI?>L<ޢB,|ʣn|3ė7Z:=5)ſO|]Xɢ jSH>Cj6mh"`B" 4HHf$IPɈ*)fdH:&$| sj$QHϘr~l j29H :eAU|әRDovj xs#;ݯ^QeYͼwls ((J4XRbX [b MIeUZ2u1Έ{2zt7.Q?dKe2vg5Dn@ҬZ ^$MHT`}W? e/e 갦8Dh#QU*)K[V說jHK[0 T؂G5 dd0BB}kY_yJf.Zwkf 6NAlTҫShVlLu%k<Uw"9͔hVA^jUϩ]+b ID2Jnb[}o*˚O&jFN( ebAqH#fks*ՑdjDwfHKYcf{t i22IL7L4DR4)ǮT=wd}ԃu~s j SHo:sVvr4bWğ5*,5aP8@*[O-fBQ3sx9 j(SHl_}%"aFeb(F:Mj~*umDZ1Q>bIJ"GWKSYl9|＿p(>G$6x*rK\=11x.v #b SI42?Lh T hA A8q)))mS;4c D4ɀ+j HژyN3)%iWrCTKQi [&cD&ky(37R! jSHSu)k<>KU +0) ,ƪo[~]?XhJ;/j"v#=E}QCNre$hx&t@PKB䒺b j)qoe6r9h1H3db b(I6޿I|Nz@ID=1\4D1[Q"93kԏ؛ެ3jHm[_r_[]Ҋ3LOdy2ʨ-a%3|fzQRQ f MH؜׷9U8ԧ JW&kaNl&)!Y 1Yr۟:Ԍٵ b8QIZg$#-ݮnbeˢRISs-N$0!βb V[U1]=[j SH^EM.x9K![rSSg^ Iyā;92xeC GL*[^I"1Sߵof9qGN1tRPVgh)EupاsjS;s_ﭿ`AY;iufa|PѴK'J'RGS.jiLdv k^8QIUUi͘t5ؾ_ȤɎxC wbDDZ)D_niF~$Xb#\#ï 9 Ga:Bl# c115̸rWs"0e2%W/&O f H+g)LDEh%IS2㓂*)D.[I~u9¦T8 ^$SHJ,ufrE6[J>\>%B#iœe&BChl|~#j?켵z b0Iʍ\v.EmSVi^.JA&RlRk< IUN2Yk} 3f$MH?HS,X<{|nj.`8" Fu3/2LzNFM7ݓeF #f4MHk]m+ڳזbIvqp֑BXiDKeYt14SBe$U+~˯" N4DbI L< Ve_$ͰFqkPеIP)ƽduz"Rƹh)f,_2J[,U-_Hv mq{#H(Q0m5@9(B b$MI;O;%T]vq#@!6-vG ?r\xkτFr#b(I9k_a A Srn4ADoM&ALAMEUUUEGѕ13*  Cf SHS ,alTDhlR?[2>ۊDf$HS4R&5ꪭ[YuOZRWR0 ePNg{F}ejM,#FoԥPo:8zx9ņ8$@YggQWd4 b4MI֔cDLjRFE^_ܯҊ.= F@qva%,0㭚j6SjSHZ{)Qdlt۽?W O§6_Y$$%Fh]_Gh$#fXf}e+~5qQ,ɗ Ru_%UKԧ2Έ cbMHggbiUE)Wv+Q.s{ŢSKRtg6̊躋X#aBG{bS˦ގ׵w[ROZ w -8Mr)Ȫ; bS-av xFf,w+#o*Jk,gdA$i"I'ƍ Z I=HǦe̩ZzzKA{d &Sjjy粟ϽWfQ a !/̘UU}Φ]S:c+ 3F(Me[9 !ֵ}TaQ.UxS8lU|χV"Bj$H# QE[+Zgb`ahod0@$PYŤʃK/7o][O3b -SU]iYAW_%,V~#FYDKE ?@ {b@GIo!K$H, k/9&!s_dOYaeM CjZK_I9ۡ$#bIJ8NJU;vUz-A;;UQ0) .Sekw>_cfS,u#EY_ov.R!Nb˜cK:JA+(us޿^NB[_Nv滼&2AFQg2b j)qqUb  bSI($ ΚU#5P/S7ngeX]LeEpP j,1ӷճ j0kpr{! :ʿ[uuQCjy"&=Nt@y/9 b$MI)e"퍞ZuDn&Nt jGրdEJ]4eUSgWg bHMIr2՝Q{U\Σ gc=b@ A@L<*7<f]x HzD r*|wict]:5%ͥ:"fUoF bS-"M{9fPrWfUEY瓩rbMu (6^Ŋ蝋"\ kfMH= {Oz1%uI__f3[tZ`p@ihJ4[b } dg9JʟOq[6L"s9 me-X-NGpv jlb 0 fM,&$ϢUfOr \[YU5td "BU%ȄU?2 ^$SHV3-͓銜JsBHSDQMeY4.]>ڙb ;5*0ugjYW~LɎ(9$=&MFE 30 PCY*< b$MIȹe~XRGXY7BHX)'kM7'jzQ슍2VV*S^$SIeRf8Dz<#imf5QIxA%cV2"$z:P0  bM- bF/CIӬ!D] gEf E)H0Z+j*o"Df,)d b d!mp˅OO/uGur0AW8XmߔT…d҇nhy{%]+  f MHkݙrn5f]Uzlaէ-PHj' #M '^ kx 2Ż@/#bIG/\n5^wfOkӞ+6y1j(^&V%dZ[F &&^SHXDtUǏ0OVj!{50yc1 SFH3SSQLˎNeQ|]%hN Cj0MH9NSOBާ ]h{-=Hx/LcMJadr4 ;b -O5ܾk΅&I䎻r$Rw}hS56TB b(MIr1 GSSTTѝXK_g?.Y!0qK4әĄ z{ j MHRwZ]Kww9ټQd",sMG=\ESկu;Ԃs&+sjyv[ +K"p& ˗#$pW {PYe<,#5/ bMI!~,x\0i4 aQԙ)e'I;ZtqLH+b [z';p)e'UU6F7"} . bQIC ( h>rm;'{@rY\@iBܠeL`8ܕ[t֊DYe2"3#jM,u.GuGkR؞cgP^`Ȁ.n'2bDG/9^ H."ڭ|/h51$xOHI'bZT >6:eQ fdMflfs,}V7LP$eYT 44eG IUoMG2bM-UNT37V3 H-L F4Ǜ*qDiƌc:rQfH8$$Ցh؉>w6~HЩ n 'Q6*Ix4TbLU)Ϟ j$MHV7^^yn=;ʪhT je#ӱG2ȱQnv'W+UTftŪfSHD\HDYZR2tƲ~nDQ.$2FPБBakKb Iؒ!y# .0J.MD)ԅ*\֨\ZXs6b S-",`uDSJHlA5LLAME3.98.2zef!2[JIcV j(SHwLOmtZbX_/,gCčiVYJ9y??skj <ʔgg{/SDHI8Mͤ"MUN0ekt?KRޮz c^$SHe07ETcۭ?Gv)շR$aa98\DzX Wٷ:=fdGfS"V4yݪgJA"!)53A-TDM7yy39򺐮_bkj vBgbԎ\JiyOKRTcuUO " @PiCpsg'PB VS-kJny4a.RiJvHPn,CP>SUHѹ!V-!TDIh$F0:L3%Z9|a,PDj* bIDʦWe0;6g~aQTFǤ@|V"3:WKV@z+b vPkY2'6lR9i5P$uDqN+ȕTdIʴ[!SOVѨ fM,J Rn?ܕ7rɘ6 D₀d&z'{)IJtЍN`mj S!$]R5BӃ$D%PHXK- ou[dy bMH4W( #(!Lqha15̸UUUUUUUUIV荚}466ٙb-y:ӍeRwf&TP`jdY` LȮ0 {f SHBw2F!4r2߿?3{ĶNjnITDr0{sH0DhFZSCf SHlGDթ脺0<6e5R~ HouJknafdj=/|MhS{`f5b1b F-mĵ/+"^$SI՜Kfuʕvn'12ͰD`Rj \Ѐ\hNmfgoGLb90zqlI!G~ 8cdL?UEgAbRY?QLȡe1pX Kb MIn ZaAjd1sЪs)f:SQjozۻR0WWnL +^$MHewR;Z<Ƨpil`m|9fewKzIHe?MJj,}?y'j'^_؊aynO'c3B15i>{]deDv +f$SHSJ{%23۶_^\n&c"^#aThnشfŎm>s\ j4MH}gvH3XBox:uV@t@'+$(XR+XNb#f I9_Y*'уmEI4iPj6 <Bo-+9B7Q f(SH9i_qR#|xdm=]Dj$X!!r䌆,# PBqIǢUcUܖ +j9o]PXR)n_K!I\wjxVEEq *9zbAqH NL  ]) +bM,= i|9~>qc@" AGFԞĐIouSJveeH b$SIU\J#VGW<,eUaԳIeSm[ac*#۳:2TC^I*#n(Qsf?aV3K_jUdT%*BB 6Zuf+b Ig5/.?&=!ỏ/H$hŪ)U4:9Q 3+YB ^(MHi-PЏcm!s*a1,h. M&>D*2vо *J|z,.j HY>R?f65R(#4LeZ4 Fu[2Gmk+%U 3^ y]C:3\S+|I4 7| nI&@Q(*F6d'$Ⱥ f$MHV <ﺋ?RMv$ݼZhL )ӣH;j .,Pͣ䅺Y?c)M߲iOp(1~hT@3U}_fڜ?M7kz {^ SIq 6fڝ__㰛dw2D8(@YB!UIY?e?ffSb -(3,=~3Wq[B=+(Zy/]kzyB"freR bS-9X)nFMV?a}#FɒYٍwdLLZ][jH]߻ʶ-I9sͶfGԲsPe[ w&)q~XvDqJ h q {^ MIjus ,jg6{Կ}iqq' )f$} i*oMS|.E[b(IdR)9{' 489fW^?!n2 lҵSJՔ\c~Sb SIr4]oKպ.zދ w!g]v(#˔}5X, hjok[j 5Gb::,+]?mŖ|W>b$6i2| bMIDExH!jZ4Kxϭoz " B(TS2'%@i& #*noϳ [f$SH,pA8[4ο~n6iTIfő;TDLBj[@.w0t^%yNY9ʿڼ6{5AZNh {lDUMEFGWzʒ b I"j~ޫnM)OW3eXBЕ!:1]ʽ|X "?SbM|/qlLyJ 2bPIB_t䌕28P<') b$SIݜyͦxlA|0qwS Lɑ{:j)ƤKye J Kj SHb̿|8$u3i0ѢynlR]h!.m%R bMI~PWqF#_^z,Fc*X͚{֭9K f0MH:A٘ݖiP泥&}W]a^ GICL9A'$C(!j{b";0"H[Bˤ_ߖiDCZn^t;{bQ-]jN@(Uu]z7lZNJHΕ& TBg$t[Zwmw jS,F)[={澤^!u~2Ғ*_'IC'|[b i΍:PV*]_O$ԥ`Ҫ BQMHQ.O% b$MIFC76dE?e?Cxd*9'yUIU5JŽF[Y9{j$JcfUrA_RGQaX),4g"fqUV)U0%7}Ms-*圈 b,Kqu5E^K{ 8LAME3.98.2rI^(@_ϟk^KWr vu!ԐaW°5dS2㓅kg EŒ2$ fSHm{J̼ͮW_2mB汾f(-kjj[a f SH%-H#PY+3?e?+Sv4UH|DzŰT-Y_9_ j0MHaG[qkUE Q)9]& */)"J/t b0QIIdRbdn§jwy;|OtDL*RM[&,L("GL".0*ªjHOSyn2~ \&}d R?Ҿ̈Kj쥑BbH1؎uw<7l_,mY@_*Tm"⊊NI-{+kk[ "`GKXvEʎu"-"QVk N53 )n*҂쏇BfM+ifbHdCQs:x& *OPQ6HQ#gW b@Me fu9ژde 60 |˩Aʅ"+b$8-!46ݖ2Ymל+E-N6j'7PF2BFAd*-6f vg=ɭVw3.rt/)&i(N0 0_+j<}zn b IގH+Jf=\ pМJMjdea0k8^S-BL߶ 3L~_Z@hnn݃J'H)J-˛drK f ,+clں{! ;3|vI$,̚3PBt6QU3QUf,ՙ7*+ 1J"rYWm?;k!HF ]tzr*ksCb HY<߫=E}TYi#)fC6 *%M; .52 fMHcx\foPi? U;Zd J "91! hK[z0Ȳ4kj,NO{*C3nY&nt) 8AiDO.EɽG[S|/<,.^ SoPU3MZjHXpL15UUUVy:)- cb$MIOSpOzBRer=FB^w^f2Ȫ $!u#h2*bM-@׵f/nMw7.I=$Dᇢ`$*UGf  #b SI#s+oyq~Q<+\@NXt*%#w1Vt 3b MIM("Pc$̊$]ގTNtsd}Л\#lkf$SHݵ$+NҭR x4Jd,[ )5%Ьʤm_BΞZkj =.),ḼG?_?_-QWsJل Eڇh`ћP1uvgb> p6G%Ow|gц/nBc@*% d=?cJJΕI f(MHe::nV5<3%#JfS0H䑒f k]gj,e2uuĘ9񷾕nLAXNlW !2mU)EγўB-1f ,u6][޾*J"aҜfƘYu$j~ ɮoDՌ͒Rd5x 36<MIj1N k/WHiRQegL0hO2)n5}5nt5Ʈ[j c)Υg~۱m~JR0,GXəiX> .? f(MHd,ހiYl?{OG3hI)[YYDO[Ꙩ@\Z IfSZ"=Ҵf5LD0qb) $ ZeK#9>Bb SI#E"r^c)9d+mZi D$ B%F FDZv*%]ȬCb  HQ v G*sІ.#sF{(l^F#33G HV(D&,(A b$MIU/??ϼ(۶M>۾5Ͻ{:bU!d-5WB^F uRdykjSH'W*rH$*)!AbLB^,72kwWkwMpId fSHdy!Zzvi I#Cb .PqrqXlQB!(k2 b̃Sb$Ef/"MGbHr.|Ezbwū.ATTJ;d勦 )a>9BMKg bMI:`aR"zu~t31¤9:Fxl4 8R [ sf(MH\ʯZԙe/NUT=z( ( ,)IŒFu2N~jS,xQ->^[C-v+% (&UĬdViԑ4oOuZ*1 b$MIT+&n ,Ej H@8hޫxmm䀅9ɓ>T:a& kO~ae[ j H yWŗcwKŚSd"i}\RU[ /:<+o?'g 6<f )#eoDlEцO&JtP5ˑl];kT~ bMIyJ;'ϼV#A@Y… P&P0A) eIĭ_\(khǒ)eVj SH|6:{g]97YQ:@,q而ɛ{ʹ2-=g;ig1 [b SIf1$dXۻ󩥱 "r &@XphPA]^uBCjH]ѓЇb! fY>צwKlcMhEW%Y7@ I #f$GH9U̧s[3Η_{X9%$ΰ6U$T5  [jS,4y׭&Y[tfNWnX[FK/ b+Ź[fS, Vʳm:7p|~c,T5"TJᖅD(8F@<ob~ c^$SIH{AGѿK9 W<ڛcA.ic #kesm)*H'n$YDݓbbq422Vf5ʿwV\w3M\g Va*'Zu)E'> b(SdZ2NhH."r~~9WAeo ma#0Tݧ,ZaZZd 2Y"-^ HR9NV_WgI۱T٬"X/HD&b Կ:H99,< bS-#єhzH df9F!Aj1 lNsTtR]2 n_W fs [fSH{I6\%hAH C(Rf %%$oۂQ?2&))CU\j ,C=XA%HH. 蘚] Rم+*_nc۩xVR +f$MHwBTa)yt}o6>)p/hu ۂ<(ċU2n( z.u، V$IKc3yQms?V]7._]mXݪb\YPNdu:Jsb(8S-dd`Q4RRS;k+ۏUx-%@D6d`NkM\ j$HhTۢufnƘQLyj<ےjceMur((yV>rV4,| BbR!|^y+M#f5*3#D7)J]GR$tz[jW,u;$dd";9V?MbzՉHDiJ(h8%(A*CjS_vM+.vmTS'z]΍yntb&duk)Q  {jMHD4u'?rH$ef\!$ Z]D_]ׯMԕ崲T jSHի,G*GIc6DT26Z_]B >66$j52sƉ"3Y'LH@a1JYfWO2-.1r  ] & )ڞB= ahneR [bM-/*UeT}VPm W 1 Ȧ(xMrCk:֋bǗOf^GΗ ;f$GHJC2{\[RʭSF(]d4Ly% BDAsÓ҈CjMWX7wce7=R>ddNI_o>LpCYMJ^IɍqgͿy-39^Υ*dKoRI"kJGEsN9 {fMH9#8ȱjrY$y$֙*& \MBr7o~Gsf4<"Qu>m5'8ϣWW.@b> GouWI8 V$MIiV#Ώ#Wilsf=GaHHVKO)E2q,+j,SH!Զue'e=Ej YHS2$[~mfl!c^$#5^zG3ˤr%>4 =Y&3rM 73PDme ̑ Z$SI㔬>%u@ }}.[7f׬oA'f`" $.ʰ;2*7* C^ SIp)EswҟnSBw#%-$9Qñu@^}r:">CZS, ߇#_xF3J("DāXiU"AWVQd ^MI#L|{Zdݴ?$'7䔪 hytG#B@ad5.YB[f$MHM;H:5JP{Nӓa|?L)@߶s3mWg [b<MIwtĪ==2&KfءIFd EIj^73J)Dy ebfSOߟfUhd";Q@j.dɘ2wʣ"$ĨMJ|vm"Aկb CheM]yΥ%n6ig*)'daa)j!2p,,*'#] bMI= k?%)%V/>SϦM V4T ;Hnegu)E/?34aj H^m"wv暽]i\$ZI`)N`Dag^RSjQjyo̲.7neG?ȈE PXh,.2 Uqk<{H bMIuo2Y_Zޚf0+QQ(#,F:D@a(U߬lk#+ffS,r喾UtrF(Y%$1`'iT̛n2Fm Ircfg!2Wyzֆׄe"v8Ϛ.3b-ΝfK8E|$#4C6OTˢv "e9 I2:P%ٰ Cf HC0O sHZ9rsjIcWM.F`BMN*'fpP&FUꞟV=bI=UсsױmVO۶Gt!1a(R4E(4k>2l3f_\uV6SdO D0THMzY#e#D bMI39H4-Rr"!U}{==L OTK\U b S%s"5IZ֨G3L1?P4YMBNvX~2fxKb1cac3 77?o+Mi˖Z8/lXj)ܑNBJoծ̕u KbSIW{&;w}W{5\xti$ĦNW#\kG=cb S?Qە'PI\ (,Fji.KI!)K:FAfEbSYs((SڔDFEuxͩ("YF)?kKKU{ bSI*]Dt:I|oor.jM8H-'.n"qeBaJ( b$IYy𬓵,_ww% zgL1Z1X8*Zs&b;L]z  b,SI"A!D:c{F:Zk>hAc1H*)E-ZdTv6@Bo)j SH|[37&QH3(pȀd%V܈A#LLIĔ$e$GIl5 j2H}C*p =)PLS LFA$'Fd()ß^=E"" f MH;WR tiIȶ8ZQ7qPj`e)ŬlRS\ bQIsI{yrWU!nn LB$((*^՗kkTU%eCj MHX&3;golK W]LBp:$9%i%a*k;NH% dKkb SI6Lrw\e_qnuӊu)%<]p!"gjo%Ir̒N{drcb$SI'ccH^}z}Z{ -cjHVH[oﻎϝ֪YעK^ H˕FbIM*R4Gf̽6LAME?"ϓD,G PSf HLe (Jf=|mD.lTl6ޛ~]&fRZ9hgjSH # N s>Yw;qm4)/ 9d ep*hU)ſ)e#Wӑ@CZSHb~[6!Nbm+SH1Vz""&S#vr: j SHQtW#Ԭ@wɿd*O'Pږ,U:/2"@²+A"LVK :+#jSEtTFsҮ+29oA[ ??w?;鑀 b,SI%sئ!=#sS1e1âLh3 x}RȗGor2 B#b=Yq)Z4TwդGw}6gVE2 *#wtMC&:  {VMI3!2$*avN#"Ir.|CdӐ4t.eE^@$ãGUjsjSHI"l2g?o^ۖ|^)PꖛL4(')0fA# u2d{>ns fMH]LDr2#]~kcט2r8)֢ti&b2F*&vqܙ.O{bSI?]kb2ܢʬ ԙs UnGҿLNj\4^ 3b$YKuڝ#|z{y͚NLQ{ʍ#B.U 8(mkt=*g%'4 baG%Z1P|IMFiҍ*>Tȏ$YopcY+ O bMI'JՉ3)6bv]x9VGE>98ǁ2/͗NEKڸy =YdC K^@MIM)O_aq[Qx‘2NY%` ?j-S*;j(Hscg{ۯocq8j&E{ZHb]4dm($~Qmϓ9VfH$W(jЪgW+ys96@=['0Vrlq5 @LErI [f MHK@**_5z&rfQ.W_Qۣ,6-9iF^f 0JKeksgN[Zpr' Cբ+B cb8MIoW>tu2/Te'w?w-J(;V 3BrgA0ޖ*M~{fS-墌rf_m%Nm|Z SݑJ )^e}!"ЌfȝQ[j=BݴPۜ~5EQy@0gaspLQ6T z,ouRN"I`;I j MH^{w^wH$Daz|DfUPRty֘U%mbDH%z f,hlk^d>lG?\( y?;M&@) P*osh +b0MIhݠ&\r7:1MgDG& =(bJ C[J+e3 f$SHTg+߯?S-tz,%r䩠; mH%[y!`,< {b SIgp|oמtE4DJ;& {Yص CfHa(R ~n n \# |-u6p'zb mVMi+{)cb(SIv"ٙQcyukudA ĈtIV !7!D (w/b-7XnTbS 7[YDs9CO*`a)( fMHk9"N^pd"Ttad6)GSa&єD}ۿ[T1$j qht(b j)qqUUUUUUUUUUUUUUUUUmIISp& bM-Y hFUmHV{ͻ\mE/60#B'e'0`*P* G7̹ kf$SH co_}m3M˂ϲ I0;Mrew_f%#Qb-Y=*W|somy(2hYrU-:+/ܕD!'bDN9OĹR"\A!UO""I`,MDw[jWojQ/09FY DYP>VuWʹ ^0ZG cbMI/NUnZm5`2]j>(0$MmiGM,S\S6bM- Z!U6[}z'8  f$SHc |:Zi?]۩NنH~U)Y) ^$SHLH6e>ez)vPÖZOQŵD 2K1\%r9bٲ#h&bYNW8}9m#0%*,a C(cttneJF(DQX Z MI ;;[e,uzKϽN iRWF& e^+tt bM-Y{|25Mp(*ƻd]bTʙ9jfTv ^M-@BЕ!;t%gtڝQQtAM|Wd4.u0 )j{jSHԿZ$䭘#u++%Q1,0͕%1(u$ [Se8j,ϹRSm-c;ΦYD$ (24NG/?Νu> f$Md yLFakZ"E筍}άGU㖍ꩰX q0bdH [(yMj3( 9 1ϯg.5ư Y @eÐFɊ>k@JSR> bS-;9E?.´QI閁\VEID 57Y~:PH3ABq  j MHfGkțOy%Wڞ贃a5 `ȄHR3PĜ(!")/}ƌfrBb(I'H T'{[ #j(ISfލU#1ME~vRg25 bMIW*B].VugS[߯ʻ:MJ$, I*rAKn DVey b$MI}erެV_wjgA: q֞o F6u!O'ɆUTgm{L5s1jM Nu'_?ٙZVۮ_ϼkafw7\YZ3f$SHT ZfL}wPnʥ&"]GEz& QDmwiAH bMIʪg9A@p( SSQLˎN B*/K4Hfb-4J$qlLy tM:n),u͖$&_Pܚ Ҥd6 UkZh j SHO;2-BWcݳ> b5bHVY͇s)tikd`,K%y b$MIˮUܥ2#n[UK3jA):X<Ӽnog>e4Awo72b|EfDfByc$FH%'ɨ!8;pjZg"̓ Y1U`&7`qJUe_O}ƀdhj HU2UfK5c>ta@"   @9xjoCHV=*#Էc^M. 85QkzyR_~~Z(G(dDk#bNByo}Jj(SH|s)*#|oߠ<(%>k](E*|Y%nl"oɯ" b$MI]i_>7rʽk ۧijP@IXgiff"fOesV {jMH&sKs(-mQ*OALsIiL>H&c ,e767=;jnsGdؓ\`R_ mm?{~0Ipi| Cb(MH90ˣ~r+'ap DD` c; %SvQvMYAbMEvC)Uu5[֤N ]wU57ʖޢ8mj DetqFUWnY3 jSHiSN4W?_i֧b[gFj8muNHvgЙflfh8̣z4tzUq-%U8 V{df Mj?R +bMIcϨ8bF[EFD:Y"i XM'f,ѕ]T5ĻT:X*g3t-&"d& ~z̃%q1{ Cf SH E;6 [?=+9r[A1W :[wG+j Sңu,: q%!i>2Dq+LAME3.98.2UUUUUk:$#L s^SI#'s^ S,x_$Zq8 {[&步15z;MBʌU2n$kj,H;0-RʏWM/.^WߴBkj"Y !R11jgfTj0SH,A!' w-eTqt9̐$y @ 8d0QAaI}jKj(HSB^ee+U? iT "{c.g#J  b SH[ \ufgww,5dhaDX&IP"7ȯ9{+%1 mj ɘa8Sd=Fks!jhKڤvDK(k0B[{Q/bZwX)bIs dG}OnwjWUvR88$\9uH" b'X]|X:j{b-w笿~V].=d4R364IG0(!IaU 1%FN +b MImDvmLnSZ 9PB@9sbA ('hG:SfSL#]Xr~P1)gvg#ךFdi`2 8fɇ Cb MI <"2O型3˟ ?QC^Rxxf+,7Ϣ͡df,bI*f$<םISHFp+*7o%! N$MIӣ5YTj F[%+J"M$߶Z\Ъ\;dDɒб! Lk!Yb^YWr :>ӺxԵ4&Q'C^ GE/.J f MH&}) #2P|Cj&l.]=&@M3,$@p"%>O b SID瑈R%f=5XᆠDWB7'!ڶHgW$*V_bwb3 bI k{-SۓHٺl$Kc\*:!(zJl.Hy"0]IG b(MIn!fCVaw,~.Sl-fX.(xi4\ ^|^re밒r^ZTgBE!QGDLT`ZS4Q ^MI*P18cj+,˨t1 "(()+EAQMDckjH&ISrGpM&${'`}xce& {+͌],}M h sf SHLew>3O;/Y|TrѿJ%FY d5KVMw*W b(ItvK ] }-ZXKZu͡ec$k6LBzl DO*Jw[~vRsnS NcΓ,nFNnLj՝*ȢZ,tP(FGdyZ9#fAlcӄ49~RcAM/XD`M|ř&#-  kb MIf7t{u:{!T!^s) :NE lPmDH ^־kb-?Frj 04eIp"ɖb j)qqUUUUU22+YVuwsBCj,:WpHÑ.ccQ&Y]Wͻj4 j+BBgJ!艌a} ZMImT."&4bysLAME3.98.2UUUUU)ӪjC͍.b(I[G>zil "@G#e+kfq87D[\ttS2Ԏ bXk8;gngoN9Zʶ؂@de)iV8#DCnYOT b7hyT_ߝXwv5?6VgI $L!XZdSfJP  b MIZ)3r]Y~GcɾBJ98cb#Fi9=H5'W{:Laũ{^$I(0 Dhf3IX"s+T=ܑƝ FegQ ,H +jj7Gp$ne<oOyݍ">-<$R)s3s b$SIMD$م FEW/[a듔YY$PWLU<[bSHg!r}7%^fҌi`8'tg*airYm͔$j SQ+7?qi|(F{'R{]e& )jF=b@d$l  Sf MH$R )y\zo&R&A2%DZQͦ*0#HRS7}ib_ 5[j S, ed2݇gFUz_kߘv1Z5~T$mr 3bMIuҋ"SR*\Do_-U41Bduk짝pT ^4MH% )0`f`#"'K2# D$Bz-ҫ@0#(!Y'k|}N;b SId?X3_y O]7Vd8\lv ih,rNr#UsE$3juՙmHj [.fI!I[HGVfm+TC(l&$'IShx%#9 f0>Ri-wћF]PIg$\W.B ] L;ffSH[2 Af!єP37w=P]Jl("4b[Oͭ4`[ Sb$MIEq)<^bt: bV[VĘ HRC9fMt43x#@'Q S0A SLAME3.98.2o_7F>g9$ bMIbJޫx+CSNKz'R`AF..JW+jM-QUHS(ŗ2mpJ8bK(uׁRB[\Hƅd6dTB&F* j MH~{erH`bK׿_UmK7q&('d*ȴ- fTGfgcřsP,7QR7f%*)"6E"&DսhjHyj{ 2 3 _ɾ9dZTEܒA"'Yg`*7?]b #3(V5h;ZR< L-'j:Zosg SfMH92@3N6c#HD>T 'c-B)2j)gͼ9Ieb-Q[ Z.BFS# i$a&c7LAMo_9i 1KfM,wd҆3m&"܎O0nj?&UUU+u:kv3 bM`}CHEn%ks5U*荒jE% cfMH15!VVr['1c DU(. z8VL8dHti]cj 9g,}Lx:bosA3 vtӱ2b j*o{!#GSr CbLGeiw*=Ժ|ݨ7-WI TQjbE  ̴,R284tT j HMHL2R 6J8w~R"eI:L.er( dlPLJ%s;^ S nEGw}2̍uO: 96 YTfŵZz21`2! +F@MIH%(/sWfΣ)14cƒn-#<[Ogav;{5kf,H#J 2bZ d!!ԙ BCRv"6*IL²lɠT.fS-hҀ$ ͛7|Cٹ 46H5)DHqbo%KJAD] fSHX.8}2eϻTmX]kt(3M4KB*2*oveؔve?} f(SJgrJ{O{:#]blZ.Y,SR`ınk$Dk|8 jSHVywSsUj*fʸ-NE 2Ќ^L_2#!Hf$SIĨH1;=WU9d?8RMQ-IfᄄBs2~ Sj$SH^mUguZ-ϖuSnn -yT1ȑ0;gd@('#5TY^ IxOvֱI<9F3G& *=;M#48V j SHXǻ%̛z~q3'mj$,zQh#RIe8ȭVt& 7[f "`&"-< -Hk!&yڳ&FҘꃡcJgڡ矍 fMH٘I yj0c CGؾXN٩dHytnŗ^[b KF<MI{%P2H[kJA6c?w^׍Bjr 'QG'`M͌d4SU+f,\g8d4#otwm> ii$o1]IǞp-CZg{;j SzsqbrŖJzS 0_P::%Ɉ*?.]Wg^b CbSIدr*9O#TrGmQVuU KND- K Eq}|HBԪ[gf 1?皓6]rxI-%8 b#Nb}|T yمotU& +j MHӢb6{JUQݔ!LLAv]yd#d2|e^H0v6jN|Cu j(MH~ C;v[JƷݵDZ֚D!Kdf56wj 5=e2Jf?ͭ*KȲW9сk$G_ʲKt((f%!Y)L' jЅ7o{Ӗtdښu< ZMKjP;lmz3Z*#Pe28HMk_:bS꧒ٝmYGkm "{(%G+6Xꆔ 3\r?m{7v dCb/ZB S^ SI+#.MѯQ~ȧ|? ˴?"g+e*ZsgR@CC@mk 9= [b MI j2 FI}b H] -C7GquI)Ћע fJM{j HE+eG\+g:Q@geZjxQL9Z_}us5jSHWeJSqEm2V._ RG[<6 @"w2GSdE*+bcj ,^amCT]rer勡A<0ܲ!Ug8B^6_\ b$GH2t~|VZY<>` Ff!:Z+UήSb IqtsH-D$%ɺu[v8/̲g$s,c'i FP@BtQcbIzLUUN(g l*H@M-f$H#§ٴ `SZTGXsm PPx,Qdd IšʘԄKw kbMI{ϕ׻>Ru59LKؘ,lWE>L f SHKj=m *IVyGG`%Dtj b$MI';mxֹk"\-r{Fit_E+@q *YU}۳%JrU: cjSH"ބ{}m͇ hSQxdnxfu$)} '!!1 s^$SHdbF|+̖GJRTy0@C((X6$+=Ș [~ +?vSb? "`GgDK?!I\_lj$hJ8)f .4D*7=O6F$zb$SI$cFs$ݓbǭ=J.aQ@8BN`j*¿OÚ'b-/Tr7:hJ&v$j'$EbIULAMEUB D)Cf SHeJ$i?=]DL10Ĕ% tz4X ZLAME3.98fSH.2LAME3.98.2;bQ fMHkmXQHTAG1 Minute of SilenceAnar Software LLCBlank Audioebooklib-0.17.1/samples/08_SMIL/create.py000066400000000000000000000031611341350332300177200ustar00rootroot00000000000000# coding=utf-8 from ebooklib import epub if __name__ == '__main__': book = epub.EpubBook() # add metadata book.set_identifier('sample123456') book.set_title('Sample book') book.set_language('en') book.add_metadata(None, 'meta', 'Naro Narrator', {'property': 'media:narrator'}) book.add_metadata(None, 'meta', '0:10:10.500', {'property': 'media:duration'}) book.add_metadata(None, 'meta', '0:05:00.500', {'property': 'media:duration', 'refines': '#intro_overlay'}) book.add_metadata(None, 'meta', '-epub-media-overlay-active', {'property': 'media:active-class'}) book.add_author('Aleksandar Erkalovic') # intro chapter c1 = epub.EpubHtml(title='Introduction', file_name='intro.xhtml', lang='en', media_overlay='intro_overlay') c1.content=u'

    Introduction

    Introduction paragraph where i explain what is happening.

    ' s1 = epub.EpubSMIL(uid='intro_overlay', file_name='test.smil', content=open('test.smil', 'rt').read()) a1 = epub.EpubItem(file_name='chapter1_audio.mp3', content=open('chapter1_audio.mp3', 'rb').read(), media_type='audio/mpeg') # add chapters to the book book.add_item(c1) book.add_item(s1) book.add_item(a1) book.toc = [epub.Link('intro.xhtml', 'Introduction', 'intro')] # add navigation files book.add_item(epub.EpubNcx()) book.add_item(epub.EpubNav()) # create spine book.spine = ['nav', c1] # create epub file epub.write_epub('test.epub', book, {}) ebooklib-0.17.1/samples/08_SMIL/parse.py000066400000000000000000000010541341350332300175660ustar00rootroot00000000000000import sys import ebooklib from ebooklib import epub from ebooklib.utils import debug book = epub.read_epub(sys.argv[1]) debug(book.metadata) debug(book.spine) debug(book.toc) debug('================================') debug('SMIL') for x in book.get_items_of_type(ebooklib.ITEM_SMIL): debug(x) debug('================================') debug('DOCUMENTS') for x in book.get_items_of_type(ebooklib.ITEM_DOCUMENT): if x.is_chapter(): debug('[{}] media_overlay={}'.format(x, x.media_overlay)) debug('================================') ebooklib-0.17.1/samples/08_SMIL/test.smil000066400000000000000000000007561341350332300177570ustar00rootroot00000000000000 ebooklib-0.17.1/samples/README.md000066400000000000000000000006241341350332300163100ustar00rootroot00000000000000EbookLib Samples ================ * 01_sample_create Create simple EPUB with two chapters and custom CSS for the navigation. * 02_cover_create Same as 01_sample_create but with cover page. * 03_advanced_create Creates EPUB but uses some advanced options from the library. * 04_markdown_parse Simple script which creates static markdown files + images from your EPUB. * 05_plugins_createebooklib-0.17.1/setup.py000066400000000000000000000023531341350332300151000ustar00rootroot00000000000000import io import re from setuptools import setup def read(path): with io.open(path, mode="r", encoding="utf-8") as fd: content = fd.read() # Convert Markdown links to reStructuredText links return re.sub(r"\[([^]]+)\]\(([^)]+)\)", r"`\1 <\2>`_", content) setup( name = 'EbookLib', version = '0.17.1', author = 'Aleksandar Erkalovic', author_email = 'aerkalov@gmail.com', packages = ['ebooklib', 'ebooklib.plugins'], url = 'https://github.com/aerkalov/ebooklib', license = 'GNU Affero General Public License', description = 'Ebook library which can handle EPUB2/EPUB3 and Kindle format', long_description = read('README.md'), keywords = ['ebook', 'epub', 'kindle'], classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Operating System :: OS Independent", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Software Development :: Libraries :: Python Modules" ], install_requires = [ "lxml", "six" ] )