This section describes the complete installation process on Mac OS 10.5. QxTransformer uses lxml library to process xml which is dependent on libxml2 and libxslt. The versions of these libraries shipped with Mac OS are outdated, we need a newer version For more additional information on installing lxml on Mac OS please visit the official lxml site. However, the easiest way for you to install everything what you need is to use the Fink or MacPorts package managers.
Installing Python and lxml with MacPorts
At first you need to install MacPorts, follow instructions on the official site. You can also install Porticus (Cocoa GUI for the MacPorts package manager) which allows working with packages visually (Recommended).
1. Install Python and lxml
Despite the fact that you have already installed Python on Mac OS, we suggest install new one from MacPorts to avoid any specific problems with your old installation. This installation will be kept completely separate from the shipped version and can be removed later without problems. It also makes sure it works flawlessly with lxml.
Install py25-lxml with Porticus
or in command line
port install py25-lxml
It will install all dependencies, which lxml needs, automatically, including Python version 2.5.
You can use MacPort's version of python as /opt/local/bin/python2.5 by default.
Installing Python and lxml with Fink
[coming soon]
Checking installed Python and lxml
Run Console.app and type:
/opt/local/bin/python2.5
It will see Python console:
Then type
import lxml
If you don't see any errors than you have properly installed Python and lxml library.
Installing qooxdoo SDK and QxTransformer toolkit
2. Adjust QXTRANSFORMER_PATH and python command in "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).
Installing Python and lxml with MacPorts
At first you need to install MacPorts, follow instructions on the official site. You can also install Porticus (Cocoa GUI for the MacPorts package manager) which allows working with packages visually (Recommended).
1. Install Python and lxml
Despite the fact that you have already installed Python on Mac OS, we suggest install new one from MacPorts to avoid any specific problems with your old installation. This installation will be kept completely separate from the shipped version and can be removed later without problems. It also makes sure it works flawlessly with lxml.
Install py25-lxml with Porticus
or in command line
port install py25-lxml
It will install all dependencies, which lxml needs, automatically, including Python version 2.5.
You can use MacPort's version of python as /opt/local/bin/python2.5 by default.
Installing Python and lxml with Fink
[coming soon]
Checking installed Python and lxml
Run Console.app and type:
/opt/local/bin/python2.5
It will see Python console:
Then type
import lxml
If you don't see any errors than you have properly installed Python and lxml library.
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 in some folder (here: ~/Documents/qooxdoo). As result you will get following:
It is necessary to modify config.json in qxtransformer-0.4a-helloworld sample application:
2. Adjust QXTRANSFORMER_PATH and python command in "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:
./generate.py transform
As result you will see the following output:
3. Now run the "source" job to create source version of application.
./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.
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.