========================
Glasnost-XML Quick Start
========================

Requirements
------------

Debian (sarge and sid) packages:

 libxml2-python2.3
 libxslt1-python2.3
 python2.3-pyopenssl

NB: latest updates to the code (2005-01-23) require a recent libxml2.
Version 2.6.11, which is currently in Sarge, is too old.
Recent packages libxml2 and libxml2-python2.3 are in experimental.

For DBXML support, add this to /etc/apt/sources.list
deb http://www.lesdeveloppementsdurables.org/debian/ sarge dbxml
deb-src http://www.lesdeveloppementsdurables.org/debian/ sarge dbxml
then install packages libpathan and dbxml

Minimal knownledge of the following specifications:

 XForms (proposed replacement for HTML forms)
   http://www.w3.org/MarkUp/Forms
 
 XML Schema (alternative to DTDs)
   http://www.w3.org/XML/Schema
   
 XPath (API to query XML nodes)
   http://www.w3.org/TR/xpath
 
 XSLT 
   http://www.w3.org/TR/xslt

For Tidy <http://tidy.sourceforge.net/> support, add packages:
 libtidy
 python2.3-ctypes
and install Python library uTidyLib <http://utidylib.berlios.de/>:
 python setup.py install --prefix /usr/local


CVS Checkout
------------

export CVSROOT=':pserver:anonymous@cvs.labs.libre-entreprise.org:/cvsroot/expression'
cvs login
cvs -z3 checkout expression


Installing
----------

As root, install the needed files in /usr/local:
  python setup.py install --prefix /usr/local \
        --install-lib /usr/local/lib/expression/modules \
        --install-data /usr/local/share

Remarks:
 . You can also use a member of group "staff".
 . You need to have the python-dev package installed.
 . install_data will only install the data, the code will remain in your cvs local copy.


Installing XML catalogs
-----------------------

As root:
./install-catalogs


Launching the server
--------------------

ln -s src expression
./expression-server -h
./expression-server -F -ldebug --debug --no-email -f config.xml


Testing
-------

Go to http://localhost:1997/
You should see a nice glasnost index page.


Learning
--------

Some documentation at http://expression.entrouvert.org/documentation.xml
and under docs/


Complaining
-----------

Subscribe and send complaints to the project's development mailing list.
  http://lists.labs.libre-entreprise.org/mailman/listinfo/expression-devel

