Skip to content

Commit

Permalink
clean(docs): Minor docs & DataType TTL
Browse files Browse the repository at this point in the history
  • Loading branch information
vorburger committed Jan 3, 2025
1 parent be6c75c commit e345c5e
Show file tree
Hide file tree
Showing 3 changed files with 41 additions and 5 deletions.
7 changes: 6 additions & 1 deletion docs/concepts/other.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<!--
SPDX-License-Identifier: Apache-2.0
Copyright 2023-2024 The Enola <https://enola.dev> Authors
Copyright 2023-2025 The Enola <https://enola.dev> Authors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -33,6 +33,11 @@ Enola 🕵🏾‍♀️ is not Configuration Management tool.

Enola 🕵🏾‍♀️ is not a Communication tool.

## RDF Linked Data Tools

* [Ontospy](https://lambdamusic.github.io/Ontospy/) #python #CLI #RDFS #OWL #SKOS #documentation #generation #ToDo
* [Iolanta Linked Data browser](https://iolanta.tech) #ToDo

## Knowledge Management

<!-- TODO //models/enola.dev/other.ttl as source of this!
Expand Down
22 changes: 22 additions & 0 deletions models/enola.dev/datatypes.ttl
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# SPDX-License-Identifier: Apache-2.0
#
# Copyright 2025 The Enola <https://enola.dev> Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

@prefix enola: <https://enola.dev/>.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#>.

xsd:integer enola:wikipedia "Integer".
xsd:int enola:wikipedia "Integer_(computer_science)".
17 changes: 13 additions & 4 deletions models/enola.dev/enola.ttl
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-License-Identifier: Apache-2.0
#
# Copyright 2024 The Enola <https://enola.dev> Authors
# Copyright 2024-2025 The Enola <https://enola.dev> Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -30,6 +30,11 @@ enola: a owl:Ontology;
rdfs:label "Enola.dev's base/core Ontology.";
enola:doc <https://docs.enola.dev/models/enola.dev/>.

enola:ID a rdfs:Datatype;
schema:name "IDentifier Datatype.";
schema:description "This is not to be confused with https://schema.org/identifier, which is a [[rdf:Property]], whereas this is a [[rdfs:Datatype]].";
enola:emoji "🆔".

enola:UnknownClass a rdfs:Class;
schema:name "(Unknown)";
rdfs:comment "Used when a Thing does not have a rdf:type but one is absolutely required e.g. by some tool.".
Expand Down Expand Up @@ -130,11 +135,12 @@ enola:origin a rdf:Property;
schema:description "What something is _\"based on\",_ e.g. where it _\"comes from\"._ This may be a list.";
enola:emoji "🏺".

# TODO Split Q & P...
# TODO Split Q & P... via sub-Datatypes?
enola:wikidata a rdf:Property;
# TODO This, and other, images should be a String, not a link, and the UI needs to be coded to handle it... validate!
schema:image <https://upload.wikimedia.org/wikipedia/commons/f/ff/Wikidata-logo.svg>;
# https://www.wikidata.org/wiki/Wikidata:Data_access#Linked_Data_Interface_(URI)
# TODO Introduce an indirection through enola:WikidataID a enola:ID;
schema:url "http://www.wikidata.org/entity/{VALUE}"^^enola:IRITemplate;
schema:description "Wikidata Q123 or P123 etc.".
# TODO Range (?) is a RegExp like [QP][0-9]+ or so...
Expand All @@ -143,6 +149,7 @@ enola:wikipedia a rdf:Property;
# TODO This, and other, images should be a String, not a link, and the UI needs to be coded to handle it... validate!
schema:image <https://upload.wikimedia.org/wikipedia/commons/8/80/Wikipedia-logo-v2.svg>;
schema:description "Wikipedia EN page ID (not URL), e.g. 'Wikipedia' (for https://en.wikipedia.org/wiki/Wikipedia)";
# TODO Introduce an indirection through enola:WikipediaID a enola:ID;
schema:url "https://en.wikipedia.org/wiki/{VALUE}"^^enola:IRITemplate.
# TODO Range (?) is a RegExp like [a-zA-Z0-9_]+ (but without slash or colon!) or whatever it is...

Expand Down Expand Up @@ -170,12 +177,12 @@ enola:example a rdf:Property;
schema:description "Link to an example of this Class. Often used together with iriTemplate, but not exclusively.";
rdfs:seeAlso enola:iriTemplate;
rdfs:range xsd:anyURI;
enola:emoji "🤔".
enola:emoji "👉".

enola:gkg a rdf:Property;
rdfs:range enola:GKG.

enola:GKG a rdfs:Datatype;
enola:GKG a enola:ID;
schema:name "Google Public Knowledge Graph ID";
schema:description "ID in Google's Public Knowledge Graph (formerly AKA Freebase), see e.g. https://developers.google.com/knowledge-graph/; starts without slash, but with 'm' or 'g' following by a slash and lower case characters, numbers and underscores; e.g. g/11bwcf511s";
enola:iriTemplate "kg:/{VALUE}";
Expand All @@ -184,6 +191,8 @@ enola:GKG a rdfs:Datatype;

enola:rfc a rdf:Property;
rdfs:range xsd:positiveInteger;
# TODO Introduce an indirection trough an enola:RFC a enola:ID
# TODO enola:sameAsTemplate "urn:ietf:rfc:{VALUE}"
schema:url "https://datatracker.ietf.org/doc/rfc{VALUE}"^^enola:IRITemplate.

enola:doc a rdf:Property;
Expand Down

0 comments on commit e345c5e

Please sign in to comment.