diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml new file mode 100644 index 0000000..f3ba9b6 --- /dev/null +++ b/.github/workflows/doc.yml @@ -0,0 +1,40 @@ +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.20/widoco-1.4.20-jar-with-dependencies_JDK-17.jar + steps: + - uses: actions/checkout@v4 + - 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 annodc.owl -rewriteAll -uniteSections -getOntologyMetadata -outFolder . + + - 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 diff --git a/annodc.owl b/annodc.owl index de5930b..28071db 100644 --- a/annodc.owl +++ b/annodc.owl @@ -20,6 +20,7 @@ 2023-08-24 + Anthropological Notation Ontology The Anthropological Notation Ontology (ANNO) allows the systematic and standardized classification of recovered bone finds into the skeletal system, the description of the skeletal pieces, and the definition of functions for the derivation of different phenotypes of humans in forensic and historical anthropology. ANNO consists of two components: ANNOdc, a domain-core ontology providing core entities such as basic anatomical categories, and ANNOds, a domain-specific ontology used for annotating structures of the human skeleton. ANNO is integrated into AnthroWorks3D, a photogrammetry pipeline and application for the creation and analysis of 3D-models of human skeletal remains. The integration is based on the three-ontology method with the General Formal Ontology as the top-level ontology, ANNOdc as the task ontology and ANNOds as the domain ontology. Thus, AnthroWorks3D only needs to implement access to the entities (classes and properties) of the task ontology, whereas the entities of the corresponding domain ontology are imported dynamically. ANNO supports the analysis of skeletal and bone finds in forensic and historical anthropology, facilitating the standardization of data annotation and ensuring accurate preservation of information for posterity. The Anthropological Notation Ontology (ANNO) allows the systematic and standardized classification of recovered bone finds into the skeletal system, the description of the skeletal pieces, and the definition of functions for the derivation of different phenotypes of humans in forensic and historical anthropology.