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.
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.
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.
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.