[oslc-core] Comments on Vocabulary.xsl (publishing vocabularies to HTML)
Ian Green1
ian.green at uk.ibm.com
Tue Mar 8 05:40:01 EST 2011
In [1] some practices for publishing OSLC vocabularies are described, and
a sample xsl is given [2] that generates wiki html from RDFS XML source.
The XSL assumes that the seeAlso linkage into the formal specification is
singular, but in the RM specification this is not the case - for example,
relationship properties are meaningful on multiple domain resource types
(RDFS classes) and so the RDFS contains more than one seeAlso for these
properties. Dealing with multiple seeAlsos means that the practice of a
hyperlink from the rdfs:label to the seeAlso resource doesn't.
The seeAlsos on the owl:Ontology element are ignored and yet including
these seems useful.
The URI of the defined vocabulary elements is never explicitly included -
only the rdfs:label and namespace URI are included. If the guidance is
followed, and the RDFS is correct, concatenating these together with an
intervening "#" should yield the correct URI. Putting the URI in the HTML
seems safer.
I've modified the XSL as follows:
headings are no longer hyperlinks - they are the rdfs:label only
there is a See Also section for each vocabulary element and the
ontology itself which contains all of the see alsos.
URIs are explicit (the rdf:about of the vocabulary element)
some minor cosmetics - like separating out classes from properties
in the summary section
By way of example, here is the CM vocabulary HTML with this new XSL [3] -
c.f. the current one at [4].
I have two questions: would folk object to me using this XSL for the RM
vocabulary? Would we prefer this XSL for all the vocabularies?
regards
-ian
[1] http://open-services.net/bin/view/Main/OSLCCoreURINamingGuidance
[2]
http://open-services.net/pub/Main/OSLCCoreURINamingGuidance/Vocabulary.xsl
[3] http://open-services.net/bin/view/Sandbox/CmAltVocab
[4] http://open-services.net/bin/view/Main/CmVocabulary
Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number
741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-core_open-services.net/attachments/20110308/e8bebaab/attachment-0003.html>
More information about the Oslc-Core
mailing list