OzNome fork of Datacats CKAN for bug fixes and customisation

datacats uses Docker to give you fully self-contained CKAN dev environments on any platform, and easy deployment to any host.

Documentation is no longer available at http://docs.datacats.com/guide.html#installation presumably because of datacats#381.

It appears the documentation is available at https://github.com/boxkite/docs.datacats.com clone. You can host a local version of the documentation by cloning the documentation repository then in the cloned directory run docker run -dit --name datacats-doc -P -v "$PWD":/usr/local/apache2/htdocs/ httpd:2.4. The documentation will then be running locally at the port assigned and visible via docker ps

Prior to running the below do

cd docker && ./build_images.sh

this rebuilds the datacats ckan docker containers using the local dockerfiles. Compared to the original ckan there are fixes to get postgis working and avoid zombie solr containers.

datacats create mytown

This will create a new environment called "mytown" in the current directory, new data files in "~/.datacats/mytown" and start serving your new site locally.

Creating environment "mytown"............
Installing ckan requirements
Installing ckan
Installing ckanext-mytowntheme
Initializing database
Starting web server at http://localhost:5306/ ...
admin user password:

Open your brower to the address shown to try out your new site. Enter an admin password at the prompt to create your first sysadmin user.

In your environment directory you will find "ckan" and "ckanext-mytowntheme" subdirectories. "ckanext-mytowntheme" is a simple example extension that extends some templates and adds some static files.

Customize your Jinja2 templates in "ckanext-mytowntheme/ckanext/mytowntheme/templates", using the files in "ckan/ckan/templates" as a reference.

Full CKAN extension possibilities are covered in the official CKAN documentation.

The site is run with "paster serve --reload" by default so changes to templates and source files will be visible almost immediately after saving them. Refresh your browser window to see the changes.

For changes to configuration files and new template files added use "reload" to force a site reload.

datacats reload mytown

You may omit "mytown" when running datacats commands from within the environment directory or any subdirectory.

Many of the 100+ existing CKAN extensions are already compatible with datacats.

First download or clone an extension in to your environment directory.

cd myproject
git clone git@github.com:ckan/ckanext-pages.git

Then add the plugins and configuration options as required by the extension to the "development.ini" file. For ckanext-pages we add "pages" to the list of plugins.

ckan.plugins = mytowntheme datastore image_view pages

Reinstall all extensions and reload the site with:

datacats install

Refresh your browser window to use the new features.

To deploy your customized CKAN site copy your source directory to your target host with rsync then run:

datacats init --image-only
datacats start --production --address=<IP-address>