NAME
    Apache2::Layout - mod_perl 2.0 html layout engine
SYNOPSIS
    httpd.conf:
      PerlModule Apache2::Layout
      Alias /layout /usr/local/apache2/htdocs
      
        PerlOutputFilterHandler Apache2::Layout
        PerlSetVar LayoutFooter /footer.html
        PerlSetVar LayoutHeader /header.html
        PerlSetVar LayoutCSS /head.html
      
DESCRIPTION
    Apache2::Layout is a filter module that can be used to inject HTML
    layout into HTML documents. Very handy when trying to apply
    customizations to existing HTML content without needing to change them.
    Only documents with a content type of "text/html" are affected - all
    others are passed through unaltered.
OPTIONS
    LayoutComments
        Inserts HTML comments in the output, marking where inserted content
        begins and ends
          PerlSetVar LayoutComments On
        LayoutComments has no default.
    LayoutDebug
        Logs debugging information about the processing. Combined with
        LayoutComments, will insert a debug summary as an HTML comment at
        the end of the filtered document.
          PerlSetVar LayoutDebug On
        LayoutDebug has no default.
    LayoutCSS
        Specifies a url to insert right before the end of the HTML 
        element, typically used to inject stylesheets into the document.
          PerlSetVar LayoutCSS /css/style.css
        LayoutCSS has no default.
    LayoutHeader
        Specifies a url to insert right after the beginning of the HTML
         element, typically used to inject the begging of a content
        wrapper into the document.
          PerlSetVar LayoutHeader /templates/header.html
        LayoutHeader has no default.
    LayoutFooter
        Specifies a url to insert right before the end of the HTML 
        element, typically used to inject the end of a content wrapper into
        the document.
          PerlSetVar LayoutHeader /templates/footer.html
        LayoutFooter has no default.
API
  handler
    This is the one and only user-visible function, it's the main filter
    handler.
      PerlOutputFilterHandler Apache2::Layout
NOTES
    This is alpha software, and as such has not been tested on multiple
    platforms or environments.
SEE ALSO
    perl(1), mod_perl(3), Apache(3), mod_layout
AUTHOR
    Philippe M. Chiasson 
REPOSITORY
    http://svn.ectoplasm.org/projects/perl/Apache2-Layout/trunk/
COPYRIGHT
    Copyright (c) 2007, Philippe M. Chiasson All rights reserved.
    This module is free software. It may be used, redistributed and/or
    modified under the same terms as Perl itself.