xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gma...@apache.org
Subject cvs commit: xml-site/targets/fop embedding.html
Date Mon, 19 Jul 2004 11:15:49 GMT
gmazza      2004/07/19 04:15:49

  Modified:    targets/fop embedding.html
  Log:
  Updated to show difference between old/new APIs in our examples.
  
  Revision  Changes    Path
  1.50      +127 -70   xml-site/targets/fop/embedding.html
  
  Index: embedding.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/embedding.html,v
  retrieving revision 1.49
  retrieving revision 1.50
  diff -u -r1.49 -r1.50
  --- embedding.html	11 Apr 2004 22:28:05 -0000	1.49
  +++ embedding.html	19 Jul 2004 11:15:49 -0000	1.50
  @@ -13,6 +13,7 @@
   </tr>
   <tr>
   <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
  +
   </tr>
   </table>
   <!--================= end Navigation Path ==================-->
  @@ -30,6 +31,7 @@
   <tr>
   <td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
   </tr>
  +
   <tr>
   <td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td
nowrap="nowrap"><input value="xml.apache.org" name="sitesearch" type="hidden"><input
size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
   <br>
  @@ -48,6 +50,7 @@
   <!--================= start Search ==================--><td bgcolor="#294563"><img
height="10" width="10" alt="" src="skin/images/spacer.gif" class="spacer"></td>
   </tr>
   <tr>
  +
   <td valign="bottom" bgcolor="#294563" colspan="2">
   <!--================= start Tabs ==================-->
   <div class="tab">
  @@ -63,6 +66,7 @@
   <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0">
   <tr>
   <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a
class="base-not-selected" href="dev/index.html">Development</a></td><td
valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
  +
   </tr>
   <tr>
   <td colspan="3" height="1"></td>
  @@ -79,6 +83,7 @@
   </table>
   </td><td width="6"><img alt="" height="8" width="6" src="skin/images/spacer.gif"></td><td
valign="bottom">
   <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0">
  +
   <tr>
   <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a
class="base-not-selected" href="design/alt.design/index.html">Alt Design</a></td><td
valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
   </tr>
  @@ -95,6 +100,7 @@
   </tr>
   <tr>
   <td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
  +
   </tr>
   </table>
   <!--================= end Banner ==================-->
  @@ -112,6 +118,7 @@
   </tr>
   <tr>
   <td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +
   </tr>
   <tr>
   <td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
  @@ -128,6 +135,7 @@
       
   <li>
   <a href="index.html">Introduction</a>
  +
   </li>
     
   </ul>
  @@ -142,6 +150,7 @@
       
   <li>
   <a href="download.html">Download</a>
  +
   </li>
       
   <li>
  @@ -156,6 +165,7 @@
   <a href="running.html">Run</a>
   </li>
       
  +
   <li>
   <span class="sel"><font color="#ffcc00">Embed</font></span>
   </li>
  @@ -170,6 +180,7 @@
     
   </ul>
   </li>
  +
   <li>
   <font color="#CFDCED">Features</font>
   <ul>
  @@ -184,6 +195,7 @@
       
   <li>
   <a href="pdfencryption.html">PDF encryption</a>
  +
   </li>
       
   <li>
  @@ -198,6 +210,7 @@
   <a href="hyphenation.html">Hyphenation</a>
   </li>
       
  +
   <li>
   <a href="extensions.html">Extensions</a>
   </li>
  @@ -212,6 +225,7 @@
   <a href="gethelp.html">Getting Help</a>
   </li>
       
  +
   <li>
   <a href="faq.html">FAQs</a>
   </li>
  @@ -226,6 +240,7 @@
       
   <li>
   <a href="maillist.html">Mailing Lists</a>
  +
   </li>
       
   <li>
  @@ -240,6 +255,7 @@
   <a href="license.html">License</a>
   </li>
       
  +
   <li>
   <a href="resources.html">Other</a>
   </li>
  @@ -254,6 +270,7 @@
   <a href="news.html">News</a>
   </li>
       
  +
   <li>
   <a href="team.html">Who We Are</a>
   </li>
  @@ -268,6 +285,7 @@
       
   <li>
   <a href="changes.html">Changes</a>
  +
   </li>
       
   <li>
  @@ -284,6 +302,7 @@
   <tr>
   <td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt="" src="skin/images/menu-left.gif"></td><td
bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10"
width="10" border="0" alt="" src="skin/images/menu-right.gif"></td>
   </tr>
  +
   <tr>
   <td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
   </tr>
  @@ -300,6 +319,7 @@
                   
                   </font><img width="10" height="8" alt="" src="skin/images/spacer.gif"
class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font
color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
                   &nbsp;
  +
                   
                   </font><img width="10" height="8" alt="" src="skin/images/spacer.gif"
class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="skin/images/spacer.gif" class="spacer"></td>
   </tr>
  @@ -316,6 +336,7 @@
   <td valign="middle">
   <h1>FOP: Embedding</h1>
   </td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="embedding.pdf"><img
alt="PDF" src="skin/images/pdfdoc.gif" class="skin"><br>
  +
             PDF</a></td>
   </tr>
   </table>
  @@ -328,6 +349,7 @@
   <a href="#basics">Basics</a>
   <ul class="minitoc">
   <li>
  +
   <a href="#basic-logging">Logging</a>
   </li>
   <li>
  @@ -341,6 +363,7 @@
   </li>
   </ul>
   </li>
  +
   <li>
   <a href="#logging">Controlling logging</a>
   </li>
  @@ -354,6 +377,7 @@
   <a href="#config-internal">Setting the Configuration Programmatically</a>
   </li>
   <li>
  +
   <a href="#hints">Hints</a>
   <ul class="minitoc">
   <li>
  @@ -367,6 +391,7 @@
   </li>
   </ul>
   </li>
  +
   <li>
   <a href="#performance">Improving performance</a>
   </li>
  @@ -380,6 +405,7 @@
   <a href="#ExampleFO2PDF">ExampleFO2PDF.java</a>
   </li>
   <li>
  +
   <a href="#ExampleXML2FO">ExampleXML2FO.java</a>
   </li>
   <li>
  @@ -393,6 +419,7 @@
   </li>
   <li>
   <a href="#ExampleDOM2PDF">ExampleDOM2PDF.java</a>
  +
   </li>
   <li>
   <a href="#ExampleSVG2PDF">ExampleSVG2PDF.java (PDF Transcoder example)</a>
  @@ -407,6 +434,7 @@
   <a name="N10015"></a><a name="overview"></a>
   <h3>Overview</h3>
   <div style="margin-left: 0 ; border: 2px">
  +
   <p>Review <a href="running.html">Running FOP</a> for important information
that applies to embedded applications as well as command-line use, such as options and performance.
       </p>
   <p>To embed FOP in your application, instantiate org.apache.fop.apps.Driver.
  @@ -431,6 +459,7 @@
     </p>
   <p>Here is an example use of Driver which outputs PDF:
     </p>
  +
   <pre class="code">
   import org.apache.fop.apps.Driver;
   
  @@ -454,6 +483,7 @@
         of org.apache.avalon.framework.logger.Logger. See 
         <a target="_top" href="#logging">below</a> for more information.
       </p>
  +
   <p>
         Call <span class="codefrag">setLogger(Logger)</span> always immediately
after 
         instantiating the Driver object. See here:
  @@ -473,28 +503,16 @@
   <h4>Logging (Upcoming FOP 1.0 Version only)</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  -      You also need to set up logging. Global logging for all FOP
  -      processes is managed by MessageHandler. Per-instance logging
  -      is handled by Driver. You want to set both using an implementation
  -      of org.apache.commons.logging.Log. See 
  -      <a target="_top" href="#logging">below</a> for more information.
  -    </p>
  -<p>
  -      Call <span class="codefrag">setLogger(Logger)</span> always immediately
