{"id":5147,"date":"2011-03-04T15:14:43","date_gmt":"2011-03-04T07:59:22","guid":{"rendered":""},"modified":"2011-03-04T18:54:00","modified_gmt":"2011-03-04T12:54:00","slug":"epub-validation","status":"publish","type":"post","link":"https:\/\/kk.org\/screenpublishing\/epub-validation\/","title":{"rendered":"EPUB Validation Tools"},"content":{"rendered":"

\"threepress-epub-valid.jpg\"There are several conversion tools that will turn other file-types into an EPUB, but they won’t necessarily give you a valid<\/em> file, that is, a file that strictly follows the IDPF specification<\/a>. This can mean trouble when porting your EPUB to different readers. And even if you build EPUB files by hand, it’s easy to make small mistakes that might hinder readability. <\/p>\n

EpubCheck<\/a> evaluates your file’s container structure and markup, and it also checks for internal reference consistency. It’s an open source project which you can run on your own machine. If you’re not validating EPUBs in bulk for commercial distribution, Threepress Consulting<\/a> graciously hosts a version of the tool, so you can just upload your file there for validation. <\/p>\n

Although the EpubCheck project wiki includes an explanation of common errors<\/a>, it can be difficult to identify exactly what’s causing an error. FlightCrew<\/a> is another open source validation tool, and one of its key features is that its error reports are very specific and clear. But FlightCrew doesn’t completely replace EpubCheck because there are certain errors it doesn’t detect (although it also detects some errors that EpubCheck won’t find). See the author’s introduction<\/a> for an explanation of the differences.<\/p>\n

So, for now anyway, we’re using a two-step validation process. Please let us know if there are other validation tools we should know about.<\/p>\n

Related resources:<\/strong><\/p>\n

Joshua Tallent’s TOC2011 presentation “ePub Finishing Touches: Fixing Errors, Adding Metadata, and Tweaking Formatting<\/a>” [no talk, but his slides are linked from that page]<\/p>\n

MobileRead ePub Forum<\/a> — lots of discussion of error troubleshooting<\/p>\n","protected":false},"excerpt":{"rendered":"

There are several conversion tools that will turn other file-types into an EPUB, but they won’t necessarily give you a valid file, that is, a file that strictly follows the IDPF specification. This can mean trouble when porting your EPUB … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"0","sticky":false,"template":"","format":"standard","meta":[],"categories":[3],"tags":[],"_links":{"self":[{"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/posts\/5147"}],"collection":[{"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/comments?post=5147"}],"version-history":[{"count":0,"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/posts\/5147\/revisions"}],"wp:attachment":[{"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/media?parent=5147"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/categories?post=5147"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kk.org\/screenpublishing\/wp-json\/wp\/v2\/tags?post=5147"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}