[Editor Plugin] epubveri

[Kayadelenium]

epubveri for calibre 0.4.2 — done.

https://github.com/veripublica/epubv...calibre-v0.4.2

Doitsu — clicking a column heading sorts, and each further click toggles ascending and descending. It works under all three Sort settings now; under Document order the headings did nothing at all, which is presumably where you met it. The panel still opens in the book's own order under that setting, and no sort arrow appears until you click, since until then nothing is sorted.

Nothing else changed.

[thiago.eec]

Originally Posted by Kayadelenium

epubveri for calibre 0.4.1 — the background glitch thiago.eec found, and one it led to.

So this one needs your eyes rather than mine. I cannot reproduce the fault on this machine, which means I cannot confirm the fix on it either; it is reasoned from where the two platforms differ. If Always dark now paints the whole panel on Windows, that closes it.

I'm sorry, but it looks the same: on a dark theme, if I choose 'Always light', the tree headers and the scrolling bar are still dark, while the dock around it is light.

[DNSB]

Possibly an issue with the OS used? MacOS vs. Windows vs Linux's multiple display technologies.

[Kayadelenium]

epubveri for calibre 0.4.3 — https://github.com/veripublica/epubv...calibre-v0.4.3

Fixed — thiago.eec, #30: choosing "Always light" or "Always dark" turned the panel and the rows but left the column headings and the scroll bar in calibre's own theme. Both follow the setting now, in the panel's own two colours.

DNSB, #31 — a fair guess, but it was not the OS. A Qt style sheet is applied by selector, and ours named only the tree, so the headings and the scroll bar — separate widgets — never heard about the setting. Checked against calibre's own Qt by rendering the panel and reading the pixels back: the headings had been wrong on macOS as well, from the day the setting shipped. My note in the source blaming Windows was wrong too.

New — a new plugin icon. The old one measured 2.00:1 against a dark editor background, and no single colour can clear 3:1 against both a mid grey and a black ground. A pair does: ink on light backgrounds, yellow on dark ones, 6.71:1 at worst across the five I measured.

Nothing else changed.

The zip and its checksums are on the release page. Install with Preferences → Plugins → Load plugin from file.

[Kayadelenium]

epubveri for calibre 0.4.4 — https://github.com/veripublica/epubv...calibre-v0.4.4

One sentence changed, and no behaviour did. It is worth a post only because of why.

The plugin's description now mentions its companion. There is a second plugin, epubveri library, which checks a whole calibre library at once and reports which defects recur across it rather than what is wrong with one book.

Until today the two sat under the same heading in Preferences → Plugins, because the library one declared itself an Edit book tool in order to be listed next to this one. It has stopped doing that — it is a library-side plugin and is now filed as one, which is correct and was settled in its own thread. The consequence lands here: the two entries are no longer adjacent, so someone who installs this plugin and never goes looking would have no way to learn the other exists.

This one came first and is the more widely installed of the two, and a large library is exactly the case the other was written for. So the cross-reference, which used to run one way only, runs both ways now.

That is the whole release. No behaviour, no settings, no new permissions — if you are happy on 0.4.3 there is nothing here you need.

[Doitsu]

@Kayadelenium please create your own plugin thread and ask a mod to link it to the official plugin list. This will allow you to upload updated plugins which will be automatically distributed via Calibre.

@Comfy.n or @BetterRed AFAIK it's not possible to transfer ownership of threads but mods can move posts to other threads.
Once Kayadelenium has created his own Calibre epubveri thread please move posts #15 and higher to his own thread and hide posts 1 to 14.

[BetterRed]

Originally Posted by Doitsu

. . . @Comfy.n or @BetterRed AFAIK it's not possible to transfer ownership of threads but mods can move posts to other threads.
Once Kayadelenium has created his own Calibre epubveri thread please move posts #15 and higher to his own thread and hide posts 1 to 14.

I'll leave it to @Comfy.n, who has already added it to the index, or one of the mods who've previously edited the thread - i.e. @theducks or @PeterT.

BR

[Comfy.n]

Originally Posted by BetterRed

I'll leave it to @Comfy.n, who has already added it to the index, or one of the mods who've previously edited the thread - i.e. @theducks or @PeterT.

BR

Sure, ok.

[Kayadelenium]

epubveri checks the book you have open in calibre's Edit Book against the EPUB specification, and puts your cursor on every problem it finds. It reads your book and reports; it changes nothing.

