make-klone-project(1)

NAME

make-klone-project - manage a KLone based custom Debian package

SYNOPSIS

make-klone-project [options] COMMAND

DESCRIPTION

make-klone-project is a tool to create and manage custom webserver packages that use KLone, a framework that integrates a web site with possibly dynamic content and a web server into a single binary.

The aim is to let the author to focus on editing the site specific files under webapp/ and allow creating a Debian package containing the web server and an init.d script to manage it with dpkg-buildpackage.

USAGE

make-klone-project takes one non-option argument.

create Create a new project directory, package-0.1 and seeds it with

KLone's source and a debian/ directory.

clean Remove all non-user created files and directories ie. everything

but debian/copyright, debian/changelog, debian/wsp.* and webapp/. See also the -l option below.

refresh

Cleans the project directory as with make-klone-project clean and reseeds the KLone source and the debian/ directory.

EXAMPLES

make-klone-project create -p myapp -m "Kari Pahula <kaol@debian.org>" cd myapp-0.1
(edit any files that require editing, mostly in webapp/)
make-klone-project refresh
dpkg-buildpackage -rfakeroot
sudo dpkg -i ../myapp_0.1_i386.deb

OPTIONS

-b NAME

Name the created web server binary as NAME. If not specified the package name is used.

-l Look for the project root directory in clean and refresh com

mands by changing the working directory to the parent directory until they find a file named debian/wsp.opt.maintainer in the current directory. Returns with error if none is found. Without this option, only the current directory is checked for this file.

The upside of using this option is that make-klone-project will be agnostic about the working directory, as long as it is somewhere inside the project tree, just like dpkg-buildpackage. The downside is that you run a greater risk of having the clean command cause unwanted data loss, if you happen to have an unfortunately named file in a wrong place.

-m NAME

Sets the maintainer name as NAME.

-p NAME

Set the package name as NAME. Only effective with the create command. If not specified, uses customkloneapp.

FILES

debian/wsp.description

A custom description for the package. Should be formatted like the corresponding field in the debian/control file.

debian/wsp.opt.*

The options set in prior calls to make-klone-project.

webapp/

The user specified site tree, to be imported as the site by KLone.

NOTES

Your web server will be run as a root, so you will need to use either allow_root or uid and gid options in your etc/kloned.conf.

SEE ALSO

dpkg-buildpackage(1), klone(1), kloned.conf(5), kloned(8).

AUTHOR

make-klone-project was written by Kari Pahula <kaol@debian.org>.

16 Sep 2007 MAKE-KLONE-PROJECT(1)