doap icon indicating copy to clipboard operation
doap copied to clipboard

Doap HTML

Open mongoponzo opened this issue 7 years ago • 6 comments

Is there any HTML version of the Doap ontology? The official website only has the XML document which is very difficult to read.

mongoponzo avatar Jun 01 '17 09:06 mongoponzo

Not yet. If you know of any RDF->HTML processors I'd be happy to automate that.

ewilderj avatar Aug 09 '17 17:08 ewilderj

I suppose it depends on the environment it should run in. Back in the day, I used Drupal based Neologism, which was pretty good, but it isn't actively maintained. I suppose the what was used for FOAF might be usable?

kjetilk avatar Aug 09 '17 22:08 kjetilk

It would be best if we could keep it all static, so that we could ship docs easily as part of the distribution. Time to hit up DanBri to find out what FOAF does I suppose!

ewilderj avatar Aug 09 '17 22:08 ewilderj

Here is a simple one:
http://www.chuci.info/view/schema/97ac7e9e37694a238d7e3ca5b84efa38

taurenshaman avatar Jan 30 '18 03:01 taurenshaman

You can use the Python package Ontospy to generate a static HTML website to document any OWL ontology

https://pypi.org/project/ontospy/

You just need to provide the OWL ontology file to the ontospy command line, it will generate the HTML automatically in the folder you specified (e.g. in the docs folder)

Then you just need to publish to docs folder as GitHub Page.

It can be automated easily using GitHub Actions to generate and commit the docs at every change to the OWL file

vemonet avatar Jun 23 '20 12:06 vemonet

I generated documentation for the DOAP ontology using Ontospy and hosted it in GitHub Pages: https://vemonet.github.io/doap

It can be done in 3 lines if you already have pip installed (python package manager)

pip install ontospy[FULL]
mkdir docs
ontospy gendocs -o docs https://raw.githubusercontent.com/vemonet/doap/master/schema/doap.rdf

Source code in this fork: https://github.com/vemonet/doap/

All documentation files have been added to the docs/ folder

vemonet avatar Jun 24 '20 10:06 vemonet