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

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

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)
There are complaints about the header L
1. Warning No Character Encoding Found! Falling back to UTF-8.
None of the standards sources gave any information on the character encoding labeling for this document. Without encoding information it is impossible to reliably validate the document. As a fallback solution, the "UTF-8" encoding was used to read the content and attempt to perform the validation, but this is likely to fail for all non-trivial documents.
Read the <http://validator.w3.org/docs/help.html#faq-charset> FAQ entry on character encoding for more details and pointers on how to fix this problem with your document.
2. Warning Unable to Determine Parse Mode!
The validator can process documents either as XML (for document types such as XHTML, SVG, etc.) or SGML (for HTML 4.01 and prior versions). For this document, the information available was not sufficient to determine the parsing mode unambiguously, because:
· the MIME Media Type (text/html) can be used for XML or SGML document types
· No known Document Type could be detected
· No XML declaration (e.g <?xml version="1.0"?>) could be found at the beginning of the document.
· No XML namespace (e.g <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">) could be found at the root of the document.
As a default, the validator is falling back to SGML mode.
3. Warning No DOCTYPE found! Checking with default HTML 4.01 Transitional Document Type.
No DOCTYPE Declaration could be found or recognized in this document. This generally means that the document is not declaring its Document Type at the top. It can also mean that the DOCTYPE declaration contains a spelling error, or that it is not using the correct syntax.
The document was checked using a default "fallback" Document Type Definition that closely resembles “HTML 4.01 Transitional”.
Learn <http://validator.w3.org/docs/help.html#faq-doctype> how to add a doctype to your document from our FAQ.
4. Info No Character encoding declared at document level
No character encoding information was found within the document, either in an HTML meta element or an XML declaration. It is often recommended to declare the character encoding in the document itself, especially if there is a chance that the document will be read from or saved to disk, CD, etc.
See <http://www.w3.org/International/tutorials/tutorial-char-enc/#Slide0250> this tutorial on character encoding for techniques and explanations.
 <http://validator.w3.org/check#jumpbar> ↑ TOP
Validation Output: 2 Errors
1. Error Line 11, Column 1: no document type declaration; implying "<!DOCTYPE HTML SYSTEM>"
 <http://validator.w3.org/feedback.html?uri=;errmsg_id=344#errormsg> ✉
The checked page did not contain a document type ("DOCTYPE") declaration. The Validator has tried to validate with a fallback DTD, but this is quite likely to be incorrect and will generate a large number of incorrect error messages. It is highly recommended that you insert the proper DOCTYPE declaration in your document -- instructions for doing this are given above -- and it is necessary to have this declaration before the page can be declared to be valid.
2. Error Line 14, Column 7: end tag for "HEAD" which is not finished
 <http://validator.w3.org/feedback.html?uri=;errmsg_id=73#errormsg> ✉
Most likely, you nested tags and closed them in the wrong order. For example <p><em>...</p> is not acceptable, as <em> must be closed before <p>. Acceptable nesting is: <p><em>...</em></p>
Another possibility is that you used an element which requires a child element that you did not include. Hence the parent element is "not finished", not complete. For instance, in HTML the <head> element must contain a <title> child element, lists require appropriate list items (<ul> and <ol> require <li>; <dl> requires <dt> and <dd>), and so on.
It would be nice to be able to avoid these warnings.
Has anyone any suggestions on quieting them?
(PS I think I've raised this before and issues with some browsers were a problem then - but surely things should be sorted now?)

Paul A. Bristow,
Prizet Farmhouse, Kendal LA8 8AB  UK
+44 1539 561830  07714330204


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