**********************************************************
    
    newSite.txt
    
    $Id$
    
    @author gERD Schaufelberger <gerd@exit0.net>
    @copyright 2004/2005 Wombat Web Bench
    @link http://wombat.exit0.net
    @package wombatSite
    @subpackage manual
    
**********************************************************

HOWTO CREATE A NEW SITE
=======================

A concrete site requires some files and folders to work. Thus "baseDir" have to
be populated. Create the "baseDir" for the new site and:

Create Folders
--------------
$ mkdir conf conf/pages templates templates/static var extension htdoc

Copy basic files
----------------
$ cp systemDir/conf/*.xml conf
$ cp systemDir/conf/*.php conf

Adjust configuration
--------------------

Create factor loader and index.php
----------------------------------

Save the following content to 'factoryLoader.php' in baseDir
-----------------8<-----------------8<-----------------8<-----------------
<?php
/**
 * factory loader
 */
    include_once  'WHERE/TO/FIND//include/wbFactory.php';
    wbFactory::setParam( 'baseDir', dirname( __FILE__ ) );
?>
-----------------8<-----------------8<-----------------8<-----------------


A typical index.php in baseDir/htdoc may look like this:
-----------------8<-----------------8<-----------------8<-----------------
<?php
/**
 * main catcher for all requests
 */
    include_once '../factoryLoader.php';
    
    wbFactory::configure();
    
    $site	=&	wbFactory::singleton( 'wbSite' );
    $site->process();
?>
-----------------8<-----------------8<-----------------8<-----------------

SITE ADMINISTRATION
===================
To enable the site admin interface, additional files are required: 

 htdoc/admin
 htdoc/cms.php (if you use the SiteMaker)

Adjust configuration files: 
 admin.xml
 siteMaker.xml

MAKE WORLD
==========

$ wombatmake -v site
$ wombatmake -v admin