Question

• TWiki version: 20011201

Running HTML-tidy on TwikiDocumentation.html shows up some interesting problems.

For example, the "Overview" anchor is over used:

grep -n "#Overview" TWikiDocumentation.html 
18:<li> <a href="#Overview">Overview</a>
30:<li> <a href="#Overview">Overview</a>
62:<li> <a href="#Overview">Overview</a>
110:<li> <a href="#Overview">Overview</a>
126:<li> <a href="#Overview">Overview</a>
196:<li> <a href="#Overview">Overview</a>
240:<li> <a href="#Overview">Overview</a>
270:<li> <a href="#Overview">Overview</a>
306:<li> <a href="#Overview">Overview</a>
316:<li> <a href="#Overview">Overview</a>
334:<li> <a href="#Overview">Overview</a>
366:<li> <a href="#Overview">Overview</a>
414:<li> <a href="#Overview">Overview</a>
444:<li> <a href="#Overview">Overview</a>
468:<li> <a href="#Overview">Overview</a>
478:<li> <a href="#Overview">Overview</a>

So is "Known_Issues", "Setting_Preferences" and a few others.

There are other anomalies that seem common to hand-written code such as incorrect nesting of "< pre >" and "< font >" and "< span >".

I appreciate this isn't a code-critical issue in this instance, but perhaps using HTML-tidy should be standard quality control. It can be used to check the output of the code and alterations from using skins and plugin-ins.

-- AntonAylward - 19 Dec 2002

Answer

Multiple anchor names with the same name is a known limitation of the TOC handling. This will be fixed.

Incorrect nesting is another issue that needs to be addressed.

I usually use the HTML validator at the W3C site.

-- PeterThoeny - 19 Dec 2002

Great. Perhaps we should also tell the skins developers about it. I'm curently playing with SeeSkin and KoalaSkin and saving the output and then running 'tidy' on the file. Some interesting odities show up. I'll e-mail the developers directly with my observations

-- AntonAylward - 19 Dec 2002

Yes, I think validation is important. I made a fairly good cleanup on KoalaSkin 1.16 (with the w3c validator) and these validations issues is what makes me opposed to switching to xhtml due to the fact that users enter html, not xhtml in their pages.

On this subject, having a way to have a link "validate this page" on pages may be interesting for authors...

-- ColasNahaboo - 19 Dec 2002