openAFRICA CKAN Extension
CKAN theme for openAFRICA platform accessible at https://openafrica.net/
openAFRICA aims to be the largest independent repository of open data on the African continent.
Installation
Step 1:
Activate your virtual environment; use the path to your virtual environment. On Mac OSX, you may have to use /usr/local/lib/ckan/default/bin/activate.
. /usr/lib/ckan/default/bin/activate
Step 2:
Install the extension:
pip install ckanext-openafrica
Alternatively, if you wish to modify the extension:
$ pip install -e git+https://github.com/CodeForAfrica/ckanext-openafrica.git#egg=ckanext-openafrica
Or clone this repo (preferably into the /src directory where you installed CKAN), cd into ckanext-openafrica and run:
$ python setup.py develop
Step 3:
Modify your configuration file (generally in /etc/ckan/default/production.ini) and add openafrica in the ckan.plugins property.
ckan.plugins = openafrica <OTHER_PLUGINS>
Step 4:
Restart your server:
paster serve /etc/ckan/default/production.ini
OR
paster serve --reload /etc/ckan/default/production.ini
With --reload, your server is restarted automatically whenever you make changes in your source code.
If your extension is installed successfully, your page will change to the openAfrica theme.
Note: This extension, being a thememing extension, may override templates from other extensions. Templates in /ckanext/openafrica/templates may require some modifications to render properly with openAfrica extension.
Contributing
If you’ve found a bug/issue in the extension, open a new issue here.
If you are interested in contributing to the development of openAfrica extension, you are welcome. A good starting point will be reading the CKAN general Contributing guide.
License
GNU General Public License
openAFRICA aims to be the largest independent repository of open data on the African continent. Copyright (C) 2017 Code for Africa
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License.