Re: Validating Pandoc generated HTML 5

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

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...-Re5JQEeQqe8@public.gmane.orgm> 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/1EF73A39-A2CD-49D0-9F14-3EDDB1E85A23%40gmail.com.