search

dgarijo / Widoco

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.
Apache License 2.0
295 stars 89 forks source link

Use Widoco for the documentation of a SKOS vocabulary #641

Open marioscrock opened 1 year ago

marioscrock commented 1 year ago

Is your feature request related to a problem? Please describe. Currently, the metadata are correctly parsed only if an owl:Ontology entity is defined within the ontology file. For this reason, I can generate a useful documentation page for a SKOS vocabulary only by defining as owl:Ontology the same individual of type skos:ConceptScheme (all the other SKOS properties are correctly parsed anyway).

Describe the solution you'd like I'd propose to accept also skos:ConceptScheme as “root entity” for Widoco to generate documentation for this type of vocabulary.

Describe alternatives you've considered I am currently adding a triple defining the skos:ConceptScheme individual as owl:Ontology.

Other alternatives:

dgarijo commented 1 year ago

This is a nice suggestion. But what happens if you have multiple conceptSchemes in a file? If it's just a matter of adding a triple, I think it should be doable.

marioscrock commented 1 year ago

This is a nice suggestion. But what happens if you have multiple conceptSchemes in a file? If it's just a matter of adding a triple, I think it should be doable.

I think it may return a warning message and continue using the default behaviour. It would be nice to generate multiple documentation folders/files but it would imply an analysis of the file to determine which individuals are associated with each ConceptScheme.