Strange Results from XSD Documentation Generator
I'm trying to use the XSD Documentation Generator on a flattened XSD generated using the NekoDTD tool from a DITA specialization (in this a slightly modified version of the element_ref topic type from the element_ref plug-in). I'm generating the documentation chunked but not processing included or imported schemas (because there aren't any). I'm also turning JavaScript off. However, in my generated HTML I see two things: 1. All the textual links to used element types look like this: <a title=""titlealts" element declaration could not be found." href="javascript:void(0)" onclick="alert('"titlealts" element declaration could not be found.');"> 2. For some elements (e.g., element_ref) the area map for the schema diagram is empty but it is correctly generated for other types. I have not specified a links file because it shouldn't be need since I'm only processing one flattened schema. Any idea what might be going on? I can provide the XSD I'm processing. Cheers, Eliot -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 610.631.6770 www.reallysi.com www.rsuitecms.com
Eliot Kimber wrote:
I have not specified a links file because it shouldn't be need since I'm only processing one flattened schema.
I just noticed that if I select "Generate documentation for included and imported schemas" the the links file field is *deactivated* but if I select select "Only for this schema" then it's activated. Looks like a bug in the GUI. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 610.631.6770 www.reallysi.com www.rsuitecms.com
Hello, No, it is not a bug. When you select that option the links file field is disabled because it is composed automatically and internally by the code that generates the schema documentation. When you select the other option ("Generate documentation only for this schema") the checkboxes "Search Included Schemas" and "Search Imported Schemas" and the links file field are enabled. This is useful in case the XSD from the Input field is a frequently modified container schema that includes/imports other large schemas. If only the container schema is frequently modified you will want to regenerate only the documentation for this XSD file and use a links file for linking it with the included/imported schemas because repeating the generation process for the whole schema will be too long for large size included/imported ones. Regards, Sorin Eliot Kimber wrote:
I just noticed that if I select "Generate documentation for included and imported schemas" the the links file field is *deactivated* but if I select select "Only for this schema" then it's activated.
Looks like a bug in the GUI.
Hello, Please provide the XSD file. It looks like a bug in the code for generating the schema documentation. Regards, Sorin Eliot Kimber wrote:
1. All the textual links to used element types look like this:
<a title=""titlealts" element declaration could not be found." href="javascript:void(0)" onclick="alert('"titlealts" element declaration could not be found.');">
2. For some elements (e.g., element_ref) the area map for the schema diagram is empty but it is correctly generated for other types.
I have not specified a links file because it shouldn't be need since I'm only processing one flattened schema.
Any idea what might be going on? I can provide the XSD I'm processing.
participants (2)
-
Eliot Kimber -
Sorin Ristache