Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Software > Sigil > Plugins

Notices

Reply
 
Thread Tools Search this Thread
Old 11-19-2026, 12:02 PM   #1
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: 297
Karma: 364036
Join Date: Jul 2026
Location: Planet Earth
Device: Kobo Forma
[Plugin] epubsana - Repair the book with epubsana.

epubsana for Sigil

This plugin repairs the book you have open in Sigil with epubsana, my EPUB repair tool. epubsana fixes the defects epubveri reports where there is exactly one correct repair that keeps the content as it is, and leaves everything else alone.

When you run it from Plugins, Edit, epubsana, a window lists what it can repair, and selecting a line shows every file the fix touches and what changes there. The safe fixes are ticked. The ones that make a visible change, such as dropping a repeated spine entry, are not, so you can look at them first. A few fixes are shown greyed out with the reason: Sigil does not let a plugin change the EPUB version or a media-type, and it writes the container itself.

The repair goes into Sigil whole or not at all. After epubsana has applied the fixes you chose and checked the book again, the plugin reads the book back out of Sigil and compares it with what epubsana wrote. If anything differs, Sigil takes none of the changes, and the window says why. The book is not saved for you: save it to keep the repair, or close it without saving. Taking a Checkpoint first lets you compare the two versions.

In an Automate list there is no window, and only the safe fixes are applied, with the same checks.

On first use the plugin downloads epubsana from its GitHub release, checks it against the release's checksums, and keeps it up to date. It also tells you when a newer version of the plugin is out.

Download: sigil-plugins releases on GitHub. Take the newest epubsana_sigil_vX.Y.Z.zip and add it with Plugins, Manage Plugins, Add Plugin. Please do not rename the zip: Sigil takes the plugin's folder name from it.

Questions and reports are welcome here or in the GitHub issues.
Kayadelenium is online now   Reply With Quote
Old Today, 03:50 PM   #2
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,097
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
I noticed a potential issue with epubsana.

In some cases, for example when the OPF is accidentally damaged by a Sigil 2.8.5 bug (issue #903), a manifest entry may be missing even though the corresponding XHTML file is still present in the EPUB.

The CLI version correctly asks for confirmation before dropping the orphaned spine itemref. However, the Sigil plugin applies this fix automatically, without asking.

I think epubsana should first check whether the missing file actually exists in the EPUB and, if so, restore the manifest entry rather than remove the spine reference.
Attached Files
File Type: zip test_file-for-epubsana.zip (4.2 KB, 0 views)
BeckyEbook is offline   Reply With Quote
Reply

Tags
book, ebook, epubsana, repair, veripublica


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
epubsana — automatic repair for what epubcheck reports (not an editor) Kayadelenium ePub 70 Today 09:47 AM
Polish Book Plugin-How to get Arabic numerals in Book Jacket acepenn Library Management 1 09-18-2026 09:01 PM
[GUI Plugin] Colophon - AI-assisted EPUB repair+proofreading (alpha, Calibre 9.5+) jbennion Plugins 5 08-21-2026 05:51 PM
Check Book repair function has unexpected side-effect DrChiper Editor 8 08-07-2015 09:50 AM


All times are GMT -4. The time now is 04:42 PM.


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