Extension Taxonomy


Extension Basics

Title
Taxonomy
Name
ckanext-taxonomy
Type
Public extension
Description
The **Taxonomy** extension for CKAN enhances the way tags are managed within a CKAN instance, speci
CKAN versions
Download-Url (zip)
Last commit
10 years ago (2015-07-21 17:14:10)
Url to repo
Category
Standards Compliance


Background Infos

Description (long)
Show details

ckanext-taxonomy

The current support for tag vocabularies in CKAN is rather limited, and this extension provides an alternative implementation of tags, or more accurately terms where:

  • Terms belong to a taxonomy which is a simple named entity
  • Terms can have child terms and parent terms so that they are hierarchichal.
  • Terms have a name, but also a URI, and a title which is the display string
  • Terms and taxonomies can be generated from SKOS data.

Information about the API is available in API.md

Installation

To install ckanext-taxonomy, you should follow these steps:

  1. Install the code

    cd /usr/lib/ckan/default/src
    git clone https://github.com/datagovuk/ckanext-taxonomy.git
    cd ckanext-taxonomy
    python setup.py install
    

    NB you should not use pip install -e to install it, since that appears to install the copy of python-skos from PyPI when it should install the DGU version. If you get this wrong then you get erro TypeError: init() got an unexpected keyword argument 'lang'

  2. Add taxonomy to your ckan.plugins setting in your ckan.ini file

  3. Setup the database for taxonomies

    paster taxonomy init -c <PATH-TO-CONFIG>
    

Running tests

cd ckanext-taxonomy
nosetests . --with-pylons=test-core.ini

Importing a SKOS document


WARNING: Importing will currently delete an existing taxonomy if it exists with the same name. If you are using term uris in your schema this shouldn’t be a problem if you are copying the same taxonomy over the top.


Import DGU themes (rdf in repo)

paster taxonomy load --filename dgu-themes.rdf --name dgu --title "DGU Themes" \
    --uri "http://data.gov.uk/themes"

Importing cofog from a file …

paster taxonomy load --filename COFOG.rdf --name cofog  \
    --title cofog --uri "http://unstats.un.org/unsd/cr/registry/regcst.asp?Cl=4"

Importing eurovoc from a file … **warni

Version
Version release date
(not set)
Contact name
(not set)
Contakt email
(not set)
Contact Url
(not set)


Installation Guide

Configuration hints

To install ckanext-taxonomy, you should follow these steps:

  1. Install the code

    cd /usr/lib/ckan/default/src
    git clone https://github.com/datagovuk/ckanext-taxonomy.git
    cd ckanext-taxonomy
    python setup.py install
    

    NB you should not use pip install -e to install it, since that appears to install the copy of python-skos from PyPI when it should install the DGU version. If you get this wrong then you get erro `TypeError: init() got an unexpected keyword argum

Plugins to configure (ckan.ini)
taxonomy
CKAN Settings (ckan.ini)
DB migration to be executed
(not set)
<< back to Extensions