datopian / ckanext-dundee

Theming extension for Dundee city

Requirements

This extension is used together with ckanext-tayside.

Installation

To install ckanext-dundee:

1. Activate your CKAN virtual environment, for example:

   . /usr/lib/ckan/default/bin/activate

2. Install the ckanext-dundee Python package into your virtual environment:

   pip install git+https://github.com/ViderumGlobal/ckanext-dundee.git#egg=ckanext-dundee

3. Add dundee to the ckan.plugins setting in your CKAN config file (by default the config file is located at /etc/ckan/default/production.ini).

4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:

   sudo service apache2 reload

Development Installation

To install ckanext-dundee for development, activate your CKAN virtualenv and do:

git clone https://github.com/ViderumGlobal/ckanext-dundee.git
cd ckanext-dundee
python setup.py develop

Modify CSS

This extension uses LESS for styles. All changes must be made in one of the LESS files located in the ckanext-dundee/ckanext/dundee/fanstatic/less folder.

In order to compile those files to CSS, the less npm module is used.

First make sure that you have installed Node.js. That will install the npm package manager. After that, open up the terminal and change the current directory to ckanext-dundee/ckanext/dundee/fanstatic.

Then run the following command that is going to install LESS:

npm install less

After a successful installation, run the next command to compile the main less file dundee.less to dundee.css:

./node_modules/.bin/lessc less/dundee.less css/dundee.css

Every time there is some change in one of the less files, the upper command needs to be run to compile those files to one css file.

Funded by