Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader

Notices

Reply
 
Thread Tools Search this Thread
Old 11-14-2026, 12:09 PM   #31
PeterT
Grand Sorcerer
PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.
 
Posts: 14,228
Karma: 84699364
Join Date: Nov 2007
Location: Toronto
Device: Libra H2O, Libra Colour
Quote:
Originally Posted by Kayadelenium View Post
kepubverto 0.5.2 is out



It happens when a book's table of contents spells a file name one way and its manifest another, for example Agatha%27nin.html and Agatha'nin.html.
For what is worth in the outdated Kobo documentation on Epub specs https://github.com/kobolabs/epub-spec it includes

Quote:
File naming conventions
Special characters and spaces should not be used for file names within an EPUB. This can result in naming inconsistencies with the items listed in the OPF manifest. File names containing non-alphanumeric characters are not fully supported, and their use may lead to undefined behaviour, which may be inconsistent across clients.
PeterT is offline   Reply With Quote
Old 11-14-2026, 06:47 PM   #32
Kayadelenium
Addict
Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.
 
Kayadelenium's Avatar
 
Posts: 295
Karma: 364036
Join Date: Jul 2026
Location: Planet Earth
Device: Kobo Forma
Quote:
Originally Posted by JSWolf
When I try to validate the KePub using epubveri. I get this totally incorrect output.
Thanks for the book, Jon. Those errors are real, but they are not in the KEPUB that kepubverto writes. They appear after calibre's own KEPUB code has rebuilt the file.

I converted your scrambled book with kepubverto 0.5.2, with and without --hyphens auto. epubveri 0.43.0 and EPUBCheck 5.4.0 both report no errors and no warnings in the KEPUB. Its OPF is the same as in your EPUB, and it has no kobo-cover-image-generated-by-calibre.jpeg.

Then I put that KEPUB through calibre's own KEPUB code, in calibre 9.18.0, the code that removes the Kobo markup and adds it back. The result has your 69 errors, at the same lines and columns. calibre adds two style elements with an id to the head of each chapter (kobostylehacks and koboSpanStyle), and EPUB 2 does not allow an id on a style element. It also adds the cover image to the OPF with properties="cover-image", which is EPUB 3 syntax in an EPUB 2 book.

So I think the calibre editor does this when it opens a KEPUB, and the check then runs on calibre's version of the book, not on kepubverto's. I have not tried it in the editor itself. Could you check one thing for me? Run epubveri or EPUBCheck on the KEPUB file directly, without opening it in the editor first. If it passes, that confirms it.

I could not reproduce the editor closing when you run EPUBCheck. That happens inside calibre, so I can't tell from here what causes it.

Quote:
Originally Posted by PeterT
Special characters and spaces should not be used for file names within an EPUB.
Thanks, that's a useful link, and it describes exactly what went wrong. kepubverto does not rename files. It only makes the two spellings of a name match, so a book whose names follow Kobo's advice is not changed at all.
Kayadelenium is offline   Reply With Quote
Old 11-14-2026, 06:59 PM   #33
PeterT
Grand Sorcerer
PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.
 
Posts: 14,228
Karma: 84699364
Join Date: Nov 2007
Location: Toronto
Device: Libra H2O, Libra Colour
Is checking on internal names something that epubveri might flag?
PeterT is offline   Reply With Quote
Old 11-15-2026, 02:16 PM   #34
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 85,770
Karma: 154365285
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3
Quote:
Originally Posted by Kayadelenium View Post
Thanks for the book, Jon. Those errors are real, but they are not in the KEPUB that kepubverto writes. They appear after calibre's own KEPUB code has rebuilt the file.

I converted your scrambled book with kepubverto 0.5.2, with and without --hyphens auto. epubveri 0.43.0 and EPUBCheck 5.4.0 both report no errors and no warnings in the KEPUB. Its OPF is the same as in your EPUB, and it has no kobo-cover-image-generated-by-calibre.jpeg.

Then I put that KEPUB through calibre's own KEPUB code, in calibre 9.18.0, the code that removes the Kobo markup and adds it back. The result has your 69 errors, at the same lines and columns. calibre adds two style elements with an id to the head of each chapter (kobostylehacks and koboSpanStyle), and EPUB 2 does not allow an id on a style element. It also adds the cover image to the OPF with properties="cover-image", which is EPUB 3 syntax in an EPUB 2 book.

So I think the calibre editor does this when it opens a KEPUB, and the check then runs on calibre's version of the book, not on kepubverto's. I have not tried it in the editor itself. Could you check one thing for me? Run epubveri or EPUBCheck on the KEPUB file directly, without opening it in the editor first. If it passes, that confirms it.

I could not reproduce the editor closing when you run EPUBCheck. That happens inside calibre, so I can't tell from here what causes it.
What I don't get is the errors that epubveri is reporting. When I go to where the errors supposedly are, I don't see them. This is in the editor. So what is calibre doing with the KePub? Is this an error in calibre?

I ran epubveri from the command line and this is the output.

WARNING PKG-017: ".kepub" is an uncommon extension for an EPUB file
— 0 error(s), 1 warning(s): VALID

After I saved the KePub from the editor and ran epubveri, I got my 69 errors back. I'll report this as a bug.


