W3C home > Mailing lists > Public > semantic-web@w3.org > March 2012

Re: Tools to produce HTML documentation of RDFS / OWL ontologies

From: Sebastian Hellmann <hellmann@informatik.uni-leipzig.de>
Date: Sat, 03 Mar 2012 11:45:13 +0100
Message-ID: <4F51F639.6030706@informatik.uni-leipzig.de>
To: David Wood <david@3roundstones.com>
CC: Tim rdf <timrdf@gmail.com>, semantic-web@w3.org, public-lod@w3.org
Hi Tim,
I forked OWLDoc and released a CLI version of it:
https://bitbucket.org/kurzum/ontology-browser-fork
https://bitbucket.org/kurzum/ontology-browser-fork/downloads
See the result here:
http://nlp2rdf.lod2.eu/schema/doc/string/index.html

The history of this code is:
1. http://www.co-ode.org/downloads/owldoc/
2. http://code.google.com/p/ontology-browser/
3. https://bitbucket.org/kurzum/ontology-browser-fork

The Ontology Browser is quite good, but not maintained any more.
I really hope, that there will be best practice soon. I had quite some 
trouble setting up the infrastructure and content negotiation. I 
dedicated a small chapter on how I set it up (including the .htaccess 
code) in the LOD2 EU deliverable [1].

I still have many problems with versioning. I think, currently the best 
way to manage ontologies is actually turtle files and a VCS (e.g. 
subversion) and Maven Java Jar files for programatic access.  They 
should be treated the same way as source code. Hence I would be willing 
to help test and improve any owldoc-like solution, which can be used 
like javadoc or phpdoc.

Sebastian

[1] http://static.lod2.eu/Deliverables/LOD2_D3.2.1_NLP2RDF.pdf

On 02/27/2012 09:58 PM, David Wood wrote:
> Hi Tim,
>
> I've used these in the past with good results:
>    OWLDoc: http://www.co-ode.org/downloads/owldoc/
>    SpecGen: https://github.com/zazi/specgen
>
> Regards,
> Dave
>
>
>
>
> On Feb 27, 2012, at 15:20, Tim rdf wrote:
>
>> Hello,
>>
>> I am working on an OWL ontology for the W3C provenance working group, at [1].
>>
>> We'd like to produce something like these examples of "good" HTML
>> documentation, such as:
>>
>> http://open-biomed.sourceforge.net/opmv/ns.html
>> http://xmlns.com/foaf/spec/
>> http://rdfs.org/sioc/spec/
>>
>>
>> Are there tools around that produce HTML documentation of RDFS or OWL
>> ontologies.
>>
>>
>> Thanks for your consideration!
>>
>> Regards,
>> Tim Lebo
>>
>> [1] http://dvcs.w3.org/hg/prov/raw-file/default/ontology/ProvenanceFormalModel.html
>>
>


-- 
Dipl. Inf. Sebastian Hellmann
Department of Computer Science, University of Leipzig
Projects: http://nlp2rdf.org , http://dbpedia.org
Homepage: http://bis.informatik.uni-leipzig.de/SebastianHellmann
Research Group: http://aksw.org
Received on Saturday, 3 March 2012 10:45:50 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 1 March 2016 07:42:32 UTC