ewilderj / doap

RDF schema for describing software projects
https://github.com/ewilderj/doap/wiki
Apache License 2.0
271 stars 57 forks source link

Doap HTML #32

Closed mongoponzo closed 4 months ago

mongoponzo commented 7 years ago

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

ewilderj commented 7 years ago

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

kjetilk commented 7 years ago

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?

ewilderj commented 7 years ago

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!

taurenshaman commented 6 years ago

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

vemonet commented 4 years ago

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 commented 4 years ago

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