Register Guidelines E-Books Search Today's Posts Mark Forums Read

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

Notices

Reply
 
Thread Tools Search this Thread
Old 12-29-2018, 05:10 PM   #1
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
[Editor Plugin] ACE by Daisy - EPUB Accessibility Checker

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
      Code:
      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:
    Code:
    $ 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.
  • Split multiline errors: split errors into multiple lines, when needed.

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, et, es, eu, fr, hu, id, it, nl, pt_BR, ru, 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:
    Code:
    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.1.0 - 19 Dec 2019
- Update code to support python 2/3
- Skip dark mode detection on old versions of calibre

Version 1.0.8 - 12 Dec 2019
- Change colors for calibre Dark Mode
- Add an option to choose the language for messages. Currently supported languages: ACE (en, es, fr, pt_BR) and AXE (de, en, es, fr, ja, nl, pt_BR). Default is 'en' for both.
- Add missing severity type (critical)
- Fix getrole() function to recognize multiple roles
- Add a new option to split multiline errors
- Fix entry on Editor's Plugins menu: it only allowed to change configuration, but not to run ACE
- Update translations

Version 1.0.7 - 10 Jun 2019
- Adjusted the code to use BS4 after calibre version 3.41.0
- Added new status message
- Added Estonian translation

Version 1.0.6 - 29 Apr 2019
- Finished Russian Translation

Version 1.0.5 - 27 Apr 2019
- Add Dutch Translation

Version 1.0.4 - 25 Mar 2019
- Finished German Translation

Version 1.0.3 - 22 Mar 2019
- Add Indonesian translation

Version 1.0.2 - 20 Fev 2019
- Update translations
- Double-click a message to copy it to clipboard

Version 1.0.1 - 21 Jan 2019
- 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 2019
- 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 2019
- 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.
Attached Thumbnails
Click image for larger version

Name:	Report.png
Views:	490
Size:	524.8 KB
ID:	169166   Click image for larger version

Name:	Menu.jpeg
Views:	316
Size:	11.6 KB
ID:	169168  
Attached Files
File Type: zip ACE.zip (101.3 KB, 1886 views)

Last edited by thiago.eec; 12-19-2019 at 05:59 PM. Reason: Version 1.1.0
thiago.eec is online now   Reply With Quote
Old 12-31-2018, 02:02 AM   #2
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
New Version - 0.2.0

Version 0.2.0 - 31 Dec 2018

- New GUI settings
- Better error handling
- Debug Mode

Last edited by thiago.eec; 12-31-2018 at 07:43 AM.
thiago.eec is online now   Reply With Quote
Advert
Old 01-08-2019, 04:07 PM   #3
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
New Release

Version 0.3.0 - 08 Jan 2019

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

Last edited by thiago.eec; 02-20-2019 at 05:41 AM.
thiago.eec is online now   Reply With Quote
Old 01-18-2019, 07:17 PM   #4
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.0 - 18 Jan 2019

- 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!

Last edited by thiago.eec; 02-20-2019 at 05:41 AM.
thiago.eec is online now   Reply With Quote
Old 02-20-2019, 05:44 AM   #5
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.2 - 20 Fev 2019

- Update translations
- Double-click a message to copy it to clipboard
thiago.eec is online now   Reply With Quote
Advert
Old 03-22-2019, 02:05 PM   #6
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.3 - 22 Mar 2019

- Add Indonesian translation
thiago.eec is online now   Reply With Quote
Old 04-27-2019, 07:24 PM   #7
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.5 - 27 Apr 2019

- Add Dutch translation

Last edited by thiago.eec; 04-28-2019 at 06:02 AM.
thiago.eec is online now   Reply With Quote
Old 06-10-2019, 05:20 PM   #8
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.7 - 10 Jun 2019

- Adjusted the code to use BS4 after calibre version 3.41.0
- Added new status message
- Added Estonian translation
thiago.eec is online now   Reply With Quote
Old 12-12-2019, 09:23 PM   #9
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.0.8 - 12 Dec 2019

- Change colors for calibre Dark Mode
- Add an option to choose the language for messages. Currently supported languages: ACE (en, es, fr, pt_BR) and AXE (de, en, es, fr, ja, nl, pt_BR). Default is 'en' for both.
- Add missing severity type (critical)
- Fix getrole() function to recognize multiple roles
- Add a new option to split multiline errors
- Fix entry on Editor's Plugins menu: it only allowed to change configuration, but not to run ACE
- Update translations
thiago.eec is online now   Reply With Quote
Old 12-12-2019, 09:33 PM   #10
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 55,141
Karma: 51406166
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Aura H2O, Sony PRS-650, Sony PRS-T1, nook STR, iPad 4, iPhone 5
What software supports these ePub 3 accessibility features? So any Readers?
JSWolf is offline   Reply With Quote
Old 12-12-2019, 10:03 PM   #11
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Quote:
Originally Posted by JSWolf View Post
What software supports these ePub 3 accessibility features? So any Readers?
First, good accessibility for EPUB is a combination of eReader and AT. So, besides the eReader, you are going to need some good AT (NVDA, Jaws, VoiceOver, Talkback, etc).
Here you have a general review of some Readers regarding accessibility features.

Accessibility is (or at least should be) a goal for the whole industry. EPUB provides the means, and we hope adoption will increase over time. ACE helps in the production of better books. That's the first step.
thiago.eec is online now   Reply With Quote
Old 12-19-2019, 05:58 PM   #12
thiago.eec
Addict
thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.thiago.eec knows who John Galt is.
 
Posts: 275
Karma: 71602
Join Date: Dec 2016
Location: Goiânia - Brazil
Device: iPad, Kindle Paperwhite
Version 1.1.0 - 19 Dec 2019

- Update code to support python 2/3
- Skip dark mode detection on old versions of calibre
thiago.eec is online now   Reply With Quote
Reply

Tags
accessibility, ace, daisy

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[Plugin] Access-Aide - help improve epub accessibility KevinH Plugins 31 11-27-2019 05:51 PM
[Plugin] Proselint - English style checker Doitsu Plugins 12 09-21-2019 06:03 PM
[Plugin] ACE - DAISY EPUB Accessibility Checker wrapper Doitsu Plugins 19 09-12-2019 03:59 PM
URL Checker plugin Doitsu Plugins 17 11-19-2017 10:39 AM
Epub Revision - accessibility support Nate the great ePub 1 02-23-2011 04:47 AM


All times are GMT -4. The time now is 07:25 PM.


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