Updated: October 4, 2019
Current Version: "0.2.2"
This plugin is a simple DAISY
ACE (=
Accessibility
Checker for
EPUB) wrapper.
Credits: This plugin uses an
epubcfi module originally written by
Kovid Goyal, which was
adapted for Sigil by
KevinH.
System requirements:This plugin requires Sigil 0.9.5 or higher. Obviously, you'll also need to install DAISY ACE. (Theoretically, the plugin should work on Macs, too, however, I couldn't get it to work on a Mac.)
Installation:1. Visit the
Inclusive Publishing website and follow the ACE installation instructions.
2. Select Manage Plugins from the Plugins menu and select
Use Bundled Python, if it isn't already selected.
3. Click Add Plugin and select
ACE_v0.2.2.zip. This will install the plugin, which you can select via Plugins >
Validation > ACE.
If ACE doesn't crash, it'll display all messages in the validation panel
and in the default browser.
If you don't want the plugin to display the results in a web browser change the following value in the ACE.json preferences file to false.
Code
BTW,
KevinH has created an accessibility plugin that'll automatically add recommended attributes to epub files. You can download it
here.
Known Issues:Since the developers apparently haven't implemented the July 2019 recommendations of the
EPUB Type to ARIA Role Authoring Guide, ACE 1.1.1 might erroneously flag some tags that can't have ARIA roles attributes.
License: GNU General Public License v3 (GPL-3)Quote Doitsu
Released: February 9, 2018
Current Version: "0.1.0"
Known Issues:
ACE often crashes before generating the report files. Hopefully these crashes will be fixed in future versions.
Just to let you know: I've been using ACE since v. 0.6, and haven't seen a crash yet, neither when I use it by dumping the epub on a batchfile nor by using your plugin (Windows 10 Pro 64 bit).
And thanks for the plugin, it spares my old fingers some clicks
Regards,
Kim
Hi Doitsu,
I have modifed Kovid's Calibre cfi parsing code to run purely on Python 3 and to return stepnums in a manner that make sense to me (with -1 step indicators to indicate redirection) . With this new cfiparse.py code I should be able write an edit plugin that uses the bk to quickly convert the cfi to find the name of the problem file. I will then write some new code to walk the gumbo tree dom and return a line number and hopefully a correct character offset.
With this information, you should be able to create a validation plugin that will work fully inside Sigil.
Give me another week or so to put something together.
KevinH
Quote KevinH
I have modifed Kovid's Calibre cfi parsing code to run purely on Python 3 [...] With this information, you should be able to create a validation plugin that will work fully inside Sigil.
I really appreciate your efforts and will update the plugin once you've released the code.
See:
https://www.mobileread.com/forums/sh...&postcount=358Quote KevinH
Thanks! I'll check it out.
Thanks to KevinH's help, I was able to convert the plugin from an edit plugin to a validation plugin.
I've attached a new version to the first post.
Thanks for the great plug in. Able to install and run it without a hitch- good work!
Quote ways2read
Thanks for the great plug in. Able to install and run it without a hitch- good work!
I should clarify that this was on Windows
Quote Doitsu
Thanks to KevinH's help, I was able to convert the plugin from an edit plugin to a validation plugin.
I've attached a new version to the first post.
Ace is running fine from terminal on my Macbook.
The plugin fails though. When I look at details, I see:
"Status: failed
Running ACE ... please wait.
-V: ace command not found"