Ready project for multi-site builds

We will need a dedicated one for each schema too, not just the main
ontology.

.github/workflows/sitebuild.yml

@@ -43,7 +43,7 @@ jobs:
           #mkdir -p ./build/upload
           #export "SITEDIR=./build/upload/$(git branch --show-current)"
           #export "SITEURL=https://concepts.datalad.org/$(git branch --show-current)"
-          make mkdocs-site
+          make build/mkdocs-site
           make build/context.jsonld
           #mv ./build/mkdocs-site $SITEDIR
           mv ./build/mkdocs-site ./build/upload

Makefile

@@ -8,8 +8,8 @@ build/context.jsonld: src/linkml/ontology.yaml
 		--mergeimports \
 		$< > $@
 
-linkml-docs: linkml-docs-stamp
-linkml-docs-stamp:
+build/linkml-docs: build/linkml-docs/ontology
+build/linkml-docs/%: src/linkml/%.yaml src/extra-docs/%
 	gen-doc \
 		--mergeimports \
 		--hierarchical-class-view \
@@ -18,19 +18,15 @@ linkml-docs-stamp:
 		--diagram-type er_diagram \
 		--metadata \
 		--format markdown \
-		-d build/linkml-docs \
-		src/linkml/ontology.yaml
-	touch $@
-
-extra-docs: extra-docs-stamp
-extra-docs-stamp:
-	mkdir -p build/linkml-docs
-	cp -r src/extra-docs/* build/linkml-docs
+		-d $@ \
+		$<
+	# try to inject any extra-docs (if any exist)
+	-cp -r src/extra-docs/$$(basename $@)/*.md $@
 
-mkdocs-site: mkdocs-site-stamp
-mkdocs-site-stamp: linkml-docs extra-docs
+build/mkdocs-site: build/linkml-docs src/extra-docs/*.md
+	# top-level content
+	cp -r src/extra-docs/*.md $<
 	mkdocs build
-	touch $@
 
 lint: lint-ontology lint-dataset-graph-schema
 lint-ontology: src/linkml/ontology.yaml
@@ -52,4 +48,4 @@ clean:
 	rm -rf build
 	rm -f *-stamp
 
-.PHONY: clean linkml-docs extra-docs  mkdocs-site lint validate
+.PHONY: clean lint validate

mkdocs.yml

@@ -9,7 +9,7 @@ repo_url: https://github.com/psychoinformatics-de/datalad-concepts
 site_author:
 site_description:
 site_dir: build/mkdocs-site
-site_name: DataLad Concepts Ontology (DLCO)
+site_name: DataLad Concepts
 site_url: !ENV [SITEURL, 'https://concepts.datalad.org']
 strict: true
 theme:

src/extra-docs/about.md

@@ -0,0 +1 @@
+Write me!

src/extra-docs/index.md

@@ -0,0 +1 @@
+- [DataLad concepts ontology](ontology/)

src/linkml/datalad-datasets.yaml

@@ -3,7 +3,7 @@
 id: https://concepts.datalad.org/datalad-datasets
 name: datalad-datasets
 prefixes:
-  dlco: https://concepts.datalad.org/
+  dlco: https://concepts.datalad.org/ontology/
   dct: http://purl.org/dc/terms/
 imports:
   - datasets

src/linkml/datasets.yaml

@@ -6,7 +6,7 @@ prefixes:
   dctypes: http://purl.org/dc/dcmitype/
   dct: http://purl.org/dc/terms/
   schema: http://schema.org/
-  dlco: https://concepts.datalad.org/
+  dlco: https://concepts.datalad.org/ontology/
   linkml: https://w3id.org/linkml/
 imports:
   - linkml:types

src/linkml/ontology.yaml

@@ -1,4 +1,4 @@
-id: https://concepts.datalad.org
+id: https://concepts.datalad.org/ontology
 name: datalad-concepts-ontology
 title: DataLad Concepts Ontology (DLCO)
 description: |-
@@ -7,7 +7,7 @@ license: MIT
 
 prefixes:
   linkml: https://w3id.org/linkml/
-  dlco: https://concepts.datalad.org/
+  dlco: https://concepts.datalad.org/ontology/
 
 default_prefix: dlco