What it is. epubveri is an EPUB validator written in Rust: no Java to install, and a typical book is checked in well under a second. It reports epubcheck's own message IDs (RSC-005, OPF-003 and the rest), so anything you already know about epubcheck's output carries straight over, and it decides VALID or NOT VALID the same way: errors and warnings count, notes do not.

What you get.

• A results panel that docks beside Check Book and the File browser. Drag it, tab it behind another panel or close it; calibre remembers where you put it.
• One row per finding: severity, file, line and message, coloured by severity. Double-click a row and the file opens with the cursor on the exact character, not just the line.
• Unsaved edits are included. What the editor holds is what gets validated, so you can fix something, validate again and watch the row disappear without saving first.
• Findings open severest first. Click any column heading to sort by it, and again to reverse.
• Ctrl+C copies the selected rows as tab-separated text, ready for a forum post or a spreadsheet. Right-click for CSV of all or selected rows, or epubveri's full JSON report, which is the file to attach when a finding looks wrong.
• A clean book does not open the panel; a message box says so.

Settings are on the arrow beside the toolbar button, and under Preferences / Plugins / epubveri / Customize:

• Keep epubveri up to date automatically. Clearing it stops every network request.
• Show usage notes: findings epubcheck also makes but hides unless you ask for them.
• Show advisory findings: epubveri's own ADV checks, beyond what epubcheck looks for.
• The order the panel opens in, and whether it follows calibre's theme or stays light or dark.

Usage notes and advisories are shown by default. Neither can change the verdict, and turning them off never hides an error or a warning.

Nothing is bundled, and nothing is trusted blindly. The plugin contains no binary. On first use it downloads the epubveri build for your platform (about 3 MB) from epubveri's own GitHub releases and verifies it against that release's published SHA256SUMS.txt before it ever runs. After that it works offline.

Installing. From calibre: Preferences / Plugins / Get new plugins, search for epubveri. Or download the zip attached to this post, then Preferences / Plugins / Load plugin from file, and restart calibre. The button appears in Edit Book's toolbar and its Plugins menu. calibre 6.0 or later is required.

Checking a whole library. This plugin answers what is wrong with the book in front of you. If the question is which of your books have a problem, the sibling plugin epubveri library scans the library from calibre's main window and groups the results by defect. It has its own thread: https://www.mobileread.com/forums/sh...d.php?t=375207

Where to report what. Anything about the plugin itself (the panel, the settings, installing) belongs in this thread or at https://github.com/veripublica/epubveri-plugins/issues. A finding you believe is wrong is a question about epubveri, and it belongs in the epubveri thread, https://www.mobileread.com/forums/sh...d.php?t=374286, ideally with the JSON report attached. A book on which epubveri and epubcheck disagree is the most useful thing you can send.

Links

• Releases and changelog: https://github.com/veripublica/epubv...ugins/releases (take the release tagged calibre-)
• Source, GPL-3: https://github.com/veripublica/epubveri-plugins
• epubveri itself: https://github.com/veripublica/epubveri

Plugin Download

[Kayadelenium]

@Comfy.n I started a new post, could you move the messages to new one?

https://www.mobileread.com/forums/sh....php?p=4609446

[Comfy.n]

Originally Posted by Doitsu

@Kayadelenium please create your own plugin thread and ask a mod to link it to the official plugin list. This will allow you to upload updated plugins which will be automatically distributed via Calibre.

@Comfy.n or @BetterRed AFAIK it's not possible to transfer ownership of threads but mods can move posts to other threads.
Once Kayadelenium has created his own Calibre epubveri thread please move posts #15 and higher to his own thread and hide posts 1 to 14.

I'm a bit confused. I just noticed the old Editor plugin thread is now called 'epubveri old' - the one started by @Doitsu. This current thread was started by @Kayadelenium, so I guess there is no need to move posts, unless I'm missing something?

Originally Posted by Kayadelenium

@Comfy.n I started a new post, could you move the messages to new one?

https://www.mobileread.com/forums/sh....php?p=4609446

I guess someone already fixed this. I have updated the Index to serve the plugin in the first post of this thread.

edit: Thread split was carried out earlier by forum staff.

[Kayadelenium]

I am the developer of epubveri. While I was working on development, Doitsu had released the initial plugin. Now, I have released the plugin myself. For this reason, Doitsu handed epubveri over to me on the forum.

If you have any questions, feel free to ask.

[DiapDealer]

I already moved the requested posts to the new thread. There was a request in the Editor Forum to do so. I soft-deleted the old thread after renaming it to "-old" to avoid any confusion.