Re: Validating Pandoc generated HTML 5

[Nandakumar Chandrasekhar <navanitachora-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

[-- Attachment #1.1: Type: text/plain, Size: 4488 bytes --]

@jgm After doing more research into the value of the role attribute being 
doc-footnote or doc-endnotes, it looks like it all depends on whether we 
are using an <aside> tag or a <section> tag as mentioned here 
<https://kb.daisy.org/publishing/docs/html/notes.html#:~:text=Note%20that%20the%20doc-footnote,to%20group%20notes%20into%20lists.&text=Note%20that%20the%20doc-endnotes,the%20section%20containing%20the%20endnotes.>
.

In Pandoc HTML generation the footnote section is defined as an <aside> and 
should probably use role="doc-footnote" which would fix the HTML5 
validation error.

Should I contribute a pull request for this?

I am not sure if this change will cause issues in the EPUB writer, however.

I would like to know your thoughts.

On Thursday, November 16, 2023 at 8:12:06 AM UTC+5:30 Nandakumar 
Chandrasekhar wrote:

> @jgm I think a possible fix for the ARIA role would be to set it to:
>
> *role="doc-footnote"*
>
> instead of:
>
> *role="doc-endnotes" *
> I found this at: 
> https://kb.daisy.org/publishing/docs/html/dpub-aria/doc-footnote.html 
> which fixes the validation error.
>
> Of course, I have only verified this with my limited use case i.e. 
> footnotes, and I am not sure what the far-reaching consequences of making 
> this change would be.
>
> Cheers
>
> On Wednesday, November 15, 2023 at 11:15:59 PM UTC+5:30 Nandakumar 
> Chandrasekhar wrote:
>
>> Thank you for your reply.
>>
>> I am using the validator put out by the W3C avaliable at: 
>> https://validator.w3.org/
>>
>> I will experiment with XHTML and figure out the syntactic differences and 
>> see what happens.
>>
>> I do not know much about aria roles so will have read up on those.
>>
>> Many thanks.
>>
>> On Wed, 15 Nov, 2023, 20:48 Nandakumar Chandrasekhar, <
>> navani...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
>>
>>> Dear Folks,
>>>
>>> I have the following question in regard to the HTML 5 generated by 
>>> Pandoc.
>>>
>>> Is Pandoc generating HTML 5 using the XHTML standard?
>>>
>>> When validating the generated HTML through the W3C validator I see the 
>>> following information notices about void elements:
>>>
>>> Trailing slash on void elements has no effect 
>>> <https://github.com/validator/validator/wiki/Markup-%C2%BB-Void-elements#trailing-slashes-in-void-element-start-tags-do-not-mark-the-start-tags-as-self-closing>
>>>  and interacts badly with unquoted attribute values 
>>> <https://github.com/validator/validator/wiki/Markup-%C2%BB-Void-elements#trailing-slashes-directly-preceded-by-unquoted-attribute-values>
>>> .
>>>
>>> Since this is just informational I am not too worried about the trailing 
>>> slash being placed at the end of elements although it does not seem to be 
>>> part of the HTML 5 standard.
>>>
>>> However, when I am faced with an error like below I would like to fix it:
>>>
>>> Error: Bad value doc-endnotes for attribute role on element aside 
>>> <https://html.spec.whatwg.org/multipage/#the-aside-element>.
>>> </figure>↩<aside id="footnotes" class="footnotes 
>>> footnotes-end-of-document"↩role="doc-endnotes">↩<hr />
>>>
>>> I would like to know the community's verdict on this and how I may 
>>> remove these messages while validating if at all possible. Many thanks
>>>
>>> -- 
>>> You received this message because you are subscribed to a topic in the 
>>> Google Groups "pandoc-discuss" group.
>>> To unsubscribe from this topic, visit 
>>> https://groups.google.com/d/topic/pandoc-discuss/E7Y0798bvp0/unsubscribe
>>> .
>>> To unsubscribe from this group and all its topics, send an email to 
>>> pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>>
>>
>>> To view this discussion on the web visit 
>>> https://groups.google.com/d/msgid/pandoc-discuss/f5859ff8-3e37-4794-9c85-ef6456cd73c1n%40googlegroups.com 
>>> <https://groups.google.com/d/msgid/pandoc-discuss/f5859ff8-3e37-4794-9c85-ef6456cd73c1n%40googlegroups.com?utm_medium=email&utm_source=footer>
>>> .
>>>
>>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/08116215-7638-4f79-9261-2574aa1422e7n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 11206 bytes --]