|
|
#1 |
|
Addict
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() 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. |
|
|
|
|
|
#2 |
|
Wizard
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() 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. |
|
|
|
![]() |
| Tags |
| book, ebook, epubsana, repair, veripublica |
|
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 |