MobileRead Forums - View Single Post

KevinH · 02-21-2026, 04:52 PM

What's funny is that I did a Checkpoint before allowing any change and then a diff after the Sigil Mend and the only thing that changed was the addition of a epub3 DOCTYPE
immediately after the xml header (which is a Sigil requirement but calibre discards them).

Code:

<!DOCTYPE html>

So nothing there should have impacted iBooks.

So the restructuring to Sigil Norm (ie. moving to a more normal epub structure) is what allowed iBooks to show the text for me on my Mac.

Interestingly, the epub3 spec specifically allows any structure (even yours) so this is a bug in iBooks not following the epub3 spec properly.

Hope this helps.

02-21-2026, 04:52 PM	#7
KevinH Sigil Developer Posts: 9,409 Karma: 6733754 Join Date: Nov 2009 Device: many	What's funny is that I did a Checkpoint before allowing any change and then a diff after the Sigil Mend and the only thing that changed was the addition of a epub3 DOCTYPE immediately after the xml header (which is a Sigil requirement but calibre discards them). Code: <!DOCTYPE html> So nothing there should have impacted iBooks. So the restructuring to Sigil Norm (ie. moving to a more normal epub structure) is what allowed iBooks to show the text for me on my Mac. Interestingly, the epub3 spec specifically allows any structure (even yours) so this is a bug in iBooks not following the epub3 spec properly. Hope this helps.