[Editor Plugin] ACE by Daisy - EPUB Accessibility Checker

[thiago.eec]

This plugin is a simple ACE (=Accessibility Checker for EPUB) wrapper.

Credits: This plugin is based on Doitsu's code for Sigil's ACE Plugin and EPUBCheck for calibre. The Config Menu is based on KindleUnpack's. Thanks to Kovid Goyal for providing the feature that made possible linked error messages.

System requirements: You need to install ACE before you can run the plugin. Mininum calibre version: 2.0.0 (when the Editor was introduced).

Ace installation:

1. Install Node.JS
   • Go to Node.JS
   • Download version 6.4.0 or higher
   • Double-click to install
2. Install (or update) Ace
   • After installing Node, open a shell window
     • On Windows: Windows System->Command Prompt or Start->Run->cmd.exe
     • On Mac: Applications->Utilities->Terminal
   • Type the following command to install or update Ace
     

     npm install @daisy/ace -g

3. If everything went smoothly, you should now be able to run the ace command in your shell. You can test it out like this:
   

   $ ace --version
   1.0.2

Visit the ACE's website if you have any trouble with the installation.

Settings: You can change the settings on the 'Configure' dropdown menu beside the ACE icon on the Editor. The same menu is reachable via Preferences > Advanced > Plugins > Customize Plugin.

Options:

• Report Folder: select de default folder to save ACE report.
• Open Report after checking: opens the html report, after finished.
• Debug Mode: copy ACE log to clipboard.
• Close Validation Docks: automatically close Check Book and EPUBCheck docks.

Language: The default language for ACE is English. There are no other options available right now. As for the plugin itself, it is available* in several languages: de, eu, fr, it, pt_BR, ru, es, sv and uk. *Some have partial translations.

You can add a translation in your language via Transifex. You can see some instructions on how to do that here.

Error handling:

Spoiler:

• ACE EBUSY Error: with some files, ACE throws this error. Its a known ACE bug. If you rerun with the same arguments, then it will correct itself. So, the plugin will ask you to rerun. The error message is something like this:
  

  Unexpected error: EBUSY: resource busy or locked, copyfile 'temp\path\OEBPS\Images\some_image.extension' -> 'report\folder\data\OEBPS\Images\some_image.extension'

• On Windows: 'ace' is not recognized as an internal or external command, operable program or batch file: it means you didn't install ACE. See ACE installation.

License: GNU General Public License v3 (GPL-3)

Screenshots attached.

Version History

Spoiler:

Version 1.0.1 - 21 Jan 2018
- Fix a bug on opf file rendering (monochromatic text and tags).
- Fix an error when clicking on ACE with no file loaded on the Editor.
- Update translations.

Version 1.0.0 - 18 Jan 2018
- Plugin redesigned
- Now with a complete GUI interface integrated with calibre
- Message list can be sorted by File, Severity or Error Message (click on the headers)
- Clicking on an error message will take you to the corresponding line

Version 0.3.0 - 08 Jan 2018
- Config Menu inside the Editor
- Integration with Icon Themes
- Update on translation mechanism
- Mininum Calibre Version reduced to 2.0.0
- Minor fixes

Version 0.2.1 - 31 Dec 2018
- Fix missing icon

Version 0.2.0 - 31 Dec 2018
- New GUI settings
- Better error handling
- Debug Mode

Version 0.1.0 - 29 Dec 2018
- Initial release.

[thiago.eec]

Version 0.2.0 - 31 Dec 2018

- New GUI settings
- Better error handling
- Debug Mode

[thiago.eec]

Version 0.3.0 - 08 Jan 2018

- Config Menu inside the Editor
- Integration with Icon Themes
- Update on translation mechanism
- Mininum Calibre Version reduced to 2.0.0
- Minor fixes

[thiago.eec]

Version 1.0.0 - 18 Jan 2018

- Plugin redesigned
- Now with a complete GUI interface integrated with calibre
- Message list can be sorted by File, Severity or Error Message (click on the headers)
- Clicking on an error message will take you to the correspondent line


Special thanks to all the translators!