gbv/bartoc-jskos

JSKOS wrapper to Basel Register of Thesauri, Ontologies & Classifications (BARTOC)

0.2.4 2017-10-18 08:39 UTC

README

This repository contains a wrapper to access the public Basel Register of Thesauri, Ontologies & Classifications (BARTOC) in JSKOS format via Entity Lookup Microservice API (ELMA).

Background

BARTOC is the most comprehensive registry of knowledge organization systems such as classification schemes, thesauri, glossaries, and ontologies. JSKOS is a unified format for information about knowledge organization systems, based on SKOS and JSON-LD. For background information see the following publications:

  • Ledl, Andreas and Voss, Jakob: Describing Knowledge Organization Systems in BARTOC and JSKOS. In: Proceedings of International Conference on Terminology and Knowledge Engineering (TKE 2016). p. 168-178. ISBN 978-87-999179-0-7

  • Voß, Jakob; Ledl, Andreas and Balakrishnan, U.: Uniform description and access to Knowledge Organization Systems with BARTOC and JSKOS. TOTh conference 2016

Requirements

Requires PHP 7, the jskos-rdf PHP library and Text_LanguageDetect.

Installation

composer require gbv/bartoc-jskos

This will automatically create composer.json for your project (unless it already exists) and add bartoc-jskos as dependency. Composer also generates vendor/autoload.php to get autoloading of all dependencies.

Usage

The wrapper can be used as instance of class \BARTOC\JSKOS\Service, a subclass of \JSKOS\Service:

require 'vendor/autoload.php';

$service = new \BARTOC\JSKOS\Service();

$jskos = $service->queryURI("http://bartoc.org/en/node/447");
$jskos = $service->query(["uri" => "http://bartoc.org/en/node/447"]);
$jskos = $service->query(["notation" => "447"]);

See jskos-php-examples for an example how to use the wrapper as part of a larger PHP application.

This repository also contains a command line script to query BARTOC in JSKOS format:

php examples/bartoc2jskos.php http://bartoc.org/en/node/18600
php examples/bartoc2jskos.php 18600

Contributung

Bugs and feature request are tracked on GitHub.

See CONTRIBUTING.md of repository jskos-php for general guidelines.

Author and License

Jakob Voß jakob.voss@gbv.de

bartoc-jskos is licensed under the LGPL license (see LICENSE for details).

Latest Stable Version License Build Status Coverage Status