Requirements

Make sure you have installed the required software:

• Python - at least version 2.4
• Django - development version svn trunk version >=7484
• A database supported by Django - For instance, SQLite or PostgreSQL
• Django Logging Support Application - svn trunk version >=21
• Django Registration Application - svn trunk version >=142
• Python Imaging Library - version 1.1.6
• sorl-thumbnail - svn trunk version >=405
  • You do not need to install either of the optional dependencies: ImageMagick or wvWare.
• pytagger - version 0.5
• OPTIONAL: If you wish to enable e-commerce, install Satchmo - svn trunk version >=1177
  1. Install the required software for Satchmo.
  2. You can safely ignore most of the installation instructions. You only need to:
     1. Grab the Satchmo source from svn.

        svn co svn://satchmoproject.com/satchmo/trunk/ satchmo-trunk
        

     2. Add it to your PYTHONPATH or your site-packages.

Installing The DJ Edna Package

1. Grab the source - svn trunk version >= 451
2. Add it to your PYTHONPATH or your site-packages.

Create A Stand Alone DJ Edna Site

This option is for those that wish to quickly run a copy of the sample DJ Edna project as their own site. You can easily customize the look and feel by modifying the default templates.

1. Create a new Django project including your database.
2. Edit the settings.py file and add 'djedna.manage' to the INSTALLED_APPS list:

   INSTALLED_APPS = (
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.sites',
       'djedna.manage',
   )
   

3. While you're editing the settings.py file feel free to change any of the other values. You must at least change the DATABASE_* values as appropriate for your project database.
4. Make sure you run the 'syncdb' management command successfully before proceeding:

   $ ./manage.py syncdb
   

5. Run the 'djedna_sample_setup' management command to transform the newly created project into a copy of the DJ Edna sample project:

   $ ./manage.py djedna_sample_setup
   

6. Run the 'syncdb' management command again to create the new tables:

   $ ./manage.py syncdb
   

7. If you installed Satchmo and wish to enable e-commerce support:
   1. Edit the new settings.py file and change the value of SATCHMO (near the bottom of the file) from False to True:

      #SATCHMO = False
      SATCHMO = True
      if SATCHMO:
      ...
      

   2. Run the 'syncdb' management command again to create the new Satchmo tables:

      $ ./manage.py syncdb
      

   3. Run the 'satchmo_load_l10n' and 'satchmo_load_us_tax' management commands to initialize e-commerce data:

      $ ./manage.py satchmo_load_l10n
      $ ./manage.py satchmo_load_us_tax
      

8. You should now be able run the development server:

   $ ./manage.py runserver localhost:8000
   

9. Fine tune the new settings.py file, using the Django settings and DJ Edna settings pages to determine which settings are available and how they work.
10. If you want to run your new site behind apache, run the 'djedna_apache_config' management command to generate an apache virtual hosts configuration file based on your current settings:

    $ ./manage.py djedna_apache_config