Skip to content

Commit 18a436b

Browse files
authored
Update README.md
1 parent 02bf069 commit 18a436b

File tree

1 file changed

+48
-25
lines changed

1 file changed

+48
-25
lines changed

README.md

+48-25
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,57 @@
1-
About Widoco output
2-
===================
3-
The purpose of Widoco is to reuse and integrate existing tools for documentation, plus the set of features listed below:
4-
* Separation of the sections of your html page so you can write them independently and replace only those needed.
5-
* Automatic annotation in RDF-a of the html produced.
6-
* Association of a provenance page which includes the history of your vocabulary (W3C PROV-O compliant).
7-
* Metadata extraction from the ontology plus the means to complete it on the fly when generating your ontology.
8-
* Guidelines on the main sections that your document should have and how to complete them.
1+
# SEDIMARK Marketplace Ontology
92

10-
Widoco will create 3 different folders:
11-
|
12-
|-provenance (a folder including an html and RDF serialization of how the documentation page was created)
13-
|-resources (folder with the different resources)
14-
|-sections (folder with the different sections of the documentation, separated for easy editing. Just edit one and the main page will be updated)
3+
## About
4+
The Marketplace Information Model is an RDFS/OWL-ontology covering the fundamental concepts of SEDIMARK needed for the registration of participants and the discovery and exchange of offerings and assets. This model establishes a common framework to ensure interoperability within a SEDIMARK-based Marketplace.
5+
This model is supported by existing proposals by similar initiatives and is built upon well-known ontologies such as Data Catalog vocabulary (DCAT), Open Digital Rights Language (ODRL), Friend Of A Friend (FOAF) or the Dublin Core Terms (DCT). In particular, the model has its foundations in the proposal shared by the International Data Spaces Protocol, to try to be compatible as much compatible as possible with such an initiative.
156

16-
Completing ontology metadata.
17-
===================
18-
Widoco uses the ontology metadata to update a configuration file. If you complete that configuration file (ended up widoco.conf), the tool will enhance your html with additional details, such as how to cite the document, previous revisions, icons with the licence, etc.
7+
## Core Concepts
198

20-
Browser issues
21-
==========
22-
The result of executing Widoco is an html file. We have tested it in Mozilla, IE and Chrome, and when the page is stored in a server all the browsers work correctly. If you view the file locally, we recommend you to use Mozilla Firefox (or Internet Explorer, if you must). Google Chrome will not show the contents correctly, as it doesn't allow XMLHttpRequest without HTTP. If you want to view the page locally with Google Chrome you have two possibilities:
9+
### Classes
10+
![image](https://github.com/Sedimark/ontology/assets/47256078/00d35702-b7cf-4eef-ad5b-9e2134c0ed26)
2311

24-
a) Place the file in a server and access it via its URL (for example, put it in dropbox and access through its public url).
12+
## Properties
13+
![image](https://github.com/Sedimark/ontology/assets/47256078/cacb6d9d-1b8d-422e-a19d-fa35e5faf9bf)
2514

26-
b) Execute Chrome with the following commands :
15+
## Instantiation Example:
16+
Offering provided by CVSSP living lab for ehealth monitoring.
2717

28-
(WIN) chrome.exe --allow-file-access-from-files,
18+
![image](https://github.com/Sedimark/ontology/assets/47256078/c44db277-2d05-4896-9522-3b344982d8af)
2919

30-
(OSX) open /Applications/Google\ Chrome.app/ --args --allow-file-access-from-files
20+
## SPARQL Query Example:
3121

32-
(UNX) /usr/bin/google-chrome --allow-file-access-from-files
22+
```sparql
23+
prefix sedi: <https://w3id.org/sedimark/ontology#>
24+
prefix owl: <http://www.w3.org/2002/07/owl#>
25+
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
26+
prefix xml: <http://www.w3.org/XML/1998/namespace>
27+
prefix xsd: <http://www.w3.org/2001/XMLSchema#>
28+
prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>
29+
prefix dcat: <http://www.w3.org/ns/dcat#>
30+
prefix dct: <http://purl.org/dc/terms/>
3331
34-
Do you have a problem? open an issue at https://github.com/dgarijo/Widoco
32+
33+
SELECT * WHERE {
34+
?participant a sedi:Participant .
35+
?participant sedi:hasSelf-Listing ?selflisting .
36+
?selflisting dct:hasPart ?localCat.
37+
?selflisting sedi:hasOffering ?offering .
38+
?offering sedi:hasAsset ?asset .
39+
?asset sedi:hasAssetQuality ?assetquality .
40+
?offering dcat:temporalResolution ?tempRes .
41+
42+
} LIMIT 10
43+
44+
```
45+
46+
### Example Result:
47+
48+
| participant | selflisting | localCat | offering | asset | assetquality | tempRes |
49+
| --------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------------- | ------- |
50+
| https://sedimark.surrey.ac.uk/ecosystem/CVSSP | https://sedimark.surrey.ac.uk/ecosystem/ehealth-living-lab | https://sedimark.surrey.ac.uk/ecosystem/surrey-local-catalogue | https://sedimark.surrey.ac.uk/ecosystem/wearable-offering-001 | https://sedimark.surrey.ac.uk/ecosystem/steps-asset-001 | https://sedimark.surrey.ac.uk/ecosystem/steps-asset-001-quality | P6H |
51+
52+
## Licence
53+
This is licensed under a Creative Commons Attribution 4.0 International License.
54+
55+
## Acknowledgement
56+
This work is funded by the European Union under the Horizon Europe framework programme [grant no. 101070074].
57+
This project is also partly funded by UK Research and Innovation (UKRI) under the UK government’s Horizon Europe funding guarantee [grant no. 10043699].

0 commit comments

Comments
 (0)