Home > Online Product Documentation > Table of Contents > XS3P Stylesheet Overview

< Previous | Next >

XS3P Stylesheet Overview

By default, Stylus Studio displays XML Schema on the Documentation tab using the XS3P stylesheet from the DSTC Project Titanium ( http://titanium.dstc.edu.au/). Figure 297 shows how the purchaseOrder.xsd looks when displayed using this stylesheet.

Figure 297. XML Schema Documentation Displayed Using XS3P Stylesheet

The XS3P stylesheet contains

  • A customizable title (the default title is XML Schema Documentation)
  • A table of contents with hypertext links to sections in the documentation
  • Information about the XML Schema's properties, such as its target namespace and any declared namespaces
  • Global declarations and global definitions, if any
  • A legend that describes the graphical conventions used in the XML Schema documentation
  • A glossary that defines terminology used in the XML Schema documentation.

Tip

 

You can hide the legend and the glossary by clicking the Printer-friendly Version check box at the top of the page.

This section covers the following topics:

XS3P Stylesheet Features

The XS3P stylesheet has several features that affect content and layout of XML Schema displayed on the Documentation tab. You can

  • Create a printer-friendly version of the documentation by clicking the Printer-friendly Version check box.

Figure 298. Features of XML Schema Documentation

When you click this check box, Stylus Studio

    • Hides the Legend and Glossary sections
    • Automatically expands all XML instance and schema component representations
    • Removes the expand/collapse controls from the page
  • Expand and collapse XML instance and schema component representations. You can do this for every XML instance or schema component by clicking the Expand All and Collapse All buttons associated with these representations. You can also set this option for individual instances by clicking the +/- button, as shown in Figure 299.

Figure 299. Representations Can be Collapsed/Expanded Individually

  • Customize and modify the XML Schema documentation. For example, you can choose to include all super-types, you can change the default name, and you can specify the sort order. Settings for these and other properties that affect the content and appearance of the XML Schema documentation are displayed in the Options dialog box. See XS3P Stylesheet Settings for more information.

XS3P Stylesheet Settings

The XS3P stylesheet allows you to modify the following:

  • Title - The default title is XML Schema Documentation, but you can change it to whatever you want by editing the Title field.
  • Sort order - By default, Stylus Studio sorts information in the XML Schema in alphabetical order by type name. If you want to display information in document order, set the Sort by Component field to False.
  • Whether or not you want Stylus Studio to search included and imported XML Schemas.
  • If you want to incorporate instructions in the HTML, the Use JavaScript option makes it easy for you to add instructions such to display pop-up windows and hide information in the generated HTML document.
  • Inclusion in the XML Schema documentation of
    • Supertypes
    • Subtypes
    • Glossary
    • Legend
    • xsd namespace prefix
    • Schema diagrams

You control these settings on the Documentation page of the Options dialog box.

Tip

 

You can also modify the stylesheet directly. See Modifying the XS3P Stylesheet.

Modifying the XS3P Stylesheet

You can customize the XS3P stylesheet that Stylus Studio uses to display XML Schema documentation. The XS3P stylesheet is in the \schema-documentation directory where you installed Stylus Studio: bin\Plugins\schema-documentation. The name of the stylesheet file is xs3p.xsl.

Should you choose to modify the default XS3P stylesheet, the new stylesheet must have the same name as the original. After you modify and save this file, click the refresh button on the Stylus Studio tool bar to see your changes.

Tip

 

Make a copy of the xs3p.xsl file before you modify it.

< Previous | Next >

Learn XQuery in 10 Minutes, by Dr. Michael Kay - An XQuery Tutorial

Learn XQuery in 10 Minutes By Dr. Michael Kay is for all those people who really want to know what XQuery is, but don't have the time to find out. It's the fastest XQuery tutorial on the planet - read it now!

XQuery Use Cases

Stylus Studio XQuery use-cases illustrate how users from different industries are putting the power, productivity, and ease of use of XQUery in their XML applications today!

Web Service Servers

Stylus Studio's Web Services tools support development and testing of Web service applications on the industry's leading Web Service Servers including Apache AXIS, Mirosoft SOAP Client Toolkit and Microsoft .NET Server.

XML Project

Stylus Studio's Project Window is an intuitive, visual feature for organizing files belonging to a project. It supports different file-type icons and nested folders; many helpful options are available from the context menu.

Stylus Most Wanted

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2007 All Rights Reserved.