WADL documentation stylesheet fails with Amazon item search example in WADL spec

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

WADL documentation stylesheet fails with Amazon item search example in WADL spec

Matson Wade

I’m considering using WADL, but only if I can generate reasonable documentation. So as a test of the WADL-to-HTML documentation stylesheet, I took the “Amazon Item Search” example from the appendix of the WADL spec and tried to transform it using “wadl_documentation.xls”. The transformation failed with both XMLSpy and Oxygen. The error I received in XMLSpy is on line 169 of the XSLT: “Function not in namespace, Error in XPath expression, Function not in namespace”. Has this stylesheet been used at all beyond the Yahoo example? Is it possible to fix the stylesheet so that it works with the examples from the spec?

 

-- Matson

Reply | Threaded
Open this post in threaded view
|

Re: WADL documentation stylesheet fails with Amazon item search example in WADL spec

Mark Nottingham-4


On 30/10/2008, at 12:24 PM, Matson Wade wrote:

> I’m considering using WADL, but only if I can generate reasonable  
> documentation. So as a test of the WADL-to-HTML documentation  
> stylesheet, I took the “Amazon Item Search” example from the  
> appendix of the WADL spec and tried to transform it using  
> “wadl_documentation.xls”.

What version of the stylesheet are you using? The Amazon example in  
the spec is uses the 07 namespace, but it appears to be using the 10  
syntax; Marc?


> The transformation failed with both XMLSpy and Oxygen. The error I  
> received in XMLSpy is on line 169 of the XSLT: “Function not in  
> namespace, Error in XPath expression, Function not in namespace”.

What XSLT processor did you use? Oxygen, at least, can use a variety.  
The instructions clearly say that EXSLT support is required.

If I change the namespace to 10 and run it with saxon against the 10  
stylesheet (the 07 stylesheet isn't supported any more), I get;

~> saxon amazon.xml http://www.mnot.net/webdesc/ 
wadl_tation-2006-10.xsl > amazon.html
Warning: at xsl:stylesheet on line 40 of http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 
:
   Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor
Error on line 173 of http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 
:
   FODC0005: java.io.FileNotFoundException: AWSECommerceService.xsd  
(No such file or directory)

The warning about XSLT 1.0 can be ignored; the error is because I  
haven't bothered to download Amazon's schema. The HTML it produces  
looks right, taking this into account.


> Has this stylesheet been used at all beyond the Yahoo example?

I'm aware of a fair number of people who use it to document services,  
both inside my company and outside.

> Is it possible to fix the stylesheet so that it works with the  
> examples from the spec?


I think it's more a matter of fixing the example, at least in this case.


--
Mark Nottingham       [hidden email]



Reply | Threaded
Open this post in threaded view
|

Re: WADL documentation stylesheet fails with Amazon item search example in WADL spec

Marc Hadley

My bad, it looks like I forgot to update the namespace declarations in  
the examples in appendix A.

Marc.

On Oct 30, 2008, at 6:09 AM, Mark Nottingham wrote:

>
>
> On 30/10/2008, at 12:24 PM, Matson Wade wrote:
>
>> I’m considering using WADL, but only if I can generate reasonable  
>> documentation. So as a test of the WADL-to-HTML documentation  
>> stylesheet, I took the “Amazon Item Search” example from the  
>> appendix of the WADL spec and tried to transform it using  
>> “wadl_documentation.xls”.
>
> What version of the stylesheet are you using? The Amazon example in  
> the spec is uses the 07 namespace, but it appears to be using the 10  
> syntax; Marc?
>
>
>> The transformation failed with both XMLSpy and Oxygen. The error I  
>> received in XMLSpy is on line 169 of the XSLT: “Function not in  
>> namespace, Error in XPath expression, Function not in namespace”.
>
> What XSLT processor did you use? Oxygen, at least, can use a  
> variety. The instructions clearly say that EXSLT support is required.
>
> If I change the namespace to 10 and run it with saxon against the 10  
> stylesheet (the 07 stylesheet isn't supported any more), I get;
>
> ~> saxon amazon.xml http://www.mnot.net/webdesc/wadl_tation-2006-10.xsl 
>  > amazon.html
> Warning: at xsl:stylesheet on line 40 of http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 
> :
>  Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor
> Error on line 173 of http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 
> :
>  FODC0005: java.io.FileNotFoundException: AWSECommerceService.xsd  
> (No such file or directory)
>
> The warning about XSLT 1.0 can be ignored; the error is because I  
> haven't bothered to download Amazon's schema. The HTML it produces  
> looks right, taking this into account.
>
>
>> Has this stylesheet been used at all beyond the Yahoo example?
>
> I'm aware of a fair number of people who use it to document  
> services, both inside my company and outside.
>
>> Is it possible to fix the stylesheet so that it works with the  
>> examples from the spec?
>
>
> I think it's more a matter of fixing the example, at least in this  
> case.
>
>
> --
> Mark Nottingham       [hidden email]
>
>
>

---
Marc Hadley <marc.hadley at sun.com>
CTO Office, Sun Microsystems.



Reply | Threaded
Open this post in threaded view
|

RE: WADL documentation stylesheet fails with Amazon item search example in WADL spec

Matson Wade

Marc/Mark,

Thanks for the quick response! The namespace was indeed the problem.
When I changed it to "10", then I was able to use Oxygen to create the
HTML documentation. Unfortunately, XMLSpy still fails, but the error it
generates (on line 173, "Error in function document, Could not find
external entity") is due to not finding the Amazon schema. Thanks again
for your help!

-- Matson

-----Original Message-----
From: [hidden email] [mailto:[hidden email]]
Sent: Thursday, October 30, 2008 5:21 AM
To: Mark Nottingham
Cc: Matson Wade; [hidden email]
Subject: Re: WADL documentation stylesheet fails with Amazon item search
example in WADL spec

My bad, it looks like I forgot to update the namespace declarations in  
the examples in appendix A.

Marc.

On Oct 30, 2008, at 6:09 AM, Mark Nottingham wrote:

>
>
> On 30/10/2008, at 12:24 PM, Matson Wade wrote:
>
>> I'm considering using WADL, but only if I can generate reasonable  
>> documentation. So as a test of the WADL-to-HTML documentation  
>> stylesheet, I took the "Amazon Item Search" example from the  
>> appendix of the WADL spec and tried to transform it using  
>> "wadl_documentation.xls".
>
> What version of the stylesheet are you using? The Amazon example in  
> the spec is uses the 07 namespace, but it appears to be using the 10  
> syntax; Marc?
>
>
>> The transformation failed with both XMLSpy and Oxygen. The error I  
>> received in XMLSpy is on line 169 of the XSLT: "Function not in  
>> namespace, Error in XPath expression, Function not in namespace".
>
> What XSLT processor did you use? Oxygen, at least, can use a  
> variety. The instructions clearly say that EXSLT support is required.
>
> If I change the namespace to 10 and run it with saxon against the 10  
> stylesheet (the 07 stylesheet isn't supported any more), I get;
>
> ~> saxon amazon.xml
http://www.mnot.net/webdesc/wadl_tation-2006-10.xsl 
>  > amazon.html
> Warning: at xsl:stylesheet on line 40 of
http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 
> :
>  Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor
> Error on line 173 of
http://www.mnot.net/webdesc/wadl_documentation-2006-10.xsl 

> :
>  FODC0005: java.io.FileNotFoundException: AWSECommerceService.xsd  
> (No such file or directory)
>
> The warning about XSLT 1.0 can be ignored; the error is because I  
> haven't bothered to download Amazon's schema. The HTML it produces  
> looks right, taking this into account.
>
>
>> Has this stylesheet been used at all beyond the Yahoo example?
>
> I'm aware of a fair number of people who use it to document  
> services, both inside my company and outside.
>
>> Is it possible to fix the stylesheet so that it works with the  
>> examples from the spec?
>
>
> I think it's more a matter of fixing the example, at least in this  
> case.
>
>
> --
> Mark Nottingham       [hidden email]
>
>
>

---
Marc Hadley <marc.hadley at sun.com>
CTO Office, Sun Microsystems.