ckanext-odsh

This CKAN extension provides custom features and the layout of the Open Data Portal Schleswig-Holstein.

Table of Contents

• Getting Started
• Contributing
• Versioning
• Acknowledgement
• Authors
• License

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

This project requires the following CKAN extensions to work properly:

• ckanext-archiver
• ckanext-dcat
• ckanext-dcatde
• ckanext-harvest
• ckanext-qa
• ckanext-spatial
• ckanext-report

Installing

To install ckanext-odsh:

1. Activate your CKAN virtual environment, for example:

   . /usr/lib/ckan/default/bin/activate

2. Install the ckanext-odsh Python package into your virtual environment:

   pip install https://code.schleswig-holstein.de/opendata/ckanext-odsh.git

3. Add odsh to the ckan.plugins setting in your CKAN config file (by default the config file is located at /etc/ckan/default/production.ini).

   You may also add odsh_autocomplete, odsh_collections, odsh_dcat_harvest, kiel_harvester and statistikamtnord_harvester to the plugin list, to enable custom functionality, e.g.:

   ckan.plugins =
     ckan_harvester
     dcat
     dcatde
     dcatde_rdf_harvester
     harvest
     image_view
     kiel_harvester
     odsh
     odsh_autocomplete
     odsh_dcat_harvest
     odsh_collections
     qa
     archiver
     recline_view
     report
     spatial_metadata
     spatial_query
     statistikamtnord_harvester
     stats
     structured_data
     text_view

4. Restart CKAN.

Configuration

The extension requires configuration parameters in the CKAN configuration file (e.g., production.ini). The following parameters should be set:

Additionaly you might want to set the following configuration parameters:

licenses_group_url = file://<path_to_ckan>/default/src/ckanext-odsh/ckanext/odsh/resources/licenses.json

Testing

To ensure the quality and functionality of the ckanext-odsh extension, a comprehensive test suite is provided. You can follow the instructions below to run the tests:

1. Activate the virtual environment associated with your project, for example:

   . /usr/lib/ckan/default/bin/activate

2. From the ckanext-odsh base directory, execute the following commands:

   pytest ckanext/odsh/tests/

Running these commands will initiate the test suite, which will automatically execute various test cases and verify the expected behavior of the extension.

Internationalization

To enable internationalization of strings, follow these steps:

1. Ensure that you are in the appropriate environment and located within the extensions directory.

2. Run the following command:

   python setup.py extract_messages

This command will generate a template PO file named ckanext/odsh/i18n/ckanext-odsh.pot. You can utilize tools like POEdit to work with this file.

For detailed instructions on internationalizing strings in extensions, refer to CKAN's official guide on translating extensions.

Contributing

To contribute to this documentation, create a branch or fork this repository, make your changes and create a merge request.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Acknowledgement

This extension was originally developed by HITeC e.V.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE - see the LICENSE file for details.