Annotated Stylesheets Project

The annotated stylesheets project is an open source project under the Apache 2.0 license, brought to you by the WSO2 Oxygen Tank.  The purpose is to provide an easily-navigable XML source view of the XML representing vocabularies such as WSDL 2.0, WSDL 1.1, and XML Schema 1.0.  The underlying model for vocabularies is a graph, and thus their XML serializations, of necessity trees, have a significant number of references, especially QName references.  Stylesheets aware of the particular referencing mechanism in the vocabulary can augment the source view not only with pretty-printing and color coding, but also with hyperlinked references, back-links, tables of contents, and indexes.

To see what the annotations look like, try out the Schema for Schemas example with the annotations applied.

Resources

The project consists of the following resources:

·         annotated-wsdl2.xsl (for WSDL 2.0 documents)

·         annotated-wsdl.xsl (for WSDL 1.1 documents)

·         annotated-xsd.xsl (for XML Schema 1.0 documents)

·         XMLSchema.xsd, XMLSchema.dtd, datatypes.dtd (schema for schemas supports hyperlinks to annotated display for built-in datatypes.)

Note that both of the annotated WSDL stylesheets depend upon the annotated-xsd.xsl for the display of inline XML Schema.  All of the stylesheets depend upon the availability of the XMLSchema.xsd for hyperlinked display of built-in datatypes.  On IE, the XMLSchema.xsd depends on the XMLSchema.dtd and datatypes.dtd to parse and display properly.

Applying the stylesheets

To apply the a stylesheet to a WSDL 2.0 document in an XML-aware browser, insert the following processing instruction before the first element:

<?xml-stylesheet type="text/xsl" href="http://wso2.org/repos/wso2/trunk/commons/annotated-stylesheets/annotated-wsdl2.xsl"?>

 

To apply the a stylesheet to a WSDL 1.1 document in an XML-aware browser, insert the following processing instruction before the first element:

<?xml-stylesheet type="text/xsl" href="http://wso2.org/repos/wso2/trunk/commons/annotated-stylesheets/annotated-wsdl.xsl"?>

 

To apply the a stylesheet to a XML Schema 1.0 document in an XML-aware browser, insert the following processing instruction before the first element:

<?xml-stylesheet type="text/xsl" href="http://wso2.org/repos/wso2/trunk/commons/annotated-stylesheets/annotated-xsd.xsl"?>

Or, install the stylesheets locally and refer to them instead.

Downloading the stylesheets.

Just grab the stylesheets from http://wso2.org/repos/wso2/trunk/commons/annotated-stylesheets/, taking into account the dependencies listed above.

Jonathan Marsh
jonathan@wso2.com
June 2007.