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.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
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