Name

CheckHTML — check the generated HTML code with an external program

SYNOPSIS

program_name_and_arguments

DESCRIPTION

Defines the name of an external program which will be invoked to check the generated page HTML code for correctness (/usr/bin/weblint, for example).

Note that you need to put [flag checkhtml] on your page, (or wrap only a block of HTML code to check in [tag flag checkhtml]...[/tag]) to trigger the actual invocation of the specified external command.

The output of the HTML checker program will be included in the output page, so you might want to wrap it in HTML comments (<!-- ... -->). Then you can check it out 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). Then, to enable the checker, define Variable CHECK_HTML [flag checkhtml] in interchange.cfg. To disable it, leave the variable value empty.

DIRECTIVE TYPE AND DEFAULT VALUE

Global directive

EXAMPLES

Example: Enabling CheckHTML

CheckHTML /usr/local/bin/weblint --structure --fluff -

NOTES

Leaving this directive enabled on a production server usually leads to unnecessary performance degradation. The additional process spawn (and the time it takes to complete) every time a page is visited is costly.

Additionally, this directive currently appears to be broken (it simply never gets called).

AVAILABILITY

CheckHTML is available in Interchange versions:

4.6.0-5.9.0 (git-head)

SOURCE

Interchange 5.9.0:

Source: lib/Vend/Config.pm
Line 509

['CheckHTML',      undef,            ''],

AUTHORS

Interchange Development Group

SEE ALSO

DocBook! Interchange!