EPUB

The following are issues that might occur when generating EPUB output with Flare.

Firefox EPUBReader Displays Incorrectly

Problem

Dynamic content displays incorrectly in Firefox EPUBReader.

Cause

This issue can occur if Javascript is not enabled in Firefox EPUBReader.

Solution

You must enable Javascript in EPUBReader. To do this, perform the following steps.

  1. In Firefox EPUBReader, open a book.
  2. Click the Preferences button.
  3. Click the Miscellaneous tab.
  4. Select the Javascript enabled check box.
  5. Click OK.

MOBI Files Displayed Incorrectly

Problem

Dynamic content displays incorrectly in MBI files.

Cause

Dynamic content is not supported in MOBI files.

Solution

To generate valid MOBI output, you must create another EPUB target with dynamic content disabled.

Multimedia Files Do Not Play

Problem

Multimedia files do not play in browser based e-readers.

Cause

This issue can occur if you are trying to view certain media types, such as Windows Media, Shockwave Flash YouTube/Vimeo, or remote videos. This is because EPUB 3 only supports specific media types, and not all e-readers can properly render them.

Solution

Convert your audio an MP3, and use HTML5 videos with H.264 compression. If the media still does not play, you may need to try a different e-reader.

Text Gets Cut Off

Problem

Opening drop-downs, togglers, or expanding text causes text to get cut off.

Cause

This issue can occur if you are using an e-reader that creates a fixed layout. This is common in web-based e-readers.

Solution

Resize the window to accomodate the text you are viewing.

Poor Performance

Problem

Performance issues with EPUB output.

Cause

This issue can occur if you have a large project with many topics, but there are no chapter or page breaks throughout. As a result, the EPUB output consists of one long file, instead of several smaller ones. A single long file can result in performance issues, both in generating the output and navigating from page to page.

Solution

Make sure that you have page breaks on heading styles. See Setting Page Breaks and Column Breaks. You can also specify chapter breaks in the TOC. See Specifying Chapter and Page Layout Breaks.