markdown comment conversion

Author: paulduchesne

data.ttl

@@ -1,6 +1,13 @@
 PREFIX ont: <https://paulduchesne.github.io/state/ontology/>
 PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
 
+<https://paulduchesne.github.io/state/resource/ad8600ce-fe98-4212-b3d8-0105abdaa567>
+    a ont:Organisation ;
+    rdfs:label "International Federation of Film Archives"@en ;
+    rdfs:comment "Primary international association of film archives."@en ;
+    ont:wikidataIdentifier "Q586693" ;
+.
+
 <https://paulduchesne.github.io/state/resource/10f8d9fa-2da2-449b-9946-3126c9584052>
     a ont:Institution ;
     rdfs:label "Bundesarchiv" ;
@@ -13,6 +20,7 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     a ont:Person ;
     rdfs:label "Mariana Enríquez"@en ;
     rdfs:comment "Argentinian writer."@en ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/90c8c4ca-4ccf-4aca-b021-d480efd1abb6> ;
     ont:wikidataIdentifier "Q5997426" ;
 .
 
@@ -24,21 +32,11 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     ont:wikidataIdentifier "Q42369365" ;
 .
 
-<https://paulduchesne.github.io/state/resource/2ed97264-8762-4f68-a8ab-06b6e3b1adfe>
-    a ont:ReadingEvent ;
-    rdfs:label "Reading 'The School of Night'"@en ;
-    rdfs:comment "Reading event."@en ;
-    ont:endDate "2025-12-03" ;
-    ont:hasParticipant
-        <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8> ,
-        <https://paulduchesne.github.io/state/resource/6b433c3a-855a-4ddd-bf14-6ed6d75b472f> ;
-    ont:startDate "2025-11-23" ;
-.
-
 <https://paulduchesne.github.io/state/resource/3b811069-fff1-4393-b16b-ef02de3b5ff9>
     a ont:Person ;
     rdfs:label "Anna Kavan" ;
     rdfs:comment "British writer." ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/727f0b29-fd9c-429d-a264-5af913651d73> ;
     ont:wikidataIdentifier "Q287679" ;
 .
 
@@ -54,15 +52,61 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     a ont:Person ;
     rdfs:label "Annie Ernaux" ;
     rdfs:comment "French Nobel-prize winning author." ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/ec0545af-f371-4df8-a0ef-5196c8a27859> ;
     ont:wikidataIdentifier "Q1153825" ;
 .
 
+<https://paulduchesne.github.io/state/resource/90d15936-a042-4151-944d-ac2ab282a448>
+    a ont:Person ;
+    rdfs:label "Paul Bowles"@en ;
+    rdfs:comment "American writer."@en ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/b300b5e9-1250-43d4-81db-7fe0e3946bc9> ;
+    ont:wikidataIdentifier "Q358342" ;
+.
+
+<https://paulduchesne.github.io/state/resource/b7315610-4737-4c68-934a-0a1fbe09d281>
+    a ont:Person ;
+    rdfs:label "Slavoj Zizek" ;
+    rdfs:comment "Slovenian neo-Marxist philosopher." ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/ba8048d3-a13c-4964-9d80-a04e0c50c0ba> ;
+    ont:wikidataIdentifier "Q184750" ;
+.
+
+<https://paulduchesne.github.io/state/resource/de97655c-95a8-4cfe-954f-a48142b3ca83>
+    a ont:Person ;
+    rdfs:label "Karl Ove Knausgaard"@en ;
+    rdfs:comment "Norwegian writer."@en ;
+    ont:authorOf <https://paulduchesne.github.io/state/resource/6b433c3a-855a-4ddd-bf14-6ed6d75b472f> ;
+    ont:wikidataIdentifier "Q609317" ;
+.
+
+<https://paulduchesne.github.io/state/resource/2ebe1653-01bb-4558-97eb-3f1ce794dd5a>
+    a ont:Event ;
+    rdfs:label "iPRES 2025" ;
+    rdfs:comment "The 2025 iteration of the [iPRES]() conference, held in [Wellington]()." ;
+    ont:hasParticipant
+        <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8> ,
+        <https://paulduchesne.github.io/state/resource/d2d8ae17-8d48-4256-931e-4f24ecf61f60> ;
+.
+
+<https://paulduchesne.github.io/state/resource/2ed97264-8762-4f68-a8ab-06b6e3b1adfe>
+    a ont:ReadingEvent ;
+    rdfs:label "Reading 'The School of Night'"@en ;
+    rdfs:comment "Reading event."@en ;
+    ont:endDate "2025-12-03" ;
+    ont:hasParticipant
+        <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8> ,
+        <https://paulduchesne.github.io/state/resource/6b433c3a-855a-4ddd-bf14-6ed6d75b472f> ;
+    ont:startDate "2025-11-23" ;
+.
+
 <https://paulduchesne.github.io/state/resource/6b433c3a-855a-4ddd-bf14-6ed6d75b472f>
     a ont:Book ;
     rdfs:label "The School of Night"@en ;
     rdfs:comment "Book by Karl Ove Knausgaard"@en ;
     ont:hasAuthor <https://paulduchesne.github.io/state/resource/de97655c-95a8-4cfe-954f-a48142b3ca83> ;
     ont:identifier "9781787304215" ;
