About the Configuration File

The configuration file (htmlvalV170.cfg) contains the elements, attributes, attribute values, tag name programs, and more that CSE HTML Validator uses to validate a document. This includes many, but not all, of the validator messages that it is capable of generating. Many of the tag name programs use "flags" that let you easily customize the validations. What do the flags do?

Editing and Customizing the Configuration File

CSE HTML Validator should work sufficiently with its default configuration without altering the default active categories and without other changes. However, if you want to "fine-tune" the configuration then you can if you have the professional or enterprise edition.

The configuration file can be edited using the Configuration Editor in the professional and enterprise editions (the Configuration Editor may appear confusing at first, because of its many options). If you do decide that you want to customize the configuration then the following information in this topic and in other documentation topics will help you decide what categories you want active and what other customizations you may wish to make.

hmtoggle_plus1Important Editing Notes (if you edit the configuration file)

About Categories

NOTE: For typical usage of CSE HTML Validator, you should not have to change the active categories or otherwise use the Configuration Editor.

CSE HTML Validator comes with an included configuration file that supports many different 'categories' of elements. Support for HTML 5.2, HTML 5.1, HTML5, HTML 4.01, HTML 4.0, XHTML 1.0, XHTML 1.1, HTML Microdata, Netscape extensions (legacy), Microsoft Internet Explorer extensions (legacy), WML, XHTML and more is already included. Note that some categories such as WML are only supported by the standard and higher editions.

An important characteristic of the included configuration file is that the categories are built upon one another. This means that if you want to validate against HTML 3.2, then the HTML 2.0 category, in addition to the HTML 3.2 category must be active. To validate against HTML 4.0 (or XHTML), the HTML 2.0, HTML 3.2, and HTML 4.0 categories must all be active (HTML 4.0 cannot be the only active category). This is because the HTML 4.0 category requires the HTML 3.2 category as its "foundation", and the HTML 3.2 category requires the HTML 2.0 category as its "foundation". Similarly, supporting HTML5 requires HTML 4.01 and all of HTML 4.01's underlying categories to also be active.

The default is for most categories to be active. If needed, categories that are not active may automatically be made active by a tag name program when a document is checked. Therefore, depending on how a specific category works, a non-active category may still allow syntax checking of that category even if it is inactive.

hmtoggle_plus1Additional Category Notes

Lite Edition

CSE HTML Validator Lite does not support messages generated by tag name programs, one of the most powerful features of the standard and above editions. Because it does not support these messages, the following information about the validator flags does not apply to the lite edition. The lite edition will never generate any of the messages that you see below. If you are using the lite edition, consider upgrading to the standard edition or better so that you can see many more messages and benefit from significantly improved syntax checking.


Message ID Feature: If you only want to disable a single message instead of all the messages for a particular flag, then you can do this by choosing to enable or disable a message on an individual basis. This works for most messages but not all. To do this, bring up the context menu for the message in the integrated editor (usually by right-clicking on the message) and choose the desired option from the Message Options sub-menu. This feature may be referred to as the message ID feature because it only works for messages that have message IDs. More information about disabling messages.

If you want to disable all tag name program functionality (not recommended), then you can uncheck the Enable programs validator engine option. This will cause any messages (such as the below messages listed under the flags) generated by a tag name program to not be displayed. It will also speed up the validation engine. However, disabling the tag name programs may significantly reduce the effectiveness of the validation and could even result, in some cases, in incorrect results. NOTE: The tag name program feature is considered to be a powerful feature of CSE HTML Validator Standard and above, and therefore should not be disabled.

If you want to disable a tag name program for a specific element or attribute, then you can use the Programs tab in the Configuration Editor (professional and enterprise editions) to select the tag name with the program you wish to disable and then uncheck the Enable open program for tag or Enable close program for tag option. NOTE: This is not recommended.