Robert Haines
BSD (See Licence file or www.opensource.org/licenses/bsd-license.php)
© 2013 The University of Manchester, UK
This is a Ruby library for working with UCF documents. See the specification for more details. UCF is a type of EPUB and very similar to the EPUB Open Container Format (OCF).
This library is a work in progress! Until we release version 1.0.0 you can expect the API to change in incompatible ways, although we will try to keep this to an absolute minimum. Once version 1.0.0 is released we will be following the principles of Semantic Versioning for our version numbering scheme.
Most of this library’s API is provided by the underlying zip-container gem so you will need to consult that documentation as well in addition to this.
There are some examples of how to use the library provided in the examples directory. See the contents of the tests directory for even more.
The basic requirements of a UCF document are all implemented but there are a number of optional features that are not yet provided.
Memory resident UCF documents. Presently all operations are performed on documents that are resident on disk as the underlying rubyzip library currently cannot do anything else.
Validation of file contents in the META-INF directory. Most of the machinery for this has been implemented but files are not validated against the schema yet.
Digital signatures (this feature has been deferred until a future revision of the UCF specification. It will be supported by this gem when it is added to the specification).
Encryption (this feature has been deferred until a future revision of the UCF specification. It will be supported by this gem when it is added to the specification).