Loading repository data…
dgarijo / repository
Wizard for documenting ontologies. WIDOCO is a step by step generator of HTML templates with the documentation of your ontology. It uses the LODE environment to create part of the template.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
WIDOCO helps you to publish and create an enriched and customized documentation of your ontology automatically, by following a series of steps in a GUI.
Author: Daniel Garijo Verdejo (@dgarijo)
Contributors: María Poveda, Idafen Santana, Almudena Ruiz, Miguel Angel García, Oscar Corcho, Daniel Vila, Sergio Barrio, Martin Scharm, Maxime Lefrancois, Alfredo Serafini, @kartgk, Pat Mc Bennett, Christophe Camel, Jacobus Geluk, Martin Scharm, @rpietzsch, Jonathan Leitschuh, Jodi Schneider, Giacomo Lanza, Alejandra Gonzalez-Beltran, Mario Scrocca, Miguel Angel García, Flores Bakker, @JohnnyMoonlight, René Fritze, @telecsur, Jan Vlug, Han Kruiger, Johannes Theissen-Lipp, Roberto Polli, Victor Chavez, Sirko Schindler and Michaël Dierick.
Citing WIDOCO: If you used WIDOCO in your work, please cite the ISWC 2017 paper: https://iswc2017.semanticweb.org/paper-138
@inproceedings{garijo2017widoco,
title={WIDOCO: a wizard for documenting ontologies},
author={Garijo, Daniel},
booktitle={International Semantic Web Conference},
pages={94--102},
year={2017},
organization={Springer, Cham},
doi = {10.1007/978-3-319-68204-4_9},
funding = {USNSF ICER-1541029, NIH 1R01GM117097-01},
url={http://dgarijo.com/papers/widoco-iswc2017.pdf}
}
If you want to cite the latest version of the software, you can do so by using: https://zenodo.org/badge/latestdoi/11427075.
Selected from shared topics, language and repository description—not editorial ratings.
trojan-abominator959 /
📄 Load documents efficiently with docsloader, an asynchronous package supporting multiple file types for seamless integration in your projects.
46/100 healthTo download WIDOCO, you need to download a JAR executable file. Check the latest release for more details: (https://github.com/dgarijo/WIDOCO/releases/latest).
Just add the dependency and repository to your pom.xml file as follows. See the WIDOCO JitPack page to find alternative means to incorporate WIDOCO to your project.
<dependencies>
<dependency>
<groupId>com.github.dgarijo</groupId>
<artifactId>Widoco</artifactId>
<version>v1.4.24</version>
</dependency>
</dependencies>
[ ... ]
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
WIDOCO helps you to publish and create an enriched and customized documentation of your ontology, by following a series of steps in a wizard. We extend the LODE framework by Silvio Peroni to describe the classes, properties and data properties of the ontology, the OOPS! webservice by María Poveda to print an evaluation and the Licensius service by Victor Rodriguez Doncel to determine the license URI and title being used. In addition, we use WebVowl to visualize the ontology and have extended Bubastis to show a complete changelog between different versions of your ontology.
Features of WIDOCO:
Examples of the features of WIDOCO can be seen on the gallery
A tutorial explaining the main features of the GUI can be found here
To see how WIDOCO recognizes metadata annotations in your ontology to create the documentation files, see the WIDOCO metadata documentation. To learn which metadata properties we recommend adding to your ontology for producing a nice-looking documentation, have a look at our best practices guide.
For example, in order to show your logo in your documentation you just need to use foaf:logo as an annotation, as follows:
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
<https://w3id.org/roar> a owl:Ontology ;
foaf:logo <https://www.leonvanwissen.nl/vocab/roar/docs/resources/roar-logo.png#> .
and it will show right next to the title. The WIDOCO metadata documentation shows all supported metadata fields.
We provide JAR files for each release (see the releases page). However, if you want to build WIDOCO from scratch, just cd into the project folder and run:
mvn install
The JAR will be generated in a "JAR" folder. The name will follow the pattern: widoco-{VERSION_ID}-jar-with-dependencies.jar, where {VERSION_ID} is the version number of the tool.
Download the latest .jar WIDOCO available release (it will be something like widoco-VERSION-jar-with-dependencies.jar). Then just double click the .jar file.
You may also execute WIDOCO through the command line. Usage:
java -jar widoco-VERSION-jar-with-dependencies.jar [OPTIONS]
If you don't want to use the JAR directly, you may run the project using a Docker container. First you will need to download or build the image, and then run it.
We build containers in the GitHub image registry for all latest releases. In order to import one, just run the following command, stating the version of Widoco you prefer (e.g., for v1.4.23):
docker pull ghcr.io/dgarijo/widoco:v1.4.23
To browse all available images, see the GitHub image registry.
Build the image using the Dockerfile in project folder:
docker build -t dgarijo/widoco .
You can now execute WIDOCO through the command line. Usage:
docker run -ti --rm dgarijo/widoco [OPTIONS]
Note: If you downloaded the image from the GitHub registry, you will have to change dgarijo/widoco with the name of the image you downloaded. For example ghcr.io/dgarijo/widoco:v1.4.23.
If you want to share data between the Docker Container and your Host, for instance to load a local ontology file (from PATH), you will need to mount the container with host directories. For instance:
docker run -ti --rm \
-v `pwd`/test:/usr/local/widoco/in:Z \
-v `pwd`/target/generated-doc:/usr/local/widoco/out:Z \
dgarijo/widoco -ontFile in/bne.ttl -outFolder out -rewriteAll
-analytics CODE: Add a code snippet for Google analytics to track your HTML documentation. You need to add your CODE next to the flag. For example: UA-1234
-confFile PATH: Load your own configuration file for the ontology metadata. Use this option if you want to load your own HTML sections as well. Incompatible with -getOntologyMetadata. See the configuration documentation for more information about the accepted fields.
-crossRef: ONLY generate the overview and cross reference sections. The index document will NOT be generated. The htaccess, provenance page, etc., will not be generated unless requested by other flags. This flag is intended to be used only after a first version of the documentation exists.
-displayDirectImportsOnly: Only those imported ontologies that are directly imported in the ontology being documented.
-doNotDisplaySerializations: The serializations of the ontology will not be displayed.
-excludeIntroduction: Skip the introduction section in the documentation.
-excludeProvenance: Do not add the link "Provenance of this page" in the metadata header section
-getOntologyMetadata: Extract ontology metadata from the given ontology
--help: Shows a help message and exits.
-htaccess: Create a bundle for publication ready to be deployed on your Apache server.
-ignoreIndividuals: Individuals will not be included in the documentation.
-includeAnnotationProperties: Include annotation properties defined in your ontology in the documentation (by default they are not included)
-includeImportedOntologies: Indicates whether the terms of the imported ontologies of the current ontology should be documented as well or not.
-import: imports a local ontology (e.g., if you don't want to load an online ontology, you may load its local version)
-lang LANG1-LANG2: Generate documentation in multiple languages (separated by "-"). Note that if the language is not supported, the system will load the labels in english. For example: en-pt-es
-licensius: Use the Licensius web services (http://licensius.com/apidoc/index.html) to retrieve license metadata. Only works if the -getOntologyMetadata flag is enabled.
-noPlaceHolderText: Do not add any placeholder text (this will remove intro, abstract (if empty) and description sections).
-ontFile PATH [required (unless -ontURI is used)]: Load a local ontology file (from PATH) to document. This option is incompatible with -ontURI
-outFolder folderName: Specifies the name of the folder where to save the documentation. By default is 'myDocumentation'
-ontURI URI [required (unless -ontFile is used)]: Load an ontology to document from its URI. This option is incompatible with -ontFile
-oops: Create an html page with the evaluation from the OOPS service (http://oops.linkeddata.es/)
-rewriteAll: Replace any existing files when documenting an ontology (e.g., from a previous execution)
-rewriteBase PATH: Change the