iBooks Author: Do not use control characters in filenames

Carriage returns and other control characters in filenames will prevent your books from being published on the iBooks Store.

When you add content (such as HTML widgets) to your iBooks Author books, make sure none of the files contained in the bundle include control characters (such as carriage returns) in the filenames. If such files are included, you won't be able to publish your book to the iBooks Store.

Note: Folders with custom icons sometimes include invisible files whose filenames contain control characters. For this reason, avoid using custom folder icons.

If, for example, you have downloaded an HTML widget from the web, and have modified it to use within your book, in addition to removing control characters from any filenames within the bundle, you will need to make sure that references to those files within the bundle have been corrected so that your HTML widget will function properly.

While HTML widgets are most likely to contain files that include control characters in the names, this may occur with files included in Collada packages or Keynote presentations as well.

Additional Information

Learn more about creating HTML widgets for use with iBooks Author.

Important: Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. Apple assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. Apple provides this only as a convenience to our users. Apple has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and Apple assumes no responsibility in this regard. Please understand that a third-party site is independent from Apple and that Apple has no control over the content on that website. Please contact the vendor for additional information.
Last Modified: Aug 14, 2013
  • Last Modified: Aug 14, 2013
  • Article: HT5471
  • Views:


Additional Product Support Information

Start a Discussion
in Apple Support Communities
See all questions on this article See all questions I have asked