Merge pull request #18 from dhlab-basel/docs-adjustements

adjustements to documentation
dhlab-basel · Oct 7, 2024 · 1539bd9 · 1539bd9
2 parents 8377d98 + 9533b54
commit 1539bd9
Show file tree

Hide file tree

Showing 2 changed files with 49 additions and 21 deletions.
diff --git a/index.markdown b/index.markdown
@@ -76,20 +76,20 @@ has super class:
 
 is domain of:
       js:hasGeonameID  (max cardinality 1, range: xsd:string)
-      js:hasWikiLink   (max cardinality 1, range: IRI)
-      schema:name      (range: xsd:string, permitted language tags "en", "de", "fr", "es")
+      js:hasWikiLink   (max cardinality 1, range: IRI or xsd:anyURI)
+      schema:name      (min cardinality 1, range: xsd:string, permitted language tags "en", "de", "fr", "es")
 
 Corresponding SHACL node shape:
       js-shacl:LocationShape
 ```
-Below, you can see an example of an RDF representation of a location:
+Below, you can see an example RDF representation of a location:
 
 ![Location Representation](docs/images/location_example.png)
 
 ***
 ## Person
 The `js:Person` is an OWL class representing a person who undertakes a journey or
- is involved in a journey (such as: hotel owner, waiter/waitress, travel companion, etc.).
+ is involved in a journey (such as hotel owner, waiter/waitress, travel companion, etc.).
 
 ```
 IRI: <http://journey-star.dhlab.unibas.ch/ontology/JourneyStar#Person>
@@ -100,12 +100,13 @@ is domain of:
       schema:name        (min cardinality 1, range: xsd:string)
       schema:givenName   (range: xsd:string)
       schema:familyName  (range: xsd:string)
-      schema:gender      (restricted to schema:Male, schema:Female, and xsd:string)
-      schema:birthDate   (max cardinality 1, range: xsd:date)
+      schema:gender      (range: xsd:string or schema:Male, schema:Female)
+      schema:birthDate   (max cardinality 1, range: xsd:date, xsd:dateTime, xsd:gYear)
       schema:birthPlace  (max cardinality 1, range: IRI)
-      schema:knows       (range js:Person, js:Location)  
-      js:participatedIn  (range js:Event)
+      schema:knows       (range: js:Person, js:Location)  
+      js:participatedIn  (range: js:Event)
       js:hasGnd          (max cardinality 1, range: xsd:string)
+      js:hasWikiLink     (max cardinality 1, xsd:anyURI)
 
 Corresponding SHACL node shape:
       js-shacl:PersonShape
@@ -117,26 +118,26 @@ Below, you can see an example of an RDF representation of a person:
 
 ***
 ## Event
-The `js:Event` is a general OWL class describing an an event in a real world with
+The `js:Event` is a general OWL class describing an event in a real world with
 spatiotemporal data and participants. An event can be an activity such as a journey,
- sightseeing, excursion, dining, etc, or an occurrence such as encounter with a person,
+ sightseeing, excursion, dining, etc., or an occurrence such as encounter with a person,
  or even a natural phenomena.
 
 ```
 IRI: <http://journey-star.dhlab.unibas.ch/ontology/JourneyStar#Event>
 
 is domain of:
-      js:hasParticipant  (range IRI)
+      js:hasParticipant  (range: IRI or xsd:anyURI)
       js:hasLocation     (range: xsd:string, js:Location, xsd:anyURI, IRI)
-      js:hasDate         (range: xsd:date, xsd:dateTime)
+      js:hasDate         (range: xsd:date, xsd:dateTime, xsd:gYear)
 
 
 Corresponding SHACL node shape:
       js-shacl:EventShape
 ```
 
 There are various classes that are defined as subclass of the `js:Event` each with their specific predicates, for example:
-- `js:Activity` that has predicates to describe the a physical activity such as a movement.
+- `js:Activity` that has predicates to describe a physical activity such as a movement.
 - `js:Occurrence` with properties to describe an occurrence.
 - `js:NaturalPhenomena` representing a natural phenomena.
 
@@ -151,7 +152,7 @@ has super class:
       activity:Activity, js:Event
 
 is domain of:
