Giter Club home page Giter Club logo

Comments (13)

dualpixel avatar dualpixel commented on June 15, 2024

Hi, @peppobon
Noe a days, besides, iBooks is there other reading system that recognize well Structural Semantics?

Regards

from publ-cg.

peppobon avatar peppobon commented on June 15, 2024

from publ-cg.

BillKasdorf avatar BillKasdorf commented on June 15, 2024

from publ-cg.

mattgarrish avatar mattgarrish commented on June 15, 2024

This goes back to the lack of support for the outline algorithm. If it were actually true that an aside were outside the document outline, then, yes, we wouldn't have to worry about heading sequence. But the reality is that the outline isn't supported and that's why the HTML spec notes the need to build one using h1-h6 tags (and ARIA role="heading" + aria-level="#").

An aside is a subsection of the section is belongs to, regardless of its internal structure, which is why the recommendation is in place that the first heading start one level lower than the containing section.

I'm not going to dispute that it requires additional work for content reuse, but user needs also trump developer needs. If we pick an arbitrary heading level to start at it may work sometimes, but more often it's going to result in gaps in the outline or leave asides appearing to be higher-level sections.

But if we reference the accessibility specification, I don't know if we have to keep these rules. They flow out of WCAG, too, so content will fail without our duplication of the rationale.

from publ-cg.

RachelComerford avatar RachelComerford commented on June 15, 2024

Avneesh - can the accessibility subgroup discuss whether this is redundant with WCAG and if it needs to be outlined in epub for education?

from publ-cg.

avneeshsingh avatar avneeshsingh commented on June 15, 2024

Right now WCAG does not cover the case in which structure is spread over multiple files. Accessibility TF will work with WCAG on such issues. We will also include cases like aside.
Regarding EPUB for education, as per my understanding, it already have more strict mark-up for headings to help in hierarchy across multiple files. Chapters are inside section tags, so it differentiates from aside.
But there is a mis match here, we do not promote use of section tag in EPUB accessibility conformance and discovery specification. So, this is another item for aligning EPUB for education.

from publ-cg.

mattgarrish avatar mattgarrish commented on June 15, 2024

The sectioning and heading requirements are in separate sections. The use of sections isn't covered by WCAG, but heading order is so we may not need it.

Our techniques document also has a couple of sections on headings in publications, so if we reference the accessibility specification I'm not sure the prose about headings in the edupub specification is useful anymore.

I'm also not sure I understand yet if the section requirement is being dropped. It sounds like it will be, in which case nothing else is needed. If it's retained, there might be a case for requiring the AAA SC that deals with headings as part of referencing the accessibility specification.

At any rate, if aside can start with any ranked heading, it sort of undercuts the requirement that document heading structure represent the outline. There's nothing that actually removes the structure in the aside (or article or whatever) from the outline that assistive technologies generate.

from publ-cg.

GeorgeKerscher avatar GeorgeKerscher commented on June 15, 2024

from publ-cg.

mattgarrish avatar mattgarrish commented on June 15, 2024

It should be automatable. Whether the heading(s) inside an aside flow sequentially from the parent section can be verified by machine. Techniques G141 and H42 cover this for SC 1.3.1, which is Level A. Using the correct heading rank establishes that it is a subsection of content.

And as far as I'm aware, AT will announce an aside as complementary content, so it shouldn't be confused for the main flow. The only issue is escaping/skipping. I don't know if that's supported for asides or articles or navs.

from publ-cg.

peppobon avatar peppobon commented on June 15, 2024

Sorry if I insist, but I think that asides (at least in the book publishing context, particularly in education) must be considered as autonomous content out of the main flow of the text and therefore they do not belong to the sections hierarchy. If they were in the main flow, they would be marked up as div (probably with a class or another semantic indicator), not as asides.

From a semantic point of view divs do partecipate indeed to the sections hierarchy, but asides not.

from publ-cg.

artbyrt avatar artbyrt commented on June 15, 2024

from publ-cg.

mattgarrish avatar mattgarrish commented on June 15, 2024

Asides are announced as complementary content, including the headings when you navigate them by shortcut.

But the headings are mapped to their stated level, so it still makes navigation confusing if their headings don't follow logically as subheadings of their containing section.

For example, if you go back to read the sidebars in a section with a level 3 heading, if the asides don't start with an h4 heading then the user has to navigate one heading at a time to figure out where the sidebars are, or guess which level they might be at (including higher than their containing subsection).

If they do start with h4, the user can jump from h4 to h4 until they hear it's complementary content and then listen to determine if it's the one they were looking for.

from publ-cg.

JayPanoz avatar JayPanoz commented on June 15, 2024

@peppobon

As @mattgarrish said, the root of this issue is the outline algorithm. If you want this eventually solved, you should probably report this in the existing WHATWG issue.

Reading System developers can’t fix browsers (rendering engines). In most cases, they can only put a band-aid on a wooden leg – especially when the fix requires the RS getting around how browsers work. Only browser vendors (and close contributors) can fix browsers in a way which will 1) be sustainable and 2) benefit the whole ecosystem.

For instance, as a RS contributor, I have to report EPUB-related issues to the CSSWG/spec editors in most cases, or else they wouldn’t even know those issues exist, and web browsers either. So it’s important we don’t stick to the epub-cg or epub-revision if issues apply to the web platform as well.

from publ-cg.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.