/djangoproject.com

Source code to djangoproject.com

Primary LanguagePython

djangoproject.com source code

To run locally, do the usual:

  1. Create a virtualenv

  2. Install dependencies:

    pip install -r deploy-requirements.txt
    pip install -r local-requirements.txt
    

    If you only need to deploy, and don't need to test any changes, you can use deploy-requirements.txt only.

  3. Create a 'secrets.json' file in the directory above the checkout, containing something like:

    { "secret_key": "xyz",
      "superfeedr_creds": ["any@email.com", "some_string"] }
    
  4. Create databases:

    createuser -d djangoproject
    createdb -O djangoproject djangoproject
    createuser code.djangoproject
    createdb -O code.djangoproject code.djangoproject
    
  5. Create tables:

    psql -d code.djangoproject < tracdb/trac.sql
    
    ./manage.py syncdb
    ./manage.py migrate
    

    and:

    ./manage.py syncdb --docs
    ./manage.py migrate --docs
    

    if you want to run docs site.

  6. For docs:

    ./manage.py loaddata doc_releases.json --docs
    ./manage.py update_docs --docs
    
  7. Finally:

    ./manage.py runserver
    

    This runs as www.djangoproject.com, the main website.

    To run locally as docs.djangoproject.com, use:

    ./manage.py runserver --docs
    

Styles

In case you want to work on the stylesheets please install Compass with Rubygems:

gem install compass

You may have to prefix that command with sudo depending on your platform.

Then run the following to compile the Compass SASS files to CSS:

make compile-scss-debug

Alternatively you can also run the following command in a separate shell to continously watch for changes to the SASS files and automatically compile to CSS:

make watch-scss