after 
  -      instantiating the Driver object. See here:
  -    </p>
  -<pre class="code">
  -import org.apache.commons.logging.Log; 
  -import org.apache.commons.logging.impl.SimpleLog; 
  -
  -/*..*/
  +      Logging is handled automatically via Jakarta Commons-Logging, which uses
  +      JDK logging by default.  No special driver configuration is needed.
  +      For specialized configuration of Commons-Logging (e.g. to use a
  +      different logger or to change logging levels), please see the  
  +      <a target="_blank" href="http://jakarta.apache.org/commons/logging/">Jakarta
Commons-Logging</a>
   
  -Driver driver = new Driver();
  -Log logger = new SimpleLog(SimpleLog.LOG_LEVEL_INFO);
  -MessageHandler.setScreenLogger(logger);
  -driver.setLogger(logger);</pre>
  +      site.
  +    </p>
   </div>
  -<a name="N1006C"></a><a name="render"></a>
  +<a name="N10061"></a><a name="render"></a>
   <h4>Processing XSL-FO</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -503,6 +521,7 @@
         invocation of the method is either <span class="codefrag">render(Document)</span>
or
         <span class="codefrag">render(Parser, InputSource)</span> respectively.
       </p>
  +
   <p>
         
   <strong>Another possibility may be used to build the FO Tree: You can
  @@ -511,6 +530,7 @@
         You don't have to call <span class="codefrag">run()</span> or <span
class="codefrag">render()</span> on the 
         Driver object if you use <span class="codefrag">getContentHandler()</span>.
       </p>
  +
   <p>Here is an example use of Driver:</p>
   <pre class="code">
   Driver driver = new Driver();
  @@ -520,7 +540,7 @@
   driver.setOutputStream(new FileOutputStream(args[1]));
   driver.run();</pre>
   </div>
  -<a name="N10099"></a><a name="render-with-xslt"></a>
  +<a name="N1008E"></a><a name="render-with-xslt"></a>
   <h4>Processing XSL-FO generated from XML+XSLT</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -549,6 +569,7 @@
   
   //Start the transformation and rendering process
   transformer.transform(src, res);</pre>
  +
   <div class="frame note">
   <div class="label">Note</div>
   <div class="content">There's no need to call <span class="codefrag">run()</span>
or <span class="codefrag">render()</span>.</div>
  @@ -564,10 +585,11 @@
         For fully working examples of the above and hints to some interesting 
         possibilities, see the <a href="#examples">examples section</a> below.
       </p>
  +
   </div>
   </div>
     
  -<a name="N100BC"></a><a name="logging"></a>
  +<a name="N100B1"></a><a name="logging"></a>
   <h3>Controlling logging</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -577,6 +599,7 @@
         <a target="_blank" href="http://avalon.apache.org/framework/">Apache Avalon
Framework</a>
         for more information.
       </p>
  +
   <p>
         Per default FOP uses the SimpleLog which logs to System.out. If you want to do logging
using a
         logging framework (such as LogKit, Log4J or JDK 1.4 Logging) you can set a
  @@ -603,6 +626,7 @@
         Similar implementations exist for Log4J (org.apache.avalon.framework.logger.Log4JLogger)
and
         JDK 1.4 logging (org.apache.avalon.framework.logger.Jdk14Logger).
       </p>
  +
   <p>
         If you want FOP to be totally silent you can also set an org.apache.avalon.framework.logger.NullLogger
instance.
       </p>
  @@ -613,7 +637,7 @@
       </p>
   </div>
     
  -<a name="N100E6"></a><a name="input"></a>
  +<a name="N100DB"></a><a name="input"></a>
   <h3>Input Sources</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -622,6 +646,7 @@
         However, the input itself can be provided in a variety of ways to FOP, 
         which normalizes the input (if necessary) into SAX events:
       </p>
  +
   <ul>
         
   <li>
  @@ -629,13 +654,16 @@
         
   <li>
   <strong>DOM (which is converted into SAX Events)</strong>: The conversion of