+    ont:participatedIn <https://paulduchesne.github.io/state/resource/2ed97264-8762-4f68-a8ab-06b6e3b1adfe> ;
 .
 
 <https://paulduchesne.github.io/state/resource/6b440e4a-fbcd-45b9-a3fd-8a2dbf930877>
@@ -96,19 +140,24 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     ont:startDate "2025-12-04" ;
 .
 
+<https://paulduchesne.github.io/state/resource/86477d45-4c1a-4f95-841d-a3fc2d8ffa25>
+    a ont:ReadingEvent ;
+    rdfs:label "Reading 'I Remain in Darkness'" ;
+    rdfs:comment "Reading event." ;
+    ont:endDate "2025-11-10" ;
+    ont:hasParticipant
+        <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8> ,
+        <https://paulduchesne.github.io/state/resource/ec0545af-f371-4df8-a0ef-5196c8a27859> ;
+    ont:startDate "2025-11-09" ;
+.
+
 <https://paulduchesne.github.io/state/resource/90c8c4ca-4ccf-4aca-b021-d480efd1abb6>
     a ont:Book ;
     rdfs:label "Our Share of Night"@en ;
     rdfs:comment "Book by Mariana Enríquez"@en ;
     ont:hasAuthor <https://paulduchesne.github.io/state/resource/15ba58be-34a3-4380-baed-733ae0c5f07a> ;
     ont:identifier "9780451495150" ;
-.
-
-<https://paulduchesne.github.io/state/resource/90d15936-a042-4151-944d-ac2ab282a448>
-    a ont:Person ;
-    rdfs:label "Paul Bowles"@en ;
-    rdfs:comment "American writer."@en ;
-    ont:wikidataIdentifier "Q358342" ;
+    ont:participatedIn <https://paulduchesne.github.io/state/resource/6b440e4a-fbcd-45b9-a3fd-8a2dbf930877> ;
 .
 
 <https://paulduchesne.github.io/state/resource/b300b5e9-1250-43d4-81db-7fe0e3946bc9>
@@ -117,13 +166,7 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     rdfs:comment "Book by Paul Bowles"@en ;
     ont:hasAuthor <https://paulduchesne.github.io/state/resource/90d15936-a042-4151-944d-ac2ab282a448> ;
     ont:identifier "9780141187778" ;
-.
-
-<https://paulduchesne.github.io/state/resource/b7315610-4737-4c68-934a-0a1fbe09d281>
-    a ont:Person ;
-    rdfs:label "Slavoj Zizek" ;
-    rdfs:comment "Slovenian neo-Marxist philosopher." ;
-    ont:wikidataIdentifier "Q184750" ;
+    ont:participatedIn <https://paulduchesne.github.io/state/resource/780a127f-b83f-4ecf-9e05-752a82faecf8> ;
 .
 
 <https://paulduchesne.github.io/state/resource/b8744ea7-c182-47c2-bf31-37e6ed6df396>
@@ -154,39 +197,6 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     ont:wikidataIdentifier "Q57970405" ;
 .
 
-<https://paulduchesne.github.io/state/resource/de97655c-95a8-4cfe-954f-a48142b3ca83>
-    a ont:Person ;
-    rdfs:label "Karl Ove Knausgaard"@en ;
-    rdfs:comment "Norwegian writer."@en ;
-    ont:wikidataIdentifier "Q609317" ;
-.
-
-<https://paulduchesne.github.io/state/resource/ec0545af-f371-4df8-a0ef-5196c8a27859>
-    a ont:Book ;
-    rdfs:label "I Remain in Darkness" ;
-    rdfs:comment "1997 book by Annie Ernaux." ;
-    ont:hasAuthor <https://paulduchesne.github.io/state/resource/585e1cc0-3883-40f9-a036-7e9bae25077e> ;
-    ont:identifier "9781910695975" ;
-    ont:participatedIn <https://paulduchesne.github.io/state/resource/86477d45-4c1a-4f95-841d-a3fc2d8ffa25> ;
-.
-
-<https://paulduchesne.github.io/state/resource/2ebe1653-01bb-4558-97eb-3f1ce794dd5a>
-    a ont:Event ;
-    rdfs:label "iPRES 2025" ;
-    rdfs:comment "The 2025 iteration of the [iPRES]() conference, held in [Wellington]()." ;
-.
-
-<https://paulduchesne.github.io/state/resource/86477d45-4c1a-4f95-841d-a3fc2d8ffa25>
-    a ont:ReadingEvent ;
-    rdfs:label "Reading 'I Remain in Darkness'" ;
-    rdfs:comment "Reading event." ;
-    ont:endDate "2025-11-10" ;
-    ont:hasParticipant
-        <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8> ,
-        <https://paulduchesne.github.io/state/resource/ec0545af-f371-4df8-a0ef-5196c8a27859> ;
-    ont:startDate "2025-11-09" ;
-.
-
 <https://paulduchesne.github.io/state/resource/df0b77c1-6b2c-4bd4-904e-9921848978d0>
     a ont:ReadingEvent ;
     rdfs:label "Reading 'Machines in the Head'"@en ;
