|
|
|
Starting the development of a new extension in an STF
|
|
|
|
|
|
|
|
.- You have to configure your repository according to the instructions below
|
|
|
|
.- You have to create the directory structure according to the instructions below
|
|
|
|
.- You have to read TR XXXXX and follow the guidelines there
|
|
|
|
.- You have to work on the repository in the STF 566 group (not in the one in the SAREF group)
|
|
|
|
Repository configuration steps
|
|
|
|
1.- Ensure that master branch exists
|
|
|
|
|
|
|
|
2.- Protect the master branch
|
|
|
|
|
|
|
|
The master branch must be protected in the settings repository so no one can directly push there. All the commits must go through pull requests.
|
|
|
|
Ontology project structure
|
|
|
|
Structure of an ontology project:
|
|
|
|
documentation/
|
|
|
|
ontology/
|
|
|
|
diagram/
|
|
|
|
example/
|
|
|
|
README.md
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Here we write the guidelines to set up a repo, minimal artefacts, metadata, etc.
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
@prefix dcterms: <http://purl.org/dc/terms/> .
|
|
|
|
@prefix owl: <http://www.w3.org/2002/07/owl#> .
|
|
|
|
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
|
|
|
|
@prefix xml: <http://www.w3.org/XML/1998/namespace> .
|
|
|
|
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
|
|
|
|
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
|
|
|
|
@prefix voaf: <http://purl.org/vocommons/voaf#> .
|
|
|
|
@prefix vann: <http://purl.org/vocab/vann/> .
|
|
|
|
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
|
|
|
|
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
|
|
|
|
@prefix s4abcd: <https://saref.etsi.org/s4abcd#> .
|
|
|
|
|
|
|
|
# change abcd to the letters of your extension
|
|
|
|
|
|
|
|
<https://saref.etsi.org/saref4abcd#> a owl:Ontology ;
|
|
|
|
|
|
|
|
# change ABCD to the letters of your extension
|
|
|
|
dcterms:title "SAREF4ABCD: an extension of SAREF for ………..."@en ;
|
|
|
|
dcterms:description "SAREF4ABCD is an extension of SAREF for …… "@en ;
|
|
|
|
|
|
|
|
dcterms:created "start date of the STF YYYY-MM-DD"^^xsd:date ;
|
|
|
|
dcterms:modified "do not set this"^^xsd:date ;
|
|
|
|
dcterms:issued "date when the document is online"^^xsd:date ;
|
|
|
|
|
|
|
|
# use only dcterms:contributor to list the editors and contributors of the ontology
|
|
|
|
dcterms:contributor <http://example.org/JohnDoe> ; # should be a dereferencable URI, ex. Institution member page or LinkedIn
|
|
|
|
|
|
|
|
# change abcd to the four letters of your extensions, and 0.1.2 to the current version of the TS
|
|
|
|
owl:versionInfo "v0.1.2" ;
|
|
|
|
owl:versionIRI <https://saref.etsi.org/saref4abcd/v0.1.2/saref4abcd#> ;
|
|
|
|
vann:preferredNamespaceUri "https://saref.etsi.org/saref4abcd#" ;
|
|
|
|
vann:preferredNamespacePrefix "s4abcd" ;
|
|
|
|
dcterms:source <https://forge.etsi.org/rep/SAREF/saref4abcd/> ;
|
|
|
|
|
|
|
|
# mandatory annotations
|
|
|
|
dcterms:license <https://forge.etsi.org/etsi-software-license> ;
|
|
|
|
dcterms:publisher <https://www.etsi.org/> .
|
|
|
|
|
|
|
|
# define the name of each contributor.
|
|
|
|
<http://example.org/JohnDoe> a foaf:Person ;
|
|
|
|
foaf:name "John Doe" .
|
|
|
|
|
|
|
|
voaf:Vocabulary a owl:Class .
|
|
|
|
dcterms:title a owl:AnnotationProperty .
|
|
|
|
dcterms:issued a owl:AnnotationProperty .
|
|
|
|
dcterms:creator a owl:AnnotationProperty .
|
|
|
|
dcterms:publisher a owl:AnnotationProperty .
|
|
|
|
dcterms:description a owl:AnnotationProperty .
|
|
|
|
dcterms:license a owl:AnnotationProperty .
|
|
|
|
dcterms:created a owl:AnnotationProperty .
|
|
|
|
vann:preferredNamespacePrefix a owl:AnnotationProperty .
|
|
|
|
vann:preferredNamespaceUri a owl:AnnotationProperty .
|
|
|
|
foaf:Person a owl:Class .
|
|
|
|
foaf:name a owl:DatatypeProperty .
|
|
|
|
|
|
|
|
|
|
|
|
s4syst:XXX a owl:Class ;
|
|
|
|
|
|
|
|
# always provide a label with language tag @en
|
|
|
|
rdfs:label "Xxx"@en ;
|
|
|
|
|
|
|
|
# always provide a definition with language tag @en
|
|
|
|
rdfs:comment """The definition in natural language, reusing the terminology as much as possible"""@en .
|
|
|
|
|
|
|
|
``` |
|
|
\ No newline at end of file |
