← Back to branch summary

~ubuntu-branches/ubuntu/quantal/netbeans/quantal

« back to all changes in this revision

Viewing changes to usersguide/javahelp/org/netbeans/modules/usersguide/xml/xsl/xsl_transform.html

  • Committer: Bazaar Package Importer
  • Author(s): Marek Slama
  • Date: 2008-01-29 14:11:22 UTC
  • Revision ID: james.westby@ubuntu.com-20080129141122-fnzjbo11ntghxfu7
Tags: upstream-6.0.1
Import upstream version 6.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
usersguide/javahelp/org/netbeans/modules/usersguide/xml/xsl/xsl_transform.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<!--       
 
3
 *     Copyright � 2007 Sun Microsystems, Inc. All rights reserved.
 
4
 *     Use is subject to license terms.
 
5
 *
 
6
-->
 
7
 
 
8
<html>
 
9
<head>
 
10
<title>Performing an XSL Transformation</title> 
 
11
<link rel="StyleSheet" href="../../ide.css" type="text/css">
 
12
</head>
 
13
<body>
 
14
<h2>Performing an XSL Transformation</h2>
 
15
<p> <small><a href="#seealso">See Also</a>&nbsp; </small>
 
16
<p>You can use an existing XSL stylesheet to transform the data in any of your 
 
17
  XML documents. You can initiate the XSL transformation from an XSL stylesheet 
 
18
  or an XML document.</p>
 
19
<h4>To perform an XSL transformation on a single file:</h4>
 
20
<ol>
 
21
  <li>In the Files window, right-click any XSL stylesheet (<img src="../images/xslObject.gif" alt="XSL stylesheet node icon">)
 
22
     or XML document (<img src="../images/xmlObject.gif" alt="XML object node icon">)
 
23
      and choose XSL Transformation.</li>
 
24
  <li>In the XML Source combo box, select the XML document you want to transform. 
 
25
    The XML Source combo box contains all the XML documents you have previously 
 
26
    transformed with the selected XSL stylesheet. If you chose the XSL Transformation 
 
27
    command on an XML document, this value is already filled in and is read-only. 
 
28
    You can type the full path to the XML document or use the Browse button to 
 
29
    select the document.</li>
 
30
  <li>In the XSLT Script combo box, specify the XSL stylesheet you want to use 
 
31
    to transform the document. The XSLT Script combo box lists all of the XSL 
 
32
    stylesheets you have previously used to transform the selected XML document. 
 
33
    If you chose the XSL Transformation command on an XSL stylesheet, this value 
 
34
    is already filled in and is read-only. You can type the full path to the XSL 
 
35
    stylesheet or use the Browse button to select the script. 
 
36
  <li>Specify the output of the transformation in the Output combo box. <p>By default, 
 
37
    the IDE generates an HTML file with the same name as the XML document. If 
 
38
    the XSL stylesheet creates a different type of output, it is automatically 
 
39
    specified in the Output combo box.</li>
 
40
  <li>
 
41
        <p>If you want to change the name and location of the output path,  type
 
42
        the relative  path and file name in the Output combo box. 
 
43
  <ul>
 
44
        <li>If you want  to preview the output in the IDE's
 
45
        default browser without creating an output file,                        select Preview
 
46
                in the combo box.   </li>
 
47
  <li>If you want the transformation to overwrite any files created by earlier 
 
48
    transformations, select Overwrite Output.</ul></li>
 
49
  <li>Specify how you want the IDE to handle the output file in the Process Output 
 
50
    combo box. You have the following choices: 
 
51
    <ul>
 
52
      <li>Select Do Nothing to create the file only.</li>
 
53
      <li>Select Apply Default Action to apply the IDE's default action for the 
 
54
        output file. The IDE's default action for most files is to open them in 
 
55
        the Source Editor.</li>
 
56
      <li>Select Open in Browser to open the output file in the IDE browser.</li>
 
57
    </ul>
 
58
  </li>
 
59
  <li>Click OK. <p>The IDE performs the transformation and directs any output and 
 
60
    errors to the Output window. You can click any error message to go to the 
 
61
    line in the source where the error occurred.</li>
 
62
</ol>
 
63
 
 
64
  <ul class="note"> 
 
65
    <li>You can also run XSL Transformation on more than
 
66
      one XML document at a time by pressing the Control key while selecting
 
67
      document nodes. Then right-click any of the selected documents and choose
 
68
      XSL Transformation. The IDE displays a separate XSL Transformation dialog
 
69
    box for each XML document. </li>
 
70
  </ul>
 
71
 
 
72
<p>The IDE uses the Apache XALAN 2.3.1 XSL processor. For more information about 
 
73
  XSL transformations, see: </p>
 
74
<p><object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
 
75
    <param name="content" value="http://www.w3.org/TR/xsl/">
 
76
    <param name="text" value="<html><u>http://www.w3.org/TR/xsl/</u></html>">
 
77
    <param name="textFontSize" value="medium">
 
78
    <param name="textColor" value="blue">
 
79
</object>
 
80
 
 
81
<dl>
 
82
    <dt><a name="seealso">See Also</a></dt>
 
83
    <dd><a href="xsl_about.html">Creating and Editing an XSL Stylesheet</a></dd>
 
84
    <dd><a href="../xml_create.html">Creating an XML Document</a></dd>
 
85
    <dd><a href="../xml_edit.html">Editing an XML Document</a></dd>
 
86
</dl>    
 
87
 
 
88
<hr>
 
89
<small><a href="../../credits.html">Legal Notices</a></small> 
 
90
 
 
91
<table border="0" cellpadding="20">
 
92
<tr><td>&nbsp;</td></tr>
 
93
<tr><td>&nbsp;</td></tr>
 
94
<tr><td>&nbsp;</td></tr>
 
95
</table></body>
 
96
</html>