NAME

combustier - run a standalone combust server

About

This program makes it easier to preview changes to combust-based sites (such as the perl.org sites) without going through the full apache/combust setup process.

This allows you to preview your changes to the site before checking-in to the live svn.

Caveats

This setup should reliably render all of the actual content (failing to do this is definitely a bug.) It may return errors for some requests where the live site would redirect, or other scenarios.

Setup

mkdir perl.org
cd perl.org

You'll need to fetch the combust code, as well as the perl.org shared components:

git clone git://git.develooper.com/combust.git combust2
svn co https://svn.perl.org/perl.org/docs/live/shared

Then whichever site you plan to hack on:

svn co https://svn.perl.org/perl.org/docs/live/learn

Now simply run combustier:

combustier learn

Usage

combustier [OPTIONS] combust.conf

Options

-c, --combust PATH

Path to combust tree. This should typically be a checkout from git://git.develooper.com/combust.git.

DEFAULT: combust2

--port NUMBER

Server port number.

DEFAULT: 9090

-h, --help

Show help about options.