1 vote

Epub Reader

Note: v8.0.1 of this plugin is for Umbarco v8.1+; v0.1.1 is for Umbraco v7.7+

This plugin allows you to display readable versions of (non-DRM) Epub books, navigable via the internal chapters, on your Umbraco site. The Epub file format is basically a .zip archive with embeded html, css, font & image files.

Using the provided example 'Book' & 'Books' Document Types and Templates (included in the installable package - not the nuget package) and Setup (see 'Setting Up' below), you can view/read your epub books by simply navigating to:

'/books' to view a list of all your books
'/books/{NAME OF BOOK}' to see the book info page. This page uses the 'Body Text' and 'Book Cover Image' from the related 'Book' content node.
'/books/{NAME OF BOOK}/read' to actually read the book. This page (which uses the view: /Views/UmbEpubReader_Read.cshtml) displays the 'Book' node Cover Image as well as the actual epub chapter content and Table of Contents. This View can be ammended as needed.

Epub books have embeded files such as images and fonts, and the plugin allows these file to be served/accessed via custom book routing i.e. /books/{NAME OF BOOK}/read/images/cover.jpg. Embeded book css styles are added automatically to the outputted html to speed up rendering.

Please note this plugin has been developed for a specific project and as such may not provided an exhaustive list of functionality or deal with all possible eventualities when encountering different epub books. You can, however, use the plugin source code as a basis for your own requirements.

This documentation/plugin assumes your site already has a basic setup e.g a Homepage Doc type and Master template or 'Umbraco Starter Kit' or similar has been installed.

Full documentation url: https://github.com/willroscoe/UmbEpubReader