Prerequisites ============= * Python 2.4+ * Django trunk - http://djangoproject.com/ * Django-evolution - http://django-evolution.googlecode.com/ Optionally, you might also want: * mod_python and Apache * MySQL, PostgreSQL, whatever else. Installation ============ Check out the latest revision somewhere *outside* your web root (usually /var/www or similar) - somewhere like your home directory works fine, provided it's globally/group readable (if you plan to properly host it later): $ mkdir ~/www $ cd ~/www/ $ hg pull http://bitbucket.org/jespern/cx/ (or ahixon/cx/) $ cd cx/ Configuration ============= There are two settings files that cx uses - Django's global settings.py that describe the project and the modules it uses, and localsettings.py, which has configuration information for cx's apps (like Askimet keys, etc) Run the following commands to copy the examples so we can edit ours: $ cp settings.py.example settings.py $ cp localsettings.py.example localsettings.py First, open up settings.py and add your database settings to the beginning of the file. If you'd like, you can use SQLite for testing. Set the TIME_ZONE and LANGUAGE_CODE values to those that match your server configuration and the language you wish to use, and save. Now, open up localsettings.py. There are only really two things you have to configure here; SITE_URL and SITE_NAME. Set these as required. If you like, fill in the information for the other fields too. You can set BLUEPRINT_CSS to True if you'd like a different looking style. Now, it's time to fill the database with the core tables: $ ./manage.py syncdb Follow the prompts to setup a superuser if required. This will act as the 'admin' account for when you need to add posts and things. TESTING ======= To run a test server using Python's inbuilt web server, just run: $ ./manage.py runserver 0.0.0.0:8000 Then, browse to http://localhost:8000/ and check out your handy work. DEPLOYING ========= FIXME. There's some docs on Django's website, too. ADMINISTERING / ADDING POSTS / ETC ================================== Browse to http://yoursite.com/admin/ and enter the user account that you setup when we ran 'syncdb' (or any other admin account you had already setup if you have another Django installation using the same DB).