User login

[commons-dev] FW: [Wsf-general] Annotated stylesheets project

Forums :

Oops, should have posted here
instead…

 

Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com

 

From:
wsf-general-bounces@wso2.org [mailto:wsf-general-bounces@wso2.org] On Behalf
Of Jonathan Marsh

Sent: Wednesday, April 18, 2007 11:14 AM

To: wsf-general@wso2.org

Subject: [Wsf-general] Annotated stylesheets project

 

As some of us had talked about a while back, I’ve created a
new “annotated-stylesheets” directory within wso2/trunk/commons, holding at
present the three files:

-         
annotated-wsdl.xsl

-         
annotated-wsdl2.xsl

-         
annotated-xsd.xsl

 

This directory structure makes it easier to share these
stylesheets for non-WSAS usage, and allows me to make fixes without
destabilizing the WSAS or Mashup builds.  I trust that the latest versions
of the stylesheets can be picked up from the new location at appropriate times
(I couldn’t get the nightly WSAS build to launch far enough to verify that we’d
moved to the new namespace or not, and so was fearful of checking in changes
directly.)

 

These latest versions also work on schemas without
targetNamespaces, and on WSDL 2.0 documents using the final namespace.  I
made the Apache license clearer in the comments as well.

 

Jonathan
Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com

 

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

[commons-dev] FW: [Wsf-general] Annotated stylesheets project

Cool!

Does this also have the ability to lookup the stylesheet from the
namespace of some content? For example, if we embed RelaxNG in WSDL and
write a RelaxNG stylesheet, do we need to manually modify the WSDL
stylesheet to tackle that case or does it "just work"? I think you were
thinking about that a while back IIRC.

Sanjiva.

Jonathan Marsh wrote:
> Oops, should have posted here instead…
>
>
>
> *Jonathan Marsh* - http://www.wso2.com -
> http://auburnmarshes.spaces.live.com
>
>
>
> *From:* wsf-general-bounces@wso2.org
> [mailto:wsf-general-bounces@wso2.org] *On Behalf Of *Jonathan Marsh
> *Sent:* Wednesday, April 18, 2007 11:14 AM
> *To:* wsf-general@wso2.org
> *Subject:* [Wsf-general] Annotated stylesheets project
>
>
>
> As some of us had talked about a while back, I’ve created a new
> “annotated-stylesheets” directory within wso2/trunk/commons, holding at
> present the three files:
>
> - annotated-wsdl.xsl
>
> - annotated-wsdl2.xsl
>
> - annotated-xsd.xsl
>
>
>
> This directory structure makes it easier to share these stylesheets for
> non-WSAS usage, and allows me to make fixes without destabilizing the
> WSAS or Mashup builds. I trust that the latest versions of the
> stylesheets can be picked up from the new location at appropriate times
> (I couldn’t get the nightly WSAS build to launch far enough to verify
> that we’d moved to the new namespace or not, and so was fearful of
> checking in changes directly.)
>
>
>
> These latest versions also work on schemas without targetNamespaces, and
> on WSDL 2.0 documents using the final namespace. I made the Apache
> license clearer in the comments as well.
>
>
>
> *Jonathan Marsh* - http://www.wso2.com -
> http://auburnmarshes.spaces.live.com
>
>
>
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> Wsf-general mailing list
> Wsf-general@wso2.org
> http://wso2.org/cgi-bin/mailman/listinfo/wsf-general
>
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> Commons-dev mailing list
> Commons-dev@wso2.org
> http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

--
Sanjiva Weerawarana, Ph.D.
Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
email: sanjiva@wso2.com; cell: +94 77 787 6880; fax: +1 509 691 2000

"Oxygenating the Web Service Platform."

_______________________________________________
Commons-dev mailing list
Commons-dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

RE: [commons-dev] FW: [Wsf-general] Annotated stylesheets projec

At this point it requires manual modification. We'd either need to go
beyond XSLT for a dynamically adapted display (e.g. parse the document
looking for namespaces, generate an XSLT which imports stylesheets for the
namespaces it knows about, and then process that), or simply import every
known vocabulary into each stylesheet. In the case of WSDL with a limited
set of extensions, it's easier to go with the latter. So it would be easy
to create and import a RelaxNG stylesheet if that's a useful case.
(WS-Policy might be a better candidate though.)

