Enable Apache2 rewrite module
=============================

The multisite fonction in this package relies on the Apache2 rewrite module.
  e.g.: a2enmod rewrite


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

To configure a SPIP website you should:
* point the required http address to /usr/share/spip in your web server;
  e.g.:	cp /usr/share/doc/spip/apache2.conf /etc/apache2/sites-available/http-host.conf
	edit /etc/apache2/sites-available/http-host.conf 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 below).
* 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/apache2/conf-available/spip.conf,
included by default in the webserver configuration.
