W3C home > Mailing lists > Public > public-lod@w3.org > February 2012

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

From: Jun Zhao <jun.zhao@zoo.ox.ac.uk>
Date: Mon, 27 Feb 2012 23:57:18 +0100
Message-Id: <CEBA161B-264E-4156-9FBB-8A55258A272D@zoo.ox.ac.uk>
Cc: Olaf Hartig <hartig@informatik.hu-berlin.de>, "public-lod@w3.org" <public-lod@w3.org>, "semantic-web@w3.org" <semantic-web@w3.org>
To: Tim rdf <timrdf@gmail.com>
I used specgen for OPMV, but the result wasn't perfect, so I ended up doing some additional editing, and then end up writing the whole thing manually:)

--jun

Sent from my iPad

On 27 Feb 2012, at 22:18, Tim rdf <timrdf@gmail.com> wrote:

> Hi, Olaf,
> 
> 
> On Mon, Feb 27, 2012 at 3:52 PM, Olaf Hartig
> <hartig@informatik.hu-berlin.de> wrote:
>> Hey Tim,
>> 
>> This question has been discussed here:
>> 
>> http://answers.semanticweb.com/questions/1087/generating-documentation-from-
>> rdfs-andor-owl-vocabularies
> 
> Thanks for the pointer.
> 
>> 
>> BTW, the cool thing about the OPMV documentation (as well as the Provenance
>> Vocabulary documentation [1] which served as a template for the OPMV doc) is,
>> that it embeds the whole vocabulary definition as RDFa in the HTML. Actually,
>> for Provenance Vocabulary it's the main representation from which we generate
>> representations in other formats such as RDF/XML. However, creating the HTML
>> (and the embedded RDFa) was a manual effort.
> 
> 
> This has always been my preferred approach, but the team decided to go
> the Protege route, so I need to generate something from Plain Old OWL.
> Glad to hear that others have done this though, I'll try to use it as
> a model in future OWL projects.
> 
> Regards,
> Tim
> 
> 
>> 
>> Cheers,
>> Olaf
>> 
>> [1] http://trdf.sourceforge.net/provenance/ns.html
>> 
>> On Monday 27 February 2012 15:20:28 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
>> 
> 
Received on Monday, 27 February 2012 22:57:49 UTC

This archive was generated by hypermail 2.3.1 : Sunday, 31 March 2013 14:24:37 UTC