GitHub - ofosos/ox-epub: Org mode epub export
source link: https://github.com/ofosos/ox-epub
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.org
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 urlDATE
the date of the document, for valid values see https://www.w3.org/TR/NOTE-datetimeAUTHOR
the document author or editor, the creator in the EPUB specTITLE
the document title
Furthermore there are some properties which are optional:
Subject
the subject matter of the bookDescription
a description of the bookPublisher
the publisher of the bookLicense
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.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK