• Chapter 1: Getting Started with Stylus Studio®
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
• Chapter 5: Creating XSLT Using the XSLT Mapper
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
  • What Is an XML Schema?
  • Creating an XML Schema in Stylus Studio
  • Working with XML Schema in Stylus Studio
  • Getting Started with XML Schema in the Tree View
  • Defining simpleTypes in XML Schemas
  • Defining complexTypes in XML Schemas
  • Defining Elements and Attributes in XML Schemas
  • Defining Groups of Elements and Attributes in XML Schemas
  • Adding Comments, Annotation, and Documentation Nodes to XML Schemas
    • Comments
    • Annotations
    • Example
  • Defining Notations
  • Referencing External XML Schemas
  • Generating Documentation for XML Schema
  • Generating JAXB Classes
  • About XML Schema Properties
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Building XML Pipelines
• Chapter 14: Publishing XML Data
• Chapter 15: Integrating with Third-Party File Systems
• Chapter 16: Extending Stylus Studio
• Chapter 17: The Stylus Studio Java API
• Chapter 18: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > Example

Example

In an XML Schema, you might have a comment node such as the following:

<xsd:schema ...>
               

              

                
<!-- The following element is .... -->
                   
<xsd:element name="..."/>
                   

                
              

            

The contents of a comment node have meaning only when a person reads them. However, the contents of annotation nodes can be operated on. For example:

<xsd:schema ... > 
               

              

                
<xsd:element name="foo"> 
                   
<xsd:annotation> 
                   

                
              
<xsd:documentation language="en"> 
               
This is a <b>foo</b> element. Use it for ... 
               
</xsd:documentation> 
               
<xsd:documentation language="jp"> 
               
xksnjgfyre fvhfdbvhjds 
               
</xsd:documentation> 
               

              

                
</xsd:annotation> 
                   
</xsd:element> 
                   
...
                   

                
              

            

You can apply an XSLT stylesheet to this XML Schema document. The stylesheet could generate an HTML manual by extracting the Documentation nodes in the desired language:

<xsl:stylesheet ... > 
               

              

                
<xsl:template match="xsd:element"> 
                   
<xsl:apply-templates select=
                   

                
              
"xsd:annotation/xsd:documentation[@language='en']"/> 
               

              

                
</xsl:template> 
                   
...