Skip to content

Latest commit

 

History

History
62 lines (43 loc) · 3.8 KB

README.md

File metadata and controls

62 lines (43 loc) · 3.8 KB

Build Status Test Coverage Code Climate Scrutinizer Code Quality SensioLabsInsight Codacy Badge Quality Gate Status Average time to resolve an issue Percentage of issues still open

Skosmos

Skosmos is a web-based tool providing services for accessing controlled vocabularies, which are used by indexers describing documents and searchers looking for suitable keywords. Vocabularies are accessed via SPARQL endpoints containing SKOS vocabularies. See skosmos.org for more general information about Skosmos including use cases, current users and publications.

In addition to a modern web user interface for humans, Skosmos provides a REST-style API and Linked Data access to the underlying vocabulary data.

Skosmos is used as a basis for the Finto vocabulary service. The latest development version is also available at dev.finto.fi.

Skosmos is implemented using PHP, with Twig templates and e.g. jQuery and jsTree used to build the web interface, and EasyRdf for SPARQL and RDF data access.

The code is open source under the MIT license. See Installation in the wiki for details on obtaining the source and running your own instance of Skosmos.

For information about released versions, see Release Notes.

Docker support

Skosmos Docker Compose uses Træfik, a modern HTTP reverse proxy and load balancer that makes deploying microservices easy. Træfik integrates with your existing infrastructure components (Docker, Swarm mode, Kubernetes, Marathon, Consul, Etcd, Rancher, Amazon ECS, ...) and configures itself automatically and dynamically.

You need to specify the value of "traefikhost" and pub your domain name there (for example, sshopencloud.eu or just localhost) before you'll deploy Skosmos:

export traefikhost=localhost OR export traefikhost=sshopencloud.eu

and create docker network for all the containers you would expose on the web.

docker network create traefik

By default you'll get SSL certificate provided by letsencrypt, please specify your email address if you need https support, for example:

export [email protected]

  • Make sure you have docker and docker-compose installed
  • Run docker-compose up to start Skosmos as a service on your domain name with SSL support

Reporting issues

If you have found a bug please create a new issue using the provided template: Report an issue