Org mode epub export
Emacs Lisp
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
sample
.gitignore
.travis.yml
CODE_OF_CONDUCT.md
COPYING
ISSUE_TEMPLATE.md
README.org
ox-epub.el

README.org

https://travis-ci.org/ofosos/ox-epub.svg?branch=master http://stable.melpa.org/packages/ox-epub-badge.svg

ox-epub

Generate .epub files directly from OrgMode. This will export EPUB version 2, which should give broad compatibility. It should also be relatiely easy to convert the resulting .epub to a .mobi (Kindle).

Prerequisites

This depends on Emacs 24.3 and OrgMode 9, it won’t work on OrgMode 8 or any version of Emacs before 24.3.

You will also need a working version of the zip utility.

Installation

If you have MELPA stable activated, it is as simple as this:

M-x package-install RET ox-epub RET

Usage

See the sample directory for a sample of what ox-epub can do.

Hit C-c C-e E e to publish the current buffer to an EPUB.

There are some required export options that need to be set. These are

  • UID a unique id of the document, otherwise known as uri, may be a url
  • DATE the date of the document, for valid values see https://www.w3.org/TR/NOTE-datetime
  • AUTHOR the document author or editor, the creator in the EPUB spec
  • TITLE the document title

Furthermore there are some properties which are optional:

  • Subject the subject matter of the book
  • Description a description of the book
  • Publisher the publisher of the book
  • License the rights associated with this book, the copyright notice and further rights may be included in this option.

The only other option that is exported:

  • LANGUAGE the language of the book, this is to be interpreted according to RFC3066 or it’s succeeding documents https://www.ietf.org/rfc/rfc3066.txt, no other interpretations are allowed according to the EPUB spec.

Features

Currently ox-epub can do the following:

  • simple cover images
  • inclusion of png and jpg images
  • export of mathematical formulas
  • direct .epub generation
  • add stylesheets to your liking: Use the EPUBSTYLE property to add a list of stylesheets and customize html-head-include-default-style to toggle inclusion of the default stylesheet.

Caveats

  • Mathematical formulas only export well if you use the dvipng backend. dvipng should be included in TeXlive.