Skip to content

Installation

Path variables used below: - $INSTALL_FOLDER (i.e. where CKAN is installed), e.g. /usr/lib/ckan/default - $CONFIG_FILE, e.g. /etc/ckan/default/development.ini

Pre-install setup

This extension depends on the following projects, which must be installed first: - versioned-datastore-tile-server

Installing from PyPI

pip install ckanext-versioned-tiledmap

Installing from source

  1. Clone the repository into the src folder: 

    cd $INSTALL_FOLDER/src
git clone https://github.com/NaturalHistoryMuseum/ckanext-versioned-tiledmap.git

  2. Activate the virtual env: 

    . $INSTALL_FOLDER/bin/activate

  3. Install via pip: 

    pip install $INSTALL_FOLDER/src/ckanext-versioned-tiledmap

Installing in editable mode

Installing from a pyproject.toml in editable mode (i.e. pip install -e) requires setuptools>=64; however, CKAN 2.9 requires setuptools==44.1.0. See our CKAN fork for a version of v2.9 that uses an updated setuptools if this functionality is something you need.

Post-install setup

  1. Add 'versioned_tiledmap' to the list of plugins in your $CONFIG_FILE: 

    ckan.plugins = ... versioned_tiledmap

  2. Install lessc globally: 

    npm install -g "less@~4.1"

  3. Add latitude and longitude fields for the resources you want to use this view for.