Possible replacement for EPUBCHECK - Page 12

Kayadelenium · Yesterday, 06:43 PM

epubveri 0.9.12

JSWolf — thank you for the two logs. The column number you mentioned was the smallest thing in them; the interesting part was the error count.

Your file: 21 fatals from both tools, then 96 errors from me against EPUBCheck's 127. That gap splits cleanly:

27 of them are inside the 21 documents that do not parse at all. EPUBCheck reads with a streaming parser, so it validates the <html> start tag on line 2 long before it reaches the unclosed <body> at the end of the file. I build a document tree, and a file that fails to parse gives me no tree to check. That is a real difference and not one I can close cheaply, so I am recording it rather than claiming otherwise.
4 were role on <img> — and that turned out to be five elements, not one. img, area, iframe, param and script were all quietly taking the EPUB 3 attribute set in an EPUB 2 book, so they escaped every EPUB 2 tightening of the last week. Rather than fix the one you found, I walked the grammar from the EPUB 2 root and listed everything that pulled in the wrong set; a test now asserts that nothing can, so the next one fails at build time instead of arriving as a forum post.

Chasing your report also made me sharpen the comparison I run against EPUBCheck over a shelf of real books: it compared which messages each tool reports, never how many. Your file is precisely the case that hides in — the message IDs agreed while the totals differed by 31.

With counting turned on, one book showed 7 errors from me against 79 from EPUBCheck. Two causes, both mine:

alt is required on <img> in XHTML 1.1 and optional in HTML5 — one of the few places EPUB 2 is the stricter version. I had it optional in both.
More seriously, a missing required attribute stopped me checking the rest of that file. One <img> without alt silenced everything after it. That book has 72 of them; EPUBCheck reports 73, I was reporting 2.

That book now matches EPUBCheck exactly, 82 to 82. Ten books on the shelf gained findings, all still at or below EPUBCheck's count, and six of them now match it exactly.

One thing I could use from you: lines 94 and 217 of that style.css, if you still have it. Two CSS differences are left and I cannot reproduce either from the log alone — one of them may well be EPUBCheck being stricter than the CSS specification rather than me being wrong, and I would rather know than guess.

Downloads (8 platforms): https://github.com/veripublica/epubveri/releases
Try it in the browser: https://veripublica.github.io/epubveri/

JSWolf · Today, 09:53 AM

Quote:

Originally Posted by Kayadelenium

One thing I could use from you: lines 94 and 217 of that style.css, if you still have it. Two CSS differences are left and I cannot reproduce either from the log alone — one of them may well be EPUBCheck being stricter than the CSS specification rather than me being wrong, and I would rather know than guess.

Downloads (8 platforms): https://github.com/veripublica/epubveri/releases
Try it in the browser: https://veripublica.github.io/epubveri/

I don't have the ePub as it was when I ran the error checks. However, I do remember the errors in the CSS. One line had ; instead of : and the other ended in ;; instead of ;.

Doitsu · Today, 10:40 AM

@Kayadelenium:

epubveri reports 3 errors for this very old IDPF epub3 sample book, however EPUBCheck reports only one USAGE message.

DNSB · Today, 09:06 PM

If it's any help, here's the result of running epubcheck and epubveri on a scrambled copy of an ePub. ePubcheck came with 69 error lines while epubveri came up with 430. I also attached the scrambled ePub.

Basically, the ebook is a conversion from an azw3 file using calibre's conversion pipeline which produced an ePub2 file. Going by the contents of the ePub, the original that Amazon published from was an ePub3.

DNSB · Today, 09:11 PM

Having nothing better to do while the hockey game I was watching was in an intermission, I directly edited the content.opf in the ePub to version ="3.0". I've attached the results of epubcheck and epubveri from running on that file.

Yesterday, 06:43 PM	#166
Kayadelenium Connoisseur Posts: 51 Karma: 100000 Join Date: Jul 2026 Location: Planet Earth Device: Kobo Forma	epubveri 0.9.12 JSWolf — thank you for the two logs. The column number you mentioned was the smallest thing in them; the interesting part was the error count. Your file: 21 fatals from both tools, then 96 errors from me against EPUBCheck's 127. That gap splits cleanly: 27 of them are inside the 21 documents that do not parse at all. EPUBCheck reads with a streaming parser, so it validates the <html> start tag on line 2 long before it reaches the unclosed <body> at the end of the file. I build a document tree, and a file that fails to parse gives me no tree to check. That is a real difference and not one I can close cheaply, so I am recording it rather than claiming otherwise. 4 were role on <img> — and that turned out to be five elements, not one. img, area, iframe, param and script were all quietly taking the EPUB 3 attribute set in an EPUB 2 book, so they escaped every EPUB 2 tightening of the last week. Rather than fix the one you found, I walked the grammar from the EPUB 2 root and listed everything that pulled in the wrong set; a test now asserts that nothing can, so the next one fails at build time instead of arriving as a forum post. Chasing your report also made me sharpen the comparison I run against EPUBCheck over a shelf of real books: it compared which messages each tool reports, never how many. Your file is precisely the case that hides in — the message IDs agreed while the totals differed by 31. With counting turned on, one book showed 7 errors from me against 79 from EPUBCheck. Two causes, both mine: alt is required on <img> in XHTML 1.1 and optional in HTML5 — one of the few places EPUB 2 is the stricter version. I had it optional in both. More seriously, a missing required attribute stopped me checking the rest of that file. One <img> without alt silenced everything after it. That book has 72 of them; EPUBCheck reports 73, I was reporting 2. That book now matches EPUBCheck exactly, 82 to 82. Ten books on the shelf gained findings, all still at or below EPUBCheck's count, and six of them now match it exactly. One thing I could use from you: lines 94 and 217 of that style.css, if you still have it. Two CSS differences are left and I cannot reproduce either from the log alone — one of them may well be EPUBCheck being stricter than the CSS specification rather than me being wrong, and I would rather know than guess. Downloads (8 platforms): https://github.com/veripublica/epubveri/releases Try it in the browser: https://veripublica.github.io/epubveri/

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
EPUBCheck v4.2.6	jhowell	ePub	0	06-30-2021 03:49 PM
EPUBCheck v4.2.5	jhowell	ePub	0	03-23-2021 09:45 AM
EPUBCheck v4.2.4	jhowell	ePub	3	06-24-2020 09:51 AM
EPUBCheck v4.1.1	Doitsu	ePub	2	03-18-2019 10:39 AM
Web-based epubcheck upgraded to epubcheck 1.0.5	kjk	ePub	4	02-09-2010 09:53 PM