Re: Validating Pandoc generated HTML 5

[John MacFarlane <fiddlosopher-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

I'm also going to change the behavior for HTML5 when footnotes are at the end.
Instead of an aside element, we'll use a section, and then it can have the appropriate
role, endnotes.

> On Dec 4, 2023, at 8:56 AM, John MacFarlane <fiddlosopher-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> 
> Thanks. I'll make the change (it's very simple).  It won't affect EPUB.
> It feels wrong either way, actually: this aside may contain multiple notes, so 'footnote' (singular) doesn't seem right.
> But it's not at the end, so 'endnotes' isn't right either.
> At least this way the validator won't complain.
> 
>> On Nov 17, 2023, at 7:33 AM, Nandakumar Chandrasekhar <navanitachora@gmail.com> wrote:
>> 
>> @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.
>> 
>> 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...@gmail.com> 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 and interacts badly with 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.
>> </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.
>> 
>> -- 
>> 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.
> 

-- 
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/30400E29-2EF8-494E-9AF8-F3EFC7784372%40gmail.com.