Gazpacho for maemo 3.x

Please note that Gazpacho in maemo 3.x is not officially
supported. This document may not be complete up-to-date nor accurate.

Introduction to Gazpacho

Gazpacho is an application for GUI design, written entirely in
Python, and aimed at the GTK+ widget set. The target audience is the
same as for Glade.

Gazpacho output is a Glade XML file. In theory, this file can be
loaded by libglade but this does not work as yet: Gazpacho
makes use of the Glade XML in extended ways that libglade
does not yet respond to.

To cope with this, the Gazpacho project also supplies an XML
loader that is employed in place of libglade. This is the
only piece of code that the XML "consumer" needs to have installed.
In the future, when libglade fully understands Gazpacho XML
files, this loader is no longer necessary.

The Gazpacho loader is implemented in Python, so, for now, only
Python/GTK+ applications can make use of Gazpacho-designed GUIs.

Unlike libglade, Gazpacho is intended to be extensible,
so it is very easy to add support to new widgets (both at GUI designer
and at loader side), like the Hildon widget set present in maemo
platform.

Gazpacho for maemo is still presently in active development. If
you find any bugs, report to http://bugs.maemo.org.

Gazpacho for maemo

Gazpacho for maemo is a package that extends Gazpacho with the
Hildon widget set, allowing for easy GUI development with Hildon
components, as well as allowing Hildon GUIs to be encoded in XML.

Before Gazpacho for maemo, Hildon components could not function in
XML .glade files; the interface had to be hard-coded in the
application (either in C or in Python).

Gazpacho for maemo files go mainly into two folders:

/usr/share/gazpacho/resources/hildonwidgets supplies the
widget set extension for the GUI builder. It does not have any Python
code, and it is not necessary at runtime.

/usr/lib/python2.4/site-packages/gazpacho/widgets/hildonwidgets
contains Python code, mostly adaptors for Hildon classes. These files
are necessary both at design and runtime.

Note the the folders contain very little code and data, since
Python makes it so easy to create objects based on classes' names (in
this case, building the GTK+ object tree based on a XML tree) that the
Gazpacho loader offloads most of the hard work onto the Python-Hildon
bindings.

Installing Gazpacho

To install Gazpacho go to garage and download the required Gazpacho components from there.

You also need to start some maemo services to allow Gazpacho to
run inside Scratchbox. The script gazenv-init.sh (included in
the gazpacho-hildon package) is analogous to the
af-sb-init script, but starts only the required services. Run
the script as follows:

You need a window manager for this virtual screen. The maemo
window manager is not sufficient because it expects a 800x480 screen.
From outside Scratchbox, run the window manager of your preference ,
for example, metacity:

To run Gazpacho applications in the target device, you need to
install Gazpacho-loader and Gazpacho-Hildon in the
device.

Installing the latest Gazpacho development packages

The latest Gazpacho development branch is supported on the
maemo platform. There are good reasons for using this branch. For
example, it is actively developed and it contains features that are
missing from the package version of Gazpacho. However, installation is
more complicated.

To run the development version of Gazpacho, you need the following
packages