Prerequisites
Before you can install woost you'll need the following:
- Python interpreter (2.5 or greater, version 3 is not supported)
- setuptools
- Python Imaging Library
If you want to install woost on a UNIX-like system (Linux, BSD, Mac OS X, etc), the following items are also required:
- C compiler (gcc)
- Python development files
- Python's profiler (some systems don't include it by default in their Python's distribution)
If you are installing on a recent Debian / Ubuntu version, you can get all dependencies with the following command:
sudo apt-get install python-setuptools python-imaging python-profiler python-dev
Installing woost
Once all pre-requisites are dealt with, installing woost is as simple as executing the following command:
easy_install woost
easy_install will download and install woost and all its dependencies.
Creating a web site
With woost installed, you are now ready to create your first web site and start working on its content. Execute the following command:
python -m woost.scripts.createsite
This will launch the installer wizard, which will assist you in setting up your site. You can access it by pointing your web browser to this address: http://localhost:10000. After completing the installation form, your new site will be ready.
Accessing your web site
Finally, in order to access your web site you'll need to launch two scripts, which you'll find in the /scripts/ folder of your web site:
- rundb.sh (or .bat, if you are running Windows) will start up the database server (ZEO)
- run.py will launch the application's embeded web server (CherryPy)
With these two processes running you can point your web browser to your site's combination of host and port, as indicated during the installation (http://localhost:8080 by default).