I think what I was talking about earlier was that each stylesheet is tied to
a specific top-level element. So if you apply it to a doc that doesn't have
that element, you get an empty display. Bummer if you get the namespace
wrong or something - it should at least give you a non-annotated view. Some
refactoring could solve this, but I've lacked urgency in getting it done.

Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com

> -----Original Message-----
> From: commons-dev-bounces@wso2.org [mailto:commons-dev-
> bounces@wso2.org] On Behalf Of Sanjiva Weerawarana
> Sent: Wednesday, April 18, 2007 8:13 PM
> To: commons-dev@wso2.org
> Subject: Re: [commons-dev] FW: [Wsf-general] Annotated stylesheets
> project
>
> Cool!
>
> Does this also have the ability to lookup the stylesheet from the
> namespace of some content? For example, if we embed RelaxNG in WSDL and
> write a RelaxNG stylesheet, do we need to manually modify the WSDL
> stylesheet to tackle that case or does it "just work"? I think you were
> thinking about that a while back IIRC.
>
> Sanjiva.
>
> Jonathan Marsh wrote:
> > Oops, should have posted here instead.
> >
> >
> >
> > *Jonathan Marsh* - http://www.wso2.com -
> > http://auburnmarshes.spaces.live.com
> >
> >
> >
> > *From:* wsf-general-bounces@wso2.org
> > [mailto:wsf-general-bounces@wso2.org] *On Behalf Of *Jonathan Marsh
> > *Sent:* Wednesday, April 18, 2007 11:14 AM
> > *To:* wsf-general@wso2.org
> > *Subject:* [Wsf-general] Annotated stylesheets project
> >
> >
> >
> > As some of us had talked about a while back, I've created a new
> > "annotated-stylesheets" directory within wso2/trunk/commons, holding
> at
> > present the three files:
> >
> > - annotated-wsdl.xsl
> >
> > - annotated-wsdl2.xsl
> >
> > - annotated-xsd.xsl
> >
> >
> >
> > This directory structure makes it easier to share these stylesheets
> for
> > non-WSAS usage, and allows me to make fixes without destabilizing the
> > WSAS or Mashup builds. I trust that the latest versions of the
> > stylesheets can be picked up from the new location at appropriate
> times
> > (I couldn't get the nightly WSAS build to launch far enough to verify
> > that we'd moved to the new namespace or not, and so was fearful of
> > checking in changes directly.)
> >
> >
> >
> > These latest versions also work on schemas without targetNamespaces,
> and
> > on WSDL 2.0 documents using the final namespace. I made the Apache
> > license clearer in the comments as well.
> >
> >
> >
> > *Jonathan Marsh* - http://www.wso2.com -
> > http://auburnmarshes.spaces.live.com
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> ---
> >
> > _______________________________________________
> > Wsf-general mailing list
> > Wsf-general@wso2.org
> > http://wso2.org/cgi-bin/mailman/listinfo/wsf-general
> >
> >
> > ---------------------------------------------------------------------
> ---
> >
> > _______________________________________________
> > Commons-dev mailing list
> > Commons-dev@wso2.org
> > http://wso2.org/cgi-bin/mailman/listinfo/commons-dev
>
> --
> Sanjiva Weerawarana, Ph.D.
> Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
> email: sanjiva@wso2.com; cell: +94 77 787 6880; fax: +1 509 691 2000
>
> "Oxygenating the Web Service Platform."
>
> _______________________________________________
> Commons-dev mailing list
> Commons-dev@wso2.org
> http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

_______________________________________________
Commons-dev mailing list
Commons-dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

[commons-dev] FW: [Wsf-general] Annotated stylesheets project

Jonathan Marsh wrote:
>
> I think what I was talking about earlier was that each stylesheet is tied to
> a specific top-level element. So if you apply it to a doc that doesn't have
> that element, you get an empty display. Bummer if you get the namespace
> wrong or something - it should at least give you a non-annotated view. Some
> refactoring could solve this, but I've lacked urgency in getting it done.

