ckanext-desq
Customizations for DESQ. This CKAN plugin is not designed to be generic or easily applicable to other data portals. It requires specific changes to the CKAN configuration and the Solr schema.
Requirements
- Python 3.9
- Ubuntu packages required by PyICU:
sudo apt install libicu-dev python3-icu pkg-config
- CKAN, DESQ fork, installed with:
pip install -e 'git+https://github.com/whiskyechobravo/ckan.git@desq#egg=ckan[requirements]'
Tested under Ubuntu 20.04 and 22.04.
Installation
Activate your CKAN virtualenv, for example:
. /usr/lib/ckan/default/bin/activate
Install ckanext-desq in the virtualenv:
pip install -e 'git+https://github.com/whiskyechobravo/ckanext-desq.git#egg=ckanext-desq'
Use config/ckan/sample.ini as a replacement to /etc/ckan/default/ckan.ini
Copy the required webfonts to the ckanext/desq/public/webfonts/ directory.
Restart CKAN.
Performing manual backup and restore
Backup:
sudo -u postgres pg_dump --format=custom -d ckan_default > desq-$(date +%Y%m%d-%H%M).pgdump
Restore:
ckan -c /etc/ckan/default/ckan.ini db clean
sudo -u postgres pg_restore --clean --if-exists -d ckan_default < desq-YYYYMMDD-HHMM.pgdump
ckan -c /etc/ckan/default/ckan.ini search-index rebuild
Managing translations
Creating the .pot file:
python setup.py extract_messages
Creating a .po file for a locale:
python setup.py init_catalog --locale LANG
Updating existing translations:
python setup.py update_catalog --locale LANG
Compile translations into a .mo file:
python setup.py compile_catalog --locale LANG