NAME

Catalyst::TraitFor::View::MarkupValidation - Validates output and replaces it with an error report if not OK

SYNOPSIS

    package Catalyst::View::Validation;

    use Moose;
    use namespace::autoclean;

    extends qw/Catalyst::View::TT/;
    with qw/Catalyst::TraitFor::View::MarkupValidation/;

    __PACKAGE__->config(MARKUP_VALIDATOR_URI => q[http://localhost/w3c-validator/check]);

    1;

DESCRIPTION

This is a Role which which takes generated content that is ready for output and validates it. If there are errors it replaces the default output with an error report.

CONFIGURATION

You must set the MARKUP_VALIDATOR_URI to the URI for an instance of the W3C Markup Validation Service. You are encouraged to install a local instance of the validator so that you see high levels of performance and do not hammer the public server (which is funded by donations).

See http://validator.w3.org/source/ for downloads and installation instructions on a variety of platforms.

CAVEATS

This is useful when you're developing your application, as it will identify validity errors in the markup. In production, however, the performance cost is likely to be too high, and throwing errors at users that browsers could probably recover from is unfriendly.

This module checks that Catalyst is running in debug mode and will not run if it is not.

METHOD MODIFIERS

after process

Validates document and (in event of an error) replaces it with an error report.

TODO

Make document types that get validated configurable

Add line numbering to output

Hyperlink from error to source

BUGS AND LIMITATIONS

Please report any you find using RT.

If URI to validation service is incorrect, shows error report w/ 0 errors.

AUTHOR

David Dorward (dorward) <david@dorward.me.uk>

CONTRIBUTORS

Tomas Doran (t0m) <bobtfish@bobtfish.net>

LICENSE AND COPYRIGHT

This module itself is copyright (c) 2009 David Dorward and is licensed under the same terms as Perl itself.