The showcase is an example QxTransformer application which provides examples for the usage of the framework. It is modelled on the qooxdoo showcase application, but also shows the extended features of QxTransformer. We suggest to keep it for reference, however, you can safely delete the folder once you think you don’t need it anymore.

If your copy of the qooxdoo library is not in a folder named “qooxdoo-trunk” which is a sibling of the “showcase” folder, you’ll need to adapt the Makefile. Open it and edit the line

QOOXDOO_PATH = ../qooxdoo-trunk

To build the showcase, you must issue the following shell commands (assuming that you are in the folder containing your newly checked-out QxTransformer installation:

cd qxtransformer-skeleton
make transform
make build # if you want to see the build version
make source # if you want to see the source version

The crucial difference to a normal qooxdoo build process is the additional “make transform” command. This instructs the makefile to run the QxTransformer XSLT style sheets over the “*.qxml” files in the source/xml folder and store the result in source/class according to the following rules:

• /source/xml/showcase.Application.qxml will be stored in /source/class/showcase/Application.js,
• /source/xml/showcase.LoginWindow.qxml will be stored in /source/class/showcase/LoginWindow.js, etc.

You can use an arbitrary namespace structure in this way - a file named “custom.foo.Bar.qxml” will be stored as /source/class/custom/foo/Bar.js. We will look at how to customize the Makefile to make use of this further below.

After running the “make source” or “make build” command, you can point your browser to the “source” or “build” folders and the showcase should be displayed. Each page of the showcase has a “Display XML source” button which opens up the XML code of each page in a separate window for reference. This makes it easy for you to copy & paste code snippets to adapt to your own needs.