NAME

Bigtop::Backend::HttpdConf::Gantry - httpd.conf generator for the Gantry framework

SYNOPSIS

If your bigtop file includes:

    config {
        HttpdConf Gantry {}
    }

and there are controllers in your app section, this module will generate docs/httpd.conf when you type:

    bigtop app.bigtop HttpdConf

    bigtop app.bigtop all

You can then directly Include this conf in your system httpd.conf or in one of its virtual hosts.

DESCRIPTION

This is a Bigtop backend which generates httpd.conf files.

By default, this module converts every statement in an app or controller level config block into a PerlSetVar statement. If you have a different conf scheme in mind (like Gantry::Conf with flat files), you may not want to define those set vars. In that, case do this in the Bigtop config section:

    config {
        HttpdConf Gantry { skip_config 1; }
    }

Any PerlSetVar statements you put in literal Location statements will still appear (remember: literal means literal). But, no PerlSetVar statements will be made by the module.

KEYWORDS

This module does not register any keywords. See Bigtop::HttpdConf for a list of allowed keywords (think app and controller level 'location' and controller level 'rel_location' statements).

METHODS

To keep podcoverage tests happy.

backend_block_keywords

Tells tentmaker that I understand these config section backend block keywords:

    no_gen
    gen_root
    full_use
    gantry_conf
    skip_config
    template

    instance
    conffile

Note that instance and conffile are deprecated. You should use the single gantry_conf instead. Then the instance and conffile will be drawn from the Conf Gantry backend's config block. This save duplicating that data.

what_do_you_make

Tells tentmaker what this module makes. Summary: docs/httpd.conf.

gen_HttpdConf

Called by Bigtop::Parser to get me to do my thing.

output_httpd_conf

What I call on the AST packages to do my thing.

setup_template

Called by Bigtop::Parser so the user can substitute an alternate template for the hard coded one here.

AUTHOR

Phil Crow <crow.phil@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.