wehjit: A Python web-widget library
===================================

`wehjit` is a Python library for for building XHTML widgets for web applications
and web pages.  It encapsulates the XHTML (a Genshi XML template), CSS, and
JavaScript for each widget into a plugin.  The full API documentation for this
relelease and other releases is available here:

    http://jderose.fedorapeople.org/wehjit/

For detailed Genshi documentation, see:

    http://genshi.edgewall.org/


Requirements
============

`wehjit` should work under Python 2.4 and newer.  `wehjit` has two required
dependencies and two optional dependencies:

    Package   URL                                      Needed by
    -------   ---------------------------------------  -------------------
    genshi    http://genshi.edgewall.org/              Library
    assets    http://jderose.fedorapeople.org/assets/  Library
    pygments  http://pygments.org/                     Highlighter plugins
    paste     http://pythonpaste.org/                  wehjit-demo

You will always need at least the `genshi` and `assets` packages.  If you wish
to use the built-in highlighter plugins, you will also need `pygements`.  To use
the `wehjit-demo` script, you will need `paste` and `pygments`.


Installation
============

To give `wehjit` a quick spin, you can run the demo from the source tree, like
this:

    python wehjit-demo

Under Python 2.6+, you can install `wehjit` in your user site-packages (in
~/.local/) like this:

    python setup.py install --user

If you omit the `--user` flag, `wehjit` will be installed in the default Python
location (ususually in /usr/), but you can install it elsewhere using the
`--prefix` option, like this:

    python setup.py install --prefix=/foo/bar