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

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: Marc.Hadley@Sun.COM [mailto:Marc.Hadley@Sun.COM] 
Sent: Thursday, October 30, 2008 5:21 AM
To: Mark Nottingham
Cc: Matson Wade; public-web-http-desc@w3.org
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       mnot@yahoo-inc.com
>
>
>

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

Received on Thursday, 30 October 2008 21:48:14 UTC