Creating a DocBook from WSDL?

[nuwandame]

Is there a way to generate WSDL documentation from within Oxygen?

[Radu]

Hello.

I understand from your post that you want to take a WSDL document and generate HTML documentation from it by extracting it's basic structure and any documentation annotations it may continue.

Oxygen 5.0 has included in the "samples/wsdl/" folder a "doc-generator.xsl" stylesheet. Just open any WSDL file, and transform it using the stylesheet.
This will generate HTML documentation from your WSDL file.

If the result does not correspond to your needs, just modify the stylesheet or let us know what improvements you would like in the future.

Regards, Radu.

[nuwandame]

That gets me what I was looking for .. Thank you =)

[maximAL]

It seems that stylesheet is gone in Oxygen 15. Is there a replacement available somewhere else? I suspect there are more people who want to generate DocBook from WSDL, so I'm suprised I could not find anything online.

[adrian]

Hi,

The original post (from 2004) refers to Oxygen 5. 10 years and 10 versions later things have changed significantly.
Oxygen now has a documentation generator tool for WSDL. You can use it from menu > Tools > Generate Documentation > WSDL Documentation. It's also available as a command line tool: wsdlDocumentation(.bat/.sh/Mac.sh)

If you need just the XSL stylesheet, it's now located in Oxygen/frameworks/wsdl_documentation/xsl/ and named wsdlDocHtml.xsl.

Note that in either case this produces documentation in HTML format, not DocBook as the title of this topic implies.

Regards,
Adrian

[maximAL]

Thank you, I found the XSL stylesheet, but not the Generate Documentation functionality. Are you sure this is available in Oxygen 15? I only found it in the documentation for version 16.

[adrian]

Yes, v15 includes this in the Tools menu, but note that it's only available in Oxygen XML Editor and Oxygen XML Developer.
Oxygen XML Author does not have this functionality, since it doesn't have support for editing WSDL.

Regards,
Adrian