Troubleshooting EPUB Issues

Following are issues that may occur when generating EPUB output with Flare.

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.

Dynamic content displays incorrectly in MOBI 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. See Specifying EPUB Options.

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, which not all e-readers can properly render.

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.

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 accommodate the text you are viewing.

Performance issues

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 and Column Breaks.

You can also specify chapter breaks in the TOC. See Specifying Chapter and Page Layout Breaks.