+1 for no urgency .. if its a problem for someone let's wait for them to
send a patch ;-).

It would be good to record an enhancement JIRA against this so we don't
forget it and so anyone looking at this knows how they can contribute
towards improving it.

Sanjiva.
--
Sanjiva Weerawarana, Ph.D.
Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
email: sanjiva@wso2.com; cell: +94 77 787 6880; fax: +1 509 691 2000

"Oxygenating the Web Service Platform."

_______________________________________________
Commons-dev mailing list
Commons-dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

RE: [commons-dev] FW: [Wsf-general] Annotated stylesheets projec

I opened a few issues pertaining to this:

https://www.wso2.org/jira/browse/COMMONS-1
https://www.wso2.org/jira/browse/COMMONS-2
https://www.wso2.org/jira/browse/COMMONS-3

The other way to drive community participation is to list it as a commons
project on wso2.org instead of just in the SVN.

OT:

Can we add the annotated stylesheets as a separate item on
http://wso2.org/projects/commons?

Here's a blurb for it:

"The annotated stylesheets project is a set of stylesheets that, when
applied to one of the supported XML vocabularies, provides a formatted view
of the XML source, annotated with crosslinks, backlinks, and indexes
appropriate for the vocabulary.

"For instance, in WSDL and XML Schema, QNames are used to refer to
components - the annotated stylesheet displays these QNames as hyperlinks,
and the targets of hyperlinks are annotated with backlinks. This makes
navigating XML Schema and WSDL documents quick and productive!

"The goals of the project are to make these stylesheets available outside
the WSO2 family of products, and extend this style of source display to
other popular known XML vocabularies.

"The annotated stylesheets are released under Apache License v2.0."

Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com

> -----Original Message-----
> From: commons-dev-bounces@wso2.org [mailto:commons-dev-
> bounces@wso2.org] On Behalf Of Sanjiva Weerawarana
> Sent: Monday, April 30, 2007 5:21 PM
> To: commons-dev@wso2.org
> Subject: Re: [commons-dev] FW: [Wsf-general] Annotated stylesheets
> project
>
> Jonathan Marsh wrote:
> >
> > I think what I was talking about earlier was that each stylesheet is
> tied to
> > a specific top-level element. So if you apply it to a doc that
> doesn't have
> > that element, you get an empty display. Bummer if you get the
> namespace
> > wrong or something - it should at least give you a non-annotated
> view. Some
> > refactoring could solve this, but I've lacked urgency in getting it
> done.
>
> +1 for no urgency .. if its a problem for someone let's wait for them
> to
> send a patch ;-).
>
> It would be good to record an enhancement JIRA against this so we don't
> forget it and so anyone looking at this knows how they can contribute
> towards improving it.
>
> Sanjiva.
> --
> Sanjiva Weerawarana, Ph.D.
> Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
> email: sanjiva@wso2.com; cell: +94 77 787 6880; fax: +1 509 691 2000
>
> "Oxygenating the Web Service Platform."
>
> _______________________________________________
> Commons-dev mailing list
> Commons-dev@wso2.org
> http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

_______________________________________________
Commons-dev mailing list
Commons-dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

RE: [commons-dev] FW: [Wsf-general] Annotated stylesheets projec

Yes please!

Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com

