Bundle the ontology and the stylesheet for your own vocabulary as a reusable package

A package is a namespace ontology and an XSLT stylesheet, published as Linked Data behind a package URI.\n Developers can create custom packages for their own domain vocabularies. The process has four steps.

Write package ontology

Create ns.ttl describing both the document the registry serves it as and the ontology inside it, with the vocabulary import and the views:

<> a dh:Item ;\n    dct:title \"Schema.org ontology\" ;\n    foaf:primaryTopic <#> .\n\n<#> a owl:Ontology ;\n    owl:imports <https://schema.org/> .\n\n# Attach view to a property\nschema:knows ldh:view :PersonKnows .\n\n:PersonKnows a ldh:View ;\n    dct:title \"Knows\" ;\n    spin:query :SelectPersonKnows .\n\n:SelectPersonKnows a sp:Select ;\n    sp:text \"\"\"\n    SELECT DISTINCT ?person\n    WHERE { GRAPH ?graph { $about schema:knows ?person } }\n    ORDER BY ?person\n    \"\"\" .

\n warning\n

The dct:title on <> is not optional. A write is held to the constraints of the document as it will be written, and a LinkedDataHub document must be titled, so an ns.ttl that describes only the ontology is refused 422 Unprocessable Entity when it is pushed.

Write XSLT stylesheet

Create the stylesheet — name the file for the vocabulary it covers — with XSLT templates using system modes like ac:*, ldh:* and xhtml:*. See the Stylesheets reference for template customization patterns.

<xsl:template match=\"schema:knows\" mode=\"ac:PropertyEditor\"/>

Publish package metadata

Publish the descriptor as Linked Data at your package URI, naming the ontology beside it:

<> a dh:Container ;\n    dct:title \"Schema.org\" ;\n    foaf:primaryTopic <#this> .\n\n<#this> a lds:Package ;\n    dct:title \"Schema.org Package\" ;\n    dct:description \"Schema.org vocabulary support\" ;\n    lds:ontology <ns/#> .

Then upload the stylesheet into the package document and add ac:stylesheet naming that upload, which is where a registry published with ldh push gets it:

package=\"https://packages.example.com/schema.org/\"\n\nupload=$(ldh add file --title schema.xsl --file schema.xsl \"$package\")\necho \"INSERT { <${package}#this> <https://w3id.org/atomgraph/client#stylesheet> <$upload> } WHERE { }\" | ldh patch \"$package\"

A dataspace importing the package dereferences its descriptor, ontology and stylesheet anonymously, so all three have to be readable without a certificate.

Test installation

Declare the ldh:import triple in a test dataspace's settings document — see Management for the command.