Re: [Boost-docs] [Invalid] Markup Validation of index.html - W3C Markup Validator_files

Subject: Re: [Boost-docs] [Invalid] Markup Validation of index.html - W3C Markup Validator_files
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2013-12-19 09:17:40


> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Wednesday, December 18, 2013 7:55 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] [Invalid] Markup Validation of index.html - W3C Markup Validator_files
>
> On 18 December 2013 19:20, Paul A. Bristow <pbristow_at_[hidden]> wrote:
> > I've been checking the output from a documentation produced using
> > Quickbook
> >
> > (after getting a clean bill of health from Boost inspect tool and
> > Doxygen warnings-free)
>
> It's a bit hard to comment without knowing what file these are for.
> But generally speaking validation is mainly useful for hand generated files, and even then it's
not nearly
> as useful a check as many believe. I don't see generating valid html as an important goal.
>
> > There are complaints about the header L
> >
> > 1. Warning No Character Encoding Found! Falling back to UTF-8.
>
> There should be a tag in the generated html that looks like:
>
> <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
>
> And even if it isn't understood, the generated text should be all ASCII so the default encoding
should
> always be fine. The reason I did it that way is because the encoding specified in the file can be
overridden
> by http parameters, and I don't always have control over how the files are served, so I used the
safest
> option.
>
> > 2. Warning Unable to Determine Parse Mode!
>
> This really doesn't matter, browsers always use a HTML parser unless the http mime type tells them
> otherwise.
>
> > 3. Warning No DOCTYPE found! Checking with default HTML 4.01 Transitional Document Type.
>
> The boostbook css was written for quirks mode. adding a doctype would cause browsers to use
> standards mode which makes some things look wrong (such as tables). It would be nice to fix this,
but it's
> not a priority.
>
> > 4. Info No Character encoding declared at document level
> > 1. Error Line 11, Column 1: no document type declaration; implying "<!DOCTYPE HTML SYSTEM>"
>
> Already gone over these.

OK - thanks - I'll file it under

"A foolish consistency is the hobgoblin of little minds," ;-)

Paul

PS I'll investigate this one

> > 2. Error Line 14, Column 7: end tag for "HEAD" which is not finished
>
> This one is odd. Do you have a title tag? Or maybe it just doesn't understand that some tags are
self
> closing.


This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC