forked from rpietzsch/Widoco
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
147 lines (127 loc) · 6.84 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<!DOCTYPE html>
<html lang="en">
<!--
/*
* This page was created by Daniel Garijo.
*/
-->
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Gallery</title>
<!-- Bootstrap -->
<link rel="stylesheet" href="http://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.2/jquery.min.js"></script>
<script src="http://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>
</head>
<body>
<div class="container">
<h3 >WIDOCO's gallery </h3>
<p> This page illustrates examples of the main features of <a href="https://w3id.org/widoco">WIDOCO</a>, a <u>WI</u>zard for <u>DOC</u>umenting <u>O</u>ntologies.
</p>
<div class="row">
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/doc2.png" alt="documentation" width="80%">
<div class="caption">
<h4>Documentation of ontology concepts</h4>
<p>Widoco builds on top of <a href="http://www.essepuntato.it/lode/">LODE</a>, an open source tool designed to generate a cross reference section with the definition of classes, properties, data properties and individuals of the ontology. Widoco extends LODE by extending the metadata types used in the annotation of ontology concepts.</p>
<p>See an <a href="http://linked.earth/ontology/core/1.2.0/index-en.html#CalibrationModel">example</a></p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/visualization.png" alt="visualization">
<div class="caption">
<h4>Dynamic visualization</h4>
<p>
Widoco uses <a href="http://vowl.visualdataweb.org/webvowl">WebVowl</a> to create an interactive diagram to the documentation. The diagram can be used to filter and browse concepts and properties.
</p>
<p>See an <a href="http://linked.earth/ontology/core/1.2.0/webvowl/index.html#ontology">example</a></p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/md.png" alt="markdown support">
<div class="caption">
<h4>Markdown support</h4>
<p>
You can write your class descriptions using markdown, and they will automatically render in your ontology documentation.
</p>
</div>
</div>
</div>
</div>
<div class="row">
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/metadata.png" alt="metadata" width="80%">
<div class="caption">
<h4>Ontology metadata documentation</h4>
<p>Widoco processes and recognizes over forty properties for ontology metadata description from common vocabularies and standards. These terms have been collected in a <a href="http://w3id.org/widoco/bestPractices">best practices document</a> grouping terms, including a rationale of their importance when describing a vocabulary, which may help users on deciding whether to include them or not. </p>
<p>See an <a href="http://linked.earth/ontology/core/1.2.0/">example</a></p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/changes.png" alt="Change log">
<div class="caption">
<h4>Change log</h4>
<p>Widoco extends <a href="http://www.ebi.ac.uk/efo/bubastis/">Bubastis</a>, a software for capturing differences between classes in ontologies, adding which are the properties, data properties and annotations that have changed from version to version.</p>
<p>See an <a href="http://linked.earth/ontology/core/1.2.0/index-en.html#changes">example</a></p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/prov.png" alt="provenance">
<div class="caption">
<h4>Provenance</h4>
<p>Widoco produces a separate page, linked to the main HTML of the documentation, with the the provenance of the documentation. The page is captured both in both a human readable and machine readable way, following the <a href="http://www.w3.org/TR/prov-o/">PROV-O</a> standard</p>
<p>See an <a href="https://dgarijo.github.io/example/release/1.0.1/provenance/provenance-en.html">example</a></p>
</div>
</div>
</div>
</div>
<div class="row">
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/schema.png" alt="provenance">
<div class="caption">
<h4>Annotations for discovery</h4>
<p>Widoco includes json-ld snippets on the main html document with a basic description of the metadata annotated according to <a href="http://schema.org/">Schema.org</a>. These snippets are useful for search engines to find and explore the contents of the documentation automatically.</p>
<p>For an example, you may go to the <a href="http://linked.earth/ontology/core/1.2.0/webvowl/index.html#ontology">following link</a> and view the page source. Close to the beggining of the document you will see a JSON-LD snippet with the information of the page, annotated according to schema.org. <a href="https://search.google.com/structured-data/testing-tool#url=http%3A%2F%2Flinked.earth%2Fontology%2Fcore%2F1.2.0%2F">This would be the information of the page</a> as seen by a search engine.</p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/cn.png" alt="...">
<div class="caption">
<h4>Serialization and content negotiation</h4>
<p>Widoco automatically creates an .htaccess file to access the documentation through its URI once it is published online. We have adopted the <a href="https://www.w3.org/TR/swbp-vocab-pub/">W3C best practices for vocabulary publishing on the Web</a>, adapting the content negotiation to the vocabulary URI (hash versus slash vocabularies) and serving the ontology (by default) on RDF/XML, TTL and N3.</p>
<p>See an <a href="https://github.com/LinkedEarth/Ontology/blob/master/release/core/1.2.0/.htaccess">example</a></p>
</div>
</div>
</div>
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="images/evaluation.png" alt="evaluation">
<div class="caption">
<h4>Evaluation Reports</h4>
<p>Widoco enables users to produce evaluation reports of the ontology, facilitating checking whether the ontology has any pitfalls in its design. Widoco produces these reports by using the <a href="http://oops.linkeddata.es/">OOPS! web service</a>, which evaluates ontologies against a catalog of pitfalls.</p>
<p>See an <a href="http://vocab.linkeddata.es/ontologies/purl.orgnetp-plan.html">example</a></p>
</div>
</div>
</div>
</div>
<!--<footer class="footer">
<p>© 2016</p>
</footer>-->
</div> <!-- /container -->
</body>
</html>