Skip to content

Commit

Permalink
#6 switch from omv:hasOntologySyntax to mod:hasSyntax\nadd variant of…
Browse files Browse the repository at this point in the history
… CC-BY 4.0\nadd comment on creator
  • Loading branch information
SArndt-TIB committed Nov 29, 2024
1 parent 302138b commit 4a48d62
Show file tree
Hide file tree
Showing 7 changed files with 23 additions and 19 deletions.
2 changes: 1 addition & 1 deletion DummyOntoPASSES.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
dcterms:subject <https://purl.org/linsearch/inf> ;
schema:inLanguage <https://id.loc.gov/vocabulary/iso639-2/deu> ;
mod:hasFormalityLevel "The DummyOntoPASSES aplies OWL2 EL (cf. https://www.w3.org/TR/2012/REC-owl2-profiles-20121211/#OWL_2_EL)"@en ;
<http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://www.w3.org/ns/formats/Turtle> ;
<https://w3id.org/mod#hasSyntax> <http://www.w3.org/ns/formats/Turtle> ;
<http://purl.org/ontology/bibo/status> "active"@en ;
doap:repository <https://github.com/StroemPhi/Ontology-Metadata> ;
<http://www.w3.org/ns/dcat#distribution> <https://www.purl.org/ontologymetadata/DummyOntoPASSES.owl> ;
Expand Down
9 changes: 5 additions & 4 deletions MetadataGuide.html
Original file line number Diff line number Diff line change
Expand Up @@ -367,7 +367,7 @@
</script>
<h1 id="ontology-metadata-recommendations-by-tib">Ontology metadata recommendations by TIB</h1>
<p>Document status: <strong>DRAFT</strong></p>
<p>Modification date: 2024-05-02</p>
<p>Modification date: 2025-01-01</p>
<p>Creators and contributors:</p>
<!-- * [Last name, First Name (Affiliation)](https://orcid.org/) -->
<ul>
Expand Down Expand Up @@ -963,7 +963,7 @@ <h3 id="47-applied-logical-framework">4.7 Applied logical framework</h3>
</ul>
<h3 id="48-ontology-serialization-file-format">4.8 Ontology serialization/ file format</h3>
<p>You should state the ontology's serialization/ file format. The value should be provided as an IRI from the Media Types list of the Internet Assigned Number Authority (IANA) <a href="#source6">[6]</a> or from the W3C resource Unique URIs for File Formats <a href="#source7">[7]</a>.</p>
<p>Recommended property: <a href="http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax">http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax</a></p>
<p>Recommended property: <a href="https://w3id.org/mod#hasSyntax">https://w3id.org/mod#hasSyntax</a></p>
<p>Recommended controlled vocabularies:</p>
<ul>
<li><a href="https://www.w3.org/ns/formats">https://www.w3.org/ns/formats</a></li>
Expand All @@ -978,13 +978,14 @@ <h3 id="48-ontology-serialization-file-format">4.8 Ontology serialization/ file
<p>Currently, there is no registered media type for obo format.</p>
<p>Example (text/turtle):</p>
<pre class="hljs"><code><div>&lt;https://www.purl.org/SomeOntology&gt; rdf:type owl:Ontology ;
omv:hasOntologySyntax &lt;http://www.w3.org/ns/formats/Turtle&gt; .
&lt;https://w3id.org/mod#hasSyntax&gt; &lt;http://www.w3.org/ns/formats/Turtle&gt; .
</div></code></pre>
<p>Alternative properties:</p>
<ul>
<li><a href="http://purl.org/dc/terms/format">http://purl.org/dc/terms/format</a></li>
<li><a href="http://purl.org/dc/elements/1.1/format">http://purl.org/dc/elements/1.1/format</a></li>
<li><a href="https://schema.org/encodingFormat">https://schema.org/encodingFormat</a></li>
<li><a href="http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax">http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax</a></li>
</ul>
<p>SHACL validation rules:</p>
<ul>
Expand Down Expand Up @@ -1707,7 +1708,7 @@ <h2 id="6-tabular-overview">6 Tabular overview</h2>
<tr>
<td>4.8</td>
<td>Serialization/ file format</td>
<td><a href="http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax">http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax</a></td>
<td><a href="https://w3id.org/mod#hasSyntax">https://w3id.org/mod#hasSyntax</a></td>
<td></td>
<td>x</td>
<td></td>
Expand Down
9 changes: 5 additions & 4 deletions MetadataGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Document status: **DRAFT**

Modification date: 2024-05-02
Modification date: 2025-01-01

Creators and contributors:

Expand Down Expand Up @@ -649,7 +649,7 @@ SHACL validation rules:

You should state the ontology's serialization/ file format. The value should be provided as an IRI from the Media Types list of the Internet Assigned Number Authority (IANA) [[6]](#source6) or from the W3C resource Unique URIs for File Formats [[7]](#source7).

Recommended property: <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>
Recommended property: <https://w3id.org/mod#hasSyntax>

Recommended controlled vocabularies:

Expand All @@ -668,14 +668,15 @@ Example (text/turtle):

```Turtle
<https://www.purl.org/SomeOntology> rdf:type owl:Ontology ;
omv:hasOntologySyntax <http://www.w3.org/ns/formats/Turtle> .
<https://w3id.org/mod#hasSyntax> <http://www.w3.org/ns/formats/Turtle> .
```

Alternative properties:

* <http://purl.org/dc/terms/format>
* <http://purl.org/dc/elements/1.1/format>
* <https://schema.org/encodingFormat>
* <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>

SHACL validation rules:

Expand Down Expand Up @@ -1515,7 +1516,7 @@ SHACL validation rules:
| 4.5 | Subject(s) | <http://purl.org/dc/terms/subject> | | x | | 0…* |
| 4.6 | Annotation language(s) | <http://purl.org/dc/terms/language> | | x | | 0…* |
| 4.7 | Applied logical framework | <https://w3id.org/mod#hasFormalityLevel> | | x | | 0...1 |
| 4.8 | Serialization/ file format | <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> | | x | | 0...1 |
| 4.8 | Serialization/ file format | <https://w3id.org/mod#hasSyntax> | | x | | 0...1 |
| 4.9 | Status | <http://purl.org/ontology/bibo/status> | | x | | 0...1 |
| 4.10 | Code repository | <http://usefulinc.com/ns/doap#repository> | | x | | 0...1 |
| 4.11 | Distributions/ products | <http://www.w3.org/ns/dcat#distribution> | | x | | 0…* |
Expand Down
Binary file modified MetadataGuide.pdf
Binary file not shown.
16 changes: 9 additions & 7 deletions OntoMetadataShape.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ ontometa: rdf:type owl:Ontology ;
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>;
<http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <https://www.iana.org/assignments/media-types/text/turtle> ;
<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)";
Expand Down Expand Up @@ -168,6 +168,7 @@ ontometa:OntologyMetadataShape a sh:NodeShape ;
[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/> ;]
Expand Down Expand Up @@ -227,6 +228,7 @@ ontometa:OntologyMetadataShape a sh:NodeShape ;
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 ;
Expand Down Expand Up @@ -514,25 +516,25 @@ ontometa:OntologyMetadataShape a sh:NodeShape ;
## Ontology serialization/ file format
### status: developer and external review needed
sh:property [
sh:path [sh:alternativePath (<http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://purl.org/dc/terms/format> <http://purl.org/dc/elements/1.1/format>) ];
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: <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> omv:hasOntologySyntax <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: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 <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>;
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: <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> omv:hasOntologySyntax <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: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 <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>;
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 (
Expand Down Expand Up @@ -570,7 +572,7 @@ ontometa:OntologyMetadataShape a sh:NodeShape ;
# [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: <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax>\nExample statement (text/turtle): <https://www.purl.org/SomeOntology> omv:hasOntologySyntax <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: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 ;
] ;
Expand Down
4 changes: 2 additions & 2 deletions OntoMetadataShape4Forms.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ ontometa4forms: rdf:type owl:Ontology ;
doap:repository <https://github.com/TIBHannover/terminology-metadata>;
dcterms:references <https://doi.org/10.5281/zenodo.11103070>;
mod:hasFormalityLevel "RDF(S), OWL, SHACL"@en;
<http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> <http://www.w3.org/ns/formats/Turtle>;
<https://w3id.org/mod#hasSyntax> <http://www.w3.org/ns/formats/Turtle>;
mod:hasEquivalencesWith <https://github.com/TIBHannover/terminology-metadata/blob/20240502/MetadataGuide.md#7-relations-to-related-work>;
.

Expand Down Expand Up @@ -330,7 +330,7 @@ ontometa4forms:OntologyMetadataShape a sh:NodeShape ;
## Ontology serialization/ file format
### status: developer and external review needed
sh:property [
sh:path <http://omv.ontoware.org/2005/05/ontology#hasOntologySyntax> ;
sh:path <https://w3id.org/mod#hasSyntax> ;
sh:severity sh:Info ;
sh:group ontometa4forms:FormalizationMetadataGroup ;
#sh:minCount 1 ;
Expand Down
Loading

0 comments on commit 4a48d62

Please sign in to comment.