Skip to content
Branch: master
Go to file
This branch is 6 commits ahead of callowayproject:master.

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

ePub Creator

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.

What's Different?

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

Detailed Documentation

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.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")

Just drop the epub/ folder into your Django app, and remember to add it to your INSTALLED_APPS as 'yourappname.epub'.


Generate ePub documents using Django




No releases published
You can’t perform that action at this time.