Home > Online Product Documentation > Table of Contents > General Information xxxvii
General Information
Copyright
How to Use This Help System
Search Tips
AND, OR, NEAR, and NOT (Boolean) Operators
Nested Expressions
Search Tab Options
Other Helpful Tips
Conventions in This Document
Typographical Conventions
Syntax Notation
Information Alerts
Home Edition Alerts
Technical Support
About Stylus Studio Home Edition
In This Chapter
Starting Stylus Studio
Getting Updates
Getting Help
Updating an XML Document-Getting Started
Opening a Sample XML Document
Updating the Text of a Sample Document
Displaying Line Numbers
Adding Elements in the Text View of a Sample Document
Copying and Pasting in the Text View of a Sample Document
Undoing Operations in the Text View of a Sample Document
Inserting Indents in the Text View of a Sample Document
Querying in the Text View of a Sample Document
Deleting a Query
Updating the Schema of a Sample Document
Creating a Sample Schema
Defining a Sample Element
Adding an Element Reference to a Sample Schema
Defining an Entity in a Sample Schema
Exploring Other Features in a Sample Schema
Updating the Tree Representation of a Sample Document
Adding an Element to a Sample Document Tree
Changing an Element's Data in a Sample Document Tree
Adding Attributes and Other Node Types to a Sample Document Tree
Adding an Entity Reference to a Sample Document Tree
Updating a Sample Document Using the Grid Tab
Modifying Values
Moving Around the Grid
Working with Stylesheets - Getting Started
Opening a Sample Stylesheet
XSLT Stylesheet Editor Quick Tour
Parts of the XSLT Editor
Exploring the XSLT Source Tab
Exploring the Params/Other Tab
Exploring the WYSIWYG Tab
XSLT Scenarios
Working with Scenarios
About Preview
Working with a Sample Result Document
Making a Static Web Page Dynamic by Editing XSLT
Importing a Sample HTML File
Creating the video Template
Instantiating the video Template
Making Titles Dynamic
Making Images Dynamic
Making Summaries Dynamic
Stylesheets That Generate HTML - Getting Started
Video Demonstrations of the XSLT WYSIWYG Editor
Descriptions
System Requirements
Getting Started with the XSLT WYSIWYG Editor
Creating Static HTML
Defining Dynamic Contents
Adding a Table with Dynamic Contents
Using the Properties Window
Making a Static Web Page Dynamic Using the WYSIWYG Editor
Before You Begin
Making Repeating Table Rows in the WYSIWYG Editor
Making Contents Dynamic in the WYSIWYG Editor
Rendering Images as Dynamic Content in the WYSIWYG Editor
Using Conditional If Processing in the WYSIWYG Editor
Using the XSLT Mapper - Getting Started
Opening the XSLT Mapper
Mapping Nodes in Sample Files
Saving the Stylesheet and Previewing the Result
Deleting Links in Sample Files
Defining Additional Processing in Sample Files
Debugging Stylesheets - Getting Started
Setting Up Stylus Studio to Debug Sample Files
Inserting a Breakpoint in the Sample Stylesheet
Gathering Debug Information About the Sample Files
The Variables Window
The Call Stack Window
The Watch Window
Ending Processing During a Debug Session
Defining a DTD - Getting Started
Process Overview
Creating a Sample DTD
Defining Data Elements in a Sample DTD
Defining the Container Element in a Sample DTD
Defining Structure Rules in a Sample DTD
Examining the Tree of a Sample DTD
Defining an XML Schema Using the Diagram Tab - Getting Started
Using the Diagram Tab
Parts of the Diagram Tab
XML Schema Diagram Canvas
Text Pane
Properties Window
Definition Browser
Editing Tools of the Diagram Tab
Menus and Tool Bars
Drag-and-Drop
QuickEdit
Description of Sample XML Schema
Defining a complexType in a Sample XML Schema in the Diagram View
Defining the Name of a Sample complexType in the Diagram View
Adding an Attribute to a Sample complexType in the Diagram View
Adding Elements to a Sample complexType in the Diagram View
Adding Optional Elements to a Sample complexType in the Diagram View
Adding an Element That Contains Subelements to a complexType in the Diagram View
Choosing the Element to Include in a Sample complexType in the Diagram View
Defining Elements of the Sample complexType in the Diagram View
Opening Files in Stylus Studio
About Opening Files
Standard File Types
Changing the Default Module When Opening a File
Opening Files Stored on Berkeley DB XML
How to Open a Locally Accessible File
How to Open a File on a WebDAV or FTP Server
Opening Files from a Browser
Working with Projects
Displaying the Project Window
Displaying Path Names
Other Documents
Creating Projects and Subprojects
Saving Projects
Opening Projects
Recently Opened Projects
Associating .prj Files with Stylus Studio
Adding Files to Projects
When Files are Open in Stylus Studio
When Files are Closed
Adding Multiple Files
Copying Projects
Rearranging the Files in a Project
Removing Files from Projects
Closing and Deleting Projects
Closing
Deleting
Using Stylus Studio with Source Control Applications
Tested Source Control Applications
Prerequisites
Recursive Selection
Using Stylus Studio with ClearCase
Using Stylus Studio with Zeus CVS
Specifying Advanced Source Control Properties
Customizing Toolbars
Toolbar Groups
Showing/Hiding Toolbar Groups
Changing Toolbar Appearance
Adding and Removing Buttons
Creating a New Toolbar
Specifying Stylus Studio Options
Associating File Type Extensions with Stylus Studio Tools
Adding an Association
Deleting Associations
Registering Stylus Studio as the Default Application
Unregistering
Modifying Java Options
About Java Virtual Machine Options
About Java Compiler Options
About External JVM Options
How to Modify Java Settings
Setting Module Options
XML Diff
XML Editor
XSLT Editor
Java
Defining Custom Tools
Defining Keyboard Shortcuts
How to Define a Keyboard Shortcut
Deleting a Keyboard Shortcut
Using Stylus Studio from the Command Line
Invoking Stylus Studio from the Command Line
Applying a Stylesheet from the Command Line
Executing an XQuery from the Command Line
Validating XML from the Command Line
Managing Stylus Studio Performance
Troubleshooting Performance
Changing the Schema Refresh Interval
Checking for Modified Files
Changing the Recursion Level or Allocated Stack Size
Automatically Opening the Last Open Files
Creating XML Documents
Converting Text Files to XML Documents
Alternative to Document Wizards
About CSV File Contents
Delimiting Commas
Structure of Resulting XML Documents
About the Default Values
Running the Convert CSV to XML and Convert Fixed-Width to XML Document Wizards
Specifying User-Defined Columns
Updating XML Documents
Choosing a View
For More Information
Saving Your Work
Ensuring Well-Formedness
Reverting to Saved Version
Updating Java Server Pages as XML Documents
Updating XML Documents Using the Text Editor
Common Text Editing Functions and Tools
Use of Colors in the Text Tab
Updating DOM Tree Structures
Displaying All Nodes in the Tree View
Adding a Node in the Tree View
Deleting a Node in the Tree View
Moving a Node in the Tree View
Changing the Name or Value of a Node in the Tree View
Obtaining the XPath for a Node
Updating XML Documents Using the Grid
Features of the Grid Tab
Layout of the Grid Tab
Expanding and Collapsing Nodes
Resizing Columns
Showing Row Tag Names
Collapsing Empty Nodes
Moving Around the Grid Tab
Selecting Items in the Grid
How Grid Changes Affect the XML Document
Types of Changes that Affect the Document
Working with Rows
Reordering Rows
Adding and Deleting Rows
Working with Columns
Selecting a Column
Adding Columns
Deleting Columns
Reordering Columns
Renaming Columns
Changing a Value
Working with Tables
Adding a Nested Table
Moving a Nested Table
Deleting a Table
Sorting a Table
Copying a Table as Tab-Delimited Text
Diffing Folders and XML Documents
Overview
Sources and Targets
The Diff Configuration File
What Diffs Are Calculated?
Tuning the Diffing Algorithm
When Does the Diff Run?
Running the Diff Manually
Symbols and Background Colors
Diffing Folders
Features
How to Diff Folders
How to Diff Documents from the Diff Folders Dialog Box
The XML Diff Viewer
The XML Diff Viewer Toolbar
Tools for Working with Documents
Removing a Target Document
Diffing a Pair of XML Documents
How to Diff a Pair of Documents
Diffing Multiple Documents
Document Focus
Symbols Used in the Target Document Window
How to Diff Multiple Documents
Modifying Default Diff Settings
Opening the Options Dialog Box
Engine Settings
Presentation Options
Using Schemas with XML Documents
Associating an External Schema With a Document
Having Stylus Studio Generate a Schema
Validating XML Documents
Updating a Document's Schema
Removing the Association Between a Document and a Schema
Querying XML Documents Using XPath
Steps for Querying a Document
Displaying Query Results
Saving Query Results
Moving Around in XML Documents
Line Numbers
Bookmarks
Tags
Find
Learning About Regular Expressions
Printing XML Documents
Saving XML Documents
File Support
Using Convert to XML
Choosing an Input File
The Convert to XML Editor
Document Grid
Example - .txt Files
Display of Delimiting and Control Characters
Document Grid Display Features
How Properties are Organized
Properties for Fixed-Width and Line-Oriented Input Files
Parts of an Input File
Regions
Managing Regions
Rows
Fields
Component Fields
Working with Regions
Converting the Region Type
How to Convert a Region Type
Adjusting Fixed-Width Regions
Defining and Joining Regions
Defining a Region
Joining Regions
Working with Fields
Naming Fields
Defining Fields
Controlling XML Output
Names
Format
Filtering Output
Creating a Convert to XML Converter
Using Converters in Stylus Studio
Properties Reference
Input File Properties
Region Properties
Field Properties
Type-Specific Properties
Specifying Control Characters
Getting Started with XSLT
What Is XSLT?
What Is a Stylesheet?
Example of a Stylesheet
About Stylesheet Contents
What Is a Template?
Contents of a Template
Determining Which Template to Instantiate
How the select and match Attributes Are Different
How the XSLT Processor Applies a Stylesheet
Instantiating the First Template
Selecting Source Nodes to Operate On
Controlling the Order of Operation
Omitting Source Data from the Result Document
When More Than One Template Is a Match
When No Templates Match
Controlling the Contents of the Result Document
Specifying Result Formatting
Creating New Nodes in the Result Document
Controlling White Space in the Result
Specifying XSLT Patterns and Expressions
Examples of Patterns and Expressions
Frequently Asked Questions About XSLT
Sources for Additional XSLT Information
Benefits of Using Stylus Studio
Structural Data View
Sophisticated Editing Environment
XSLT and Java Debugging Features
Integrated XML Parser/XSLT Processor
Tutorial: Understanding How Templates Work
Creating a New Sample Stylesheet
Understanding How the Default Templates Work
Instantiating the Template That Matches the Root Node
Instantiating the Root/Element Default Template
Instantiating the Text/Attribute Default Template
Illustration of Template Instantiations
Editing the Template That Matches the Root Node
Creating a Template That Matches the book Element
Creating a Template That Matches the author Element
Working with Stylesheets
Opening Stylesheets
About the XSLT Editor
Creating Stylesheets
Specifying Stylesheet Parameters and Options
Applying Stylesheets
About Applying Stylesheets
Results of Applying a Stylesheet
Applying Stylesheets to Large Data Sets
Creating a Scenario
Cloning Scenarios
Saving Scenario Meta-Information
Applying a Stylesheet to Multiple Documents
Applying the Same Stylesheet in Separate Operations
Applying a Stylesheet to Multiple Documents in One Operation
Contents Provided by Stylus Studio
Contents You Can Add
Updating Stylesheets
Dragging and Dropping from Schema Tree into XSLT Editor
Using Sense:X Automatic Tag Completion
Using Sense:X to Ensure Well-Formed XML
Using Standard Editing Tools
Saving Stylesheets
Using Updated Stylesheets
Creating Stylesheets That Generate HTML
Descriptions of WYSIWYG Terms
Inserting Contents in the HTML Editor
Displaying a Repeating Element in the HTML Editor
Adding Conditional Processing in the HTML Editor
Specifying Choose Conditional Processing in the HTML Editor
Specifying If Conditional Processing in the HTML Editor
Instantiating Templates in the HTML Editor
Calling a Named Template
Specifying Properties and Attributes in the HTML Editor
Specifying Extension Functions in Stylesheets
Using an Extension Function in Stylus Studio
Basic Data Types
Declaring an XSLT Extension Function
Working with XPath Data Types
Declaring an Extension Function Namespace
Invoking Extension Functions
Finding Classes and Finding Java
Debugging Stylesheets That Contain Extension Functions
Working with Templates
Viewing Templates
Viewing a List of Templates
Viewing a Specific Template
Checking if a Template Generates Output
Using Stylus Studio Default Templates
Contents of a New Stylesheet Created by Stylus Studio
About the Root/Element Built-In Template
About the Text/Attribute Built-In Template
Creating Templates
Saving a Template
Applying Templates
Updating Templates
Deleting Templates
Using an External XSLT Processor
How to Use an External Processor
Passing Parameters
Options for Using External Processors
Xalan-J XSLT Processor Options
Custom XSLT Processor Options
Postprocessing Result Documents
Generating Formatting Objects
Developing Stylesheets That Generate FO
Troubleshooting FOP Errors
Viewing the FO Sample Application
Deploying Stylesheets That Generate FO
Example
Using Apache FOP to Generate NonPDF Output
Generating Scalable Vector Graphics
About SVG Viewers
Running the SVG Example
XSLT Instructions Quick Reference
xsl:apply-imports
xsl:apply-templates
Description
xsl:attribute
xsl:attribute-set
xsl:call-template
xsl:choose
xsl:comment
xsl:copy
xsl:copy-of
xsl:decimal-format
xsl:element
xsl:fallback
xsl:for-each
xsl:if
xsl:import
xsl:include
xsl:key
xsl:message
xsl:namespace-alias
xsl:number
xsl:otherwise
xsl:output
xsl:param
xsl:preserve-space
xsl:processing-instruction
xsl:sort
xsl:strip-space
xsl:stylesheet
xsl:template
xsl:text
Examples
xsl:transform
xsl:value-of
xsl:variable
xsl:when
xsl:with-param
Overview of the XSLT Mapper
Graphical Support for Common XSLT Instructions and Expressions
Setting Options for the XSLT Mapper
Ensuring That Stylesheets Output Valid XML
Steps for Mapping XML to XML
Source Documents
Choosing Source Documents
Source Documents and XML Instances
Types of associations
Source document icons
How to change a source document association
How to Add a Source Document
How to Remove a Source Document
How Source Documents are Displayed
Document structure symbols
Getting source document details
Target Structures
Using an Existing Document
Building a Target Structure
Modifying the Target Structure
Adding a Node
Removing a Node
Mapping Source and Target Document Nodes
Preserving Mapper Layout
Left and Right Mouse Buttons Explained
How to Map Nodes
Removing Source-Target Maps
Working with XSLT Instructions in XSLT Mapper
What XSLT Instructions Are Represented Graphically
Instruction Block Ports
Specifying Values for Ports
Understanding Input Ports
Specifying Values for Input Ports
Red Input Ports
The Flow Port
Adding an Instruction Block to the XSLT Mapper
Notes About Creating Instruction Blocks
Editing xsl: Instruction Properties
xsl:if and xsl:choose
Editing xsl:choose Instruction Properties
Processing Source Nodes
XPath Function Blocks
Parts of a Function Block
Types of Function Blocks
XPath Mathematical Functions
Creating a Function Block
Deleting a Function Block
Logical Operators
Setting a Text Value
How to Set a Text Value on the Mapper Canvas
How to Set a Text Value on the Target Node
Defining Java Functions in the XSLT Mapper
About Adding Java Class Files
Creating and Working with Templates
What Happens When You Create a Template
How to Create a Named or Matched Template
Creating an XSLT Scenario
Overview of Scenario Features
Specifying XML Source Documents
Setting Values for Global Parameters
Choosing an XSLT Processor
Performance Metrics Reporting
Performing Post-Processing
How to Create a Scenario
How to Run a Scenario
How to Clone a Scenario
Steps for Debugging Stylesheets
Using Breakpoints
Inserting Breakpoints
Removing Breakpoints
Start Debugging
Viewing Processing Information
Watching Particular Variables
Evaluating XPath Expressions in the Current Processor Context
Obtaining Information About Local Variables
Determining the Current Context in the Source Document
Displaying a List of Process Suspension Points
Displaying XSLT Instructions for Particular Output
Using Bookmarks
Determining Which Template Generated Particular Output
Determining the Output Generated by a Particular Template
Profiling XSLT Stylesheets
Enabling the Profiler
Displaying the XSLT Profiler Report
Handling Parser and Processor Errors
Debugging Java Files
Requirements for Java Debugging
Setting Options for Debugging Java
Using the Java Editor
Stylus Studio and JVM
Example of Debugging Java Files
Setting Up to Debug Sample Java/XSLT Application
Inserting a Breakpoint in the Sample Java/XSLT Application
Gathering Debug Information About the Sample Java/XSLT Application
What Is an XML Schema?
Reference Information
Creating an XML Schema in Stylus Studio
Creating XML Schema from a DTD
Working with XML Schema in Stylus Studio
Validating XML Schema
Updating XML Schema Associated with a Document
Using XML Schema in XQuery and XSLT Mapper
Printing and Opening
Schemas That Have Schemas
Node Properties
Getting Started with XML Schema in the Tree View
Tips for Adding Nodes
Defining a complexType in a Sample XML Schema in the Tree View
Defining the Name of the Sample complexType in the Tree View
Adding an Attribute to a Sample complexType in the Tree View
Adding Elements to a Sample complexType in the Tree View
Adding Optional Elements to a Sample complexType in the Tree View
Adding an Element That Contains Subelements to a complexType in the Tree View
Choosing the Element to Include in the Sample complexType in the Tree View
Defining Elements of the Sample complexType in the Tree View
Defining simpleTypes in XML Schemas
About simpleTypes in XML Schemas
Examples of simpleTypes in an XML Schema
Defining a simpleType in the Diagram View
Defining an Atomic simpleType
Specifying a Restriction for a simpleType - QuickEdit
Specifying a Restriction for a simpleType - Manually
Defining List and Union simpleTypes
Defining a simpleType in the Tree View
About Facet Types for simpleTypes
Defining List and Union simpleTypes in the Tree View
Defining complexTypes in XML Schemas
Defining complexTypes That Contain Elements and Attributes - Diagram View
Adding Nodes to a complexType
Choosing an Element
Including All Elements
Specifying the Sequence of Elements
Reordering Nodes
Combining the Sequence and Choice Modifiers
Defining complexTypes That Contain Elements and Attributes - Tree View
Defining complexTypes That Mix Data and Elements
Diagram View
Tree View
Defining complexTypes That Contain Only Attributes
Defining Elements and Attributes in XML Schemas
Defining Elements That Carry Attributes and Contain Data in XML Schemas
Defining Elements That Contain Subelements in XML Schemas
Adding an Identity Constraint to an Element
Example of an Identity Constraint
Defining Groups of Elements and Attributes in XML Schemas
Defining Groups of Elements in XML Schemas - Diagram View
Alternative
Defining Groups of Elements in XML Schemas - Tree View
Defining attributeGroups in XML Schemas - Diagram View
Defining attributeGroups in XML Schemas - Tree View
Adding Comments, Annotation, and Documentation Nodes to XML Schemas
Comments
Annotations
Moving a Comment or Annotation
Defining Notations
Referencing External XML Schemas
Ways to Reference XML Schemas
Including an XML Schema
Importing an XML Schema
Redefining an XML Schema
Where You Can Reference XML Schemas
What to Do Next
Referencing XML Schemas in the Diagram View
Referencing XML Schemas in the Tree View
Redefining Nodes
Extensions and Restrictions
Specifying Restriction Facets
How to Redefine a Node
Generating Documentation for XML Schemas
Options That Determine Contents of XML Schema Documentation
Viewing Sample XML Schema Documentation
Modifying the Stylesheet That Generates XML Schema Documentation
About XML Schema Properties
About xsd:schema Properties
Element and Element Reference Properties in XML Schemas
Attribute and Attribute Reference Properties in XML Schemas
Group Properties in XML Schemas
Model Group Properties in XML Schemas
Complex and simpleType Properties in XML Schemas
Restriction and Extension Type Properties in XML Schemas
Content Type Properties in XML Schemas
Aggregator Type Properties in XML Schemas
Facet Type Properties in XML Schemas
Notation Type Properties in XML Schemas
Include Type Properties in XML Schemas
Import Type Properties in XML Schemas
Redefine Type Properties in XML Schemas
Identity Constraint Type Properties in XML Schemas
Constraint Element Type Properties in XML Schemas
Documentation Type Properties in XML Schemas
What Is a DTD?
Creating DTDs
About Editing DTDs
Restrictions
About Modifiers in Element Definitions in DTDs
Description of Element Modifiers in DTDs
Simple Example of Aggregating Modifiers in DTDs
More Complex Example of Aggregating Modifiers in DTDs
Aggregating Modifiers to Allow Any Order and Any Number in DTDs
Cart