Ace outputs a human-readable report in HTML format, containing information about which automated tests failed, as well as extracted data visualizations, to highlight potential problem areas and to assist in manual checking.
After the header, which contains the Ace version, report date, and publication title, there are four sections, detailed below.
Summary of Violations
This table lists statistics for the violations, in terms of severity: Critical, Serious, Moderate, or Minor; and by ruleset category: WCAG 2.0 A, WCAG 2.0 AA, EPUB, Best Practice, or Other. It’s useful for getting a quick overview of the violations.
This table details each violation and provides information about:
Impact: the severity of the violation
Ruleset: the category that this rule is in
Rule: identifier for the rule, as well as the underlying engine that checks for it (e.g. axe or Ace)
Location: where in the book the violation occurred, as well as an HTML code snippet of the relevant portion.
Details: suggestions on how to fix the problem, as well as a link to the relevant topic page in our online knowledge base.
This section lists accessibility metadata, describing what’s present in the publication, and which properties are missing.
The outlines are intended to assist with manual checking. They represent extracted views of different structural aspects of the publication. The outlines are:
- Table of contents, taken from the EPUB navigation document
- Headings, including indications of missing heading levels (i.e. going from
- HTML, which is a view of just the heading content and sectioning content
This table contains each image in the EPUB and information about it. The table columns are:
Image: the image itself
alt attribute: the contents of the
aria-describedby: the contents of the element referenced by the
Associated figcaption: the
figcaptionfor this image
Location: location in the EPUB of this image
Role: the image’s
Please refer to the images topic in the Accessible Publishing Knowledge Base for guidance on image accessibility techniques and examples.