Calibre Accessibility Tool

[Lukusaukko]

I've been toying around with an idea for an accessibility tool that runs inside the Edit Book editor, does not depend on ACE (which is kind of annoying to install), and which would make it easier for non-savvy users to make their ebooks accessible, i.e. take away much of the need to know intimate details about landmarks, epub:types, aria, etc.

The existing tools tend to have two problems: they aren't very transparent at what they do and may do things they shouldn't: for example, a novice user may think that running Access Aide alone makes the book accessible, and AA also doesn't provide much input about what it actually did; ACE on the other hand is a mainly a reporting tool that doesn't really hook back into the editing flow easily, and which requires you to get quite intimate with the above-mentioned details.

The basic ideas are that first it should provide an easy way to jump into the location where the accessibility issue is and inform the user what the problem is and what could be done about it; secondly, for those issues that cannot be automatically fixed and need human review, it should provide an appropriate editing interface to manually resolve that issue (something Sigil's Access Aide does with image alt text). This should all happen within the Edit Books interface, and provide hooks to Calibre's diff so that the user can review what it did.

I have a basic prototype already in testing, but since I don't personally need accessibility features at least for now, it's basically a toy that I play around with - but if it's something that people might find useful and something that isn't already adequately served by existing tools, I might take it further.

[BetterRed]

@Lukusaukko - I moved your post to here because its more likely to be seen here by users who will have an opinion on the issues you raise.

BR

[DNSB]

How does the ouput from your proposed plugin for the calibre ebook-editor compare to the output from the Access-Aide plugin for Sigil?

[Lukusaukko]

Originally Posted by DNSB

How does the ouput from your proposed plugin for the calibre ebook-editor compare to the output from the Access-Aide plugin for Sigil?

Are we talking about the semantic code itself? In that case, it shouldn't be all that different - accessible semantics are pretty much set. Otherwise, in it's current proof-of-concept form, it produces a list of accessibility issues it discovers (a subset of ACE checks), and then lets the user click at the issue and jump to the spot; it also has some automatic fixes, such as adding missing language definitions and aria roles corresponding to their epub:types where those are missing. It then lets the user to view the standard Calibre diff to see what has changed.

One of the concepts in CAT is its semantic map editor, which allows the user to define parts of the document in terms of frontmatter, bodymatter, backmatter, and their roles (chapter, preface, etc.) - it can then use that information to create the semantic structure. It's still very basic, but the idea is that ultimately the user creates a semantic map of the document based on its contents, and CAT does the actual semantic tagging where it can automatically do so, and provides an interface to manually edit those parts that need human review (like image alt text or landmarks).

An example of the checker output:

Warning LANG-DOC-001 chapter01.html:2 The html element declares no language.
Pass HEAD-001 : No problems found by this check.
Pass ID-001 : No problems found by this check.
Pass IMG-001 : No problems found by this check.
Pass LINK-001 : No problems found by this check.
Pass PUB-LANG-001 : No problems found by this check.
Pass PUB-PARSE-001 : No problems found by this check.
Pass PUB-TITLE-001 : No problems found by this check.
Pass SEM-ARIA-001 : No problems found by this check.
Not applicable CONF-001 : No dcterms:conformsTo claim.
Not applicable PAGE-001 : No page-list or page-break markers.
Warning DISC-001-ACCESSIBILITYFEATURE content.opf: schema:accessibilityFeature is not declared.
Warning DISC-001-ACCESSIBILITYHAZARD content.opf: schema:accessibilityHazard is not declared.
Warning DISC-001-ACCESSMODE content.opf: schema:accessMode is not declared.
Warning DISC-001-ACCESSMODESUFFICIENT content.opf: schema:accessModeSufficient is not declared.
Warning NAV-LANDMARKS-001 nav.xhtml: Navigation document has no landmarks nav.
Info DISC-001-ACCESSIBILITYSUMMARY content.opf: schema:accessibilitySummary is not declared.
Pass NAV-002 : No problems found by this check.
Pass NAV-003 : No problems found by this check.
Not applicable DISC-002 : No accessibility metadata declared.
Not applicable DISC-003 : No accessibilityHazard declared.
Not applicable DISC-004 : No accessibility metadata to compare.