ePub Creator is a Django app originally written by Corey Oordt from the Washington Times. This fork is a maintained update of that app, for use with the Pandamian code base.
A couple of things:
- Updated template encoding to 'UTF-8', as per EPUB2.01 specs
- Updated epubcheck to 1.2
- Fixed an issue for when an author has only one name
- Fixed an issue for handling of entity conversion
- Added a templates section to docs
- Reorganized documentation so you won't need to use Sphinx to build
Corey has provided comprehensive documentation with the original version of ePub Creator. I've done some reorganization: the generated html docs are in documentation/; the Sphinx build files are available in docs_source/. (This way if you're lazy you won't have to install Sphinx to build documentation)
I've also added a section on Templates, which Corey left blank.
Generating an ePub with ePub creator is fairly simple. Here's an example taken from Pandamian:
from appname.epub.models import EPub
final_path = os.path.join(temp_dir, "book.epub")
e = EPub()
e.metadata.title = book.title
e.metadata.add_creator(book.author)
e.metadata.description = book.description
e.metadata.publisher = 'Pandamian'
e.metadata.language = 'en-US'
#images, to be added later
#e.add_image(img_path, name='logo.svg')
s = Entry.objects.filter(book=bookObj, status=1)
for entry in s:
e.add_entry(entry.title, entry, entry.slug+".html")
e.generate_epub(final_path)Just drop the epub/ folder into your Django app, and remember to add it to your INSTALLED_APPS as 'yourappname.epub'.