SPARQL Unicorn Ontology Documentation

This repository hosts a standalone version of the HTML documentation feature included in the SPARQLing Unicorn QGIS Plugin.

Rather than initiating the documentation generation within the SPARQLing Unicorn QGIS Plugin, this python script allows the generation of the documentation standalone or as a Github Action.

The standalone script does not rely on QGIS classes and does not provide the full functionality available in the SPARQLUnicorn QGIS Plugin.

Deviations from the SPARQLing Unicorn Plugin are listed as follows:

• Support for less geometry literals: Only WKT and GeoJSON literals are supported for rendering

Usage Example as Github Action

For a usage example please refer to this repository: https://github.com/sparqlunicorn/sparqlunicornGoesGIS_testdata

Usage Example as Gitlab CI Workflow

For a usage example please refer to this repository: https://gitlab.com/sparqlunicorn/sparqlunicornGoesGIS_testdata

Installation as PIP package

You can install the ontology documentation script as a pip package using the following command:

pip install -U git+https://github.com/sparqlunicorn/sparqlunicornGoesGIS-ontdoc@v017

The execution parameters are the ones described in the next section.

Usage as standalone script

You can use the standalone script by downloading a release or cloning this repository.

Before using the script, please ensure you have installed the requirements listed in the file requirements.txt.

pip install -r requirements.txt

The command docgeneration.py -h will print a help dialog with all available parameters and options.

At the minimum, this script expects an input RDF file and an output file path.

usage: docgeneration.py [-h] -i [INPUT ...] -o [OUTPUT ...] [-pxns PREFIXNS] [-px PREFIXNSSHORT]
                        [-ip CREATEINDEXPAGES] [-cc CREATECOLLECTIONS] [-ll LABELLANG] [-li LICENSE] -ex EXPORTS
                        [EXPORTS ...] [-lgu LOGOURL] [-dt DATASETTITLE] [-lo LOCALOPTIMIZED] [-mdt METADATATABLE]
                        [-nnsp NONNSPAGES] [-vowl CREATEVOWL] [-of OFFLINECOMPAT] [-ogc OGCAPIFEATURES]
                        [-iiif IIIFMANIFEST] [-sc STARTCONCEPT] [-dp DEPLOYPATH] [-tp TEMPLATEPATH] [-tn TEMPLATENAME]

optional arguments:
  -h, --help            show this help message and exit
  -i [INPUT ...], --input [INPUT ...]
                        the input TTL file(s) to parse
  -o [OUTPUT ...], --output [OUTPUT ...]
                        the output path(s)
  -pxns PREFIXNS, --prefixns PREFIXNS
                        the prefixnamespace
  -px PREFIXNSSHORT, --prefixnsshort PREFIXNSSHORT
                        the prefix
  -ip CREATEINDEXPAGES, --createIndexPages CREATEINDEXPAGES
                        create index pages?
  -cc CREATECOLLECTIONS, --createCollections CREATECOLLECTIONS
                        create collections?
  -ll LABELLANG, --labellang LABELLANG
                        preferred label language (default: en)
  -li LICENSE, --license LICENSE
                        license under which this data is published
  -ex EXPORTS [EXPORTS ...], --exports EXPORTS [EXPORTS ...]
                        choose script exports to be generated next to HTML ['graphml', 'json', 'tgf', 'ttl']
  -lgu LOGOURL, --logourl LOGOURL
                        URL of an optional page logo
  -dt DATASETTITLE, --datasettitle DATASETTITLE
                        The title of this dataset to use in HTML templates
  -lo LOCALOPTIMIZED, --localOptimized LOCALOPTIMIZED
                        build a version for local deployment
  -mdt METADATATABLE, --metadatatable METADATATABLE
                        create metadata table?
  -nnsp NONNSPAGES, --nonnspages NONNSPAGES
                        create nonns pages?
  -vowl CREATEVOWL, --createvowl CREATEVOWL
                        create vowl graph view?
  -of OFFLINECOMPAT, --offlinecompat OFFLINECOMPAT
                        built-result is offline compatible
  -ogc OGCAPIFEATURES, --ogcapifeatures OGCAPIFEATURES
                        create ogc api features collections?
  -iiif IIIFMANIFEST, --iiifmanifest IIIFMANIFEST
                        create iiif manifests?
  -sc STARTCONCEPT, --startconcept STARTCONCEPT
                        the concept suggested for browsing the HTML documentation
  -dp DEPLOYPATH, --deploypath DEPLOYPATH
                        the deploypath where the documentation will be hosted
  -tp TEMPLATEPATH, --templatepath TEMPLATEPATH
                        the path of the HTML template
  -tn TEMPLATENAME, --templatename TEMPLATENAME
                        the name of the HTML template

Supported vocabularies

The following vocabularies are supported by the ontology documentation tool and may be rendered in a specific way in HTML:

• BIBO Vocabulary [Example Dataset (Ancient Ports)]
• Dublin Core DCTerms
• FOAF Vocabulary [Example Dataset (Ancient Ports)]
• GeoSPARQL 1.0 and 1.1 vocabulary [Example Dataset (CIGS)]
• SKOS Vocabulary
• SOSA Ontology [Example Dataset (hgis_stats)]
• Unit of Measurements Ontology
• W3C Web Annotation Data Model
• W3C Geo Vocabulary