@@ -208,6 +218,15 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     ont:wikidataIdentifier "Q2565882" ;
 .
 
+<https://paulduchesne.github.io/state/resource/ec0545af-f371-4df8-a0ef-5196c8a27859>
+    a ont:Book ;
+    rdfs:label "I Remain in Darkness" ;
+    rdfs:comment "1997 book by Annie Ernaux." ;
+    ont:hasAuthor <https://paulduchesne.github.io/state/resource/585e1cc0-3883-40f9-a036-7e9bae25077e> ;
+    ont:identifier "9781910695975" ;
+    ont:participatedIn <https://paulduchesne.github.io/state/resource/86477d45-4c1a-4f95-841d-a3fc2d8ffa25> ;
+.
+
 <https://paulduchesne.github.io/state/resource/fe923883-a71b-460f-99a0-d8abf05a2281>
     a ont:ReadingEvent ;
     rdfs:label "Reading 'Against Progress'" ;
@@ -222,8 +241,10 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
 <https://paulduchesne.github.io/state/resource/0ef53722-52ca-49c8-873d-3549a74914e8>
     a ont:Person ;
     rdfs:label "Paul Duchesne" ;
-    rdfs:comment "Paul Duchesne is a film archivist and software developer, based in Canberra. He has worked for the <a href='https://paulduchesne.github.io/state/resource/e5e95fdb-dda9-4c40-9273-395fe34aba3c'>NFSA</a> and <a href='https://paulduchesne.github.io/state/resource/b8744ea7-c182-47c2-bf31-37e6ed6df396'>TIB</a>, and is a member of the <a href=''>FIAF</a> <a href=''>Cataloguing and Documentation Commission</a>." ;
-    ont:memberOf <https://paulduchesne.github.io/state/resource/e5e95fdb-dda9-4c40-9273-395fe34aba3c> ;
+    rdfs:comment "Paul Duchesne is a film archivist and software developer, based in Canberra. He has worked for the [NFSA](https://paulduchesne.github.io/state/resource/e5e95fdb-dda9-4c40-9273-395fe34aba3c) and [TIB](https://paulduchesne.github.io/state/resource/b8744ea7-c182-47c2-bf31-37e6ed6df396), and is a member of the [FIAF](https://paulduchesne.github.io/state/resource/ad8600ce-fe98-4212-b3d8-0105abdaa567) [Cataloguing and Documentation Commission]()." ;
+    ont:memberOf
+        <https://paulduchesne.github.io/state/resource/b8744ea7-c182-47c2-bf31-37e6ed6df396> ,
+        <https://paulduchesne.github.io/state/resource/e5e95fdb-dda9-4c40-9273-395fe34aba3c> ;
     ont:participatedIn
         <https://paulduchesne.github.io/state/resource/2ebe1653-01bb-4558-97eb-3f1ce794dd5a> ,
         <https://paulduchesne.github.io/state/resource/2ed97264-8762-4f68-a8ab-06b6e3b1adfe> ,

main.py

@@ -1,5 +1,6 @@
 from flask import Flask, render_template
 from flask_frozen import Freezer
+import markdown
 import pathlib
 import pydash
 import rdflib
@@ -51,7 +52,7 @@ def extract_text(uriref, prop):
 # node comment.
 
 for x in node_array.keys():
-    node_array[x]['comment'] = extract_text(x, rdflib.RDFS.comment)
+    node_array[x]['comment'] = markdown.markdown(extract_text(x, rdflib.RDFS.comment))
 
 # node statements.
 

ontology.ttl

@@ -127,7 +127,17 @@ PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
     rdfs:label "Has Author"@en ; 
     rdfs:comment "Person responsible for the text of a book."@en ;
     rdfs:domain ont:Book ;   
