Products         Services         Customers         News         Downloads         Licensing         Shop    

 DocFlex Technology
About
Features
Documentation
 DocFlex/XML
About
Documentation
Samples
XSDDoc
Features
Organization
Examples
Templates
Subtemplates
Parameters
FAQ
Integrations
Tutorials
 DocFlex/Javadoc
About
Documentation
Basic Templates
JavadocPro
Examples
Tutorials
 DocFlex/Together
About
Examples
Basic Templates
Documentation
Tutorials
 Try
Downloads
Registration
Trial License
 Buy
Licensing/Pricing
Shop
 Company
News
Products
Services
Customers
About Us
Imprint
Legal
Contact
Links
 

DocFlex/XML - XSDDoc - Parameters

About XSDDoc parameters

Parameter Tree


“Navigation” parameter group

This group of parameter controls the generation of the frameset and various navigation lists used in Framed HTML Documentation.

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:
  1. All Components
  2. Namespace Components
  3. 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:
  1. Overview Summary
  2. All Component Summary
  3. Namespace Overview
  4. Schema Overview
  5. Component Documentation
  6. Namespace Bindings Report

Copyright© 2003-2012 Filigris Works, Leonid Rudy Softwareprodukte. All rights reserved.