Joho the BlogGetting EPub wrong every possible way - Joho the Blog

Getting EPub wrong every possible way

I spent too much of yesterday and today trying to placate EPub, the God of Finickiness.

EPub (which the creators would prefer I spelled EPUB, but I figure there’s no need to shout) is the ebook format that iPad and many other readers like. I have a young adult novel that I give away in html, pdf, and Word .doc, but I figured I should modernize it up to the EPub standard.

First, I converted all 26 chapters to XHTML. XHTML is HTML’s obsessive-compulsive younger brother. The sloppiness that made HTML a success — you could sling together code of the ugliest sort and browsers would still display it for you with red blush and lipstick — drives XHTML nuts. So, you’d better close every tag and make sure you don’t start any of your inner ID tags with a number. The W3C has a useful validator that will tell you every thing you’re doing wrong. (Under options, turn on “Show source” and it will show you your original text with the mistakes flagged.)

I downloaded a bunch of automatic EPub creators, many of them listed at JediSabre, but I couldn’t get any of them to do what I wanted. A lot of people really like Calibre, which does much more than just compile EPub files, but I couldn’t figure out how to get it to treat 26 chapters as one book; dumb of me, I know, but I didn’t see that basic point covered in the documentation, and I was too embarrassed to ask it in the user forum where the creator generously responds.

I also tried eCub. I couldn’t remember why I gave up on it, so I just now tried it again, and of course it worked perfectly. Instantly. Easily. Dammit! It must have been something wrong in the XHTML files that I fixed after I’d given up on it.

I also tried Sigil, which is quite full-featured, but it kept crashing before making it through all 26 chapters, very likely because of the same irregularities in those files. So, try the automated systems before you venture down the hand-coding path.

I spent many hours with TextWrangler — a text editor that can do search and replace across multiple files is a requirement if you’re going to end up doing this somewhat by hand. EPub files are actually zip files, and, astoundingly, the files in them have to be in the proper order. Why ebooks are too dumb to be able to randomly access the contents of a zip file is beyond me, but then, so is using an easy-to-use EPub compiler. So, you need to download a sample (I used Sigil to create one), unzip it, put in your content, and zip it back up. WebVivant tells us the three magic command-line commands to get the zip file to rezip itself correctly. I did that dozens of times today. Now it’s time to test the resulting file…

ThreePress has an online EPub validator that shows you what you did wrong this time. Very helpful, although the error messages can be a bit cryptic, mainly because there are so many freaking ways to go wrong.

If you need to handcode how to get your EPub to display your cover, here’s a very helpful step-by-step guide to cover markup, by Keith Fahlgren at ThreePress.

The upshot? Make sure your XHTML is valid, and that your id values do not begin with numerals, and then try the automated systems. The one’s I’ve mentioned are free. (Thank you!) (Bowerbird posted a comment to my earlier post about EPub about a system Bowerbird is developing that outputs lots of book/document formats.) If you find yourself preparing or tweaking it by hand, expect to spend some time at it.

The upshot’s upshot? I spent a day creating a crappy version of my YA adult in EPub format that I’m not even sure works beyond with Wordplayer on my Droid. If you care to try it and let me know if it works on your device or software ebook, let me know? (You can get the pdf and .doc versions here, and here’s Bowerbird’s epub version.)

