Should HTML documents produced by Quarto be tidy-HTML5 compliant? #3831
Replies: 2 comments 4 replies
-
|
It looks to me like there is a head tag in the first example (at the end of the line). Are there other issues that tidy flags? |
Beta Was this translation helpful? Give feedback.
-
|
Ah, missed that tag completely because of the formatting! There are a number of other changes, but most of them have to do with formatting. Apart from formatting, with the default HTML document example rendered, line 134 column 333 - Warning: trimming empty <i>
line 134 column 274 - Warning: trimming empty <button>
Info: Document content looks like XHTML5
Tidy found 2 warnings and 0 errors! |
Beta Was this translation helpful? Give feedback.
-
|
I'll take a peek at those warnings, but I'm guessing that those are elements targeted by CSS or JS which need to remain (e.g. a bootstrap icon for example). |
Beta Was this translation helpful? Give feedback.
-
|
Related: #7489 |
Beta Was this translation helpful? Give feedback.
-
|
I'd be cautious of trusting third party validators that have opinions about good HTML rather than actually being a validator. For example, we document that if we fail to parse an HTML table that passes the official w3c validator, then we consider that a bug. But we can't take third-party tools as arbitrators of good markup, it's just not a good idea. |
Beta Was this translation helpful? Give feedback.
-
|
Thank you for your insight! 🙏 |
Beta Was this translation helpful? Give feedback.
-
Tidy HTML (http://www.html-tidy.org/) tool helps correct and clean up HTML and XML documents by fixing markup errors, and I am wondering if it might be a good idea to make sure that all HTML outputs from Quarto have
0 warningsand0 errorsfromtidycheck and also the formatting istidy-compliant.E.g. with v1.3.78, if I open example html format document shipped with RStudio and render it. The HTML produced has
<meta>tags outside<head>tags:If I run tidy tool on this document:
tidy -m -i -w 120 -c -utf8 *.htmlIt changes this to:
But maybe the original HTML produced Quarto should already look tidied?
That is, the users shouldn't even need to use tidy tool since Quarto HTMLs will by default be tidy-compliant, or at least as compliant as they can be without having to sacrifice any Quarto-specific innovation.
Beta Was this translation helpful? Give feedback.
All reactions