Base example repository on building off of UCO-Profile-Example

A follow-on patch will regenerate Make-managed files.

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>

Author: ajnelson-nist

.gitmodules

@@ -2,3 +2,7 @@
 	path = dependencies/CASE
 	url = https://github.com/casework/CASE.git
 	branch = master
+[submodule "dependencies/UCO-Profile-Example"]
+	path = dependencies/UCO-Profile-Example
+	url = https://github.com/ucoProject/UCO-Profile-Example.git
+	branch = main

CONTRIBUTE.md

@@ -18,6 +18,7 @@ To create a new profile repository for the ontology with short name `Foo`, we su
 1. Substitute all references to the "example" ontology with the desired ontology.  Generally, this is handled by:
    1. Update the [README](README.md) to change the name of the repository.  (Minimally, the title line should be revised.)
    1. Addressing the "TODOs" in [`dependencies/Makefile`](dependencies/Makefile)
+   1. Updating the submodule pointer to the UCO profile for the external ontology.  The example given is that [`CASE-Profile-Example`](https://github.com/casework/CASE-Profile-Example)'s profile ontology `owl:import`s [`UCO-Profile-Example`](https://github.com/ucoProject/UCO-Profile-Example)'s profile ontology for the Example Ontology, with the UCO profile file tracked by Git submodule.
    1. Updating the TSV files under [`etc/`](etc/).  This is to support local-file editing with some ontology tooling (developed for [UCO Issue 449](https://github.com/ucoProject/UCO/issues/449)).  [These lines](https://github.com/ucoProject/UCO/blob/1.2.0/src/create-catalog-v001.xml.py#L68-L77) describe the file formats.
    1. Renaming the [ontology file under `/ontology`](ontology/case-example.ttl), and updating its contents.
    1. Renaming the [shapes file under `/shapes`](shapes/sh-case-example.ttl), and updating its contents.  If the profile does not require shapes, the directory `shapes` can be removed.

Makefile

@@ -48,6 +48,12 @@ all: \
   .git_submodule_init_imports.done.log
 	git submodule update \
 	  --init
+	# Import profile's non-CDO submodules.
+	# TODO - Adapt UCO-Profile-Example reference if this CASE
+	# profile builds on a UCO profile.
+	$(MAKE) \
+	  --directory dependencies/UCO-Profile-Example \
+	  .git_submodule_init_imports.done.log
 	$(MAKE) \
 	  --directory dependencies/CASE \
 	  .git_submodule_init.done.log \

dependencies/Makefile

@@ -33,6 +33,7 @@ $(RDF_TOOLKIT_JAR):
 	@test -r $@
 
 catalog-v001.xml: \
+  $(case_srcdir)/ontology/master/catalog-v001.xml \
   $(top_srcdir)/.venv.done.log \
   $(top_srcdir)/etc/domain_directories.tsv \
   $(top_srcdir)/etc/dependency_files.tsv \
@@ -41,6 +42,7 @@ catalog-v001.xml: \
 	rm -f _$@
 	source $(top_srcdir)/venv/bin/activate \
 	  && python3 $(uco_srcdir)/src/create-catalog-v001.xml.py \
+	    --catalog-xml $(case_srcdir)/ontology/master/catalog-v001.xml \
 	    _$@ \
 	    $(top_srcdir)/etc/domain_directories.tsv \
 	    $(top_srcdir)/etc/dependency_files.tsv \
@@ -56,27 +58,8 @@ check: \
 clean:
 	@rm -f \
 	  catalog-v001.xml \
-	  example.ttl \
 	  imports-transitive.ttl
 
-# TODO: Adapt this recipe to normalize a submodule's file, or downloaded
-# file, in the same manner as CDO ontologies are normalized.
-example.ttl: \
-  example/example.owl \
-  $(RDF_TOOLKIT_JAR) \
-  $(top_srcdir)/.venv.done.log
-	source $(top_srcdir)/venv/bin/activate \
-	  && pyshacl \
-	    --shacl $(uco_srcdir)/ontology/owl/owl.ttl \
-	    $<
-	java -jar $(RDF_TOOLKIT_JAR) \
-	  --inline-blank-nodes \
-	  --source $< \
-	  --source-format rdf-xml \
-	  --target _$@ \
-	  --target-format turtle
-	mv _$@ $@
-
 # This recipe intentionally does not incorporate CDO ontologies (UCO,
 # CASE, etc.), to avoid redundant imports between multiple profiles.
 # TODO: Adapt this recipe to depend instead on the normalized file, as
@@ -85,7 +68,9 @@ example.ttl: \
 # command but for RDF graph files, will combine all recipe dependencies
 # into one file, using the $^ ("all dependencies") Make variable.
 imports-transitive.ttl: \
-  example.ttl
+  UCO-Profile-Example/dependencies/example.ttl \
+  UCO-Profile-Example/dependencies/imports-transitive.ttl \
+  UCO-Profile-Example/ontology/uco-example.ttl
 	source $(top_srcdir)/venv/bin/activate \
 	  && rdfpipe \
 	    --output-format turtle \

dependencies/UCO-Profile-Example

@@ -1,2 +1,4 @@
-http://example.org/ontology/example/0.0.1	${top_srcdir}/dependencies/example.ttl
-http://example.org/shapes/sh-uco-example	${top_srcdir}/shapes/sh-uco-example.ttl
+http://example.org/ontology/example/0.0.1	${top_srcdir}/dependencies/UCO-Profile-Example/dependencies/example.ttl
+http://example.org/ontology/uco-example	${top_srcdir}/dependencies/UCO-Profile-Example/ontology/uco-example.ttl
+http://example.org/shapes/sh-case-example	${top_srcdir}/shapes/sh-case-example.ttl
+http://example.org/shapes/sh-uco-example	${top_srcdir}/dependencies/UCO-Profile-Example/shapes/sh-uco-example.ttl

dependencies/example.ttl

@@ -1,4 +1,4 @@
-# imports: http://example.org/ontology/example/0.0.1
+# imports: http://example.org/ontology/uco-example
 # imports: https://ontology.caseontology.org/case/case/1.3.0
 
 @prefix drafting: <http://example.org/ontology/drafting/> .
@@ -12,7 +12,7 @@
 <http://example.org/ontology/case-example>
 	a owl:Ontology ;
 	owl:imports
-		ex:0.0.1 ,
+		<http://example.org/ontology/uco-example> ,
 		<https://ontology.caseontology.org/case/case/1.3.0>
 		;
 	.