Code Monkey home page Code Monkey logo

Comments (6)

aleventhal avatar aleventhal commented on June 29, 2024

Thanks Matt. I don't remember why this was decided, or who's idea it was. Can you find any correspondence on that?

It just forces duplicated numbers in close proximity as far as I can tell.

Can you explain this part more?

from dpub-aria.

mattgarrish avatar mattgarrish commented on June 29, 2024

Can you find any correspondence on that?

No, I was hoping you might remember... 😄

All I've been able to find is your original pull request #28 but it doesn't have any specific discussion about the restrictions. My guess would be that it was related to the abandoned request for a doc-pagenum role and not wanting confusion over where to place one or the other. If that was the case, though, it would further eliminate a need for restricting page breaks from headers.

It just forces duplicated numbers in close proximity as far as I can tell.

Can you explain this part more?

Going by the example in the specification, you'd need to mark an invisible page break with the same number outside the header, like this:

<section role="doc-pageheader">
   <div>War and Peace</div>
   <div>321</div>
</section>
<div role="doc-pagebreak" aria-label="321"/>
…

Headers aren't usually included in ebooks as they tend to cause confusion with the reading system-generated ones, but I don't see that publishers will like this kind of pattern if they do have to include them.

If we remove the restriction, the page number inside the header can be tagged once:

<section role="doc-pageheader">
   <div>War and Peace</div>
   <div role="doc-pagebreak">321</div>
</section>
…

from dpub-aria.

aleventhal avatar aleventhal commented on June 29, 2024

I agree with most of this, but I find that using the accessible name on a pagebreak for the page number to be funky -- not in the P-Funk sense, but in the bad smell sense :)

To me, the actual page break is above War and Peace.

from dpub-aria.

mattgarrish avatar mattgarrish commented on June 29, 2024

I find that using the accessible name on a pagebreak for the page number to be funky

That's the way it's been done in EPUB for over a decade now, predating the role, so it may be but we can't change it without breaking content and the way publishers are operating right now.

To me, the actual page break is above War and Peace.

Yes, I don't know that anyone would do it this way (or do it at all), but I don't like declaring that it's absolutely not allowed. The page number could occur before the title (e.g., if the running header is set below the page number). It was only meant as a demonstration.

from dpub-aria.

aleventhal avatar aleventhal commented on June 29, 2024

Ok. How about we provide some guidance as to what is good, as opposed to making limitations on what's allowed? What the ideal structure?
Perhaps we should say something about how to avoid duplicated page numbers.

from dpub-aria.

mattgarrish avatar mattgarrish commented on June 29, 2024

Closing with #46

from dpub-aria.

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.