Options - Module Settings - XML Schema Editor - Documentation

 

The XSD Documentation tab is available only in Stylus Studio XML Enterprise Edition and Stylus Studio XML Professional Edition.

You use the Documenation page of the Options dialog box to specify the layout and contents of the XML Schema documentation displayed on the Documentation tab of the XML Schema Editor.

Fields

Documentation Style

Determines the format that Stylus Studio uses to display and print the XML Schema shown on the Documentation tab. The default is XS3P. A sample is shown here:

Figure 417. XS3P XML Schema Display Style

Options - XS3P

Note that options vary based on the documentation style you select. The following options pertain to the XS3P style.

baseURL

The base URL used to resolve links in the XML Schema.

base_IMG_URL

The base URL used to resolve diagrams in the XML Schema documentation.

DEFAULT_DOCUMENT_EXT

The extension you want to use for the saved XML Schema documentation. The default is .html.

externalCSSURL

The external CSS stylesheet used to render the XML Schema documentation. If no value is specified, Stylus Studio uses internally-declared CSS properties.

linksFile

URL of an XML document that maps the XML Schema's URL to the related documentation URL for imported and included schemas.

printAllSubTypes

Controls which sub-types are displayed in the XML Schema documentation.

  • True - All sub-types that appear in the XML Instance Representation tables in the XML Schema documentation are displayed.
  • False - Only direct sub-types are displayed.

printAllSuperTypes

Controls which super-types are displayed in the XML Schema documentation.

  • True - All super-types that appear in the XML Instance Representation tables in the XML Schema report are displayed.
  • False - Only direct super-types are displayed.

printDiagram

    • True - Displays/ schema diagrams in the XML Schema documentation.
    • False - Does not display schema diagrams in the XML Schema documentation.

print Glossary

    • True - Displays the XML Schema documentation's Glossary.
    • False - Does not display the XML Schema documentation's Glossary.

Tip

 

You can hide the Glossary by clicking the Printer-friendly Version check box.

printLegend

    • True - Displays the XML Schema documentation's Legend.
    • False - Does not display the XML Schema documentation's Legend.

Tip

 

You can hide the Legend by clicking the Printer-friendly Version check box.

printNSPrefixes

    • True - Displays the prefix that matches the namespace of schema components in XML Instance Representation tables.
    • False - Prefixes of matching namespaces are not displayed.

searchImportedSchemas

    • True - `imported' schemas are searched for schema components when generating links and XML Instance Representation tables.
    • False - `imported' schemas are not searched.

searchIncludedSchemas

    • True - `included' schemas are searched for schema components when generating links and XML Instance Representation tables.
    • False - `included' schemas are not searched.

sortByComponent

Determines how report content is sorted:

  • True - Sorts the top-level schema components by type, then name.
  • False - Displays the components in the order in which they appear in the schema.

title

The title of the XML Schema documentation. The default, which is not displayed in the Options dialog box, is XML Schema Documentation.

useJavaScript

Some Internet browsers do not support JavaScript. This option allows you to specify whether you want Stylus Studio to generate the XML Schema documentation as plain HTML or as HTML plus JavaScript.

Options - XSDDOC

Note that options vary based on the documentation style you select. The following options pertain to the XSDdoc style.

Doctitle

Document title. The text you enter here is displayed on the overview page ( index.html).

Footer

The text you enter here is displayed at the bottom of every page. The default is http://www.stylusstudio.com.

Header

The text you enter here is displayed in the Namespaces frame (if you are displaying the XML Schema documentation using frames) and in the navigational header that appears at the top and bottom of every page, an example of which is shown here:

Figure 418. XSDdoc Header Text

HideAttributes

Whether or not attributes are hidden in the XML Schema documentation.

  • True - Attributes are hidden in the XML Schema documentation.
  • False - Attributes are not hidden in the XML Schema documentation. This is the default.

HideGroups

Whether or not groups are hidden in the XML Schema documentation.

  • True - Groups are hidden in the XML Schema documentation.
  • False - Groups are not hidden in the XML Schema documentation. This is the default.

HideLocalUsage

Whether or not local type definitions are hidden in the XML Schema documentation.

  • True - Local type definitions are hidden in the XML Schema documentation.
  • False - Local type definitions are not hidden in the XML Schema documentation. This is the default.

HideSubTypes

Whether or not subtypes are hidden in the XML Schema documentation.

  • True - Subtypes are hidden in the XML Schema documentation.
  • False - Subtypes are not hidden in the XML Schema documentation. This is the default.

HideTypes

Whether or not ypes are hidden in the XML Schema documentation.

  • True - Types are hidden in the XML Schema documentation.
  • False - Types are not hidden in the XML Schema documentation. This is the default.

ProxyHost

The name or network address of the proxy host server. The proxy host, if needed in your environment, is used to access the Internet in order to resolve imported or included stylesheets.

ProxyPort

The port on the proxy server to which Stylus Studio attaches.

Description

Displays a description of the currently selected option.

For More Information

Generating Documentation for XML Schema

Printing XML Schema Documentation

 
Free Stylus Studio XML Training: