Installation

Venus has been tested on Linux, and Mac OSX, and Windows.

You'll need at least Python 2.2 installed on your system, we recommend Python 2.4 though as there may be bugs with the earlier libraries.

Everything Pythonesque Planet needs to provide basic operation should be included in the distribution. Some optional features may require additional libraries, for example:

Instructions

  1. If you are reading this online, you will need to download and extract the files into a folder somewhere. You can place this wherever you like, ~/planet and ~/venus are good choices, but so's anywhere else you prefer.

  2. This is very important: from within that directory, type the following command:

    python runtests.py

    This should take anywhere from a one to ten seconds to execute. No network connection is required, and the script cleans up after itself. If the script completes with an "OK", you are good to go. Otherwise stopping here and inquiring on the mailing list is a good idea as it can save you lots of frustration down the road.

  3. Make a copy of one of the ini the files in the examples subdirectory, and put it wherever you like; I like to use the Planet's name (so ~/planet/debian), but it's really up to you.

  4. Edit the config.ini file in this directory to taste, it's pretty well documented so you shouldn't have any problems here. Pay particular attention to the output_dir option, which should be readable by your web server. If the directory you specify in your cache_dir exists; make sure that it is empty.

  5. Run it: python planet.py pathto/config.ini

    You'll want to add this to cron, make sure you run it from the right directory.

  6. (Optional)

    Tell us about it! We'd love to link to you on planetplanet.org :-)

  7. (Optional)

    Build your own themes, templates, or filters! And share!