Get started

All the basics of LinkedDataHub. From installation to customizing the model and user interface.

This guide will show how a LinkedDataHub application can be used to manage domain-specific RDF classes and instances. As an example, we will us SKOS concepts and concept schemes.

Note that all management actions can also be performed using the CLI (Command Line Interface). Where applicable, the UI and CLI instructions are shown side by side. The SKOS demo app which implements the SKOS example which is used in this guide.

Setup

Setup is only required if you plan to run your own instance of LinkedDataHub. It consists of few steps, which involve creating a configuration file and running a docker-compose command.

Read setup instructions.

If you want to use an existing instance of LinkedDataHub, proceed to the next step.

Get an account

With LinkedDataHub, you obtain a WebID and use its client certificate for authentication. You can obtain the WebID either by setting up your own instance or signing up on an existing instance. Alternatively, you can authenticate using your social login.

Read instructions on getting an account.

Request access

After you login to (authenticate with) a LinkedDataHub instance, the next step is getting an authorization from its owners that allows you to view and possibly append or edit documents. That is done by issuing an access request.

Read instructions on requesting access.

Create a container

We will need to containers for our SKOS instances: one for the concepts and one for the concept schemes.

Use Concepts as title and concepts as URI slug for the former; Concept schemes as title and concept-schemes as URI slug for the latter.

Follow a tutorial to create a container.

Change the model

In order to be able to manage SKOS concepts and concept schemes, we need to create classes that represent them in the model of our dataspace. Not only will they serve as RDF types of the instances, but will have constructors attached that define the default properties and their (data)types for that class.

Model is managed in the administration application of a dataspace. Head there by clicking the Settings in the action bar and then choosing Administration.

In order to change the access control or the model of a dataspace, you need to be an administrator, i.e. a member of the owners group.

Follow a tutorial to change the model: a class and its constructor.

Create an instance

Go back to the end-user application and refresh the page — the previously created classes should now be available for instance creation. Follow these steps:

  1. Click the Create dropdown in the top-left corner
  2. Click on Instance in the drop-down list that appears. An editing form will open.
  3. In the resource of Type Instance, click on the Instance typeahead input, type Concept and select the class from the list
  4. Fill out the mandatory fields in the form that appeared:
    Preferred label
    Enter concept label
    Title
    Enter document title
  5. Click Save

A concept and its item should appear with the URI https://localhost:4443/concepts/{slug}/, depending on the optional URI slug value (a unique UUID string is assigned by default).

Congratulations! You have just created the first concept instance based on your model.

Read more about document management.

Import CSV data

A common step at this point would be to populate your dataset with instances by importing data. LinkedDataHub currently supports CSV and RDF data imports.

Follow a tutorial to import CSV data and map it to RDF.

Change the layout

User interface changes are done by adding and overriding templates in XSLT stylesheets.

Follow a tutorial to change the layout: create an XSLT stylesheet and override a template.