
Needed steps to handle a SPIP instance
======================================

To configure a SPIP website you should:
* point the required http address to /var/lib/spip in your web server;
  e.g.:	cp /usr/share/doc/spip/apache2.conf /etc/apache2/sites-available/http-host
	edit /etc/apache2/sites-available/http-host to fit your needs
	a2ensite http-host
* use this command: spip_add_site http-host;
  This will register a SPIP instance for this host.
  You can add more in /etc/spip/sites/http-host.php (see bellow).
* make sure to have access to a database;
  e.g.:	CREATE DATABASE http-host character;
	CREATE user 'http-host'@'localhost' IDENTIFIED BY 'a_password_you_should_change';
	GRANT ALL privileges ON http-host.* TO 'http-host'@'localhost';
* visit <URL:http://http-host/ecrire> and complete the installation.


About /etc/spip/sites/http-host.php format
==========================================

The correspondence between the various site files and the HTTP request
is made using $GLOBALS['spip_sites'][$site], where $site is 
the directory of the site's files (/var/lib/spip/sites/$site).

You can use regular expressions. For instance:
  $GLOBALS['spip_sites']['foo'] = array('foo.example.com\/spip_[^\/]+\/.*');
Will match requests of the form: "http://foo.example.com/spip_bar/whatever"


Global configuration
====================

There is an Apache configuration file at /etc/spip/apache.conf and
a file for Cherokee too.

This file is included in your webserver configuration if you requested it during
package configuration.