a DOM tree is done via the <span class="codefrag">render(Document)</span> method
on <span class="codefrag">Driver</span>.</li>
  +
         
   <li>
   <strong>Data Source (which is parsed and converted into SAX Events)</strong>:
The <span class="codefrag">Driver</span> can take an <span class="codefrag">InputSource</span>
as input.
   This can use a <span class="codefrag">Stream</span>, <span class="codefrag">String</span>
etc.</li>
         
  +
   <li>
   <strong>XML+XSLT Transformation</strong> (which is transformed using an XSLT
Processor and the result is fired as SAX Events: <span class="codefrag">XSLTInputHandler</span>
is used as an <span class="codefrag">InputSource</span> in the render(<span
class="codefrag">XMLReader</span>, <span class="codefrag">InputSource</span>)
method on <span class="codefrag">Driver</span>.</li>
  +
       
   </ul>
   <p>
  @@ -650,7 +678,8 @@
       </p>
   </div>
     
  -<a name="N10143"></a><a name="config-external"></a>
  +
  +<a name="N10138"></a><a name="config-external"></a>
   <h3>Using a Configuration File</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -668,6 +697,7 @@
   <div class="content">
           This is all you need to do, it sets up a static configuration class.
       </div>
  +
   </div>
   <p>
         No further reference to the <span class="codefrag">options</span> variable
is necessary.
  @@ -678,7 +708,8 @@
       </p>
   </div>
     
  -<a name="N10162"></a><a name="config-internal"></a>
  +
  +<a name="N10157"></a><a name="config-internal"></a>
   <h3>Setting the Configuration Programmatically</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -688,17 +719,19 @@
   <p>
         Here is another that sets baseDir in a Windows environment:
       </p>
  +
   <pre class="code">org.apache.fop.configuration.Configuration.put("baseDir","C:\my\base\dir");</pre>
   <p>
         See <a href="#multithreading">Multithreading FOP</a> for issues related
to changing configuration in a multithreaded environment.
       </p>
   </div>
     
  -<a name="N10183"></a><a name="hints"></a>
  +<a name="N10178"></a><a name="hints"></a>
   <h3>Hints</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10189"></a><a name="object-reuse"></a>
  +<a name="N1017E"></a><a name="object-reuse"></a>
   <h4>Object reuse</h4>
  +
   <div style="margin-left: 0 ; border: 2px">
   <p>
   If FOP is going to be used multiple times within your application
  @@ -712,7 +745,7 @@
   IntputStream and renderer.
        </p>
   </div>
  -<a name="N10199"></a><a name="awt"></a>
  +<a name="N1018E"></a><a name="awt"></a>
   <h4>AWT issues</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -722,6 +755,7 @@
           is created by the JVM and on Unix it will need to connect to a
           DISPLAY.
         </p>
  +
   <p>
           The thread means that the Java application may not automatically quit
           when finished, you will need to call <span class="codefrag">System.exit()</span>.
These
  @@ -732,9 +766,10 @@
           <a href="graphics.html#batik">notes on Batik</a>.
         </p>
   </div>
  -<a name="N101B3"></a><a name="render-info"></a>
  +<a name="N101A8"></a><a name="render-info"></a>
   <h4>Getting information on the rendering process</h4>
   <div style="margin-left: 0 ; border: 2px">
  +
   <p>
   To get the number of pages that were rendered by FOP you can call 
   <span class="codefrag">Driver.getResults()</span>. This returns a FormattingResults
object 
  @@ -747,13 +782,14 @@
   </div>
   </div>
     
  -<a name="N101C1"></a><a name="performance"></a>
  +<a name="N101B6"></a><a name="performance"></a>
   <h3>Improving performance</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
         There are several options to consider:
       </p>
   <ul>
  +
         
   <li>
           Whenever possible, try to use SAX to couple the individual components involved

  @@ -770,6 +806,7 @@
           Make sure you properly close the OutputStream when FOP is finished.
         </li>
         
  +
   <li>
           Cache the stylesheet. If you use the same stylesheet multiple times 
           you can setup a JAXP <span class="codefrag">Templates</span> object
and reuse it each time you do
  @@ -781,11 +818,12 @@
           Use an XSLT compiler like <a target="_blank" href="http://xml.apache.org/xalan-j/xsltc_usage.html">XSLTC</a>
           that comes with Xalan-J.
         </li>
  +
       
   </ul>
   </div>
     
  -<a name="N101EA"></a><a name="multithreading"></a>
  +<a name="N101DF"></a><a name="multithreading"></a>
   <h3>Multithreading FOP</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -799,6 +837,7 @@
   <li>
           To avoid having your threads blocked, create a Driver object for each thread.
         </li>
  +
         
   <li>
           If possible, do not change the configuration data while there is a Driver object
rendering.
  @@ -814,9 +853,10 @@
   </ul>
   <p>There is also a known issue with fonts being jumbled between threads when using
the AWT renderer (which is used by the -awt and -print output options).
   In general, you cannot safely run multiple threads through the AWT renderer.</p>
  +
   </div>
   
  -<a name="N10206"></a><a name="examples"></a>
  +<a name="N101FB"></a><a name="examples"></a>
   <h3>Examples</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -824,26 +864,30 @@
   In contrast to the examples above the examples here primarily use JAXP for 
   XML access. This may be easier to understand for people familiar with JAXP.
     </p>
  -<a name="N1020F"></a><a name="ExampleFO2PDF"></a>
  +<a name="N10204"></a><a name="ExampleFO2PDF"></a>
   <h4>ExampleFO2PDF.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleFO2PDF.java?rev=HEAD">
  -            This example</a>
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleFO2PDF.java?rev=1.12">
  +            (current 0.20.5)</a>
  +
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleFO2PDF.java?rev=HEAD">
  +            (future 1.0dev)</a>
   demonstrates the basic usage pattern to transform an XSL-FO
   file to PDF using FOP.
       </p>
   <div align="center">
   <img class="figure" alt="Example XSL-FO to PDF" src="images/EmbeddingExampleFO2PDF.png"></div>
   </div>
  -<a name="N10221"></a><a name="ExampleXML2FO"></a>
  +<a name="N1021A"></a><a name="ExampleXML2FO"></a>
   <h4>ExampleXML2FO.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2FO.java?rev=HEAD">
  -            This example</a>
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2FO.java?rev=1.4">
  +            (current 0.20.5)</a>
  +
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2FO.java?rev=HEAD">
  +            (future 1.0dev)</a>
   has nothing to do with FOP. It is there to show you how an XML 
   file can be converted to XSL-FO using XSLT. The JAXP API is used to do the
   transformation. Make sure you've got a JAXP-compliant XSLT processor in your 
  @@ -852,13 +896,15 @@
   <div align="center">
   <img class="figure" alt="Example XML to XSL-FO" src="images/EmbeddingExampleXML2FO.png"></div>
   </div>
  -<a name="N10237"></a><a name="ExampleXML2PDF"></a>
  +<a name="N10234"></a><a name="ExampleXML2PDF"></a>
   <h4>ExampleXML2PDF.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2PDF.java?rev=HEAD">
  -        This example</a>
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2PDF.java?rev=1.10">
  +
  +        (current 0.20.5)</a>
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2PDF.java?rev=HEAD">
  +        (future 1.0dev)</a>
   demonstrates how you can convert an arbitrary XML file to PDF 
   using XSLT and XSL-FO/FOP. It is a combination of the first two examples 
   above. The example uses JAXP to transform the XML file to XSL-FO and FOP to 
  @@ -875,13 +921,15 @@
   performance is significantly higher with SAX.
       </p>
   </div>
  -<a name="N1024C"></a><a name="ExampleObj2XML"></a>
  +<a name="N1024D"></a><a name="ExampleObj2XML"></a>
  +
   <h4>ExampleObj2XML.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -    
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2XML.java?rev=HEAD">
  -        This example</a>
  +<p>This example
  +    <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2XML.java?rev=1.4">
  +        (current 0.20.5)</a>
  +    <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2XML.java?rev=HEAD">
  +        (future 1.0dev)</a>
   is a preparatory example for the next one. It's an example that 
   shows how an arbitrary Java object can be converted to XML. It's an often 
   needed task to do this. Often people create a DOM tree from a Java object and 
  @@ -891,6 +939,7 @@
       </p>
   <div align="center">
   <img class="figure" alt="Example Java object to XML" src="images/EmbeddingExampleObj2XML.png"></div>
  +
   <p>
   For this example we've created two classes: ProjectTeam and ProjectMember 
   (found in xml-fop/examples/embedding/java/embedding/model). They represent 
  @@ -911,13 +960,15 @@
   <a target="_blank" href="http://java.sun.com/xml/jaxp/dist/1.1/docs/tutorial/xslt/3_generate.html">An
older JAXP tutorial</a>).
       </p>
   </div>
  -<a name="N1026B"></a><a name="ExampleObj2PDF"></a>
  +<a name="N10270"></a><a name="ExampleObj2PDF"></a>
   <h4>ExampleObj2PDF.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2PDF.java?rev=HEAD">
  -            This example</a>
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2PDF.java?rev=1.8">
  +
  +            (current 0.20.5)</a>
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2PDF.java?rev=HEAD">
  +            (future 1.0dev)</a>
   combines the previous and the third to demonstrate 
   how you can transform a Java object to a PDF directly in one smooth run
   by generating SAX events from the Java object that get fed to an XSL 
  @@ -927,29 +978,32 @@
   <div align="center">
   <img class="figure" alt="Example Java object to PDF (via XML and XSL-FO)" src="images/EmbeddingExampleObj2PDF.png"></div>
   </div>
  -<a name="N1027D"></a><a name="ExampleDOM2PDF"></a>
  +<a name="N10286"></a><a name="ExampleDOM2PDF"></a>
   <h4>ExampleDOM2PDF.java</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleDOM2PDF.java?rev=HEAD">
  -            This example</a>
  +
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleDOM2PDF.java?rev=1.9">
  +            (current 0.20.5)</a>
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleDOM2PDF.java?rev=HEAD">
  +            (future 1.0dev)</a>
   has FOP use a DOMSource instead of a StreamSource in order to 
   use a DOM tree as input for an XSL transformation.
       </p>
   </div>
  -<a name="N1028B"></a><a name="ExampleSVG2PDF"></a>
  +<a name="N10298"></a><a name="ExampleSVG2PDF"></a>
   <h4>ExampleSVG2PDF.java (PDF Transcoder example)</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -        
  -<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleSVG2PDF.java?rev=HEAD">
  -            This example</a>
  +
  +<p>This example
  +        <a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleSVG2PDF.java?rev=1.4">
  +            (current 0.20.5)</a><a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleSVG2PDF.java?rev=HEAD">
  +            (future 1.0dev)</a>
   shows use of the PDF Transcoder, a sub-application within FOP.  
   It is used to generate a PDF document from an SVG file.
       </p>
   </div>
  -<a name="N10299"></a><a name="example-notes"></a>
  +<a name="N102A9"></a><a name="example-notes"></a>
   <h4>Final notes</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
  @@ -959,12 +1013,13 @@
   mailing lists.  Finally, for more help please send your questions to the FOP-USER
   mailing list.
       </p>
  +
   </div>
   </div>
       
   <div class="attribution">
   <span class="version">
  -          version 1.21</span>
  +          version 1.23</span>
   </div>
   </div>
   </td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
  @@ -974,6 +1029,7 @@
   </td>
   </tr>
   </table>
  +
   <!--================= end Menu, NavBar, Content ==================-->
   <!--================= start Footer ==================-->
   <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  @@ -988,8 +1044,9 @@
   </tr>
   <tr>
   <td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +
   </tr>
   </table>
   <!--================= end Footer ==================-->
   </body>
  -</html>
  +</html>
  \ No newline at end of file
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message