Digital Helsinki CMS

This Wagtail-based CMS powers the Digital Helsinki website.

Installation

Set the DEBUG environment variable to 1

export DEBUG=1

Install required Python packages

(sudo) pip install -r requirements.txt

Create the database

sudo -u postgres createuser digihel
sudo -u postgres createdb -O digihel digihel

Install node dependencies

npm install

Install bower components

./manage.py bower install

If you have acquired a database dump, install it this way:

tar xvjf digihel-backup.tar.bz2
pg_restore -d digihel digihel.sql
echo "delete from wagtailimages_rendition;" | ./manage.py dbshell

Requirements

This project uses two files for requirements. The workflow is as follows.

requirements.txt is not edited manually, but is generated
with pip-compile.

requirements.txt always contains fully tested, pinned versions
of the requirements. requirements.in contains the primary, unpinned
requirements of the project without their dependencies.

In production, deployments should always use requirements.txt
and the versions pinned therein. In development, new virtualenvs
and development environments should also be initialised using
requirements.txt. pip-sync will synchronize the active
virtualenv to match exactly the packages in requirements.txt.

In development and testing, to update to the latest versions
of requirements, use the command pip-compile. You can
use requires.io to monitor the
pinned versions for updates.

To remove a dependency, remove it from requirements.in,
run pip-compile and then pip-sync. If everything works
as expected, commit the changes.

Configuration

These settings are recognized in the Django settings.

You can acquire the Twitter keys from the Twitter developer portal (https://apps.twitter.com).

• TWITTER_CONSUMER_KEY: “Consumer Key (API Key)”
• TWITTER_CONSUMER_SECRET: “Consumer Secret (API Secret)”
• TWITTER_ACCESS_TOKEN: A personal (read-only) access token
• TWITTER_ACCESS_TOKEN_SECRET: The secret for the personal (read-only) access token

Docker

Currently the development environment has been dockerized.

Configurations

Configure the following settings to local_settings.py:

DEBUG = True
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'postgres',
        'USER': 'postgres',
        'PASSWORD': 'postgres',
        'HOST': 'db',
        'PORT': '5432',
    }
}

Daily running

• Run docker-compose up
• Run docker-compose exec web python3 manage.py migrate
• Run docker-compose exec web python3 manage.py compilemessages