|
What tools do people recommend for generating human-readable documentation from RDFS/OWL vocabularies? |
|
I've also written some code to generate simple HTML documentation from RDFS/OWL documents: Written in Ruby, uses Redland libraries. Allows templates output and automatic inclusion of some static documentation. |
|
Another alternative would be to use something like Neologism to manage and publish your vocabulary...I think it only does RDFS though. |
|
TopBraid Composer has a feature to export any model into a set of HTML pages. An example can be seen at http://www.estrellaproject.org/lkif-core/doc/index.html |
|
I'll suggest Parrot as I thought it pretty cool and simple. http://ontorule-project.eu/parrot/parrot |
|
I really like OWLDoc.....it parses OWL Ontologies to HTML and produces documentation for ontologies which is very Java-Doc like. Exists as a plugin into Protege and generation of the documentation is essentially a one-click affair! |
|
In the past I have used an XSLT stylesheet to produce HTML from RDF/XML. You can see an example of this in use at http://vocab.org/aiiso-roles/schema More recently I use my own Paget framework to produce documentation like http://vocab.org/bio/0.1/ |
|
I tried and liked the "Ontology Browser"[1] and also LODE [2] which also links to the first one. Both are "live" documentations, in the sense that documentation does not need to be regenerated on changes. However, so far, I could not find out how to point the browser directly to a resource, not the whole vocabulary. Has someone already done this? I'd like to use it with content negotiation when calling a URI of one of the resources (they have slash uri style). [1] http://code.google.com/p/ontology-browser/ [2] http://lode.sourceforge.net/ Great: LODE is now able to do exactly, what I was missing - you can now point the browser to a specific resource: http://palindrom.es/phd/applications-services/lode/ |


Is there also a specification generator, which produces RDFa in my documentation?
I'll test Danbri's SpecGen branch: "Inputs: RDF, HTML and OWL description(s) of an RDF vocabulary - Output: an XHTML+RDFa specification designed for human users".
I created a modified, extended and more generalized version of Danbri'S SpecGen5 version. You can found SpecGen6 ( ;) ) here: http://smiy.svn.sourceforge.net/viewvc/smiy/specgen/trunk/