.. _install:

Installing and Enabling ToscaWidgets
====================================


Installation
------------

ToscaWidgets can be installed using ``easy_install`` from `setuptools`_.

To install the latest stable release type in a shell::

    $ easy_install ToscaWidgets

For the tutorials below, you will also need tw.forms::

    $ easy_install tw.forms

.. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools


Enabling ToscaWidgets in your Web Framework
-------------------------------------------

For instructions and an example, select your framework:

.. toctree::
   :maxdepth: 1

   tg1_app
   tg2_app
   pylons_app
   cherrypy_app
   webpy_app
   wsgi_app
   grok_app
   
Once you've enabled ToscaWidgets, you can move on to the `tw.forms tutorial`_.

.. _tw.forms tutorial: http://toscawidgets.org/documentation/tw.forms/tutorials/


Hints and Tips
--------------

If you only have a few widgets, just define them in the controller. If you have more, create a separate ``widgets.py`` file.