nlbdev / nordic-accessible-epub-guidelines

2 stars 2 forks source link

Define a general rule for composing labels for untitled chapter sections #62

Closed martinpub closed 7 months ago

martinpub commented 8 months ago

Decision is to use MTM's current algorithm:

For bodymatter sections where no heading is available in the source copy, the Nordic Guidelines require labels to be created and stored in an @aria-label attribute in the heading section. For MTM productions, if nothing else is mentioned in accompanying Editing Instructions, we kindly request our producers to name the untitled sections using the first three words of the chapter text, followed by a space and an ellipsis, e.g. aria-label="Det var längesedan …" for a bodymatter section where the first three words of the body text are "Det var längesedan".

martinpub commented 8 months ago

See also #6

josteinaj commented 8 months ago

What if there are no sections? One example is the Discworld novels. They're just a series of paragraphs, separated by thematic breaks. Should producers put the whole book in one big chapter or should they group the content into untitled sections? If so, should there be some suggestions about using thematic breaks as possible break points when creating sections? I think it is useful to create sections, not only for being able to navigate the book (navigating by page breaks is always an option), but mainly for performance reasons. If you open an e-book on a reading system such as Kindle, Kobo or Pocketbook, you will get very sluggish performance. Especially when changing font size and navigating between big content files.

martinpub commented 8 months ago

This issue is not addressing section boundaries as such, I think the assumption is that sections are already created for separating the book into smaller chunks (e.g. chapters). This is just about the labelling of those sections.

josteinaj commented 8 months ago

Ok, I created a separate issue for it: https://github.com/nlbdev/nordic-accessible-epub-guidelines/issues/65

martinpub commented 7 months ago

I will add something along the lines of "this method can also be used in cases where there are untitled sections on levels below chapter".

martinpub commented 7 months ago

I tried to update but I realise

I will add something along the lines of "this method can also be used in cases where there are untitled sections on levels below chapter".

is potentially in conflict with the current text

No sub-sections of any content document should have an aria-label or aria-labelledby attribute, unless specific instructions are given by the Ordering Agency.

Any ideas?

oscarlcarlsson commented 7 months ago

As long as it's allowed to include aria-labels on sub sections I guess we can keep it on an editing instruction-level.

martinpub commented 7 months ago

OK great.