Skip to content

Calibre plug-in to enhance EPUB accessibility features

License

Notifications You must be signed in to change notification settings

lb803/access-aide

Repository files navigation

Access Aide

Access Aide is a Calibre (book editor) plug-in to enhance EPUBs with accessibility features and help comply with the WCAG guidelines.

This plug-in is especially suited for people producing EPUBs through InDesign, but other users might find Access Aide useful. At the time of writing, InDesign is capable of adding language information to OPF files and appropriate epub:type to HTML tags. Access Aide reads this information and adds language declarations, aria roles and metadata statements to comply with the WCAG guidelines for accessible publications.

Features

  • Add language declaration to <html> tags;
  • Find tags with epub:type attributes and add corresponding aria roles;
  • Add accessibility declarations to book metadata:
    • schema:accessMode, schema:accessibilityFeature, schema:accessibilityHazard, schema:accessibilitySummary, schema:accessModeSufficient;
    • a11y:certifiedBy, a11y:certifierCredential, a11y:certifierReport;
    • dcterms:conformsTo.

Installation

You can either:

  • Install this plugin via the plug-in manager tool in your Calibre client Preferences -> Advanced -> Plug-ins -> Get new plug-ins;
  • Manually download a release from this repository and then load the zip file by Preferences -> Advanced -> Plug-ins -> Load plugin from file.

Config

Plugin behaviour can be fine tuned via plugin config dialogue.

Access Aide config dialogue

Use

Open the book to enhance in the Calibre ebook editor and start Access Aide. This can be performed clicking Plugins -> Access Aide, or via Ctrl+Shift+a.

Access Aide confirm dialogue

License

Copyright (C) 2020-2022 Luca Baffa GPL v3.0

Acknowledgements

This project originally aimed at porting the functionalities of the excellent Access-Aide LGPL v2.1 Sigil plugin to Calibre.

The plugin icon (./icon/icon.png) comes from the adwaita-icon-theme pack (gitlab page of the project), released as LGPL v3 by the GNOME Project.

The GitHub icon (./icon/GitHub-Mark-32px.png) was downloaded from the dedicated web page and it is used to link to this GitHub repository.