OntoMetadataShape.ttl

@base <https://www.purl.org/ontologymetadata/shape> .
@prefix adms: <http://www.w3.org/ns/adms#> .
@prefix bibo: <http://purl.org/ontology/bibo/> .
@prefix cc: <http://creativecommons.org/ns#> .
@prefix dash: <http://datashapes.org/dash#> .
@prefix dbo: <http://dbpedia.org/ontology/> .
@prefix dc: <http://purl.org/dc/elements/1.1/> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix doap: <http://usefulinc.com/ns/doap#> .
@prefix mod: <https://w3id.org/mod#> .
@prefix ontometa:    <https://www.purl.org/ontologymetadata/shape#> .
@prefix owl:   <http://www.w3.org/2002/07/owl#> .
@prefix pav: <http://purl.org/pav/> .
@prefix prov: <http://www.w3.org/ns/prov#> .
@prefix premis: <http://www.loc.gov/premis/rdf/v3/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
@prefix schema: <https://schema.org/> .
@prefix sh:    <http://www.w3.org/ns/shacl#> .
@prefix shacl: <http://www.w3.org/ns/shacl#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix vann: <http://purl.org/vocab/vann/> .
@prefix vs: <http://www.w3.org/2003/06/sw-vocab-status/ns#> .
@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .


ontometa: rdf:type owl:Ontology ;
    # owl:imports <http://www.w3.org/ns/shacl#> ; #when last imported (2024-04-05), SHACL was inconsistent
    <http://purl.org/dc/terms/abstract> "OntoMeta provides SHACL shapes for ontology metadata. It is intended for use in TIB Terminology Service. You may re-use (please refer back to our repo!) for your own services. Please note that adaptations might be necessary. If you have any remarks or questions get in touch with us at https://github.com/StroemPhi/Ontology-Metadata/issues"@en ;
    dcterms:license <https://creativecommons.org/licenses/by/4.0/>;
    <http://purl.org/dc/terms/created> "2024-05-02T11:42:00"^^xsd:dateTime;
    <http://purl.org/dc/terms/modified> "2025-01-01T00:00:00"^^xsd:dateTime;
    <http://www.w3.org/2002/07/owl#versionIRI> <https://www.purl.org/ontologymetadata/shape/20250101>;
    <http://purl.org/dc/terms/title> "Ontology Metadata Shape by TIB"@en, "TIB Metadatenshape für Ontologien"@de;
    <http://purl.org/dc/terms/creator> <https://orcid.org/0000-0002-1019-9151>, <https://orcid.org/0000-0003-1043-4964>, <https://orcid.org/0000-0003-2499-7741>, <https://orcid.org/0000-0002-1595-3213> , <https://orcid.org/0000-0002-8280-0487> ;
    <http://purl.org/vocab/vann/preferredNamespacePrefix> "ontometa";
    <http://usefulinc.com/ns/doap#bug-database> <https://gitlab.com/TIBHannover/terminology/tib-terminology-service-issue-tracker> ;
    <http://www.loc.gov/premis/rdf/v3/documentation> <tbd> ;
    <http://purl.org/ontology/bibo/status> "active"@en ;
    <http://usefulinc.com/ns/doap#audience> "Ontology engineers, ontology publishers, terminology service providers, terminology service curators"@en;
    dcterms:language <http://id.loc.gov/vocabulary/iso639-2/eng>;
    <http://purl.org/dc/terms/subject> <http://d-nb.info/gnd/4827894-4>, <http://d-nb.info/gnd/4410512-5> ;
    <http://usefulinc.com/ns/doap#repository> <tbd>;
    <https://w3id.org/mod#hasSyntax> <https://www.iana.org/assignments/media-types/text/turtle> ;
    <http://purl.org/dc/terms/references> <https://www.doi.org/10.5281/zenodo.11103071> ;
    <https://w3id.org/mod#hasFormalityLevel> "RDF(S), OWL, SHACL"@en ;
    dcterms:bibliographicCitation "Arndt, S., Ganske, A., Hauschke, C., Strömert, P., & Vogt, L. (2024). Terminology Metadata Recommendations by TIB. Zenodo. https://doi.org/10.5281/zenodo.11103070 (latest version)";
.

# Start of the Ontology Metadata Shape
ontometa:OntologyMetadataShape a sh:NodeShape ;
    sh:targetClass owl:Ontology ; 

# MANDATORY METADATA

## Ontology title
### status: developer and external review needed
    sh:property [              
        sh:path [sh:alternativePath (rdfs:label skos:prefLabel dc:title dcterms:title schema:name schema:headline) ] ; 
        sh:severity sh:Warning ;
        sh:minCount 1 ;
        # sh:message """The ontology does not include its own title. Please provide it if known."""@en ; # optimized message for current TIB TS implementation
        sh:message """You must add an ontology title or label. The title should be an rdf:langString.\nRecommended property: <http://purl.org/dc/terms/title>.\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:title \"Some Ontology\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology has a title or label. It produces a warning message if the title is missing. The ontology title is mandatory."@en ;
        sh:name "Ontology title"@en ;
    ] ;

    sh:property [             
        sh:path [sh:alternativePath (rdfs:label skos:prefLabel dc:title dcterms:title schema:name  schema:headline) ] ; 
        sh:severity sh:Info ;
        sh:datatype rdf:langString ;
        sh:uniqueLang true ;
        sh:message """You should make the ontology title an rdf:langString by adding a language tag to it.\nThere may be only title per language.\nRecommended property: <http://purl.org/dc/terms/title>.\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:title \"Some Ontology\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology title literal value is an rdf:langString and whether only one title per language is given. It produces an info message if the title does not carry a language tag or if several titles in the same language are present."@en ;
        sh:name "Ontology title - datatype"@en ;
    ] ;

