Parameter/Group |
Name / Type / Description |
|
Overview Frame
|
nav.overviewFrame : boolean
Specify whether to generate the
Overview Frame,
which contains the primary navigation lists (such as the lists of namespaces and XML schemas that have been documented).
This might be more important for big XML schema projects (with multiple schemas/namespaces).
For a small XML schema or when you generate some specialized documentation,
you may find that the Overview Frame
is redundant.
|
|
List Frame
|
nav.listFrame : enum {"allcomps", "namespace", "schema"}
This parameter allows you to customize the initial content of the
List Frame,
which is used to display one of the second-level
component navigation lists (pages)
associated with a particular selection in the
Overview Frame.
Possible Choices:
- "All Components"
-
Load the first the
All Components
page with the list of all global components and local elements defined throughout all XML schemas being documented.
Using the “Navigation | List Frame | All Components”
parameters, you can customize precisely what is included in that list (as well as how it is sorted).
- "Namespace Components"
-
This selection will cause loading the first a
Namespace Components
page with the list of all components that belong to one of the documented namespaces.
There may be several such pages -- a separate component list for each namespace.
Among them, the one will be loaded that was generated the first. This is controlled by the
“Generate Details | Sorting | Namespaces” parameter.
- "Schema Components"
-
This selection will cause loading the first a
Schema Components
page with the list of components defined in one of the documented XML schemas.
There may be several such pages -- a separate component list for each XML schema.
Among them, the one will be loaded that was generated the first. This is controlled by the
“Generate Details | Sorting | Schemas” parameter.
- Note:
-
When the specified component list (HTML page) is not available (has not been generated),
by default, the initially loaded document is chosen according to the following priority list:
- All Components
- Namespace Components
- Schema Components
- Nested Parameters:
-
Control the generation in content of the particular navigation lists loaded in the
List Frame.
|
|
All Components
|
nav.listFrame.allcomps : boolean
Specify whether to generate the
All Components
navigation list (page).
Nested Parameters:
Control the generation of the page content (see below).
|
|
Link To
|
nav.listFrame.allcomps.linkTo : enum {"details", "xml_source"}
With this parameter you can choose the destination of the component hyperlinks.
Possible Choices:
- "Component Details"
-
All component hyperlinks will go to the component details,
which are the Component Documentation
pages generated for each component.
- "XML Source"
-
In this case, each component hyperlink will be directed to the definition
of this component within the reproduced full
XML schema source.
That effectively will allow you to use the component list as an index to your XML schema source.
Note that the full XML schema source is reproduced on the
Schema Overview page.
Notes:
-
When a particular hyperlink destination corresponding to this parameter setting
does not exist (has not been generated), an alternative destination will be tried
(e.g. the component's XML source instead of the
Component Documentation
and vice-versa).
-
All pages loaded by the component hyperlinks will be targeted to the
Detail Frame.
|
|
Sorting
|
nav.listFrame.allcomps.sorting : boolean
With this parameter you can specify the sorting order of components (within each component type group).
The exact meaning of this parameter is the same as of
“Generate Details | Sorting | Components”
parameter, from which it also inherits its default value.
|
|
Elements
Local Elements
Complex Types
Simple Types
Element Groups
Global Attributes
Attribute Groups
|
nav.listFrame.allcomps.elements : boolean
nav.listFrame.allcomps.element.local : enum {"all", "complexType", "none"}
nav.listFrame.allcomps.complexTypes : boolean
nav.listFrame.allcomps.simpleTypes : boolean
nav.listFrame.allcomps.groups : boolean
nav.listFrame.allcomps.attributes : boolean
nav.listFrame.allcomps.attributeGroups : boolean
Specify whether to include in the list the components of particular types.
Note:
The default values of these parameters are copied dynamically from the values of the
respective parameters in
“Generate Details” group
(e.g. “Generate Details | Elements”).
|
|
Namespace Components
|
nav.listFrame.namespace : boolean
Specify whether to generate
Namespace Components
navigation lists (pages).
Nested Parameters:
Control the generation of the page content;
similar to “All Components” parameter group.
|
|
Schema Components
|
nav.listFrame.schema : boolean
Specify whether to generate
Schema Components
navigation lists (pages).
Nested Parameters:
Control the generation of the page content;
similar to “All Components” parameter group.
|
|
Detail Frame
|
nav.detailFrame : enum {"overview", "allcomps", "namespace", "schema"}
This parameter allows you to customize the initial content of the
Detail Frame,
which is used to display the actual documentation content.
Possible Choices:
- "Overview Summary"
-
Load the first the Overview Summary page.
- "All Component Summary"
-
Load the first the All Component Summary page.
- "Namespace Overview"
-
This selection will cause loading the first some of the
Namespace Overview pages.
The documentation may contain several such pages -- a separate page for each namespace.
Among them the one will be loaded which has been generated the first.
This is controlled by the
“Generate Details | Sorting | Namespaces” parameter.
- "Schema Overview"
-
This selection will cause loading the first some of the
Schema Overview pages.
The documentation may contain several such pages -- a separate page for each XML schema.
Among such pages the one will be loaded which has been generated the first.
This is controlled by the
“Generate Details | Sorting | Schemas” parameter.
- Note:
-
When the specified page is not available (has not been generated),
by default, the initially loaded document is chosen according to the
following priority list:
- Overview Summary
- All Component Summary
- Namespace Overview
- Schema Overview
- Component Documentation
- Namespace Bindings Report
|