> -----Original Message-----
> From: commons-dev-bounces@wso2.org [mailto:commons-dev-
> bounces@wso2.org] On Behalf Of saminda abeyruwan
> Sent: Thursday, May 03, 2007 11:24 PM
> To: commons-dev@wso2.org
> Subject: Re: [commons-dev] FW: [Wsf-general] Annotated stylesheets
> project
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi,
>
> To get theses annotated stylesheets embedded into a project ex: WSAS,
> we
> need to get them as an artifact (a zip perhaps), most preferably a
> Maven2 artifact. Shall I include a single pom.xml in here to crate a
> annotated-stylesheets-.zip under the group id
> "org.wso2.annotated-stylesheets" and artifact id
> "annotated-stylesheets" with the truck version as SNAPSHOT. Thus, in
> the
> case of WSAS we could remove the annotated stylesheets it has and use
> the stylesheets coming from annotated-stylesheets-SNAPSHOT.zip.
>
> Thank you
>
> Saminda
>
> Jonathan Marsh wrote:
> > Sanjiva:
> >
> > I opened a few issues pertaining to this:
> >
> > https://www.wso2.org/jira/browse/COMMONS-1
> > https://www.wso2.org/jira/browse/COMMONS-2
> > https://www.wso2.org/jira/browse/COMMONS-3
> >
> > The other way to drive community participation is to list it as a
> commons
> > project on wso2.org instead of just in the SVN.
> >
> >
> > OT:
> >
> > Can we add the annotated stylesheets as a separate item on
> > http://wso2.org/projects/commons?
> >
> > Here's a blurb for it:
> >
> > "The annotated stylesheets project is a set of stylesheets that, when
> > applied to one of the supporteed XML vocabularies, provides a
> formatted view
> > of the XML source, annotated with crosslinks, backlinks, and indexes
> > appropriate for the vocabulary.
> >
> > "For instance, in WSDL and XML Schema, QNames are used to refer to
> > components - the annotated stylesheet displays these QNames as
> hyperlinks,
> > and the targets of hyperlinks are annotated with backlinks. This
> makes
> > navigating XML Schema and WSDL documents quick and productive!
> >
> > "The goals of the project are to make these stylesheets available
> outside
> > the WSO2 family of products, and extend this style of source display
> to
> > other popular known XML vocabularies.
> >
> > "The annotated stylesheets are released under Apache License v2.0."
> >
> >
> > Jonathan Marsh - http://www.wso2.com -
> http://auburnmarshes.spaces.live.com
> >
> >
> >> -----Original Message-----
> >> From: commons-dev-bounces@wso2.org [mailto:commons-dev-
> >> bounces@wso2.org] On Behalf Of Sanjiva Weerawarana
> >> Sent: Monday, April 30, 2007 5:21 PM
> >> To: commons-dev@wso2.org
> >> Subject: Re: [commons-dev] FW: [Wsf-general] Annotated stylesheets
> >> project
> >>
> >> Jonathan Marsh wrote:
> >>> I think what I was talking about earlier was that each stylesheet
> is
> >> tied to
> >>> a specific top-level element. So if you apply it to a doc that
> >> doesn't have
> >>> that element, you get an empty display. Bummer if you get the
> >> namespace
> >>> wrong or something - it should at least give you a non-annotated
> >> view. Some
> >>> refactoring could solve this, but I've lacked urgency in getting it
> >> done.
> >>
> >> +1 for no urgency .. if its a problem for someone let's wait for
> them
> >> to
> >> send a patch ;-).
> >>
> >> It would be good to record an enhancement JIRA against this so we
> don't
> >> forget it and so anyone looking at this knows how they can
> contribute
> >> towards improving it.
> >>
> >> Sanjiva.
> >> --
> >> Sanjiva Weerawarana, Ph.D.
> >> Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
> >> email: sanjiva@wso2.com; cell: +94 77 787 6880; fax: +1 509 691 2000
> >>
> >> "Oxygenating the Web Service Platform."
> >>
> >> _______________________________________________
> >> Commons-dev mailing list
> >> Commons-dev@wso2.org
> >> http://wso2.org/cgi-bin/mailman/listinfo/commons-dev
> >
> >
> > _______________________________________________
> > Commons-dev mailing list
> > Commons-dev@wso2.org
> > http://wso2.org/cgi-bin/mailman/listinfo/commons-dev
> >
>
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.2.2 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFGOtGNYmklbLuW6wYRAse6AKCbuiddcwZjXevuL7QEFqF+qqu5JQCgnoT7
> 80MlCLSesiqLNwUL6T1NQ7Y=
> =0sx0
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Commons-dev mailing list
> Commons-dev@wso2.org
> http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

_______________________________________________
Commons-dev mailing list
Commons-dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/commons-dev

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.