## Preferred ontology prefix/ acronym
### status: developer and external review needed: add check for forbidden characters like - ? 
    sh:property [
        sh:path [sh:alternativePath ( <http://purl.org/vocab/vann/preferredNamespacePrefix> <https://w3id.org/mod#acronym> )];
        sh:severity sh:Warning;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        # sh:message """The ontology does not declare its preferred prefix. Please provide it if known."""@en ; # optimized message for current TIB TS implementation
        sh:message """You must declare at most one preferred namespace prefix or acronym for the ontology.\nIt must not contain hyphens or other special characters and should be written in lowercase.\nRecommended property: <http://purl.org/vocab/vann/preferredNamespacePrefix>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> vann:preferredNamespacePrefix \"so\"^^xsd:string .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares a preferred namespace prefix. It produces a warning message if the ontology does not declare a preferred namespace prefix."@en ;
        sh:name "Preferred ontology prefix/ acronym"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/vocab/vann/preferredNamespacePrefix> <https://w3id.org/mod#acronym>)];
        sh:severity sh:Info ;
        sh:datatype xsd:string ;
        sh:message """You should provide the ontology's preferred namespace prefix or acronym as an xsd:string.\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> vann:preferredNamespacePrefix \"so\"^^xsd:string .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's preferred namespace prefix or acronym is an xsd:string. It produces an info message if it is not."@en ;
        sh:name "Preferred ontology prefix/ acronym - datatype"@en ;
    ] ;

## Ontology license
### status: developer and external review needed
### <http://purl.org/dc/terms/licence> has been added, since licence is a variant of license and thus the property may easily occur as a common mistake
    sh:property [
        sh:path [sh:alternativePath (dcterms:license dcterms:rights schema:license cc:license dbo:license <http://purl.org/dc/terms/licence>)] ;
        sh:severity sh:Warning ;
        sh:minCount 1;
        sh:maxCount 1;
        # tbd/todo: add further licenses to the list of accepted licenses? 
        sh:xone (
            [sh:hasValue <http://opendatacommons.org/licenses/by/summary/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/by/summary/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/by/1-0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/by/1-0/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/by/1.0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/by/1.0/> ;] 

            [sh:hasValue <http://opendatacommons.org/licenses/pddl/1-0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/pddl/1-0/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/pddl/summary/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/pddl/summary/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/pddl/1.0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/pddl/1.0/> ;] 

            [sh:hasValue <http://opendatacommons.org/licenses/odbl/summary/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/odbl/summary/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/odbl/1-0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/odbl/1-0/> ;] 
            [sh:hasValue <http://opendatacommons.org/licenses/odbl/1.0/> ;] 
            [sh:hasValue <https://opendatacommons.org/licenses/odbl/1.0/> ;] 

            [sh:hasValue <http://spdx.org/licenses/Unlicense.html> ;]
            [sh:hasValue <https://spdx.org/licenses/Unlicense.html> ;]
            [sh:hasValue <http://unlicense.org/> ;]
            [sh:hasValue <https://unlicense.org/> ;]

            [sh:hasValue <http://creativecommons.org/publicdomain/zero/1.0/> ;] 
            [sh:hasValue <https://creativecommons.org/publicdomain/zero/1.0/> ;] 
            [sh:hasValue <http://creativecommons.org/publicdomain/zero/1.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/publicdomain/zero/1.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/publicdomain/zero/1.0/deed> ;] 
            [sh:hasValue <http://creativecommons.org/publicdomain/zero/1.0/deed> ;] 
            
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/> ;]

            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/de/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/de/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/de/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/de/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/3.0/de/> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/3.0/de/> ;] 

            [sh:hasValue <http://creativecommons.org/licenses/by-sa/3.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/3.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/3.0/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by-sa/3.0/deed> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by-sa/3.0/> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/3.0/> ;] 

            [sh:hasValue <https://creativecommons.org/licenses/by/4.0/> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/4.0/> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by/4.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/4.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/4.0/deed> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/4.0/deed> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by/4.0> ;] 

            [sh:hasValue <http://creativecommons.org/licenses/by-sa/4.0/> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/4.0/> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by-sa/4.0/legalcode> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/4.0/legalcode> ;] 
            [sh:hasValue <http://creativecommons.org/licenses/by-sa/4.0/deed> ;] 
            [sh:hasValue <https://creativecommons.org/licenses/by-sa/4.0/deed> ;] 

            # [sh:hasValue <> ;] 
            );
        # sh:message """The ontology does not declare its own license. Please provide it, if known."""@en ; # optimized message for current TIB TS 
        sh:message """You must provide exactly one ontology license.\nThe license must be open (Read more about open licenses at https://opendefinition.org/licenses/).\nThe license must be given as an IRI from the following list:\n\n    - <https://opendatacommons.org/licenses/by/1-0/>\n    - <https://opendatacommons.org/licenses/pddl/1-0/>\n    - <https://opendatacommons.org/licenses/odbl/1-0/>\n    - <https://unlicense.org/>\n    - <https://creativecommons.org/publicdomain/zero/1.0/legalcode>\n    - <https://creativecommons.org/licenses/by/3.0/legalcode>\n    - <https://creativecommons.org/licenses/by/4.0/legalcode>\n    - <https://creativecommons.org/licenses/by/3.0/de/legalcode>\n    - <https://creativecommons.org/licenses/by-sa/3.0/legalcode>\n    - <https://creativecommons.org/licenses/by-sa/4.0/legalcode>\n\nRecommended property: <http://purl.org/dc/terms/license>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:license <http://creativecommons.org/licenses/by/4.0/> .\nYou want to use a different open license? File an issue at https://gitlab.com/TIBHannover/terminology/tib-terminology-service-issue-tracker/-/issues\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides a license IRI from a list of accepted open licenses. It produces a warning message if not."@en ;
        sh:name "Ontology license"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:license dcterms:rights schema:license cc:license dbo:license <http://purl.org/dc/terms/licence>)] ;
        sh:severity sh:Warning ;
        # tbd/todo: add further licenses to the list of unaccepted licenses?
        # tbd/todo: discuss > redundant test?
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/3.0/de/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nc-nd/3.0/de/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/3.0/de/legalcode> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nc-nd/3.0/de/deed> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nd/4.0/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nd/4.0/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nd/3.0/de/legalcode> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nd/3.0/de/legalcode> ;] ;
        sh:not [sh:hasValue <https://creativecommons.org/licenses/by-nd/3.0/de/deed> ;] ;
        sh:not [sh:hasValue <http://creativecommons.org/licenses/by-nd/3.0/de/deed> ;] ;
        # sh:not [sh:hasValue <> ;] ; 
        sh:message """The ontology license is not accepted at TIB Terminology Service since it is not an open license according to the Open Definition (https://opendefinition.org/licenses/).\nYou must provide an open ontology license.\nThe license must be given as an IRI.\nThe following licenses are not accepted at TIB Terminology Service:\n    - https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode\n    - https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode\n    - https://creativecommons.org/licenses/by-nc-nd/3.0/de/legalcode\n    - https://creativecommons.org/licenses/by-nd/4.0/legalcode\n    - https://creativecommons.org/licenses/by-nd/3.0/de/legalcode\nRecommended property: <http://purl.org/dc/terms/license>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:license <http://creativecommons.org/licenses/by/4.0/> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides a license IRI from a list of unaccepted, non-open licenses. It produces a warning message if it does."@en ;
        sh:name "Ontology license"@en ;
    ] ;

## Ontology creator(s)
### status: developer and external review needed
    sh:property [
        sh:path  [sh:alternativePath (dc:creator dcterms:creator schema:creator pav:createdBy prov:wasAttributedTo schema:accountablePerson schema:author)];
        sh:severity sh:Warning ;
        sh:minCount 1;
        # sh:message """The ontology does not name its creators. Please provide them if known. This information is required for licenses that require attribution. Use ORCID, ROR or comparable identifiers for people and organisations if available."""@en ; # optimized message for current TIB TS 
        sh:message """You must add the ontology creators.\nYou must list at least one person who was involved in developing the ontology.\nCreators should be referenced via PIDs, e.g. ORCiDs for persons and RORs for organisations.\nIf an ontology is developed by a larger group, it is recommended to give the organization or project identifier as the creator and list individual persons as contributors.\nRecommended property: <http://purl.org/dc/terms/creator>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/creator> <https://orcid.org/0000-0000-0000-0000>. <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person .\nPlain name strings could be provided in addition (for readability).\nExample statement 2 (text/turtle):\n    <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/creator> <https://orcid.org/0000-0000-0000-0000>\n    <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person ; <http://xmlns.com/foaf/0.1/firstName> "Max" ;\n        <http://xmlns.com/foaf/0.1/lastName> "Muster" .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides information about its creator. It produces a warning message if no creator information is present."@en ;
        sh:name "Ontology creator(s)"@en ;
    ] ;

### discuss: switch to string/ literal following "FirstName LastName (ORCID)" 
    sh:property [
        sh:path  [sh:alternativePath (dc:creator dcterms:creator schema:creator pav:createdBy prov:wasAttributedTo schema:accountablePerson schema:author)];
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI; 
        sh:message """You should provide the ontology creators as IRIs.\nPlease make sure to provide persistent identifiers (PIDs) wherever possible, e.g. ORCiDs for persons and RORs for organisations.\nIf an ontology is developed by a larger group, it is recommended to give the organization or project identifier as the creator and list individual persons as contributors.\nRecommended property: <http://purl.org/dc/terms/creator>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/creator> <https://orcid.org/0000-0000-0000-0000>. <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person .\nPlain name strings could be provided in addition (for readability).\nExample statement 2 (text/turtle):\n    <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/creator> <https://orcid.org/0000-0000-0000-0000>.\n    <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person ; <http://xmlns.com/foaf/0.1/firstName> \"Max\" ;\n        <http://xmlns.com/foaf/0.1/lastName> \"Muster\" .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology states its creator as an IRI. It produces an info message if creator information is given e.g. as xsd:string"@en ;
        sh:name "Ontology creator(s) - datatype"@en ;
    ] ;

## Version information

### Ontology version IRI
#### status: developer and external review needed
    sh:property [
        sh:path  owl:versionIRI ;
        sh:severity sh:Warning ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        # sh:message """The ontology does not declare a versionIRI. Please provide it, if known."""@en ; # optimized message for current TIB TS 
        sh:message """You must add a versionIRI to the ontology.\nThe versionIRI should be stable and resolvable, i.e. a fixed version of the ontology should be retrievable from the provided IRI.\nIt is recommended to use semantic versioning (cf. https://semver.org/) or OBO style date-based versioning (http://obofoundry.org/principles/fp-004-versioning.html).\nRecommended property: <http://www.w3.org/2002/07/owl#versionIRI>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://www.w3.org/2002/07/owl#versionIRI> <https://www.purl.org/SomeOntology/1.0.0>.\nExample statement 2 (text/turtle): <https://www.purl.org/SomeOntology> <http://www.w3.org/2002/07/owl#versionIRI> <https://www.purl.org/SomeOntology/2019-12-31> .\nExample statement 3 (text/turtle): <http://purl.obolibrary.org/obo/pco.owl> <http://www.w3.org/2002/07/owl#versionIRI> <http://purl.obolibrary.org/obo/pco/releases/2021-05-03/pco.owl> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provids exactly one versionIRI. It produces a warning message if none is found."@en ;
        sh:name "Ontology version IRI"@en ;
    ] ;

    sh:property [
        sh:path  owl:versionIRI ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI;
        sh:message """You should state the versionIRI as an IRI. It should not be given as a sring or literal.\nRecommended property: <http://www.w3.org/2002/07/owl#versionIRI>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://www.w3.org/2002/07/owl#versionIRI> <https://www.purl.org/SomeOntology/1.0.0>.\nExample statement 2 (text/turtle): <https://www.purl.org/SomeOntology> <http://www.w3.org/2002/07/owl#versionIRI> <https://www.purl.org/SomeOntology/2019-12-31> .\nExample statement 3 (text/turtle): <http://purl.obolibrary.org/obo/pco.owl> <http://www.w3.org/2002/07/owl#versionIRI> <http://purl.obolibrary.org/obo/pco/releases/2021-05-03/pco.owl> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology versionIRI is provided as an IRI (https://www.w3.org/TR/rdf11-concepts/#dfn-iri) (as compared to a literal). It produces an info message if it is not."@en ;
        sh:name "Ontology version IRI - datatype"@en ;
    ] ;

### Ontology creation date
### status: developer and external review needed
    sh:property [
        sh:path [sh:alternativePath (dcterms:created schema:dateCreated pav:createdOn prov:generatedAtTime )] ;
        sh:severity sh:Warning ;
        sh:minCount 1;
        sh:maxCount 1 ;
        # sh:message """The ontology does not declare its creation date. Please provide it, if known. Use the xsd:dateTime format to do so (e.g. 2024-12-12T11:18:44)"""@en ; # optimized message for current TIB TS 
        sh:message """You must add a creation date to the ontology.\nYou must provide exactly one date in xsd:dateTime format.\nRecommended property: <http://purl.org/dc/terms/created>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:created \"2020-11-19T00:00:00\"^^xsd:dateTime .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides its creation date. It produces a warning message if not."@en ;
        sh:name "Ontology creation date"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:created schema:dateCreated pav:createdOn prov:generatedAtTime )] ;
        sh:severity sh:Info ;
        sh:datatype xsd:dateTime ;
        sh:message """You should provide the creation date of the ontology in xsd:dateTime format.\nRecommended property: <http://purl.org/dc/terms/created>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:created \"2020-11-19T00:00:00\"^^xsd:dateTime .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ; 
        sh:description "This shape checks whether the ontology provides its creation date in xsd:dateTime format. It produces an info message if not."@en ;
        sh:name "Ontology creation date - datatype"@en ; 
    ] ;

## Ontology abstract
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (dcterms:abstract <https://schema.org/abstract>)] ;
        sh:severity sh:Warning ;
        sh:minCount 1 ;
        # sh:message """The ontology does not contain an abstract. Please provide it, if knwon."""@en ; # optimized message for current TIB TS 
        sh:message """You must provide a short abstract about the ontology and its scope.\nRecommended property: <http://purl.org/dc/terms/abstract>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:abstract \"SomeOntology defines a range of classes and properties which can be applied to do stuff in a particular domain.\"@en , \"SomeOntology definiert eine Reihe von Klassen und Properties, die in einer bestimmten Domäne verwendet werden können, um etwas damit zu tun.\"@de .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides an abstract. It produces an info message if not."@en ;
        sh:name "Ontology abstract"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:abstract <https://schema.org/abstract>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:Literal ;
        sh:datatype rdf:langString ;
        sh:message """You should provide the ontology abstract as an rdf:langString.\nRecommended property: <http://purl.org/dc/terms/abstract>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:abstract \"SomeOntology defines a range of classes and properties which can be applied to do stuff in a particular domain.\"@en , \"SomeOntology definiert eine Reihe von Klassen und Properties, die in einer bestimmten Domäne verwendet werden können, um etwas damit zu tun.\"@de .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides its abstract as an rdf:langString. It produces an info message if not."@en ;
        sh:name "Ontology abstract - language"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:abstract <https://schema.org/abstract>)] ;
        sh:severity sh:Info ;
        sh:uniqueLang true ;
        sh:message """You should provide only one ontology abstract per language.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides several abstracts in the same language. It produces an info message if it does."@en ;
        sh:name "Ontology abstract - unique language"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:abstract <https://schema.org/abstract>)] ;
        sh:severity sh:Info ;
        sh:maxLength 500 ; 
        sh:message """You should limit the ontology abstract to 500 characters maximum.\nThe TIB Terminology Service requires short ontology descriptions for a user-friendly ontology list.\nTo provide more information about the ontology, add an additional description (recommended property: <http://purl.org/dc/terms/escription>) or add a reference to a related article (recommended property: <http://purl.org/dc/terms/isReferencedBy>).\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape cheks whether the ontology abstract is longer than 500 characters. It produces an info message if it does."@en ;
        sh:name "Ontology abstract - length"@en ;
    ] ;

## Ontology issue tracker
### status: developer and external review needed
    sh:property [
        sh:path <http://usefulinc.com/ns/doap#bug-database> ;
        sh:severity sh:Warning ;
        sh:nodeKind sh:IRI ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        # sh:message """The ontology does not contain the link to its issue tracker. Please provide if available and known."""@en ; # optimized message for current TIB TS 
        sh:message """You must provide an IRI for the ontology's issue tracker or another location where bugs and suggestions for the ontology can be reported.\nRecommended property: <http://usefulinc.com/ns/doap#bug-database>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:bug-database <https://github.com/SomeOrganisation/SomeOntology/issues> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references an issue tracker on its repository (e.g. at GitLab or GitHub). It creates a warning message, if it does not."@en ;
        sh:name "Ontology issue tracker"@en ;
    ] ;

## Ontology documentation
### status: developer and external review needed
    sh:property [
        sh:path  <http://www.loc.gov/premis/rdf/v3/documentation> ;
        sh:severity sh:Warning ;
        sh:nodeKind sh:IRI ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        # sh:message """The ontology does not contain the link to its documentation. Please provide it, if known."""@en ; # optimized message for current TIB TS
        sh:message """You must provide an IRI to the ontology documentation.\nRecommended property: <http://www.loc.gov/premis/rdf/v3/documentation>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> premis:documentation <https://www.purl.org/SomeOntology/Documentation> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides a link to its documentation. It produces warning message if it does not."@en ;
        sh:name "Ontology documentation"@en ; 
    ] ;

# RECOMMENDED METADATA

## Ontology contributor(s)
### status: developer and external review needed
    sh:property [
        sh:path  [sh:alternativePath (dcterms:contributor dc:contributor schema:contributor pav:contributedBy)] ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """You should list all contributors to the ontology.\nContributors should be referenced via PIDs, e.g. ORCiDs for persons and RORs for organisations.\nIf an ontology is developed by a larger group, it is recommended to give the organization or project identifier as the creator and list individual persons as contributors.\nRecommended property: <http://purl.org/dc/terms/contributor>\n\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/contributor> <https://orcid.org/0000-0000-0000-0000>. <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person .\nPlain name strings can be provided in addition (for readability).\nExample statement 2 (text/turtle):\n    <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/contributor> <https://orcid.org/0000-0000-0000-0000>.\n    <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person ;<http://xmlns.com/foaf/0.1/firstName> \"Max\" ;\n        <http://xmlns.com/foaf/0.1/lastName> \"Muster\" .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides information about its contributors. It produces an info message if no contributor information is present."@en ;
        sh:name "Ontology contributor(s)"@en ;
    ] ;

    sh:property [
        sh:path  [sh:alternativePath (dcterms:contributor dc:contributor schema:contributor pav:contributedBy)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide the ontology contributor information as IRIs.\nPlease make sure to provide persistent identifiers (PIDs) wherever possible, e.g. ORCiDs for persons and RORs for organisations.\nIf an ontology is developed by a larger group, it is recommended to give the organization or project identifier as the creator and list individual persons as contributors.\nRecommended property: <http://purl.org/dc/terms/contributor>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/contributor> <https://orcid.org/0000-0000-0000-0000>. <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person .\n\nPlain name strings could be provided in addition (for readability).\nExample statement 2 (text/turtle):\n    <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/contributor> <https://orcid.org/0000-0000-0000-0000>.\n    <https://orcid.org/0000-0000-0000-0000> rdf:type foaf:Person ; <http://xmlns.com/foaf/0.1/firstName> \"Max\" ;\n        <http://xmlns.com/foaf/0.1/lastName> \"Muster\" .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology states its contributors via IRIs. It produces an info message if contributor information is given e.g. as xsd:string."@en ;
        sh:name "Ontology contributor(s) - datatype"@en ; 
    ] ;

## Ontology funder
### status: developer and external review needed
    sh:property [
        sh:path <https://schema.org/funder> ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """If applicable, you should reference any institutions funding the work on the ontology.\nThe funding instution(s) should be referenced by PIDs, e.g. RORs (https://ror.org/) or Crossref Funder Registry IDs (https://www.crossref.org/services/funder-registry/)).\nRecommended property: <https://schema.org/funder>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://schema.org/funder> <https://ror.org/018mejw64> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references funding information. It produces an info message if not."@en ;
        sh:name "Ontology funder"@en ;
    ] ;

    sh:property [
        sh:path <https://schema.org/funder> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should reference any institutions funding your ontology via IRI.\nThe funding institution should be referenced by PIDs, e.g. RORs (https://ror.org/) or Crossref Funder Registry IDs (https://www.crossref.org/services/funder-registry/)).\nRecommended property: <https://schema.org/funder>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://schema.org/funder> <https://ror.org/018mejw64> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references its funder via IRI. It produces an info message if it does not."@en ;
        sh:name "Ontology funder"@en ;
    ] ;

## Ontology funding
### status: developer and external review needed
### Funding: the link is not useful, because CrossRef does not offer a searchable database.

    sh:property [
        sh:path <https://schema.org/funding> ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """If applicable, you should reference the grant which funds the work on the ontology.\nThe grant should be referenced by PID, e.g. Crossref Grant ID (https://www.crossref.org/documentation/research-nexus/grants/)).\nRecommended property: <https://schema.org/funding>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://schema.org/funding> <https://doi.org/00.00000/000000000> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references a grant funding the work on the ontology. It produces an info message if not."@en ;
        sh:name "Ontology funding (grant)"@en ;
    ] ;

    sh:property [
        sh:path <https://schema.org/funding> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should reference any grants funding your ontology via IRI.\nThe funding grant should be referenced by PID, e.g. Crossref Grant IDs (https://www.crossref.org/documentation/research-nexus/grants/)).\nRecommended property: <https://schema.org/funding>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://schema.org/funding> <https://doi.org/00.00000/000000000> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references its funding grant via IRI. It produces an info message if it does not."@en ;
        sh:name "Ontology funding (grant)"@en ;
    ] ;


## Ontology audience description
### status: developer and external review needed
    sh:property [
        sh:path [sh:alternativePath (doap:audience schema:audience dcterms:audience)] ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:message """You should describe the intended audience of the ontology.\nThe audience description should be a short, language-tagged text.\nRecommended property: <http://usefulinc.com/ns/doap#audience>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:audience \"This ontology is intended for researchers in derivational morphology, a branch of linguistics.\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology describes its audience. It produces an info message if audience information is missing."@en ;
        skos:editorialNote "see also open comment at G-Doc: https://docs.google.com/document/d/1FRmCQ7eD6PcqSQgPbqCGjki3t39ROoYozsehCPX9E0Q/edit?disco=AAAAwke7GNs" ;
        sh:name "Ontology audience description"@en ; 
    ] ;

    sh:property [
        sh:path [sh:alternativePath (doap:audience schema:audience dcterms:audience)] ;
        sh:severity sh:Info ;
        sh:datatype rdf:langString ;
        sh:message """You should provide the audience description of the ontology as an rdf:langString.\nRecommended property: <http://usefulinc.com/ns/doap#audience>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:audience \"This ontology is intended for researchers in derivational morphology, a branch of linguistics.\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/ """@en ;
        sh:description "This shape checks whether the ontology provides the audience description as an rdf:langString. It produces an info message if not."@en ;
        sh:name "Ontology audience description - language"@en ; 
    ] ;


## Ontology subject(s)
### status: developer and external review needed
    sh:property [
        sh:path dcterms:subject ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """You should provide some keywords  to describe the subject(s) of your ontology.\nIt is recommended to use identifiers of controlled vocabularies or ontologies to do so.\nYou can search for fitting terms on TIB Terminology Service (https://terminology.tib.eu).\nRecommended property: <http://purl.org/dc/terms/subject>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:subject <https://d-nb.info/gnd/4067537-3>, <https://d-nb.info/gnd/4070177-3>, <http://uri.gbv.de/terminology/bk/42.15>, <https://github.com/tibonto/dfgfo/201-03>.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides subjects. It produces an info message if it does not."@en ;
        sh:name "Ontology subject(s)"@en ;
    ] ;

    sh:property [
        sh:path dcterms:subject ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide ontology subjects with IRIs from controlled vocabularies or ontologies.\nYou can search for fitting terms on TIB Terminology Service (https://terminology.tib.eu).\nRecommended property: <http://purl.org/dc/terms/subject>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:subject <https://d-nb.info/gnd/4067537-3>, <https://d-nb.info/gnd/4070177-3>, <http://uri.gbv.de/terminology/bk/42.15>, <https://github.com/tibonto/dfgfo/201-03>.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides its subjects via IRIs. It produces an info message if it does not."@en ;
        sh:name "Ontology subject(s) - datatype"@en ;
    ] ;


## Ontology annotation language(s)
### status: developer and external review needed
    sh:property [
        sh:path [sh:alternativePath (dcterms:language <https://schema.org/inLanguage>) ];
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """You should provide information about the ontology annotation language(s) (e.g. for term labels, term definitions, etc.).\nYou should only claim that the ontology uses an annotation language, if all ontology elements or an extensive part of the ontology is annotaed in that languge.\nRecommended controlled vocabulary: <http://id.loc.gov/vocabulary/iso639-2>\nRecommended property: <https://schema.org/inLanguage>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:language <http://id.loc.gov/vocabulary/iso639-2/eng>, <http://id.loc.gov/vocabulary/iso639-2/tgl> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology specifies the languages it covers (e.g. for term labels, term definitions, etc.). It produces an info message if no language information is given."@en ;
        sh:name "Ontology annotation language(s)"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:language <https://schema.org/inLanguage>) ];
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should specify the ontology annotation language(s) via IRIs.\nRecommended controlled vocabulary: <http://id.loc.gov/vocabulary/iso639-2>\nRecommended property: <https://schema.org/inLanguage>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:language <http://id.loc.gov/vocabulary/iso639-2/eng>, <http://id.loc.gov/vocabulary/iso639-2/tgl> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides information about its language coverage via IRIs. It produces an info message if it does not."@en ;
        sh:name "Ontology annotation language(s) - datatype"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dcterms:language <https://schema.org/inLanguage>) ];
        sh:severity sh:Info ;
        sh:pattern "(^http://id.loc.gov/vocabulary/iso639-2/[a-z]{3}$|^https://id.loc.gov/vocabulary/iso639-2/[a-z]{3}$)" ;
        sh:message """You should provide ontology annotation language values that match the pattern for language identifiers from 'ISO 639-2: Codes for the Representation of Names of Languages - Part 2: Alpha-3 Code for the Names of Languages' (cf. https://id.loc.gov/vocabulary/iso639-2.html).\nExample identifier: <http://id.loc.gov/vocabulary/iso639-2/tgl>\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the values for language coverage match the pattern for language identifiers from 'ISO 639-2: Codes for the Representation of Names of Languages - Part 2: Alpha-3 Code for the Names of Languages'. It produces an info message if they do not."@en ;
        sh:name "Ontology annotation language(s) - pattern"@en ; 
    ] ;


## Applied logical framework
### status: developer and external review needed
#### external comment Giacomo: Logical framework: the user needs a reference to a half-way authoritative list of frameworks (OWL? SKOS? RDF? OBO?) showing how they separate (wie sie sich voneinander abgrenzen)
    sh:property [
        sh:path <https://w3id.org/mod#hasFormalityLevel>;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:message """You should state which logical framework the ontology applies.\nThe information can be given as a text, referring to the Semantic Web Standard (e.g. 'OWL 2') and possibly the OWL profile (e.g. 'OWL 2 EL profile').\nRecommended property: <https://w3id.org/mod#hasFormalityLevel>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> mod:hasFormalityLevel \"OWL version 2, EL profile\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology specifies the logical framework it applies. It produces an info message if the information is missing."@en ;
        sh:name "Applied logical framework description"@en ;
    ] ;

    sh:property [
        sh:path <https://w3id.org/mod#hasFormalityLevel>;
        sh:severity sh:Info ;
        sh:datatype rdf:langString ;
        sh:message """You should provide the description of the logical framework applied by the ontology as an rdf:langString.\nRecommended property: <https://w3id.org/mod#hasFormalityLevel>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> mod:hasFormalityLevel \"OWL version 2, EL profile\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's information about it applied logical framework is provided as an rdf:langString. It produces an info message if it does not."@en ;
        sh:name "Applied logical framework description - language"@en ;
    ] ;


## Ontology serialization/ file format
### status: developer and external review needed
    sh:property [
        sh:path [sh:alternativePath (<https://w3id.org/mod#hasSyntax> <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://purl.org/dc/terms/format> <http://purl.org/dc/elements/1.1/format>) ];
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """You should state the ontology's serialization/ file format.\nThe value should be provided as an IRI.\nWe recommend to provide the information about the media type/ file format of your ontology as one of the values from the Media Types list of the Internet Assigned Number Authority (IANA) (cf. https://www.iana.org/assignments/media-types/media-types.xhtml) or from the W3C resource "Unique URIs for File Formats" <https://www.w3.org/ns/formats/>:\n\nIn order to publish your ontology on the TIB Terminology Service, you must provide the ontology in one of the following formats:\n    - <https://www.iana.org/assignments/media-types/application/rdf+xml> resp. <http://www.w3.org/ns/formats/RDF_XML>\n    - <https://www.iana.org/assignments/media-types/text/turtle> resp. <http://www.w3.org/ns/formats/Turtle>\n    - OBO format (cf. http://purl.obolibrary.org/obo/oboformat/spec.html)\nCurrently, there is no registered media type for obo format.\nRecommended property: <https://w3id.org/mod#hasSyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://w3id.org/mod#hasSyntax> <http://www.w3.org/ns/formats/RDF_XML> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology specifies its serialization/ file format. It produces an info message if it does not."@en ;
        sh:name "Ontology serialization/ file format"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (<https://w3id.org/mod#hasSyntax> <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://purl.org/dc/terms/format> <http://purl.org/dc/elements/1.1/format>) ];
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should state the ontology's serialization/ file format.\nThe value should be provided as an IRI.\nWe recommend to provide the information about the media type/ file format of your ontology as one of the values from the Media Types list of the Internet Assigned Number Authority (IANA) (cf. https://www.iana.org/assignments/media-types/media-types.xhtml) or from the W3C resource \"Unique URIs for File Formats\" <https://www.w3.org/ns/formats/>:\n\nIn order to publish your ontology on the TIB Terminology Service, you must provide the ontology in one of the following formats:\n    - <https://www.iana.org/assignments/media-types/application/rdf+xml> resp. <http://www.w3.org/ns/formats/RDF_XML>\n    - <https://www.iana.org/assignments/media-types/text/turtle> resp. <http://www.w3.org/ns/formats/Turtle>\n    - OBO format (cf. http://purl.obolibrary.org/obo/oboformat/spec.html)\nCurrently, there is no registered media type for obo format.\nRecommended property: <https://w3id.org/mod#hasSyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <https://w3id.org/mod#hasSyntax> <http://www.w3.org/ns/formats/RDF_XML> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology specifies its serialization/ file format via IRI. It produces an info message if it does not."@en ;
        sh:name "Ontology serialization/ file format - datatype"@en ; 
    ] ;

    sh:property [
        sh:path [sh:alternativePath (<https://w3id.org/mod#hasSyntax> <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://purl.org/dc/terms/format> <http://purl.org/dc/elements/1.1/format>) ];
        sh:severity sh:Info ;
        sh:maxCount 1;
        sh:xone (
        # tbd: not all are relevant or digestable by the TS
        # for the TS rdf+xml, turtle and obo are confirmed
        # no expected value for obo ontologies > Ontorowser mentions application/obo and text/obo, but these are specific to the service, not officially acknowledged: https://github.com/Novartis/ontobrowser/blob/master/doc/web_services.md
            # [sh:hasValue <http://www.w3.org/ns/formats/JSON-LD> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/N3> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/N-Triples> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/N-Quads> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/LD_Patch> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/microdata> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/OWL_XML> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/OWL_Functional> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/OWL_Manchester> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/POWDER> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/POWDER-S> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/PROV-N> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/PROV-XML> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/RDFa> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/RDF_JSON> ;] 
            [sh:hasValue <http://www.w3.org/ns/formats/RDF_XML> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/RIF_XML> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/SPARQL_Results_XML> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/SPARQL_Results_JSON> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/SPARQL_Results_CSV> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/SPARQL_Results_TSV> ;] 
            [sh:hasValue <http://www.w3.org/ns/formats/Turtle> ;] 
            # [sh:hasValue <http://www.w3.org/ns/formats/TriG> ;] 
            [sh:hasValue <https://www.iana.org/assignments/media-types/application/rdf+xml> ;] 
            [sh:hasValue <https://www.iana.org/assignments/media-types/text/turtle> ;]
            # [sh:hasValue <https://www.iana.org/assignments/media-types/application/trig> ;]
            # [sh:hasValue <https://www.iana.org/assignments/media-types/text/n3> ;]
            # [sh:hasValue <https://www.iana.org/assignments/media-types/application/n-triples> ;]
            # [sh:hasValue <https://www.iana.org/assignments/media-types/application/n-quads> ;]
            # [sh:hasValue <https://www.iana.org/assignments/media-types/application/ld+json> ;]
            );
        sh:message """You should state the ontology's serialization/ file format.\nThe value should be provided as an IRI.\nWe recommend to provide the information about the media type/ file format of your ontology as one of the values from the Media Types list of the Internet Assigned Number Authority (IANA) (cf. https://www.iana.org/assignments/media-types/media-types.xhtml) or from the W3C resource \"Unique URIs for File Formats\" <https://www.w3.org/ns/formats/>:\n\nIn order to publish your ontology on the TIB Terminology Service, you must provide the ontology in one of the following formats:\n    - <https://www.iana.org/assignments/media-types/application/rdf+xml> resp. <http://www.w3.org/ns/formats/RDF_XML>\n    - <https://www.iana.org/assignments/media-types/text/turtle> resp. <http://www.w3.org/ns/formats/Turtle>\n    - OBO format (cf. http://purl.obolibrary.org/obo/oboformat/spec.html)\nCurrently, there is no registered media type for obo format.\nRecommended property: <https://w3id.org/mod#hasSyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> [sh:alternativePath (<https://w3id.org/mod#hasSyntax> <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://purl.org/dc/terms/format> <http://purl.org/dc/elements/1.1/format>) ]; <http://www.w3.org/ns/formats/RDF_XML> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's serialization/ file format value is from a selection of the recommended controlled lists. It produces an info message if there is more than one value or when the value is not from the selection of the list."@en ;
        sh:name "Ontology serialization/ file format - controlled vocabulary value"@en ;
    ] ;

## Ontology status
### status: developer and external review needed
### for later: dedicated ontology_status property missing - suggest to OBO? if available: use instead of bibo:status
    sh:property [
        sh:path <http://purl.org/ontology/bibo/status> ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:datatype rdf:langString ;
        sh:message """You should declare the current maintenance status of the ontology. You could use an English label to do so. We recommend using one of 'active', 'inactive', 'orphaned' or 'obsolete' (cf. https://obofoundry.org/docs/OntologyStatus.html).\nThe value you use should be language-tagged.\nRecommended property: <http://purl.org/ontology/bibo/status>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> bibo:status \"inactive\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides its maintenance status. It produces an info message, if the information is missing."@en ;
        sh:name "Ontology status"@en ; 
    ] ;

## Ontology code repository
### status: developer and external review needed
    sh:property [
        sh:path <http://usefulinc.com/ns/doap#repository>;
        sh:severity sh:Info ;
        sh:minCount 1;
        sh:maxCount 1;
        sh:message """You should provide the link to the ontology's code repository.\nThe ontology should be on a code repository and the ontology should contain the repository's IRI.\nRecommended property: <http://usefulinc.com/ns/doap#repository>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:repository <https://github.com/SomeOrganisation/SomeOntology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology povides a link to its code repository. It produces an info message, if the information is missing."@en ;
        sh:name "Ontology code repository"@en ;
    ] ;

    sh:property [
        sh:path <http://usefulinc.com/ns/doap#repository>;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI;
        sh:message """You should provide the link to the ontology's code repository as an IRI.\nRecommended property: <http://usefulinc.com/ns/doap#repository>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:repository <https://github.com/SomeOrganisation/SomeOntology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology povides the link to its code repository as an IRI. It produces an info message, if the information is given as an xsd:string or the like."@en ;
        sh:name "Ontology code repository - datatype"@en ;
    ] ;

## Ontology distributions/ products
### status: developer and external review needed
   sh:property [
        sh:path [ sh:alternativePath (<http://www.w3.org/ns/dcat#distribution> schema:distribution dcterms:hasFormat)];
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide IRIs to available alternative serializations or distributions of the ontology.\nRecommended property: <http://www.w3.org/ns/dcat#distribution>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcat:distribution <https://www.purl.org/SomeOntology.owl>, <https://www.purl.org/SomeOntology.json>, <https://www.purl.org/SomeOntology.ttl> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides links to alternative serializations. It produces an info message if the ontology is missing or not provided as an IRI."@en ;
        sh:name "Ontology distributions/ products"@en ;
   ] ; 

## Application example
### status: developer and external review needed
    sh:property [
        sh:path <https://vocab.org/vann/example> ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide a link to an application example of the ontology.\nIdeally, the ontology provides a PID to e.g. a publication describing applications of the ontology, or directly to an application or online service that uses the ontology.\nRecommended property: <https://vocab.org/vann/example>\nExample statement (text/turtle): <http://www.w3.org/ns/dcat> vann:example <https://www.w3.org/TR/vocab-dcat-2/#collection-of-examples> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides links to application examples. It produces an info message if the information is missing or not provided as an IRI."@en ;
        sh:name "Application example"@en ;
    ] ;

## Related resource(s)
### status: developer and external review needed
    sh:property [
        sh:path dcterms:references ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide references to resources related to the ontology via IRI.\nRelated recources could for example be publications introducing, discussing, evaluating or describing the ontology, recources containing alignments of your ontology to other ontologies, or any other resources that you would like to reference in your ontology.\nThe reference should be provided via PID, for example a DOI, if available.\nRecommended property: <http://purl.org/dc/terms/references>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:references <http://doi.org/10.00000/some0.ontolo> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides references to related resources as IRIs. It produces an info message if the information is missing or not provided as an IRI."@en ;
        sh:name "Related resource(s)"@en ;
    ] ;


## Citation suggestion
### status: developer and external review needed
    sh:property [
        sh:path dcterms:bibliographicCitation ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:message """You should provide information about how the ontology should be cited.\nThe information should be provided as an rdf:langString.\nRecommended property: <http://purl.org/dc/terms/bibliographicCitation>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:bibliographicCitation \"Last name, first name; last name, first name et al. (YYYY): Title. URL: https://w3id.org/SomeOntology/1.1.6\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape ckecks whether the ontology provides information about how it should be cited. It produces an info message if the information is missing."@en ;
        sh:name "Citation suggestion"@en ;
    ] ;

## Ontology sources (derived from)
### status: developer and external review needed
    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/pav/derivedFrom> <http://www.w3.org/ns/prov#wasDerivedFrom>)] ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:nodeKind sh:IRI ;
        sh:message """You should specify whether and from which other ontologies your ontology has been derived.\nThe reference should be made by an owl:versionIRI of the ontology from which the current ontology has been derived.\nRecommended property: <http://purl.org/pav/derivedFrom>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> pav:derivedFrom <https://www.purl.org/SomeOtherOntology/3.1.2> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides links to other ontologies it has been derived from. It produces an info message if the information is missing or not provided as IRIs."@en ;
        sh:name "Ontology sources (derived from)"@en ;
    ];

## Ontology root classes
### status: developer and external review needed
    sh:property [
        sh:path <http://purl.obolibrary.org/obo/IAO_0000700> ;
        sh:severity sh:Info ;
        sh:minCount 1 ;
        sh:nodeKind sh:IRI ;
        sh:message """You should explicitly declare the ontology's root classes.\nThis information can be used for tree-like visualizations of the class hierarchy in technical services, e.g. TIB Terminology Service.\nThe repsective classes (if any) need to be provided via their identifier.\nRecommended property: <http://purl.obolibrary.org/obo/IAO_0000700>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> obo:IAO_0000700 <https://www.purl.org/SomeOntology/12345654544545> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares its preferred root classes. It produces an info message if the information is missing or the information is not provided as IRIs."@en ;
        sh:name "Ontology root classes"@en ;
    ] ;

# OPTIONAL METADATA
### status: developer and external review needed

## Ontology description
### status: developer and external review needed

    sh:property [
        sh:path  [sh:alternativePath (dc:description dcterms:description schema:description)];
        sh:severity sh:Info ;
        sh:nodeKind sh:Literal;
        sh:datatype rdf:langString ;
        sh:message """You should provide the ontology description as an rdf:langString.\nRecommended property: <https://schema.org/description>\nExample statetement (text/turtle): <https://www.purl.org/SomeOntology> schema:description \"Free text describing the ontology and how it came to be. Basically everything you might want to add and which does not fit into the abstract.\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology description is an rdf:langString. It produces an info message if it is not."@en ;
        sh:name "Ontology description - language"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (dc:description dcterms:description schema:description)] ;
        sh:severity sh:Info ;
        sh:uniqueLang true ;
        sh:message """You should only provide one ontology description per language.\nRecommended property: <https://schema.org/description>\nExample statements (text/turtle): <https://www.purl.org/SomeOntology> schema:description \"Free text describing the ontology and how it came to be. Basically everything you might want to add and which does not fit into the abstract.\"@en, \"Freitext, der die Ontologie und ihre Genese beschreibt. Hier können umfangreiche Hintergrundinformationen zur Ontologie gegeben werden, die über ein kurzes Abstract hinausgehen.\" .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether multiple ontology descriptions in the same language are present. It produces an info message if there are multiple descriptions in the same language."@en ;
        sh:name "Ontology description - unique language"@en ;
    ] ;


## Alternative ontology title
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/dc/terms/alternative> <https://schema.org/alternateName> <https://schema.org/alternativeHeadline>)];
        sh:severity sh:Info ;
        sh:datatype rdf:langString ;
        sh:message """You should provide the ontology's alternative title as an rdf:langString.\nRecommended property: <http://purl.org/dc/terms/alternative>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:alternative \"My Ontology\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en;
        sh:description "This shape checks whether the ontology's alternative title is an rdf:langString. It produces an info message if it is not."@en;
        sh:name "Alternative ontology title - language"@en;
    ] ;

## Alternative ontology prefix/ acronym
### status: developer and external review needed

    sh:property [
        sh:path <http://identifiers.org/idot/alternatePrefix> ;
        sh:severity sh:Info ;
        sh:datatype xsd:string ;
        sh:message """You should provide the ontology's alternative prefix as an xsd:string.\nRecommended property: <http://identifiers.org/idot/alternatePrefix>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> idot:alternatePrefix \"mo\"^^xsd:string .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's alternative prefix is an xsd:string. It produces an info message if it does not."@en ;
        sh:name "Alternative ontology prefix/ acronym - datatype"@en ;
    ] ;

## Related version/ version history
### status: see below

### Prior ontology version
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://www.w3.org/2002/07/owl#priorVersion> <http://www.w3.org/ns/adms#prev> <http://purl.org/pav/previousVersion> <http://www.w3.org/ns/prov#wasRevisionOf> <http://purl.org/dc/terms/replaces> )] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide the ontology's prior version as an IRI.\nIdeally, a resolving ontology versionIRI should be used.\nRecommended property: <http://www.w3.org/2002/07/owl#priorVersion>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> owl:priorVersion <https://www.purl.org/SomeOntology/1.1.6> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description """This shape checks whether the ontology's prior version is provided as an IRI, ideally via a resolving versionIRI. It produces an info message if it is not."""@en ;
        sh:name "Prior ontology version"@en ;
    ] ;

### Related ontology version
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/pav/hasCurrentVersion> <https://schema.org/version> <http://purl.org/dc/terms/hasVersion>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide the ontology's related version as an IRI.\nIdeally, a resolving ontology versionIRI should be used.\nRecommended property: <http://purl.org/dc/terms/hasVersion>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology/1.1.6> dcterms:isVersionOf <https://www.purl.org/SomeOntology>.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's related versions are provided as IRIs, ideally via a resolving versionIRI. It produces an info message if they are not."@en ;
        sh:name "Related ontology version"@en ;
    ] ;

### Compatible ontology version
### status: developer and external review needed

    sh:property [
        sh:path <http://www.w3.org/2002/07/owl#backwardCompatibleWith> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide compatible versions of the ontology as IRIs.\nIdeally, a resolving ontology versionIRI should be used.\nRecommended property: <http://www.w3.org/2002/07/owl#backwardCompatibleWith>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology/1.1.7> owl:backwardCompatibleWith <https://www.purl.org/SomeOntology/1.1.6> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides links to compatible versions of the ontology via IRIs. It produces an info message if they are not."@en ;
        sh:name "Compatible ontology version"@en ;
    ] ;

### Incompatible ontology version
### status: developer and external review needed

    sh:property [
        sh:path <http://www.w3.org/2002/07/owl#incompatibleWith> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide incompatible versions of the ontology as IRIs.\nIdeally, a resolving ontology versionIRI should be used.\nRecommended property: <http://www.w3.org/2002/07/owl#incompatibleWith>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology/1.1.7> owl:incompatibleWith <https://www.purl.org/SomeOntology/1.1.6> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides links to incompatible versions of the ontology via IRIs. It produces an info message, if it does not."@en ;
        sh:name "Incompatible ontology version"@en ;
    ] ;


## Social media
### status: intentionally no shape

## KOS type
### status: developer and external review needed

    sh:property [
        sh:path dcterms:type ;
        sh:severity sh:Info ;
        sh:maxCount 1 ;
        sh:message """You should declare at most on KOS type for the resource. Use an identifier from the NKOS type vocabulary (https://nkos.dublincore.org/nkostype/nkostype.rdf).\nRecommended property: <http://purl.org/dc/terms/type>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology/1.1.7> dcterms:type <http://w3id.org/nkos/nkostype#ontology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares a KOS-type as an IRI from the NKOS type vocabulary. It produces an info message if it does not."@en ;
        sh:name "KOS type"@en ;
    ] ;

    sh:property [
        sh:path dcterms:type ;
        sh:severity sh:Info ;
        sh:xone (
            [sh:hasValue <http://w3id.org/nkos/nkostype#authority_file>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#categorization_schema>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#classification_schema>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#dictionary>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#gazetteer>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#glossary>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#list>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#name_authority_list>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#ontology>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#pick_list>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#semantic_network>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#subject_heading_scheme>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#synonym_ring>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#taxonomy>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#terminology>]
            [sh:hasValue <http://w3id.org/nkos/nkostype#thesaurus>]
            ) ;
        sh:message """The KOS type identifier should be provided as an IRI. The IRI should be one of the KOS types defined by the NKOS type vocabulary (https://nkos.dublincore.org/nkostype/nkostype.rdf).\nRecommended property: <http://purl.org/dc/terms/type>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology/1.1.7> dcterms:type <http://w3id.org/nkos/nkostype#ontology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares a KOS-type as an IRI from the NKOS type vocabulary. It produces an info message if it does not."@en ;
        sh:name "KOS type"@en ;
    ] ;

## Example ontology identifier
### status: developer and external review needed
 
    sh:property [
        sh:path <http://identifiers.org/idot/exampleIdentifier> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should declare an example identifier for the ontology as an IRI.\nRecommended property: <http://identifiers.org/idot/exampleIdentifier>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> idot:exampleIdentifier <https://www.purl.org/SomeOntology/1234-XY> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares example identifiers as IRIs. It produces an info message if it does not."@en ;
        sh:name "Example ontology identifier"@en ;
    ] ;

## Ontology identifier pattern
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://identifiers.org/idot/identifierPattern> <https://bioregistry.io/schema/#0000008>)] ;
        sh:severity sh:Info ;
        sh:datatype xsd:string ;
        sh:maxCount 1 ;
        sh:message """You should provide the identifier pattern for the ontology as an xsd:string.\nRecommended property: <http://identifiers.org/idot/identifierPattern>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> idot:identifierPattern \"^\\d{4}-[A-Z]{2}$\"^^xsd:string .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares an identifier pattern as xsd:string. It produces an info message if it does not."@en ;
        sh:name "Ontology identifier pattern"@en ;
    ] ;


## Ontology homepage
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://xmlns.com/foaf/0.1/homepage> <http://xmlns.com/foaf/0.1/page>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:maxCount 1 ;
        sh:message """You should provide the homepage of the ontology as an IRI.\nRecommended property: <http://xmlns.com/foaf/0.1/homepage>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> foaf:homepage <https://www.example.com/SomeOntologyInfo> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology homepage is provided as an IRI. It produces an info message if it is not."@en ;
        sh:name "Ontology homepage"@en ;
    ] ;

## Ontology publisher
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/dc/terms/publisher> <http://purl.org/dc/elements/1.1/publisher> <https://schema.org/publisher>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:xone (
            # pattern sources: Wikidata entries of the identifier types
            [sh:pattern "https://ror.org/([a-z0-9]{9})" ; ]
            [sh:pattern "https://isni.org/isni/[0]{4}[0-9]{4}[0-9]{4}[0-9]{3}[0-9X]" ;]
            [sh:pattern "https://d-nb.info/gnd/(|(1[012]?[0-9]{7}[0-9X]|[47][0-9]{6}-[0-9]|[1-9][0-9]{0,7}-[0-9X]|3[0-9]{7}[0-9X]))$" ;]
        ) ;
        sh:message """You should specify the ontology publisher via ROR, ISNI or GND identifier.\nThe value you provide should be given as an IRI and match the identifier patterns.\nIf you use valid ROR, ISNI or GND identifiers, this should be the case.\nRecommended property: <http://purl.org/dc/terms/publisher>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:publisher <https://isni.org/isni/0000000121746694> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology specifies its publisher as an IRI belonging to the ROR, ISNI or GND namespace. It produces an info message if not."@en ;
        sh:name "Ontology publisher"@en ;
    ] ;

## Ontology comments
### status: developer and external review needed

    sh:property [
        sh:path rdfs:comment ;
        sh:severity sh:Info ;
        sh:datatype rdf:langString ;
        sh:message """You should provide any comments about the ontology as rdf:langString.\nRecommended property: <http://www.w3.org/2000/01/rdf-schema#comment>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> rdfs:comment \"SomeOntology does not actually exist.\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the comments about the ontology are provided as an rdf:langString. It produces an info message if they are not."@en ;
        sh:name "Ontology comments"@en ;
    ] ;


## Example ontology class
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://www.w3.org/2004/02/skos/core#example> <http://rdfs.org/ns/void#exampleResource> )] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide example classes of the otology as IRIs.\nRecommended property: <http://rdfs.org/ns/void#exampleResource>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> void:exampleResource <https://www.purl.org/SomeClass> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether example classes of the ontology are provided as IRIs. It produces an info message if they are not."@en ;
        sh:name "Example ontology class - data type"@en ;
    ] ;


## Ontology mailing list
### status: developer and external review needed

    sh:property [
        sh:path <http://usefulinc.com/ns/doap#mailing-list> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:maxCount 1 ;
        sh:message """You should provide the ontology mailing list as an IRI.\nRecommended property: <http://usefulinc.com/ns/doap#mailing-list>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> doap:mailing-list <someontology@list.de> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology mailing list is provided as an IRI. It produces an info message if it is not."@en ;
        sh:name "Ontology mailing list"@en ;
    ];

## Ontology logo/ depiction/ related visualizations
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<http://xmlns.com/foaf/0.1/logo> <https://schema.org/logo> <http://xmlns.com/foaf/0.1/depiction> <https://w3id.org/mod#depiction> <https://schema.org/image>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide links to depictions related to the ontology as IRIs.\nRecommended property: <http://xmlns.com/foaf/0.1/logo>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> foaf:logo <https://www.example.com/MyOntoLogo.jpg>\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/ """@en ;
        sh:description "This shape checks whether the ontology's related depictions are provided via IRI. It produces an info message if they are not."@en ;
        sh:name "Ontology logo/ depiction/ related visualizations"@en ;
    ];

## Alternative identifiers of the ontology
### status: developer and external review needed
### This shape is probably confusing since the properties shall provide identifiers for the ontology, not related resources.

    sh:property [
        sh:path [sh:alternativePath (<http://purl.org/dc/terms/identifier> <http://purl.org/ontology/bibo/doi> <http://purl.org/dc/elements/1.1/identifier>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide the ontology's identifiers as IRIs.\nThe identifier used as the base uri of the ontology should be provided with <http://purl.org/vocab/vann/preferredNamespaceUri>.\nRecommended property: <http://purl.org/dc/terms/identifier>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:identifier <https://doi.org/10.5281/zenodo.0000000> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology's related identifiers are provided as IRIs. It produces an info message if they are not."@en ;
        sh:name "Related identifiers"@en ;
    ];

## Development environment
#### status: intentionally no shape

## Alignments/ mappings
### status: developer and external review needed

### Aligned resources
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (<https://w3id.org/mod#hasEquivalencesWith> <http://w3id.org/nkos#alignedWith>)] ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide information about ontologies your ontology is aligned to as IRIs.\nRecommended property: <https://w3id.org/mod#hasEquivalencesWith>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> mod:hasEquivalencesWith <https://www.purl.org/SomeOtherOntology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology references ontologies it is aligned to via IRIs. It produces an info message if it does not."@en ;
        sh:name "Aligned resources"@en ;
    ];

### Alignment files/ Mapping files
### status: see shape "Related resources"

## Competency Questions
### status: developer and external review needed

    sh:property [
        sh:path <https://w3id.org/mod#competencyQuestion> ;
        sh:severity sh:Info ;
        sh:xone ( [sh:nodeKind sh:IRI ;] [sh:datatype rdf:langString ;] );
        sh:message """You should provide the link to the ontology's competency questions as an IRI or provide the questions directly as an rdf:langString.\nRecommended property: <https://w3id.org/mod#competencyQuestion>\nExample statement 1 (text/turtle): <https://www.purl.org/SomeOntology> <https://w3id.org/mod#competencyQuestion> \"Who developed an ontology?\"@en .\nExample statement 2 (text/turtle): <https://www.purl.org/SomeOntology> <https://w3id.org/mod#competencyQuestion> <https://www.example.com/SomeOntologyInfo/Questions#Q1> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides competency questions as rdf:langString or an IRI to an online document. It produces an info message if it does not."@en ;
        sh:name "Competency questions"@en ;
    ];

## Applied methodology
### status: intentionally no shape

## Preferred ontology namespace
### status: developer and external review needed

    sh:property [
        sh:path <http://purl.org/vocab/vann/preferredNamespaceUri> ;
        sh:severity sh:Info ;
        sh:maxCount 1 ;
        sh:message """You should provide at most one preferred namespace URI for the ontology.\nRecommended property: <http://purl.org/vocab/vann/preferredNamespaceUri>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/vocab/vann/preferredNamespaceUri> <https://w3id/Example/SomeOntology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "The ontology should declare its preferred namespace URI."@en ;
        sh:name "Preferred ontology namespace"@en ; 
    ] ;

    sh:property [
        sh:path <http://purl.org/vocab/vann/preferredNamespaceUri> ;
        sh:severity sh:Info ;
        sh:nodeKind sh:IRI ;
        sh:message """You should provide the ontology's preferred namespace URI as an IRI.\nRecommended property: <http://purl.org/vocab/vann/preferredNamespaceUri>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> <http://purl.org/vocab/vann/preferredNamespaceUri> <https://w3id/Example/SomeOntology> .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology declares its preferred namespace URI as an IRI. It produces an info message if it does not."@en ;
        sh:name "Preferred ontology namespace - datatype"@en ;
    ] ;

## Ontology issue date
### status: developer and external review needed

    sh:property [
        sh:path [
            sh:alternativePath (
                <http://purl.org/dc/terms/issued>
                <https://schema.org/datePublished>
                <https://schema.org/dateIssued>
                )
            ] ;
        sh:severity sh:Info ;
        sh:datatype xsd:dateTime ;
        sh:maxCount 1 ;
        sh:message """You should provide at most one ontology issue date that conforms to xsd:dateTime.\nRecommended property: <http://purl.org/dc/terms/issued>\nExample statement: <https://www.purl.org/SomeOntology> <http://purl.org/dc/terms/> \"2023-11-21T00:00:00\"^^xsd:dateTime .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/ """@en ;
        sh:description "This shape checks whether the ontology's issue date conforms to xsd:dateTime. It produces an info message if it does not."@en ;
        sh:name "Ontology issue date - datatype"@en ; 
    ] ;

### Ontology modification date
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (dcterms:modified schema:dateModified pav:curatedOn pav:lastUpdateOn)];
        sh:severity sh:Info ;
        sh:datatype xsd:dateTime ;
        sh:maxCount 1;
        sh:message """You should provide at most one (the latest) ontology modification date in xsd:dateTime format.\nRecommended property: <http://purl.org/dc/terms/modified>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> dcterms:modified \"2020-11-19T00:00:00\"^^xsd:dateTime.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides at most one modification date in xsd:dateTime format. It produces an info message if not."@en ;
        sh:name "Ontology modification date"@en ;
    ] ;

### Ontology version information
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (owl:versionInfo pav:version)];
        sh:severity sh:Info ;
        sh:xone ( [sh:datatype xsd:string ;] [sh:datatype rdf:langString ;] );
        #        sh:datatype xsd:string ;
        sh:message """You should provide textual information about the ontology version as an xsd:string.\nIt is recommended to use semantic versioning (cf. https://semver.org/) or OBO style date-based versioning (http://obofoundry.org/principles/fp-004-versioning.html).\nIf you need to add a larger comment in natural language, you should provide the info as an rdf:langString, i.e. with a language tag. We do not encourage this, since such statements can most likely be expressed in more granular fashion with formal statements.\nRecommended property: <http://www.w3.org/2002/07/owl#versionInfo>\nExample statement 1: <https://www.purl.org/SomeOntology> owl:versionInfo \"2023-01-01\"^^xsd:string .\nExample statement 2: <https://www.purl.org/SomeOntology> owl:versionInfo \"1.0.0\"^^xsd:string.\nExample statement 3: <https://www.purl.org/SomeOntology> owl:versionInfo \"Ontology version 1.0.0 of the subject classification in tabular format from Nov 2024.\"@en.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides at most one textual version information as an xsd:string. It produces an info message if not."@en ;
        sh:name "Ontology version information"@en ;
    ] ;

    sh:property [
        sh:path [sh:alternativePath (owl:versionInfo pav:version)];
        sh:severity sh:Info ;
        sh:maxCount 1 ;
        sh:message """You should provide at most one textual information about the ontology version.\nThe value should be providee as an xsd:string.\nIt is recommended to use semantic versioning (cf. https://semver.org/) or OBO style date-based versioning (http://obofoundry.org/principles/fp-004-versioning.html).\nRecommended property: <http://www.w3.org/2002/07/owl#versionInfo>\nExample statement 1: <https://www.purl.org/SomeOntology> owl:versionInfo \"2023-01-01\"^^xsd:string .\nExample statement 2: <https://www.purl.org/SomeOntology> owl:versionInfo \"1.0.0\"^^xsd:string.\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "This shape checks whether the ontology provides at most one textual version information as an xsd:string. It produces an info message if not."@en ;
        sh:name "Ontology version information"@en ;
    ] ;

### Ontology version notes
### status: developer and external review needed

    sh:property [
        sh:path [sh:alternativePath (adms:versionNotes vann:changes)]  ;
        sh:severity sh:Info ;
        sh:nodeKind sh:Literal ; 
        sh:datatype rdf:langString ;
        sh:message """You should provide ontology version notes (e.g. notes on updates as compared to the previous version of the ontology) as an rdf:langString.\nRecommended property: <http://www.w3.org/ns/adms#versionNotes>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> adms:versionNotes \"Changes from 2000-01-12: add annotation properties: familyName [...]\"@en .\nNeed help? Learn more about SHACL: https://www.w3.org/TR/2017/REC-shacl-20170720/"""@en ;
        sh:description "The shape checks whether the ontology provides version notes as an rdf:langString. It produces an info message if not."@en ; 
        sh:name "Ontology version notes"@en ;
    ] ;

# End of shape
    sh:closed false ;
    sh:ignoredProperties ( rdf:type owl:topDataProperty owl:topObjectProperty ) .