SSDN - XML schema documentation generation.

XML Editor

Sign Up

Search

Options

Chat

Help

News

Log in

Not Logged in

Topic

Topic Page 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

jan iversen

Subject: XML schema documentation generation.
Author: jan iversen
Date: 17 Jan 2006 06:49 PM

Hi.

I am generating X3P documentation with the Pro version and run into a bug (I think).

I have 4 XSD files that include each other. I generate documentation at top level, and it correctly generated 4 html files.

However the item links in "XML instance representation"....does not always link to the correct file, it often links to the "current" file instead of the file that contains the defintion.

I have included the 4 XSD files, together with the generated doc. please open amis_comm.xsd.html goto "command" open instance representation and click at e.g. "type_sequenceId [1]"...this simpleType is defined in amis_types.xsd, but the url points to amis_comm.xsd.

I hope you can give me swift answer since this problem is holding up a delivery.

I thank in advance for your support.

doc.zip
Zip file with example files and XSD proj

Ivan Pedruzzi

Subject: XML schema documentation generation.
Author: Ivan Pedruzzi
Date: 17 Jan 2006 10:18 PM

Jan,

Which Stylus Studio build are you running (help -> about)?

Could you verify if serchImportedSchemas and serchIncludedSchemas are
set to true (Tools -> Options -> Module Settings -> XML Schema Editor -> Documentation)?

Thank You
Ivan Pedruzzi
Stylus Studio Team

jan iversen

Subject: XML schema documentation generation.
Author: jan iversen
Date: 18 Jan 2006 01:37 AM

Hi.

ups I forgot the version number...it is 2006 Professional version Build 501f.

Both SearchIncludedSchema and SearchImportedSchema are set to "true".
Looking at my files the setup are
amis_extern incl. amis_comm incl. amis_elements incl. amis_types.

I always generate from amis_extern, and it generates 4 html files, so it is aware of the include files.

I have now testet a bit more, and the problem seem to be isolated in amis_comm when referencing amis_types....I have controlled that the "header" are identical built in all 4 files.

I also tried to generate documentation from amis_comm and amis_comm...html still contains wrong references for all types (located in amis_types) but are ok for all elements (located in amis_elements)...

This is quite weird, I dont understand it....

thanks for your swift response

Ivan Pedruzzi

Subject: XML schema documentation generation.
Author: Ivan Pedruzzi
Date: 18 Jan 2006 03:03 PM

The problem seems to manifest only for reference to AttributeGroup components.
For instance in the global element "reply" (amis_comm.xsd.html#element_reply)
the "Schema Component Representation" has a correct link to the
AttributeGroup but the "XML Instance Representation" hyperlinks to the simple types are incorrect.

Ivan Pedruzzi
Stylus Studio Team

jan iversen

Subject: XML schema documentation generation.
Author: jan iversen
Date: 18 Jan 2006 03:23 PM

I just checked it, and it seems you are right. It is only references to attribute types.

But only in amis_comm.xsd. If you try amis_elements.xsd "elm_comm_load" and select "activateTime" it works...

Have I done something wrong or have I found a bug ?

rgds
Jan I

Ivan Pedruzzi

Subject: XML schema documentation generation.
Author: Ivan Pedruzzi
Date: 18 Jan 2006 05:23 PM

Hi Jan,

Please backup the following file

c:\Program Files\Stylus Studio 2006 XML Enterprise Edition\bin\Plugins\schema-documentation\xs3p.xsl

and copy the attached file in the same location, it should solve your problem.

Hope this helps
Ivan Pedruzzi
Stylus Studio Team

xs3p.xsl
xs3p.xsl

jan iversen

Subject: XML schema documentation generation.
Author: jan iversen
Date: 18 Jan 2006 05:46 PM

Hi Ivan.

It nearly works.

The reference is changed, but you forgot ".html" in the url:

C:\data\temp\amis\XMLlib\doc\amis_types.xsd#type_type_sequenceId

at least if I compare with other references:

file:///C:/data/temp/amis/XMLlib/doc/amis_comm.xsd.html#type_int_commModule

You seem to be expert in xs3p stylesheet, so I allow myself to insert a small extra question.

I want to print the "manual" pages, and look for a way to get printed so that each element start on top of a new page (there is a bold seperator line, which basically needs to be replaced with a form feed), do you know of a intelligent way to do this ?

rgds
Jan Iversen

Ivan Pedruzzi

Subject: XML schema documentation generation.
Author: Ivan Pedruzzi
Date: 18 Jan 2006 06:46 PM

You are right, I tested the navigation from inside Stylus instead of generating the HTML.
Try again please.

For page break you may take a look to CSS; IE supports the following attribute
http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/reference/properties/pagebreakafter.asp

It is up to you modify XS3p to change the page layout.

Ivan Pedruzzi
Stylus Studio Team

xs3p(1).xsl
XS3P

jan iversen

Subject: XML schema documentation generation.
Author: jan iversen
Date: 18 Jan 2006 07:07 PM

THANKS, it works !!!

now I will stop working for today, it is 1 after midnight here in europe (and freezing cold).

have a nice day.

Rgds
Jan I.

Topic Page 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

Powered by Stylus Studio, the world's leading XML IDE for XML, XSLT, XQuery, XML Schema, DTD, XPath, WSDL, XHTML, SQL/XML, and XML Mapping!

Go to Conference:

Log In Options Username: Password:

Site Map | Privacy Policy | Terms of Use | Trademarks

Stylus Studio® and DataDirect XQuery ™are from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2016 All Rights Reserved.