NAME

Gantry::Build - a Module::Build subclass for Gantry apps

SYNOPSIS

Sample Build.PL:

    use strict;
    use Gantry::Build;

    my $build = Gantry::Build->new(
        build_web_directory => 'html',
        install_web_directories =>  {
            # XXX unix specific paths
            'dev'   => '/home/httpd/html/Contact',
            'qual'  => '/home/httpd/html/Contact',
            'prod'  => '/home/httpd/html/Contact',
        },
        create_makefile_pl => 'passthrough',
        license            => 'perl',
        module_name        => 'Contact',
        requires           => {
            'perl'      => '5',
            'Gantry'    => '3.0',
            'HTML::Prototype' => '0',
        },
        create_makefile_pl  => 'passthrough',

        # XXX unix specific paths
        script_files        => [ glob('bin/*') ],
        'recursive_test_files' => 1,

        # XXX unix specific paths
        install_path        => { script => '/usr/local/bin' },
    );

    $build->create_build_script;

DESCRIPTION

Use this module instead of Module::Build (which it subclasses). Use any or all of the Module::Build constructor keys as needed. Include these keys to make the module sing:

build_web_directory: Usually "html". This is the top level directory of your web content. Put your content in subdirectories of this dir. Example: if you are in the build directory (the one where Build.PL lives), your templates should live in "html/templates".
install_web_directories: This is a hash reference. The keys are what installing users will type, values are where the content from "build_web_directory" subdirectories will go.

METHODS

Except new, these methods are all internal or for use by Module::Build. They are documented to keep POD tests happy.

new: Just like Module::Build->new, but takes the extra parameters shown in the DESCRIPTION above.
ACTION_code: Standard Module::Build routine.
ACTION_install: Standard Module::Build routine.

AUTHOR

Phil Crow <philcrow2000@yahoo.com>

Tim Keefer <tkeefer@gmail.com>

COPYRIGHT and LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.