Theming extension for Stirling city
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ckanext Remove custom registration template Sep 28, 2018
.gitignore Initial commit Apr 19, 2018
LICENSE Initial commit Apr 19, 2018
MANIFEST.in Initial commit Apr 19, 2018
README.rst Revert lessc command change in README.rst Apr 19, 2018
euro_scot.png Initial commit Apr 19, 2018
setup.cfg Initial commit Apr 19, 2018
setup.py Initial commit Apr 19, 2018
smart.png Initial commit Apr 19, 2018

README.rst

Requirements

This extension is used together with ckanext-tayside.

Installation

To install ckanext-stirling:

  1. Activate your CKAN virtual environment, for example:

    . /usr/lib/ckan/default/bin/activate
    
  2. Install the ckanext-stirling Python package into your virtual environment:

    pip install git+https://github.com/ViderumGlobal/ckanext-stirling.git#egg=ckanext-stirling
    
  3. Add stirling to the ckan.plugins setting in your CKAN config file (by default the config file is located at /etc/ckan/default/production.ini).

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

    sudo service apache2 reload
    

Development Installation

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

git clone https://github.com/ViderumGlobal/ckanext-stirling.git
cd ckanext-stirling
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-stirling/ckanext/stirling/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-stirling/ckanext/stirling/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 stirling.less to stirling.css:

./node_modules/.bin/lessc less/stirling.less css/stirling.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

smart.png

euro_scot.png