Threepress Consulting blog » epubcheck http://blog.threepress.org Threepress creates software for publishers, educators and authors. Tue, 27 Jul 2010 16:34:57 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 Quick ePub check http://blog.threepress.org/2009/01/19/quick-epub-check/ http://blog.threepress.org/2009/01/19/quick-epub-check/#comments Mon, 19 Jan 2009 16:36:44 +0000 Liza Daly http://blog.threepress.org/?p=267 If you’re producing ePub files, take the time to ask yourself two simple questions:

  1. Are all the files I listed in the OPF file actually in the ePub archive?
  2. Are all the files in the archive in the OPF file?

The OPF file is meant to be the canonical listing of all resources in your ePub.  If it’s in the ZIP but not in the OPF, reading systems are required to ignore it.  Likewise, including an entry in the OPF but not including the actual file (or putting it in the wrong folder) is also an error.

Bookworm used to reject ePubs which failed the first case, but I saw so many bad files (usually missing CSS or images) that it now simply ignores the error.

However, I sometimes also see case #2, where the OPF file is missing resources (again, frequently CSS and images).  For example, these ePubs from Hindawi Publishing Company make admirable use of SVG, but none of their SVG files are in the OPF.  Bookworm can’t find them and therefore can’t display them.

EpubCheck does flag both of these cases with the following errors:

  1. Case 1, where the file is declared in OPF but not in the archive:  resource ‘XXXX.html’ is missing
  2. Case 2, where the file is in the archive but is missing from the OPF: referenced resource exists, but not declared in the OPF file

Other explanations for error messages from EpubCheck.

]]> http://blog.threepress.org/2009/01/19/quick-epub-check/feed/ 1 epubcheck service now updated to use version 1.0.0 http://blog.threepress.org/2008/09/08/epubcheck-service-now-updated-to-use-version-100/ http://blog.threepress.org/2008/09/08/epubcheck-service-now-updated-to-use-version-100/#comments Mon, 08 Sep 2008 16:03:51 +0000 Liza Daly http://blog.threepress.org/?p=42 The web-based method to validate ePub files against epubcheck has been updated to use epubcheck version 1.0.0, the first official release.

Additionally, the tei2epub library which bundles epubcheck has also been updated to include 1.0.0.

]]> http://blog.threepress.org/2008/09/08/epubcheck-service-now-updated-to-use-version-100/feed/ 0 ‘Tools’ section added, first tool is web-based epubcheck http://blog.threepress.org/2008/05/26/tools-section-added-first-tool-is-web-based-epubcheck/ http://blog.threepress.org/2008/05/26/tools-section-added-first-tool-is-web-based-epubcheck/#comments Mon, 26 May 2008 20:44:24 +0000 Liza Daly http://blog.threepress.org/?p=10 For one-off checks or use by non-developers, there is now a web front-end for the valuable epubcheck validation tool.

Uploaded files are run through the validator and any error messages are reported. The error report includes some notes to help decipher the sometimes-cryptic messages (notes are taken from the epubcheck wiki).

epub files are deleted immediately after validation, but take care not to upload any proprietary or sensitive documents. This tool provides no guarantees that any information it receives is secure.

The tool is running epubcheck version 0.9.5.  It is planned that the front-end will track updates of the epubcheck library.

]]> http://blog.threepress.org/2008/05/26/tools-section-added-first-tool-is-web-based-epubcheck/feed/ 0