QxTransformer Wiki

Installing and launching first application on Windows

This section describes the complete installation process on Windows, starting with the installation of Python to building a first sample application.

Installing Python

Similarly to the recommendations of  the qooxdoo site, we use the ActivePython package. If you have already installed Python to use it with the qooxdoo generator, you can skip this step and proceed with Installing lxml.

1. Download latest 2.x version of Python installer (currently 2.6.1.1).

2. Run installation package.


3. Click "Next" button.


4. Accept the terms in the License Agreement and click "Next".


5. Make sure that you enabled "Register as Default Python installation", it will add installed python to PATH environment variable. Click "Next".


6. Click "Next".


7. It will copy all files to your installation directory.


8. Uncheck "Open User Guide" and click "Finish".



Check installed Python

1. Run Console application


2. Type following command:

python --version

You will see following:


It means that you have properly installed Python and it's ready to use.


1. Please download the latest stable lxml package for Windows from PyPi for installed version of Python (latest stable version 2.1.4, lxml-2.1.4.win32-py2.6.exe).

2. Launch installer and click "Next".


3. Click "Next".


4. Click "Next" and it will copy files in your installation directory.


5. Click "Finish".


Now you've finished lxml installation. Move to next step.

Checking installed lxml

In order to check installed lxml, please open console and run python console:

python

and then type 

import lxml

if you don't see any errors 



than you have properly installed lxml on your computer. To exit from console type exit().


Installing qooxdoo SDK and QxTransformer toolkit

1. Download following packages:
        1) qooxdoo-0.8.1-sdk.zip (http://qooxdoo.org/download)
        2) qxtransformer-0.4a.zip (QxTransformer download page)
        3) qxtransformer-0.4a-helloworld.zip (QxTransformer download page)

and extract them to a location in your webspace (here: c:\qooxdoo). As result you will get following:


You now need to modify the config.json file in the qxtransformer-0.4a-helloworld sample application and provide the correct paths.


2. Adjust QXTRANSFORMER_PATH and python command in the "let" section of configuration file.


3. Adjust QOOXDOO_PATH in the same section


4.Make sure the qxtransformer path is included int the QxTransformer configuration file in "include" section (this is already preconfigured in sample application, so you don't need to change anything).


5. Also, make sure that a "transform" job is present in the "exported" list (this is already preconfigured in sample application, so you don't need to change anything).


Building sample application

1. Open the console application and go to the qxtransformer-0.4a-helloworld folder.

2. Run transformation process:

python ./generate.py transform

As result you will see the following output:


3. Now run the "source" job to create source version of application.

python ./generate.py source


4. Launch your first qooxdoo/qxtransformer application in your browser (qxtransformer-0.4a-helloworld/source/index.html) and you will see following:


5. Congratulations! You've just configured your environment and run first application.