gbv / bartoc-jskos
JSKOS wrapper to Basel Register of Thesauri, Ontologies & Classifications (BARTOC)
Requires
- php: >=7.0
- gbv/jskos: >=0.3.4
- gbv/jskos-rdf: 0.3.x
- pear/text_languagedetect: 1.0.x
- symfony/yaml: ^3.3
Requires (Dev)
- helmich/phpunit-json-assert: >=2.0.0
- php-http/mock-client: ^1.0
- phpunit/phpunit: >=6.0.0
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
- http://hdl.handle.net/10760/29366 (paper)
- http://hdl.handle.net/10760/29572 (presentation)
-
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).