daisy / daisy/ace

Add sectioning element names to the HTML outline

Open
#110 1 comment 2 reactions 1 assignee Claimed by @rdeltour View on GitHub
enhancement feature
Dominant language
JavaScript
Stars
98
Forks
29
PR merge metrics
No merged PRs in 30d

Description

Sections and articles must definitely have their own headings (h1-h6). But the ePub HTML files splitting policy way lead to place individual sections and articles into separate HTML files.
In this case, only sections and articles have a title. The body does not. Which is perfectly normal and allowed by ePub accessibilty techniques specification (http://www.idpf.org/epub/a11y/techniques/techniques.html#titles-002).

So far, in this specific case, ACE is indicating an "Untitled BODY" in the HTML outline. This message sounds as a warning/error, though nothing is wrong.

To fix this, would it be possible:
- either not to report any "Untitled BODY" message in this case,
- or (at least) to qualify children's titles by their element's name, i.e. [section] or [article]. Thanks to this qualifier, the human certifier will easily understand that there is actually no problem hre (without having to open the relevant HTML files to understand what is going on).


Go further



Laurence

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.