Index: /main/waeup.diazo/trunk/README.rst
===================================================================
--- /main/waeup.diazo/trunk/README.rst	(revision 10115)
+++ /main/waeup.diazo/trunk/README.rst	(revision 10115)
@@ -0,0 +1,61 @@
+waeup.diazo
+===========
+
+Diazo support for waeup.kofa.
+
+Diazo 'masquerades' running sites. In our case it gives nearly
+unstyled Kofa sites a nice look, injects twitter bootstrap and more.
+
+Prerequisites:
+
+  You need git installed locally. Also libxslt-dev, libxml-dev, a C
+  compiler like gcc, etc.  No Windows(tm) support.
+
+In short:
+
+1) Create a virtual environment (Python 2.6 or 2.7) and activate it::
+
+    $ virtualenv sandbox27
+    $ source sandbox27/bin/activate
+
+2) Build diazo and all the stuff in here::
+
+    (sandbox27)$ python bootstrap.py
+    (sandbox27)$ ./bin/buildout
+
+   This also creates a runnable Grok instance in src/waeup.kofa.
+
+3) Start some grok instance on port 8080 and create a kofa instance
+   named `app`. You can use, for instance, the stuff in src/::
+
+    (sandbox27)$ cd src/waeup.kofa
+    (sandbox27)$ python bootstrap.py
+    (sandbox27)$ ./bin/buildout
+    (sandbox27)$ ./bin/kofactl start
+
+   Now login on http://localhost:8080/ (grok/grok) and create an
+   instance called `app`.
+
+4) Start diazo::
+
+    (sandbox27)$ cd ../../
+    (sandbox27)$ ./bin/paster serve --reload kofaproxy.ini
+
+  Watch the results on http://localhost:8000/.
+
+The results shown can be modified in kofa/base.xml and
+kofa/theme.html. Changes should be reflected immediately, if you
+started the diazo paster process with the ``--reload`` option.
+
+The machine whose output we want to filter is set in
+`kofaproxy.ini`. In this file we also tell where twitter bootstrap and
+static resources reside (and many more things).
+
+To shutdown Diazo press CTRL-D, to stop Grok change to the
+src/waeup.kofa dir and run::
+
+  (sandbox27)$ ./bin kofactl stop
+
+
+Have fun.
+
