ckanext-open_alberta
Ckan theme for open.alberta.ca
Requirements
Ckan 2.3.x release / CentOS/Rhel 7.x Postgresql 9.x
Installation
To install ckanext-open_alberta:
- Activate your CKAN virtual environment:
. /usr/lib/ckan/default/bin/activate
Install the ckanext-open_alberta Python package into your virtual environment.
Add open_alberta to the ckan.plugins setting in your CKAN config file (by default the config file is located at /etc/ckan/default/development.ini).
Restart CKAN:
sudo systemctl restart httpd
Config Settings
ckan.plugins = ... open_alberta openalbertapages
License edit license.json:
licenses_group_url = file:///usr/lib/ckan/default/src/ckanext-open_alberta/ckanext/open_alberta/public/licenses.json
Update package licenses:
update package set license_id = 'Alberta Queens Printer Terms of Use' where license_id = 'QPTU';
update package set license_id = 'Open Government Licence - Alberta' where license_id = 'OGLA';
update package set license_id = 'Open Government Licence - Alberta' where license_id = 'ABOGPL';
Development Installation
To install ckanext-open_alberta for development, activate your CKAN virtualenv and do:
git clone --recursive https://github.com/abgov/ckanext-open_alberta.git
# Get the stable branch only:
git clone --recursive https://github.com/abgov/ckanext-open_alberta.git --branch stable
cd ckanext-open_alberta
python setup.py develop
pip install -r dev-requirements.txt
CKAN Theming
Links:
- http://docs.ckan.org/en/latest/theming/
- http://ckan.readthedocs.org/en/ckan-2.2/theming.html
Jinja:
- http://jinja.pocoo.org/
- http://jinja.pocoo.org/docs/dev/
Ckan theme files reside mostly under:
- ckanext-open_alberta/ckanext/open_alberta/
Default ckan 2.2 templates are under:
- ckanext-open_alberta/ckan_default_templates/
To update your submodules in your repo:
git submodule update --init --recursive
Running the Tests
To run the tests:
nosetests --nologcapture --with-pylons=test.ini
To run the tests and produce a coverage report:
nosetests --nologcapture --with-pylons=test.ini --with-coverage --cover-package=ckanext.open_alberta --cover-inclusive --cover-erase --cover-tests