expression/README.quickstart

======================
Expression Quick Start
======================

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

Debian (sarge and sid) packages:

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

For DBXML support, add this to /etc/apt/sources.list
deb http://www.lesdeveloppementsdurables.org/debian/ sarge dbxml2 python-bsddb3
then install package libdbxml-python

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

For SVG support, you need package svg2png, add this to /etc/apt/sources.list:
deb http://cairographics.org/packages/debian/ unstable/


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

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


Registering XML catalog directories
-----------------------------------

As root (or a member of group "staff" so you can write below /usr/local):

for d in entities schema misc
do
 ln -s $PWD/xml/$d /usr/local/share/xml/$d/expression
done

As root:
./install-catalogs


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

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


Testing
-------

Go to http://localhost:1997/
You should see a nice test 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