NAME
    Plack::Middleware::FileWrap - Wrap file with headers/footers in Plack

VERSION
    version 0.01

  SYNOPSIS
        use Plack::Builder;

        # with text
        mount '/static/docs/' => builder {
            enable 'FileWrap', headers => [\'TEST HEAD'], footers => [\'TEST FOOT'];
            Plack::App::File->new( root => "/path/to/static/docs" )->to_app;
        },
    
        # with file
        builder {
            enable 'FileWrap', headers => ['/path/to/headerA.html', '/path/to/headerB.html'], footers => ['/path/to/footer.html'];
            $app;
        },

  DESCRIPTION
    Enable this middleware to allow your Plack-based application to have
    common header/footer.

   CONFIGURATIONS
    headers, footers
        Arrayref. Text ref or file paths. can be mixed like

            headers => [ \'<!-- blabla -->', '/path/to/file/header.html' ]

   EXAMPLES with enable_if
    If you have images or other files under the same directory and you don't
    want to apply the changes, please use enable_if:

        mount '/static/docs/' => builder {
            enable_if { $_[0]->{PATH_INFO} =~ /\.html/ } 'FileWrap',
                headers => ["$root/static/docs/header.html"], footers => ["$root/static/docs/footer.html"];
            Plack::App::File->new( root => "$root/static/docs" )->to_app;
        },

AUTHOR
    Fayland Lam <fayland@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2011 by Fayland Lam.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.