Also, I do have epubcheck close the editor. I'll report this in the epubcheck thread.
JSWolf is online now   Reply With Quote
Old 11-18-2026, 05:33 PM   #35
Kayadelenium
Addict
Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.Kayadelenium ought to be getting tired of karma fortunes by now.
 
Kayadelenium's Avatar
 
Posts: 295
Karma: 364036
Join Date: Jul 2026
Location: Planet Earth
Device: Kobo Forma
Quote:
Originally Posted by JSWolf
What I don't get is the errors that epubveri is reporting. When I go to where the errors supposedly are, I don't see them. This is in the editor. So what is calibre doing with the KePub? Is this an error in calibre?
Yes, I think it is calibre. Thank you for checking from the command line, and for reporting it.

Your test shows it: the KEPUB is valid as kepubverto wrote it, and the 69 errors come back once the editor has saved it.

I think the editor removes the Kobo markup when it opens a KEPUB, so that you can edit the book, and adds its own markup back when it saves or checks it. The errors are in that rebuilt file. That would be why you can't see them in the editor: what it shows you is the book without that markup. I have not tried this in the editor myself.

The one warning, PKG-017, is only about the file name. epubveri expects a book to end in .epub, and the file you checked ends in .kepub. kepubverto names its output .kepub.epub, the name a Kobo expects, and epubveri does not warn about that one.

Quote:
Originally Posted by PeterT
Is checking on internal names something that epubveri might flag?
It does now. Since epubveri 0.44.0, the --advisory option reports a reference that only finds its file after %27 or a similar code is turned back into its character (ADV-025). On the Agatha book from my last post, it reports 20 of them, one per table of contents entry. The calibre and Sigil plugins for epubveri pass --advisory, so you see it there too.

kepubverto 0.5.3 is out. It updates the tools kepubverto uses to check the CSS you add with --css, so a few rules that a reader would ignore are now refused, and a few valid ones are now accepted. The books it writes are the same as with 0.5.2.

https://github.com/veripublica/kepub...ses/tag/v0.5.3
https://crates.io/crates/kepubverto
https://www.npmjs.com/package/@verip...epubverto-wasm
Kayadelenium is offline   Reply With Quote
Old 11-18-2026, 05:42 PM   #36
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 85,770
Karma: 154365285
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3
@Kayadelenium, the problem is calibre. The editor hides the KePub code and then puts in it's own code. So there is no way to edit a KePub created by kepubverto, kepupify, or from Kobo. The code will get changed to calibre's code. I asked for this to be an option and was rejected as unneeded.

Since I don't know which books make have this, I'll ask. Does epubveri flag filenames using a space by it an error or a warning?

Last edited by JSWolf; 11-18-2026 at 05:46 PM.
JSWolf is online now   Reply With Quote
Old 11-18-2026, 06:14 PM   #37
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 55,965
Karma: 182837452
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Sage, Libra Colour, Lenovo M8 FHD, Paperwhite 4, Tolino epos
Quote:
Originally Posted by JSWolf View Post
@Kayadelenium, the problem is calibre. The editor hides the KePub code and then puts in it's own code. So there is no way to edit a KePub created by kepubverto, kepupify, or from Kobo. The code will get changed to calibre's code. I asked for this to be an option and was rejected as unneeded.
Strictly speaking the calibre editor does not hide the kepub code. Basically, dekepubify before editing and then kepubify after editing. I thought this was something that you had wanted since you whinged about how the kepub additions made it harder to edit. Perhaps you might want to try using Sigil instead.

Quote:
Originally Posted by JSWolf View Post
Since I don't know which books make have this, I'll ask. Does epubveri flag filenames using a space by it an error or a warning?
Both epubcheck and epubveri flag a space in a XTHML filename as a PKG-010 error though epubcheck's error message is more verbose. Easy enough to generate the error by adding a space to a filename in the filename.

epubcheck:
Code:
WARNING(PKG-010): The file name "OEBPS/Text/spark_0 01.xhtml" contains spaces, which may create interoperability issues with older reading systems.
epubveri:
Code:
WARNING PKG-010: file name 'spark_0 01.xhtml' contains a space
DNSB is offline   Reply With Quote
Old 11-18-2026, 06:23 PM   #38
PeterT
Grand Sorcerer
PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.PeterT ought to be getting tired of karma fortunes by now.
 
Posts: 14,228
Karma: 84699364
Join Date: Nov 2007
Location: Toronto
Device: Libra H2O, Libra Colour
Just install Sigil and use it to view / edit the kepub.
PeterT is offline   Reply With Quote
Reply


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Libra Colour How to sort EPUB and KEPUB on Kobo raydawson Kobo Reader 15 01-10-2025 07:33 AM
KEPUB and non-breaking space Vetchy Kobo Developer's Corner 33 11-13-2024 03:44 PM
New Kobo, ePub vs Kepub Pjama Kobo Reader 8 04-07-2021 01:26 PM
What will happen/I gain if I forced an ePub book to a KePub book? andsoitgoes Kobo Reader 4 04-04-2012 05:33 PM
Kobo Adobe Epub is a Kepub instead rashkae Kobo Reader 61 01-13-2012 07:15 AM


All times are GMT -4. The time now is 10:08 AM.


MobileRead.com is a privately owned, operated and funded community.