Add Widoco GitHub Action. Resolve #114.

Author: KonradHoeffner

.github/workflows/build.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       - name: Install dependencies
         run: |
@@ -21,7 +21,7 @@ jobs:
         run: ./build
 
       - name: Deploy
-        uses: JamesIves/github-pages-deploy-action@4.1.5
+        uses: JamesIves/github-pages-deploy-action@v4
         with:
           branch: dist
           folder: dist

.github/workflows/doc.yml

@@ -0,0 +1,47 @@
+name: Generate and Publish Ontology Documentation
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - master
+
+jobs:
+  doc:
+    runs-on: ubuntu-latest
+    env:
+      WIDOCO_DOWNLOAD_URL: https://github.com/dgarijo/Widoco/releases/download/v1.4.17/java-17-widoco-1.4.17-jar-with-dependencies.jar
+    steps:
+      - uses: actions/checkout@v3
+
+      # use preinstalled Java
+      #- uses: actions/setup-java@v3
+      #  with:
+      #    distribution: 'temurin'
+      #    java-version: '19'
+
+      - name: Cache Widoco
+        uses: actions/cache@v3
+        with:
+          path: jar
+          key: ${{ env.WIDOCO_DOWNLOAD_URL }}
+
+      - name: Download Widoco if it doesn't exist
+        # wget --no-clobber has exit code 1
+        run: |
+          mkdir -p jar
+          if test -f jar/widoco.jar; then echo "Widoco already exists, skipping download."; exit 0; fi
+          wget $WIDOCO_DOWNLOAD_URL --progress=dot:giga --output-document=jar/widoco.jar
+
+      - name: Run Widoco
+        run: java -jar jar/widoco.jar -ontFile ontology.ttl -rewriteAll -uniteSections -getOntologyMetadata -outFolder doc
+
+      - name: Rename index-en.html to index.html
+        run: mv doc/index-en.html doc/index.html
+
+      - name: Deploy Documentation to gh-pages branch
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: doc
+          single-commit: true

README.md

@@ -16,7 +16,8 @@ This file can then be uploaded to the HITO SPARQL endpoint:
 Warning: This will not include updated software products from the database.
 
 ## Documentation
-[Download WIDOCO](https://github.com/dgarijo/Widoco/releases) and make it available as `widoco`, then run `./doc` under Linux to generate the ontology documentation.
+[Download WIDOCO](https://github.com/dgarijo/Widoco/releases) and make it available as `widoco`, then run `./scripts/doc` under Linux to generate the ontology documentation and open `/tmp/doc/index-en.html`.
+Automatically built and published to <https://hitontology.github.io/ontology/>.
 Adapt the `doc` script accordingly on other operating systems.
 
 ## List of files

ontology.ttl

@@ -38,7 +38,7 @@
      dcterms:contributor  "<a href=''http://www.imise.uni-leipzig.de/Mitarbeiter/Birgit_Schneider>Birgit Schneider</a>, <a href='https://www.imise.uni-leipzig.de/en'>IMISE Leipzig, Germany</a>",
                          "<a href='https://www.imise.uni-leipzig.de/en/Mitarbeiter/Maryam_Ghalandari'>Maryam Ghalandari</a>, <a href='https://www.imise.uni-leipzig.de/en'>IMISE Leipzig, Germany</a>",
                          "<a href='https://github.com/ThomasPause'>Thomas Pause</a>, formerly <a href='https://www.imise.uni-leipzig.de/en'>IMISE Leipzig, Germany</a>";
-     dcterms:created "2021-07-29"^^xsd:gYear;
+     dcterms:created "2022-10-20"^^xsd:gYear;
      dcterms:publisher <https://www.imise.uni-leipzig.de/>;
      vann:preferredNamespaceURI <http://hitontology.eu/ontology/>;
      vann:preferredNamespacePrefix "hito";