CheckHTML

Specify an external program to use to report on the HTML output.

Synopsis

Scope

This directive is only available for use in the global (interchange.cfg) configuration file, and will affect all websites running under the Interchange installation.  It will not work in a website's local (catalog.cfg) configuration file. 

Description

This defines the name of an external program which will be invoked to check HTML code, generated by Interchange pages, for correctness.  An example program could be "/usr/bin/weblint".

Note You need to put [flag checkhtml] on your page, or wrap a block of HTML code in [tag flag checkhtml]...[/tag], to trigger the specified external command.

The output of the HTML checker program will be included in the output page, so you might want to wrap the output in HTML comments (<!-- ... -->).  You can then check the output by viewing the HTML page source in your browser.

If you want a quick way to enable or disable this feature, without modifying each HTML page individually, put __CHECK_HTML__ on every page or, ideally, in a template.  To enable the checker, define the following in your interchange.cfg global configuration file:

You can delete, or comment out, the variable to switch the facility off.

Warning Leaving this directive enabled on a live server will cause unnecessary performance degradation.  The additional time taken to spawn the external process, combined with the time taken for the process to complete, is very costly, especially considering that the process will be spawned every time the marked pages are requested.

Example