78 Responses to “Getting EPub wrong every possible way”

  1. You’re right than ePub is picky about the ordering of the files inside the ZIP container, but it turns out that it *only* worries about the first file (‘mimetype’) and ignores all the rest. Justified or not, it works this way so that software can quickly sniff the first bit of the whole ZIP to see if it smells epubby or not (starts with ‘application/epub+zip’).

  2. […] full post on epub – Google Blog Search Share and […]

  3. Keith, thanks for the info. And thanks for the post I linked to about how to get a cover inserted; that post really helped.

  4. Opened ok for me

  5. Hi David

    In case you were not aware, there’s the MobileRead Wiki which has a conversion software section you might find helpful

    Also there’s the TeleRead ebook blog you might find helpful as well:

  6. Joho the Blog » Getting EPub wrong every possible way…

    Joho the Blog » Getting EPub wrong every possible way…

  7. direct conversion to any format does not give 100% accuracy it needs some manual edits also, I have got my books converted from they are experts

  8. It’s an remarkable article designed for all the web viewers; they will take benefit from it I am sure.

  9. This article presents clear idea for the new users of blogging, that truly how to do blogging.

    Also visit my web page – Easy Money Hard to Kill Télécharger

  10. Thank you for the auspicious writeup. It in truth was a leisure account it.

    Look complicated to more added agreeable from you! By the way, how
    can we be in contact?

    my homepage … Un Voyage Film Télécharger

  11. Hi to every body, it’s my first visit of this blog; this
    weblog contains awesome and truly excellent information designed for readers.

    Also visit my blog post: Supercondriaque Film Télécharger

  12. Pretty! This was an incredibly wonderful post. Thanks for supplying these details.

    Feel free to surf to my blog post … hybrid bike reviews

  13. hello!,I really like your writing very a lot!
    percentage we keep in touch extra about your article on AOL?
    I require an expert on this area to unravel my problem.
    Maybe that is you! Looking forward to see you.

    My homepage la vie rêvée de walter mitty télécharger

  14. Write more, thats all I have to say. Literally,
    it seems as though you relied on the video to make your point.
    You definitely know what youre talking about, why
    waste your intelligence on just posting videos to your weblog
    when you could be giving us something enlightening to read?

    Stop by my website: télécharger homefront

  15. Thanks for one’s marvelous posting! I actually enjoyed reading it, you’re a great author.

    I will make certain to bookmark your blog and will often come back
    from now on. I want to encourage one to continue
    your great writing, have a nice day!

    my blog post – télécharger jack et la mécanique du coeur

  16. When I originally commented I clicked the “Notify me when new comments are added” checkbox
    and now each time a comment is added I get four emails with the same comment.
    Is there any way you can remove people from that service? Appreciate it!

    My site … télécharger le vent se lève

  17. This is the right website for anyone who wishes to find out about this topic.
    You understand a whole lot its almost tough to argue with you (not that I really will need to…HaHa).
    You certainly put a fresh spin on a topic which has been written about for
    decades. Excellent stuff, just great!

    Here is my weblog … de guerre lasse streaming

  18. Amazing! This blog looks exactly like my old one! It’s on
    a completely different subject but it has pretty much the
    same page layout and design. Great choice of colors!

    Feel free to visit my web site 100 cachemire télécharger

  19. Excellent beat ! I wish to apprentice while you amend your website,
    how can i subscribe for a blog website? The account helped me a acceptable deal.

    I had been a little bit acquainted of this your broadcast
    offered bright clear idea

    Here is my site; belle et sébastien télécharger

  20. WOW just what I was looking for. Came here by
    searching for pompéi télécharger

    Here is my homepage – pompéi film

  21. I am regular visitor, how are you everybody?
    This article posted at this web site is actually pleasant.

  22. Hey there, your site is really good. I really do appreciate you sharing informative posts.

    Also visit my web blog … acne cure [Forrest]

  23. Good day! I know this is kinda off topic but I was wondering if
    you knew where I could locate a captcha plugin for my
    comment form? I’m using the same blog platform as yours and
    I’m having problems finding one? Thanks a lot!

  24. Howdy! I’m at work surfing around your blog from my new iphone!
    Just wanted to say I love reading your blog and look forward to all your posts!

    Carry on the superb work!

  25. Everything is very open with a really clear clarification of the
    challenges. It was really informative. Your website is very useful.
    Thank you for sharing!

  26. Valuable info. Lucky me I discoverd your web sitte
    accidentally, and I am shocked why thjs coincidence ddid not
    came about in advance! I bookmarked it.

    Visit my webpage; frenchy’s oasis motel at clearwater beach

  27. Never ever heard of a steam shower enclosure until I came upon this site, so happy I did want to have one
    now and finances letting will be purchasing one soon enough

    my page :: steam showers uk (Reginald)

  28. You can definitely see your expertise in the article
    you write. The sector hopes for more passxionate writers like you
    who are not afraid to mention how they believe.
    At all times ggo after your heart.

    Also visit my blog :: top hair care products for natural hair

  29. I have been browsing online more than 3 hours nowadays,
    but I never found any interesting article like yours.
    It’s pretty worth enough for me. Personally, if all webmasters
    and bloggers made good content as you did, the internet can be
    a lot more useful than ever before.

  30. Many times guests are assigned a certain time in
    the daily activity of baby. ? If the soon to-be-parents are expecting twins,
    then implementing the mirror image idea for centerpieces will work just fine.
    Diaper cakes are also a great way to promote environmentalism because
    you can use organic cloth diapers to make your diaper cake.

    Feel free to surf to my weblog: free easy baby shower appetizer recipes (Aleisha)

  31. It has been established, that in terms of the tablet gadgets, i –
    Pad was the first one who was able to introduce and triggered the competition.
    Applying the groundbreaking from-the-inside-out approach
    that made Organizing from the Inside Out a New York Times bestseller,
    Julie Morgenstern set a new standard for the time- management category.
    The program contains exercises, information, and anecdotes to help you change unhealthful emotions like anger, depression, anxiety, and perfectionism.
    Despite being a retail site, it should be treated
    as a search engine from an online marketing standpoint.
    The Samsung PN59D8000 is a 59-inch 3D plasma HDTV that has fantastic picture quality and
    very deep black levels.

  32. Great blog here! Also your website loads up very fast!
    What host are you the use of? Can I am getting your associate
    link for your host? I want my website loaded up as quickly as yours lol

    Also visit my page; best biometric gun safe

  33. I was wondering if you ever considered changing the
    layout of your website? Its very well written; I love what youve got
    to say. But maybe you could a little more in the way of content so people could connect with it better.
    Youve got an awful lot of text for only having 1 or 2 images.
    Maybe you could space it out better?

    my blog; fruit ninja cheats (

  34. ” published in 2007 by avipesqueta This barracuda fishing video looks a like a battle supreme. Catchers gear is used to protect you from the impact of a ball or any injuries. Look for a place where the soil is loose or find an ant hill.

    Look at my web blog; descargar atube catcher (Whitney)

  35. Have you ever considered publishing an ebook or
    guest authoring on other sites? I have a blog based upon on the same subjects you discuss and would love to have you share some stories/information. I know my viewers would
    enjoy your work. If you are even remotely interested, feel free
    to send me an e mail.

  36. I have been absent for a while, but now I remember why I used to
    love this blog. Thanks , I will try and check back more often. How frequently you update
    your site?

  37. What’s Taking place i’m new to this, I stumbled upon this I’ve
    discovered It positively useful and it has aided me out loads.
    I am hoping to give a contribution & help other users like its helped me.

    Great job.

    My website – Une Rencontre Télécharger

  38. Good article. I will be going through some of these issues as

  39. This web site definitely has all the information and facts I
    wanted concerning this subject and didn’t know
    who to ask.

  40. Este es un tema es cerca Muchas gracias Exactamente dónde son sus datos de contacto , aunque?

  41. You will want to purchase a plan at the very best selling
    price that is available to you. It essential to respect and observe this
    sort of policies. It was seemingly in the agreement on web
    page 11840.

    Review my page; Women Car Insurance [http://Www.Articlesnatch.Com/]

  42. There are several reasons of indoor pollution, and the EPA Environmental Protection agencies offer advice and a
    list of the predominant pollen. Child powder could
    be a combination of pushing and tapping to completely fill the halves.
    That would already include the investigation, laboratory costs and even the wooden frame
    of a home, you should be careful to protect yourself.
    Since that time, however, has a white border to
    it and its spores can stick to these surfaces.
    Now, take the time to fix mold x fogger the problem.

  43. I read this article fully regarding the resemblance of most recent and preceding technologies, it’s remarkable article.

  44. In short one should prefer a design that makes him feel comfortable while wearing and that will look fashionable on him.
    It’s Google’s new Nexus 7, the next generation of perhaps the most popular Android tablet
    ever. And undeniably, you can enjoy the best driving
    and travelling experience ever even in the midst of a heavy traffic.

  45. Nice post. I learn something new and challenging on websites I stumbleupon
    everyday. It’s always useful to read articles from other writers and use a little something from their web sites.

  46. It’s very simple to find out anyy topic on web as
    compared to books, as I found this article at this web page.

    Take a look at my site: pc games

  47. Wow, that’s what I was seeking for, what a data!
    existing here at this website, thanks admin of this web page.

    Also visit my site – beetleheaded (

  48. Howdy! Do you use Twitter? I’d like too follow you if thazt would bee okay.
    I’m definitely enjoying your blog and look forward to new updates.

  49. What’s up colleagues, how is everything, and what you would like to say
    regarding this article, in my view its actually awesome
    for me.

  50. I do not even know how I ended up right here, however I thought this submit used to be
    great. I don’t know who you might be however certainly you are going to a famous blogger for those who
    are not already. Cheers!

  51. I love porn! I watch it every week.

  52. Áo Khoác Nam D? Th??ng Cá Tính

  53. Hey very nide website!! Man .. Excellent .. Wonderful
    .. I’ll bookmark your site aand take the feeds additionally?
    I’m satisfied to search out a lot oof helpful information right here in the submit, we want work out more techniques on this
    regard, thank you for sharing. . . . . .

  54. I will supply some concepts for how to decrease your signs and symptoms later
    on in this assessment but permit me make clear a bit a lot more of what it particularly is.
    Co2 laser surgery, which involves skin grafting, is normally considered a final resort if you are at the highest point with
    this problem. Antibiotics might be used to treat the infection and might prevent
    the condition from getting worse.

    Take a look at my homepage: what is hs disease (

  55. you’re really a excellent webmaster. The site loading pace is amazing.
    It seems that you are doing any unique trick.

    Furthermore, The contents are masterpiece. you have done a
    wonderful job on this matter!

  56. If you have taken the time to study a good
    affiliate marketing tutorial and you have researched your keywords and niche market, now is the time
    to get your affiliate link and start promoting the heck out of it.
    This article is about generating sales with articles.
    You can run one or more marketing campaign to get the buyers like:.

  57. Building a chicken coop doesn’t have to be an elaborate process.

    They are basically skin rashes which are caused by varicella zoster virus (VZV).
    These shingles are usually superb insulators and some advanced ones provide a cooler inside in
    the summer months and a warmer inside during harsh winters.

    Here is my website :: shingles medication (

  58. Attractive section of content. I just stumbled upon your web site and in accession capital to assert that I acquire in fact enjoyed account your blog posts.
    Any way I’ll be subscribing to your augment and even I achievement you access consistently quickly.

  59. The natural web customer possesses a remarkably short window
    of curiosity, this is certainly specifically why you will need an excellent web site.

    Before diving into the world of web development, get in terms with jargons of the industry
    and there is much more to consider than determining price. Handcoders can be
    used for more involved projects that require PHP, ASP
    or Custom CMS Development or actual programming.

    My page – Jacksonville Sunshine State Website Design

  60. Thanks a lot for sharing this with all people you actually recognise what you are speaking about!
    Bookmarked. Please additionally discuss with my site
    =). We could have a hyperlink trade agreement between us

    Here is my website; Wildstar Free Download Pc

  61. new port richey consulting firm

    Joho the Blog » Getting EPub wrong every possible way

  62. speaking of

    Joho the Blog » Getting EPub wrong every possible way

  63. Liability Insurance

    Joho the Blog » Getting EPub wrong every possible way

  64. click here for more info

    Joho the Blog » Getting EPub wrong every possible way

  65. Personal Injury Claim

    Joho the Blog » Getting EPub wrong every possible way


    Joho the Blog » Getting EPub wrong every possible way

  67. Knowledge sharing

    Joho the Blog » Getting EPub wrong every possible way

  68. KS

    Joho the Blog » Getting EPub wrong every possible way

  69. Victorinox lommekniv – Hercules

    Joho the Blog » Getting EPub wrong every possible way

  70. rich dad poor dad book download

    Joho the Blog » Getting EPub wrong every possible way

  71. dumpster rental in montgomery al

    Joho the Blog » Getting EPub wrong every possible way

  72. canada goose bomber jacket ebay

    Joho the Blog » Getting EPub wrong every possible way

  73. visit the next website

    Joho the Blog » Getting EPub wrong every possible way

  74. ultimas noticias

    Joho the Blog » Getting EPub wrong every possible way

  75. metformin weight loss diabetes

    Joho the BlogGetting EPub wrong every possible way – Joho the Blog

  76. types of leukemia

    Joho the BlogGetting EPub wrong every possible way – Joho the Blog

  77. […] been doing some quotes with Admiral for £465 however the results have been advised that if he alters his license to a UK license he must wait 6 months before he […]

  78. black friday virgin mobile iphone deals

    Joho the BlogGetting EPub wrong every possible way – Joho the Blog

Web Joho only

Comments (RSS).  RSS icon