[z3-checkins] r33238 - in z3/deliverance/branches/packaged: . content themes

Thu Oct 12 20:47:51 CEST 2006

Author: ltucker
Date: Thu Oct 12 20:47:45 2006
New Revision: 33238

Removed:
   z3/deliverance/branches/packaged/content/
   z3/deliverance/branches/packaged/themes/
Modified:
   z3/deliverance/branches/packaged/README.txt
Log:
adding instructions for running tests, removing old test data

Modified: z3/deliverance/branches/packaged/README.txt
==============================================================================

--- z3/deliverance/branches/packaged/README.txt	(original)
+++ z3/deliverance/branches/packaged/README.txt	Thu Oct 12 20:47:45 2006
@@ -1,77 +1,45 @@
-=======================================
-Deliverance, high-speed themes for Zope
-=======================================
 
-Quick Start
------------
-
-1) Install lxml.
-
-2) cd to the directory containing this README.
-
-3) python ./deliverance.py
-
-This runs the timeit function, showing average time to apply a simple theme.
-
-
-Quick mod_python Start
-----------------------
-
-1) Edit mpfilter.conf and point it to where you put the SVN checkout.
-
-2) In your Apache httpd.conf file, add a line like this::
-
-  Include /Users/me/sandboxes/namespaced/mpfilter.conf
-
-3) Shut Apache down and restart.
-
-4) Keep an eye on the Apache error log::
-
-  tail -f logs/error_log
-
-5) Open a URL like this (or however you have your HTML files pointed to on 
-whichever port)::
-
-  http://localhost:9000/sandboxes/namespaced/
+Quick Start to run tests 
+-------------------------
 
-6) If that works, click on the on the "content" directory or go to this URL::
+get workingenv.py from
+http://cheeseshop.python.org/pypi/workingenv.py
 
-  http://localhost:9000/sandboxes/namespaced/content/intro.html
+Create a working enviornment for deliverance and its dependencies:  
 
-7) In the site menu on that page, try clicking on the 3 links.
+workingenv.py deliverance_env
+source deliverance_env/bin/activate
 
+Install lxml using the buildout 
+(full instructions at http://faassen.n--tree.net/blog/view/weblog/2006/10/03/0,  
+ alternatively, install a recent cvs version of libxml2,libxstl and svn lxml. 
+ You are likely to encounter segfaults if recent versions are not used.)
 
-Customization Quick Start
--------------------------
+$ svn co https://infrae.com/svn/buildout/lxml-recent/trunk lxml-recent
+$ cd lxml-recent
+$ python bootstrap/bootstrap.py
+$ bin/buildout
 
-1) Edit ``themes/simple/sampletheme.xml`` and add the following snippet 
-**inside** the ``<div id="pageframe">``::
+put the lxml egg into your deliverance environment 
 
-  <div id="pageauthor">Theme section for author</div>
+$ cp -r lxml-recent/develop-eggs/lxml-<whatever>.egg deliverance_env/lib/python_2.4/
 
-2) Edit ``content/index.html`` and add the following in the ``<head>``:
+add a line to deliverance_env/lib/easy-install.pth like:
+./lxml-<whatever>.egg
 
-  <meta name="dc.creator" content="Your Name"/>
+$ easy_install nose 
+$ easy_install FormEncode
+$ easy_install elementtree
+$ easy_install paste 
 
-3) Edit ``etc/themerules.xml`` and add a rule like the following::
+checkout deliverance: 
+$ svn co http://codespeak.net/svn/z3/deliverance/branches/packaged deliverance
 
-  <replace theme="//html:div[@id='pageauthor']" 
-      content="/html:html/html:head/html:meta[@name='dc.creator']/@content"/>
-  
-4) Restart Apache and reload the page.
+$ cd deliverance
+$ nosetests 
 
 
-How Does This Work?
--------------------
 
-There are proposals on zope.org and other places that explain the idea.  Here's 
-the short version:
 
-1) A configuration "map" points at a pile of HTML artifacts that look the 
-way you'd like your site to look.  Let's call this look-and-feel the "theme".
 
-2) A rule file defines boxes in that theme that should get filled by boxes 
-coming from the dynamic side.
 
-3) At startup, a one-time compilation processes turns the theme into a 
-high-speed XSLT transform.
