W3C home > Mailing lists > Public > public-prov-wg@w3.org > March 2012

Re: automated prov-o html prototype

From: Timothy Lebo <lebot@rpi.edu>
Date: Wed, 7 Mar 2012 10:21:54 -0500
Cc: Provenance Working Group WG <public-prov-wg@w3.org>
Message-Id: <F7C08B8C-0EDA-4911-AABF-64638516084F@rpi.edu>
To: Jun Zhao <jun.zhao@zoo.ox.ac.uk>
Hi, Jun!

On Mar 7, 2012, at 6:46 AM, Jun Zhao wrote:

> Tim,
> 
> Your prototype page looks great!
> 
> The next question would be about process:
> 
> 1/ Khalid and I are continuing working on selecting examples, and thinking about diagrams. Shall we share them as separate files with you or do you suggest otherwise?

Great!
The examples should go into http://dvcs.w3.org/hg/prov/file/tip/examples according to [1] ("just like any other example")

Plop the diagrams into http://dvcs.w3.org/hg/prov/file/tip/ontology like we have in the past (Khalid is familiar). I can pull them from there.

[1] http://www.w3.org/2011/prov/wiki/PROV_examples_-_directory_conventions


> 
> 2/ we have a good base for automatically generate section 4, is it going to be integrated into your framework?

Sounds good. We should skype to iron out the details on that. Will you be mentioning this objective in the next iteration of your "pdf" requirements? 
If so, I'd like to read it through before we meet to discuss.

> 
> What do you aim to present to the group on Thursday?


I'd imagine a cross between the three of our efforts:

1) your pdf outlining requirements and objectives
2) Daniel's survey of tools
3) My automated outline and inclusion of the components.


Thanks for such great work, everyone!

-Tim



> 
> Cheers,
> 
> Jun
> 
> 
> On 06/03/2012 18:37, Timothy Lebo wrote:
>> Thanks for your review, Daniel. It will certainly help us along.
>> Regards,
>> Tim
>> 
>> On Mar 6, 2012, at 1:31 PM, Daniel Garijo wrote:
>> 
>> Hi Tim,
>> According to what you requested, I have tested all the tools I found for
>> creating html from owl automatically, and I have summarized them here:
>> http://www.w3.org/2011/prov/wiki/Generating_HTML_documentation_of_OWL#PROV-O_Views_in_the_previous_tools
>> 
>> What worked: Parrot, Owldoc, LODE, jOWL. LODE and jOWL provide cool stuff that we could reuse for the properties.
>> What didn't work properly: ontologyBrowser (it is not currently reading any ontology) and ontospec (I managed to load
>> succesfully the ontology, but it generates an empty html. Also, there is barely any documentation on this one.
>> What I didn't manage to run: specgen.
>> 
>> I hope this helps, I think we have enough to get started.
>> Best,
>> Daniel
>> 
>> 2012/3/6 Daniel Garijo<dgarijo@delicias.dia.fi.upm.es<mailto:dgarijo@delicias.dia.fi.upm.es>>
>> Tim,
>> this looks pretty good and quite flexible to introduce new changes.
>> I will keep trying some of the tools on your notes to see if we can reuse some parts for
>> showing domain and range of the properties.
>> 
>> Thanks,
>> Daniel
>> 
>> 
>> 2012/3/6 Khalid Belhajjame<Khalid.Belhajjame@cs.man.ac.uk<mailto:Khalid.Belhajjame@cs.man.ac.uk>>
>> 
>> Great work Tim. You managed to make the automation work in no time :-)
>> 
>> Just a couple of observations.
>> 
>> - Currently in Section 2 " PROV-O at a glance" will be better in the Introduction, or in Section 3. For example the example can be mentioned in the intro paragraph of Section 3.
>> - Section 2, should be compact, and will contains mainly the three indexes of the terms in the three parts of the ontology. I notice that such indexes are in Section 3!
>> - If we go with the option of having one example that is shown mainly in Section 3.1 (Core terms) and Section 3.2 (Qualified relationships), then I think that we will not anymore need the "hide/show examples" button. I didn't discuss this last point with jun, so she may have a different opinion.
>> 
>> Thanks, khalid
>> 
>> 
>> On 06/03/2012 02:23, Timothy Lebo wrote:
>> 
>> prov-o,
>> 
>> I have a prototype that shows the essential features that we discussed today in our telecon:
>> 
>> 
>> 0) Follows the new section organization from Khalid and Jun.
>> 
>> 
>> 1) Permitting areas for manual editing
>> 
>> This can be done by editing the main body, or a separate file that is included upon page request.
>> 
>> 
>> 2) Listing classes and properties according to the "three categories"
>> 
>> This is done via SPARQL query into a triple store named graph that caches http://dvcs.w3.org/hg/prov/raw-file/default/ontology/ProvenanceOntology.owl
>> 
>> 
>> 3) Including manually-created diagrams.
>> 
>> This is done by traditional HTML.
>> 
>> 
>> 4) Example hiding
>> 
>> Taken from the previous WD. The input type is odd but can be fixed.
>> 
>> 
>> 5) Including examples directly from the version controlled examples listed in http://www.w3.org/2011/prov/wiki/PROV_examples
>> 
>> This is done a priori with a script that fetches the examples to include, which are then included upon page request.
>> 
>> 
>> 
>> The prototype can be seen at:
>> 
>> http://aquarius.tw.rpi.edu/prov-wg/prov-o
>> 
>> The code is version controlled at https://github.com/timrdf/prov-lodspeakr/tree/master/components/services/prov-o
>> 
>> 
>> Suggestions and feedback welcome.
>> 
>> Regards,
>> Tim
>> 
>> 
>> 
>> 
>> 
>> 
>> 
> 
> 
Received on Wednesday, 7 March 2012 15:22:33 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 26 April 2012 13:06:58 GMT