https://github.com/mattharrison/rst2epub2
convert rst to epub
https://github.com/mattharrison/rst2epub2
Last synced: 9 months ago
JSON representation
convert rst to epub
- Host: GitHub
- URL: https://github.com/mattharrison/rst2epub2
- Owner: mattharrison
- Created: 2011-08-08T11:56:44.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2020-08-12T19:16:43.000Z (over 5 years ago)
- Last Synced: 2025-04-17T15:49:14.140Z (11 months ago)
- Language: Python
- Homepage:
- Size: 179 KB
- Stars: 74
- Watchers: 7
- Forks: 13
- Open Issues: 7
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
- my-awesome-github-stars - mattharrison/rst2epub2 - convert rst to epub (Python)
README
rst2epub2
===============
This code consists of two tools:
* a binary, ``rst2epub``, to convert rst files into epub2 compliant
files (ie that pass epub check, can be loaded into Apple, BN, Kobo,
etc. Or converted to mobi and thrown into AMZN)
* a library, ``epublib``, that has the ability to programatically
create epub files. See the ``test`` function in ``epublib/epub.py``
for more details. There is experimental support for KF8 fixed layout
as well.
Install
============
running::
make dev
will create a virtualenv in ``env``. The ``rst2epub.py`` binary will be
located in the ``env/bin/`` directory.
Known to work on linux systems. (Should work on apple, cygwin, MS with
some futzing).
Docs
======
There are a few rst tweaks to support features such as metadata. See
the sample doc for examples of a complete book and how to generate
both epub and mobi files.
Feel free to interact via github for support.
Thanks
========
timtambin@gmail.com wrote the original epublib and hosted it on google
code. I've tweaked (pep8'd) it and imported into github.