-    rdfs:range ont:Person ;   
+    rdfs:range ont:Person ;  
+    owl:inverseOf ont:authorOf ; 
+.
+
+<https://paulduchesne.github.io/state/ontology/authorOf>
+    a owl:ObjectProperty ;
+    rdfs:label "Author Of"@en ; 
+    rdfs:comment "Books written by the author."@en ;
+    rdfs:domain ont:Person ;   
+    rdfs:range ont:Book ;   
+    owl:inverseOf ont:hasAuthor ;
 .
 
 # owl:DatatypeProperty

pyproject.toml

@@ -7,6 +7,7 @@ requires-python = ">=3.13"
 dependencies = [
     "flask>=3.1.2",
     "frozen-flask>=1.0.2",
+    "markdown>=3.10",
     "pydash>=8.0.5",
     "rdflib>=7.4.0",
 ]

utilities/add_organisation.py

@@ -0,0 +1,57 @@
+
+# add organisation to graph.
+# note that this assumes no two individuals with the same name!
+
+import pathlib
+import rdflib
+import uuid
+
+# information to be added.
+
+org = {
+    "label": "International Federation of Film Archives",
+    "comment": "Primary international association of film archives.",
+    "wikidata": "Q586693",
+}
+
+# load existing graph.
+
+data_path = pathlib.Path.cwd().parent / 'data.ttl'
+if not data_path.exists():
+    raise Exception('File not found.')
+data = rdflib.Graph().parse(data_path)
+
+# pull or mind id.
+
+org['id'] = f"https://paulduchesne.github.io/state/resource/{str(uuid.uuid4())}"
+orgs = [s for s,p,o in data.triples((None, rdflib.RDF.type, rdflib.URIRef('https://paulduchesne.github.io/state/ontology/Organisation')))]
+for p in orgs:
+    for a,b,c in data.triples((p, rdflib.RDFS.label, None)):
+        if str(c) == org['label']:
+            org['id'] = p
+
+print(org)
+
+# add label.
+
+data.add((rdflib.URIRef(org['id']), rdflib.RDF.type, rdflib.URIRef('https://paulduchesne.github.io/state/ontology/Organisation')))
+data.add((rdflib.URIRef(org['id']), rdflib.RDFS.label, rdflib.Literal(org['label'], lang='en')))
+
+# add comment.
+
+if len(org['comment']):
+    comment = [o for s,p,o in data.triples((rdflib.URIRef(org['id']), rdflib.RDFS.comment, None))]
+    if not len(comment):
+        data.add((rdflib.URIRef(org['id']), rdflib.RDFS.comment, rdflib.Literal(org['comment'], lang='en')))
+
+# add wikidata.
+
+if len(org['wikidata']):
+    wikidata = [o for s,p,o in data.triples((rdflib.URIRef(org['id']), rdflib.URIRef('https://paulduchesne.github.io/state/ontology/wikidataIdentifier'), None))]
+    if not len(wikidata):
+        data.add((rdflib.URIRef(org['id']), rdflib.URIRef('https://paulduchesne.github.io/state/ontology/wikidataIdentifier'), rdflib.Literal(org['wikidata'])))
+
+# write to graph.
+
+data.serialize(data_path, format='longturtle')
+

utilities/validate_inverse.py

@@ -0,0 +1,49 @@
+
+# validate inverse properties.
+
+import pathlib
+import pydash
+import rdflib
+
+def raise_exception(s,p,o):
+    s_name = pathlib.Path(s).name
+    p_name = pathlib.Path(p).name
+    o_name = pathlib.Path(o).name
+    raise Exception(f'Inverse of {s_name} {p_name} {o_name} not found.')
+
+# load ontology.
+
+ontology_path = pathlib.Path.cwd().parent / 'ontology.ttl'
+if not ontology_path.exists():
+    raise Exception('File not found.')
+ontology = rdflib.Graph().parse(ontology_path)
+
+# detect inverse properties.
+
+inverse_pairs = list()
+for s,p,o in ontology.triples((None, rdflib.RDF.type, rdflib.OWL.ObjectProperty)):
+    for a,b,c in ontology.triples((s, rdflib.OWL.inverseOf, None)):
+        inverse_pairs.append(sorted([s, c]))
+        
+inverse_pairs = pydash.uniq(inverse_pairs)
+
+# load data.
+
+data_path = pathlib.Path.cwd().parent / 'data.ttl'
+if not data_path.exists():
+    raise Exception('File not found.')
+data = rdflib.Graph().parse(data_path)
+
+
+for props in inverse_pairs:
+    for s,p,o in data.triples((None, props[0], None)):
+        inverse = [(a,b,c) for a,b,c in data.triples((o, props[1], s))]
+        if len(inverse) != 1:
+            raise_exception(s,p,o)
+            
+    for s,p,o in data.triples((None, props[1], None)):
+        inverse = [(a,b,c) for a,b,c in data.triples((o, props[0], s))]
+        if len(inverse) != 1:
+            raise_exception(s,p,o)
+            
+