Connexions EPUB3 Library
Library for parsing and building EPUB3 files for connexions content.
Getting started
Tested on Ubuntu 18.04, packages needed: sudo apt install build-essential python-dev python3-dev libicu-dev python3-venv
Optional (Python3 virtualenv):
python3 -m venv env source env/bin/activate pip install -U pip setuptools
To install:
pip install git+https://github.com/openstax/cnx-cssselect2.git#egg=cnx-cssselect2 python setup.py install
Running tests
Either of the following will work:
python setup.py test python -m unittest discover
Format notes
Order of documents
To enforcing order of contents, we use the navigation document rather than
the Open Packaging Format (OPF),
which supports a spine
element that aids in epub reader in navigation order.
The Connexions library does not use the spine for order.
A navigation document is the authority on order of contents
and which contents are document like.
Anything not included in the navigation document is considered a resource.
Document encapsulation
Collections are easy because they will be sent across as individual OPF entries that contain the collection tree as navigation documents. In the case of publishing module documents without a collection, the navigation document will be flagged as a non-document item.
License
This software is subject to the provisions of the GNU Affero General Public License Version 3.0 (AGPL). See license.txt for details. Copyright (c) 2013 Rice University