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
276 stars 86 forks source link

Use Widoco for the documentation of a SKOS vocabulary #641

Open marioscrock opened 9 months ago

marioscrock commented 9 months 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 9 months 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 9 months 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.