-      schema:name  (min cardinality 1, range: xsd:string)
+      schema:name  (range: xsd:string)
       js:hasCost   (max cardinality 1, range: xsd:decimal)
 
 Corresponding SHACL node shape:
@@ -161,6 +162,7 @@ Corresponding SHACL node shape:
 There are various classes that are defined as subclass of the `js:Activity` each with their specific predicates, for example:
 - `js:Dining` that has predicates to describe the cuisine and type of the meals.
 - `js:Sightseeing` with properties to describe the building or monument.
+- `js:Entertainment` that has predicates to describe entertainment activities.
 - `js:Trip` representing a movement from one place to another.
 
 ***
@@ -200,6 +202,22 @@ Corresponding SHACL node shape:
       js-shacl:SightSeeingShape
 ```
 
+***
+## Entertainment
+The `js:Entertainment` is a general OWL class describing entertainment.
+
+```
+IRI: <http://journey-star.dhlab.unibas.ch/ontology/JourneyStar#Entertainment>
+has super class:
+      js:Activity
+
+is domain of:
+      js:entertainmentType (range: xsd:string)
+
+Corresponding SHACL node shape:
+      js-shacl:EntertainmentShape
+```
+
 ***
 ## Journey
 The `js:Journey` is an OWL class that represents a journey a person undertakes
@@ -213,14 +231,15 @@ has super class:
       js:Activity
 
 is domain of:
+      js:hasParticipant        (range: IRI)
       js:origin                (min cardinality 1, range: IRI or xsd:anyURI)
       js:destination           (min cardinality 1, range: IRI or xsd:anyURI)
-      js:startDate             (max cardinality 1, range: xsd:date , xsd:dateTime)
-      js:endDate               (max cardinality 1, range: xsd:date , xsd:dateTime)
+      js:startDate             (max cardinality 1, range: xsd:date, xsd:dateTime or xsd:gYear)
+      js:endDate               (max cardinality 1, range: xsd:date, xsd:dateTime or xsd:gYear)
       js:hasActivity           (range: js:Activity)
       js:hasStay               (range: js:Stay)
-      js:meanOfTransportation  (range: range: IRI or xsd:anyURI)
-      js:transitThrough        (range: range: IRI or xsd:anyURI)
+      js:meanOfTransportation  (range: IRI or xsd:anyURI)
+      js:transitThrough        (range: IRI or xsd:anyURI)
 
 Corresponding SHACL node shape:
       js-shacl:JourneyShape
@@ -269,7 +288,7 @@ has super class:
 
 is domain of:
       schema:name     (min cardinality 1, range: xsd:string)
-      schema:adress   (range: xsd:string)
+      schema:address  (range: xsd:string)
       js:hasLocation  (range: xsd:string, js:Location, xsd:anyURI, IRI)
 
 Corresponding SHACL node shape:
@@ -287,7 +306,7 @@ has super class:
     js:Activity
 
 is domain of:
-      js:hasAccommodation  (range:  js:Accommodation or any IRI)
+      js:hasAccommodation  (range: js:Accommodation or IRI)
       js:startDate         (max cardinality 1, range: xsd:date or xsd:dateTime)
       js:endDate           (max cardinality 1, range: xsd:date or xsd:dateTime)
 

diff --git a/journeyStar_shacl.ttl b/journeyStar_shacl.ttl
@@ -138,7 +138,7 @@ js-shacl:AccommodationShape a sh:NodeShape ;
         sh:datatype xsd:string ;
     ] ,
     [
-        sh:path schema:adress ;
+        sh:path schema:address ;
         sh:datatype xsd:string ;
     ] ,
     [
@@ -232,6 +232,15 @@ js-shacl:JourneyShape a sh:NodeShape;
     [
         sh:path js:hasActivity ;
         sh:node js-shacl:ActivityShape ;
+    ] ,
+    [
+        sh:path js:meanOfTransportation ;
+        sh:or ([ sh:datatype xsd:anyURI ]
+               [ sh:nodeKind sh:IRI ]) ;
+    ] ,
+    [
+        sh:path js:transitThrough ;
+        sh:node js-shacl:LocationShape ;
     ] .
 
 ### Shape for Class SightSeeing ###