You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general-cvs@xml.apache.org by je...@apache.org on 2003/05/30 20:37:51 UTC
cvs commit: xml-site/targets/fop/dev api-doc.html api-doc.pdf doc.html doc.pdf examples.html extensions.html extensions.pdf faq.html faq.pdf fonts.html fonts.pdf implement.html implement.pdf index.html index.pdf svg.html svg.pdf testing.html testing.pdf tools.html tools.pdf
jefft 2003/05/30 11:37:50
Modified: targets/fop anttask.html anttask.pdf bugs.html bugs.pdf
changes.html changes.pdf changes.rss.xml
compiling.html compiling.pdf compliance.html
compliance.pdf configuration.html configuration.pdf
download.html download.pdf embedding.html
embedding.pdf examples.html examples.pdf
extensions.html extensions.pdf faq.html faq.pdf
fo.html fo.pdf fonts.html fonts.pdf gethelp.html
gethelp.pdf graphics.html graphics.pdf index.html
index.pdf license.html license.pdf logocontest.html
logocontest.pdf news.html news.pdf output.html
output.pdf pdfencryption.html pdfencryption.pdf
relnotes.html relnotes.pdf resources.html
resources.pdf running.html running.pdf status.html
status.pdf todo.html todo.pdf
targets/fop/design areas.pdf breakpos.pdf embedding.pdf
extending.pdf fotree.pdf images.pdf index.pdf
layout.pdf optimise.pdf parsing.pdf pdf-library.pdf
properties.pdf renderers.pdf startup.pdf svg.pdf
useragent.pdf
targets/fop/design/alt.design FOPropertySets.html
FoXMLEvent.html SyncedFoXmlEventsBuffer.html
XMLNamespaces.html codedisplay.js
compound-properties.pdf coroutines.pdf
footnotes.pdf galleys.pdf index.pdf keeps.pdf
spaces.pdf traits.pdf user-agent-refs.pdf
targets/fop/design/alt.design/properties
AbstractPropertyValue.html FOAttributes.html
PropNames.html Property.html PropertyConsts.html
PropertyParser.html PropertySets.html
PropertyTokenizer.html PropertyValue.html
PropertyValueList.html ShorthandPropSets.html
codedisplay.js introduction.pdf
targets/fop/dev api-doc.html api-doc.pdf doc.html doc.pdf
examples.html extensions.html extensions.pdf
faq.html faq.pdf fonts.html fonts.pdf
implement.html implement.pdf index.html index.pdf
svg.html svg.pdf testing.html testing.pdf
tools.html tools.pdf
Added: targets/fop cleeds@medata.com.html glenmazza@yahoo.com.html
jaccoud@petrobras.com.br.html
jtauber@jtauber.com.html maillist.html maillist.pdf
servlets.html servlets.pdf servlets.xml.html
svg.html team.html team.pdf
Log:
Automatic publish at Fri May 30 20:37:22 CEST 2003 from http://forrestbot.cocoondev.org.
Revision Changes Path
1.9 +12 -0 xml-site/targets/fop/anttask.html
Index: anttask.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/anttask.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- anttask.html 14 May 2003 18:13:08 -0000 1.8
+++ anttask.html 30 May 2003 18:37:30 -0000 1.9
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<span class="sel"><font color="#ffcc00">Ant task</font></span>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.3 +140 -179 xml-site/targets/fop/anttask.pdf
<<Binary file>>
1.31 +12 -0 xml-site/targets/fop/bugs.html
Index: bugs.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/bugs.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- bugs.html 14 May 2003 18:13:08 -0000 1.30
+++ bugs.html 30 May 2003 18:37:30 -0000 1.31
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<span class="sel"><font color="#ffcc00">Bugs</font></span>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.8 +79 -92 xml-site/targets/fop/bugs.pdf
<<Binary file>>
1.18 +19 -1 xml-site/targets/fop/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/changes.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- changes.html 14 May 2003 18:13:08 -0000 1.17
+++ changes.html 30 May 2003 18:37:31 -0000 1.18
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -310,6 +322,12 @@
<li>
<img alt="fix" src="images/fix.jpg">
+ Fix for bug #20239: Failure while generating XML metrics files from TT
+ collections when names are in Unicode (JM)
+ (JM)</li>
+
+<li>
+<img alt="fix" src="images/fix.jpg">
Fixed bug: PFBParser reports "Could not load the whole segment" (#19764).
(JM) Thanks to <a href="mailto:germannm.at.post.ch">Matthias Germann</a>.</li>
@@ -421,7 +439,7 @@
</ul>
</div>
-<a name="N1008D"></a><a name="2002"></a>
+<a name="N10093"></a><a name="2002"></a>
<h3>Version 2002 (2002)</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
1.11 +332 -501 xml-site/targets/fop/changes.pdf
<<Binary file>>
1.8 +7 -0 xml-site/targets/fop/changes.rss.xml
Index: changes.rss.xml
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/changes.rss.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- changes.rss.xml 14 May 2003 18:13:08 -0000 1.7
+++ changes.rss.xml 30 May 2003 18:37:32 -0000 1.8
@@ -5,6 +5,13 @@
JM
:
+ Fix for bug #20239: Failure while generating XML metrics files from TT
+ collections when names are in Unicode (JM)
+ </description></item><item><title>code fix</title><link>http://xml.apache.org/fop//changes.html</link><description>code fix
+ by
+ JM
+ :
+
Fixed bug: PFBParser reports "Could not load the whole segment" (#19764).
Thanks to Matthias Germann.</description></item><item><title>code add</title><link>http://xml.apache.org/fop//changes.html</link><description>code add
by
1.36 +12 -0 xml-site/targets/fop/compiling.html
Index: compiling.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/compiling.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- compiling.html 14 May 2003 18:13:08 -0000 1.35
+++ compiling.html 30 May 2003 18:37:32 -0000 1.36
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.9 +143 -169 xml-site/targets/fop/compiling.pdf
<<Binary file>>
1.17 +22 -2 xml-site/targets/fop/compliance.html
Index: compliance.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/compliance.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- compliance.html 14 May 2003 18:13:08 -0000 1.16
+++ compliance.html 30 May 2003 18:37:32 -0000 1.17
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -1162,10 +1174,18 @@
<td><a name="#fo-property-white-space-treatment">white-space-treatment</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#white-space-treatment">§7.15.8</a></td><td align="center" class="yes">.</td><td align="center" class="no">no</td><td align="center" class="no">.</td><td align="center">.</td>
</tr>
<tr>
-<td><a name="#fo-property-text-align">text-align</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#text-align">§7.15.9</a></td><td align="center" class="yes">yes</td><td align="center" class="yes">.</td><td align="center" class="yes">.</td><td align="center">.</td>
+<td><a name="#fo-property-text-align">text-align</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#text-align">§7.15.9</a></td><td align="center" class="partial">partial</td><td align="center" class="partial">.</td><td align="center" class="partial">.</td><td align="left">
+<ul>
+<li>Only start, end, center and justify are supported</li>
+</ul>
+</td>
</tr>
<tr>
-<td><a name="#fo-property-text-align-last">text-align-last</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#text-align-last">§7.15.10</a></td><td align="center" class="yes">.</td><td align="center" class="yes">yes</td><td align="center" class="yes">.</td><td align="center">.</td>
+<td><a name="#fo-property-text-align-last">text-align-last</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#text-align-last">§7.15.10</a></td><td align="center" class="yes">.</td><td align="center" class="partial">partial</td><td align="center" class="partial">.</td><td align="left">
+<ul>
+<li>Only start, end, center and justify are supported</li>
+</ul>
+</td>
</tr>
<tr>
<td><a name="#fo-property-text-indent">text-indent</a></td><td align="center"><a target="http://www.w3.org/TR/xsl" href="http://www.w3.org/TR/xsl/slice7.html#text-indent">§7.15.11</a></td><td align="center" class="yes">yes</td><td align="center" class="yes">.</td><td align="center" class="yes">.</td><td align="center">.</td>
1.6 +31 -44 xml-site/targets/fop/compliance.pdf
<<Binary file>>
1.15 +65 -15 xml-site/targets/fop/configuration.html
Index: configuration.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/configuration.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- configuration.html 14 May 2003 18:13:08 -0000 1.14
+++ configuration.html 30 May 2003 18:37:33 -0000 1.15
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -293,17 +305,22 @@
</table>
<ul class="minitoc">
<li>
-<a href="#How+to+configure+FOP">How to configure FOP</a>
+<a href="#general">How to configure FOP</a>
</li>
<li>
-<a href="#Setting+up+hyphenation">Setting up hyphenation</a>
+<a href="#hyphenation">Setting up hyphenation</a>
+<ul class="minitoc">
+<li>
+<a href="#hyphenation-sources">Places to find TeX hyphenation pattern files</a>
+</li>
+</ul>
</li>
</ul>
-<a name="N101BE"></a><a name="How+to+configure+FOP"></a>
+<a name="N101BE"></a><a name="general"></a>
<h3>How to configure FOP</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>In the directory xml-fop/conf you will find two configuration files. One of them,
+<p>In the directory {fop-dir}/conf you will find two configuration files. One of them,
config.xml, is only intended for FOP developers, who want to add new default values
to some FOP feature. Don't change this file. For user configuration there is a file called
userconfig.xml. It contains templates for all settings a user can change. Most of them are
@@ -317,24 +334,25 @@
</p>
</div>
-<a name="N101D3"></a><a name="Setting+up+hyphenation"></a>
+<a name="N101D3"></a><a name="hyphenation"></a>
<h3>Setting up hyphenation</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>FOP comes already with some hyphenation pattern. If you need a hyphenation pattern
- which isn't included in the distribution, do the following:
+<p>
+ FOP comes already with some hyphenation patterns. If you need a hyphenation pattern
+ which isn't included in the distribution, do the following:
</p>
<ol>
<li>
Get the TeX hyphenation pattern file and turn it into an xml file which
-conforms to the hyphenation.dtd in the subdirectory /src/hyph.
+conforms to the hyphenation.dtd in the subdirectory {fop-dir}/src/hyph.
</li>
<li>
-Name this new file following this schema: languageCode_countryCode.xml. If
-you don't need a country code, leave it out, e.g the file name for an American
-english hyphenation pattern would look like this: en_US.xml. For an Italian
-file: it.xml. Language and country codes must be the same as in xsl:fo, that
+Name this new file following this schema: <span class="codefrag">languageCode_countryCode.xml</span>. If
+you don't need a country code, leave it out, e.g. the file name for an American
+english hyphenation pattern would look like this: <span class="codefrag">en_US.xml</span>. For an Italian
+file: <span class="codefrag">it.xml</span>. Language and country codes must be the same as in XSL-FO, that
is follow
<a href="http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt">ISO 639</a>
and
@@ -344,13 +362,13 @@
</li>
<li>
-If you have build your new hyphenation pattern file successfully there are
+If you have built your new hyphenation pattern file successfully there are
two ways to make it accessible to FOP.
<ul>
<li>
-Put this new file into the directory /src/hyph and rebuild FOP. The file will
-be picked up and added to the fop.jar.
+Put this new file into the directory {fop-dir}/src/hyph and rebuild FOP. The file will
+be picked up and added to fop.jar.
</li>
<li>
@@ -363,6 +381,38 @@
</li>
</ol>
+<a name="N10202"></a><a name="hyphenation-sources"></a>
+<h4>Places to find TeX hyphenation pattern files</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The most important place to find hyphenation pattern file is the CTAN TeX Archive:
+ </p>
+<ul>
+
+<li>
+<a target="_blank" href="http://www.ctan.org/tex-archive/language/hyphenation/">CTAN TeX Archive</a>
+</li>
+
+</ul>
+</div>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">
+ You have to carefully check license issues when using hyphenation
+ pattern files from other places. The licenses of the files found
+ on the Internet are not always clear.
+ </div>
+</div>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+ Most of the files published in the CTAN Archive are licenced under the
+ <a target="_blank" href="http://www.latex-project.org/lppl.html">LaTeX Project Public License (LPPL)</a>.
+ The Apache Foundation can't redistribute files under this license. If you want to use such
+ a file you have to decide for yourself if you can use (and possibly distribute) the file under
+ these conditions.
+ </div>
+</div>
</div>
</div>
1.6 +201 -88 xml-site/targets/fop/configuration.pdf
<<Binary file>>
1.37 +12 -0 xml-site/targets/fop/download.html
Index: download.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/download.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- download.html 14 May 2003 18:13:08 -0000 1.36
+++ download.html 30 May 2003 18:37:33 -0000 1.37
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.9 +128 -154 xml-site/targets/fop/download.pdf
<<Binary file>>
1.39 +305 -278 xml-site/targets/fop/embedding.html
Index: embedding.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/embedding.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- embedding.html 14 May 2003 18:13:08 -0000 1.38
+++ embedding.html 30 May 2003 18:37:33 -0000 1.39
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -298,29 +310,23 @@
</li>
<li>
<a href="#basics">Basics</a>
-</li>
+<ul class="minitoc">
<li>
-<a href="#logging">Controlling logging</a>
+<a href="#basic-logging">Logging</a>
</li>
<li>
-<a href="#input">Input Sources</a>
+<a href="#render">Processing XSL-FO</a>
</li>
<li>
-<a href="#hints">Hints</a>
-<ul class="minitoc">
-<li>
-<a href="#object-reuse">Object reuse</a>
-</li>
-<li>
-<a href="#render-info">Getting information on the rendering process</a>
+<a href="#render-with-xslt">Processing XSL-FO generated from XML+XSLT</a>
</li>
</ul>
</li>
<li>
-<a href="#servlet">Using FOP in a Servlet</a>
+<a href="#logging">Controlling logging</a>
</li>
<li>
-<a href="#servlet-transform">Using FOP in a Servlet with an XSLT Transformation</a>
+<a href="#input">Input Sources</a>
</li>
<li>
<a href="#config-external">Using a Configuration File</a>
@@ -329,20 +335,26 @@
<a href="#config-internal">Setting the Configuration Programmatically</a>
</li>
<li>
-<a href="#multithreading">Multithreading FOP</a>
-</li>
-<li>
-<a href="#servlet-engine">Servlet Engines</a>
+<a href="#hints">Hints</a>
<ul class="minitoc">
<li>
-<a href="#tomcat">Tomcat</a>
+<a href="#object-reuse">Object reuse</a>
</li>
<li>
-<a href="#websphere">WebSphere 3.5</a>
+<a href="#awt">AWT issues</a>
+</li>
+<li>
+<a href="#render-info">Getting information on the rendering process</a>
</li>
</ul>
</li>
<li>
+<a href="#performance">Improving performance</a>
+</li>
+<li>
+<a href="#multithreading">Multithreading FOP</a>
+</li>
+<li>
<a href="#examples">Examples</a>
<ul class="minitoc">
<li>
@@ -395,161 +407,247 @@
<p>Here is an example use of Driver which outputs PDF:
</p>
<pre class="code">
- import org.apache.fop.apps.Driver;
+import org.apache.fop.apps.Driver;
- /*..*/
+/*..*/
- Driver driver = new Driver(new InputSource(args[0]),
- new FileOutputStream(args[1]));
- driver.setRenderer(Driver.RENDER_PDF);
- driver.run();</pre>
+Driver driver = new Driver(new InputSource(args[0]),
+ new FileOutputStream(args[1]));
+driver.setRenderer(Driver.RENDER_PDF);
+driver.run();</pre>
<p>
In the example above, args[0] contains the path to an XSL-FO file, while
args[1] contains a path for the target PDF file.
</p>
-<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.avalon.framework.logger.Logger. See
- <a target="_top" href="#logging">below</a> for more information.
- </p>
-<pre class="code">
- import org.apache.avalon.framework.logger.Logger;
- import org.apache.avalon.framework.logger.ConsoleLogger;
-
- /*..*/
-
- Logger logger = new ConsoleLogger(ConsoleLogger.LEVEL_INFO);
- MessageHandler.setScreenLogger(logger);
- driver.setLogger(logger);</pre>
-<p>To setup the user config file you can do the following
- </p>
+<a name="N101E6"></a><a name="basic-logging"></a>
+<h4>Logging</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.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:
+ </p>
<pre class="code">
- import org.apache.fop.apps.Options;
-
- /*..*/
-
- userConfigFile = new File(userConfig);
- options = new Options(userConfigFile);</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">
- This is all you need to do, it sets up a static configuration class.
- </div>
-</div>
-<p>Once the Driver is set up, the render method
- is called. Depending on whether DOM or SAX is being used, the
- invocation of the method is either <span class="codefrag">render(Document)</span> or
- <span class="codefrag">render(Parser, InputSource)</span> respectively.
- </p>
+import org.apache.avalon.framework.logger.Logger;
+import org.apache.avalon.framework.logger.ConsoleLogger;
+
+/*..*/
+
+Driver driver = new Driver();
+Logger logger = new ConsoleLogger(ConsoleLogger.LEVEL_INFO);
+MessageHandler.setScreenLogger(logger);
+driver.setLogger(logger);</pre>
+</div>
+<a name="N101FE"></a><a name="render"></a>
+<h4>Processing XSL-FO</h4>
+<div style="margin-left: 0 ; border: 2px">
<p>
-
-<strong>Another possibility may be used to build the FO Tree. You can
- call <span class="codefrag">getContentHandler()</span> and fire the SAX events yourself.
- </strong>
-
-</p>
-<p>Once the FO Tree is built, the format() and render() methods may be
- called in that order.
- </p>
+ Once the Driver is set up, one of the <span class="codefrag">render()</span> methods
+ is called. Depending on whether DOM or an InputSource is being used, the
+ 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
+ call <span class="codefrag">getContentHandler()</span> and fire the SAX events yourself.
+ </strong>
+ 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();
- driver.setRenderer(Driver.RENDER_PDF);
- driver.setInputSource(new FileInputSource(args[0]));
- driver.setOutputStream(new FileOutputStream(args[1]));
- driver.run();</pre>
-<p>You can also specify an xml and xsl file for the input.
- </p>
-<p>Here is an example use of Driver with the XSLTInputHandler:</p>
+Driver driver = new Driver();
+//Setup logging here: driver.setLogger(...
+driver.setRenderer(Driver.RENDER_PDF);
+driver.setInputSource(new FileInputSource(args[0]));
+driver.setOutputStream(new FileOutputStream(args[1]));
+driver.run();</pre>
+</div>
+<a name="N1022A"></a><a name="render-with-xslt"></a>
+<h4>Processing XSL-FO generated from XML+XSLT</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ If you want to process XSL-FO generated from XML using XSLT we recommend
+ using standard JAXP to do the XSLT part and piping the generated SAX
+ events directly through to FOP. Here's how this would look like:
+ </p>
<pre class="code">
- Driver driver = new Driver();
- driver.setRenderer(Driver.RENDER_PDF);
- InputHandler inputHandler = new XSLTInputHandler(xmlFile, xslFile);
- XMLReader parser = inputHandler.getParser();
- driver.setOutputStream(new FileOutputStream(outFile));
- driver.render(parser, inputHandler.getInputSource());</pre>
-<p>Have a look at the classes CommandLineStarter or FopServlet for complete
- examples. Also, have a look at the examples at the bottom of this page.
- </p>
+Driver driver = new Driver();
+//Setup logging here: driver.setLogger(...
+driver.setRenderer(Driver.RENDER_PDF);
+
+//Setup the OutputStream for FOP
+driver.setOutputStream(new java.io.FileOutputStream(outFile));
+
+//Make sure the XSL transformation's result is piped through to FOP
+Result res = new SAXResult(driver.getContentHandler());
+
+//Setup XML input
+Source src = new StreamSource(xmlFile);
+
+//Setup Transformer
+Source xsltSrc = new StreamSource(xslFile);
+TransformerFactory transformerFactory = TransformerFactory.newInstance();
+Transformer transformer = transformerFactory.newTransformer(xsltSrc);
+
+//Start the transformation and rendering process
+transformer.transform(src, res);</pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">If your XSL-FO files contain SVG then Batik will be used. When Batik is
-initialised it uses certain classes in <span class="codefrag">java.awt</span> that
-intialises the java AWT classes. This means that a daemon thread
-is created by the JVM and on Unix it will need to connect to a
-DISPLAY.
-The thread means that the Java application will not automatically quit
-when finished, you will need to call <span class="codefrag">System.exit()</span>. These
-issues should be fixed in the upcoming JDK 1.4</div>
+<div class="content">There's no need to call <span class="codefrag">run()</span> or <span class="codefrag">render()</span>.</div>
+</div>
+<p>
+ This may look complicated at first, but it's really just the combination of an
+ XSL transformation and a FOP run. It's also easy to comment out the FOP part
+ for debugging purposes, for example when you're tracking down a bug in your
+ stylesheet. You can easily write the XSL-FO output from the XSL transformation
+ to a file to check if that part generates the expected output.
+ </p>
+<p>
+ 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="N1022E"></a><a name="logging"></a>
+<a name="N1024C"></a><a name="logging"></a>
<h3>Controlling logging</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>FOP uses Jakarta Avalon's
- <a target="_blank" href="http://jakarta.apache.org/avalon/api/org/apache/avalon/framework/logger/Logger.html">Logger</a>
- interface to do logging. See the <a target="_blank" href="http://jakarta.apache.org/avalon/">Jakarta Avalon project</a> for more information.</p>
-<p>Per default FOP uses the ConsoleLogger 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
- different Logger implementation on the Driver object. Here's an example how you would use LogKit:</p>
+<p>
+ FOP uses the
+ <a target="_blank" href="http://avalon.apache.org/framework/api/org/apache/avalon/framework/logger/package-summary.html">Logger package</a>
+ from Apache Avalon Framework to do logging. See the
+ <a target="_blank" href="http://avalon.apache.org/framework/">Apache Avalon Framework</a>
+ for more information.
+ </p>
+<p>
+ Per default FOP uses the ConsoleLogger 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
+ different Logger implementation on the Driver object. Here's an example how you would use LogKit:
+ </p>
<pre class="code">
- Hierarchy hierarchy = Hierarchy.getDefaultHierarchy();
- PatternFormatter formatter = new PatternFormatter(
- "[%{priority}]: %{message}\n%{throwable}" );
-
- LogTarget target = null;
- target = new StreamTarget(System.out, formatter);
-
- hierarchy.setDefaultLogTarget(target);
- log = hierarchy.getLoggerFor("fop");
- log.setPriority(Priority.INFO);
-
- driver.setLogger(new org.apache.avalon.framework.logger.LogKitLogger(log));</pre>
-<p>The LogKitLogger class implements the Logger interface so all logging calls are being redirected to LogKit.
- More information on Jakarta LogKit can be found <a target="_blank" href="http://jakarta.apache.org/avalon/logkit/index.html">here</a>.</p>
-<p>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>
-<p>If you want to use yet another logging facility you simply have to create a class that implements org.apache.avalon.framework.logging.Logger
- and set it on the Driver object. See the existing implementations in Avalon Framework for examples.</p>
+Hierarchy hierarchy = Hierarchy.getDefaultHierarchy();
+PatternFormatter formatter = new PatternFormatter(
+ "[%{priority}]: %{message}\n%{throwable}" );
+
+LogTarget target = null;
+target = new StreamTarget(System.out, formatter);
+
+hierarchy.setDefaultLogTarget(target);
+log = hierarchy.getLoggerFor("fop");
+log.setPriority(Priority.INFO);
+
+driver.setLogger(new org.apache.avalon.framework.logger.LogKitLogger(log));</pre>
+<p>
+ The LogKitLogger class implements the Logger interface so all logging calls are being redirected to LogKit.
+ More information on Jakarta LogKit can be found <a target="_blank" href="http://jakarta.apache.org/avalon/logkit/index.html">here</a>.
+ </p>
+<p>
+ 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>
+<p>
+ If you want to use yet another logging facility you simply have to create a class that
+ implements org.apache.avalon.framework.logging.Logger and set it on the Driver object.
+ See the existing implementations in Avalon Framework for examples.
+ </p>
</div>
-
-<a name="N10257"></a><a name="input"></a>
+
+<a name="N10275"></a><a name="input"></a>
<h3>Input Sources</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>The input XSL-FO document is always handled internally as SAX (see the <a href="design/parsing.html">Parsing Design Document</a> for the rationale).
-However, the input itself can be provided in a variety of ways to FOP, which normalizes the input (if necessary) into SAX events:</p>
+<p>
+ The input XSL-FO document is always handled internally as SAX (see the
+ <a href="design/parsing.html">Parsing Design Document</a> for the rationale).
+ 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>
<strong>SAX Events through SAX Handler</strong>: <span class="codefrag">FOTreeBuilder</span> is the SAX Handler which is obtained through <span class="codefrag">getContentHandler</span> on <span class="codefrag">Driver</span>.</li>
-
+
<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>There are a variety of upstream data manipulations possible.
-For example, you may have a DOM and an XSL stylesheet; or you may want to
-set variables in the stylesheet.
-Interface documentation and some cookbook solutions to these situations are provided in <a target="_blank" href="http://xml.apache.org/xalan-j/usagepatterns.html">Xalan Basic Usage Patterns</a>.</p>
<p>
-See the <a href="#examples">Examples</a> for some variations on input.
- </p>
+ There are a variety of upstream data manipulations possible.
+ For example, you may have a DOM and an XSL stylesheet; or you may want to
+ set variables in the stylesheet. Interface documentation and some cookbook
+ solutions to these situations are provided in
+ <a target="_blank" href="http://xml.apache.org/xalan-j/usagepatterns.html">Xalan Basic Usage Patterns</a>.
+ </p>
+<p>
+ See the <a href="#examples">Examples</a> for some variations on input.
+ </p>
</div>
-<a name="N102B4"></a><a name="hints"></a>
+<a name="N102D2"></a><a name="config-external"></a>
+<h3>Using a Configuration File</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ To access an external configuration:
+ </p>
+<pre class="code">
+import org.apache.fop.apps.Options;
+
+/*..*/
+
+userConfigFile = new File(userConfig);
+options = new Options(userConfigFile);</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<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.
+ The "options = " is actually not even necessary.
+ </p>
+<p>
+ See <a href="#multithreading">Multithreading FOP</a> for issues related to changing configuration in a multithreaded environment.
+ </p>
+</div>
+
+<a name="N102F0"></a><a name="config-internal"></a>
+<h3>Setting the Configuration Programmatically</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ If you wish to set configuration options from within your embedded application, use the <span class="codefrag">Configuration.put</span> method. Here is an example that sets the "baseDir" configuration in a Unix environment:
+ </p>
+<pre class="code">org.apache.fop.configuration.Configuration.put("baseDir","/my/base/dir");</pre>
+<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="N1030F"></a><a name="hints"></a>
<h3>Hints</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N102BA"></a><a name="object-reuse"></a>
+<a name="N10315"></a><a name="object-reuse"></a>
<h4>Object reuse</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -559,12 +657,32 @@
<p>
The renderers and the driver can both be reused. A renderer is reusable
once the previous render has been completed. The driver is reuseable
-after the rendering is complete and the reset method is called.
+after the rendering is complete and the <span class="codefrag">reset()</span> method is called.
You will need to setup the driver again with a new OutputStream,
IntputStream and renderer.
</p>
</div>
-<a name="N102C7"></a><a name="render-info"></a>
+<a name="N10325"></a><a name="awt"></a>
+<h4>AWT issues</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ If your XSL-FO files contain SVG then Batik will be used. When Batik is
+ initialised it uses certain classes in <span class="codefrag">java.awt</span> that
+ intialises the java AWT classes. This means that a daemon thread
+ 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
+ issues should be fixed in the upcoming JDK 1.4.
+ </p>
+<p>
+ If you run into trouble running FOP on a head-less server, please see the
+ <a href="graphics.html#batik">notes on Batik</a>.
+ </p>
+</div>
+<a name="N1033F"></a><a name="render-info"></a>
<h4>Getting information on the rendering process</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -579,110 +697,43 @@
</div>
</div>
-<a name="N102D5"></a><a name="servlet"></a>
-<h3>Using FOP in a Servlet</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Here is a minimal code snippet to demonstrate the basics:
- </p>
-<pre class="code">response.setContentType("application/pdf");
-Driver driver=new Driver( new InputSource("foo.fo"),
- response.getOutputStream());
-driver.setRenderer(Driver.RENDER_PDF);
-driver.run();</pre>
-<p>
-There are numerous problems with the code snippet above.
-Its purpose is only to demonstrate the basic concepts.
-See xml-fop/examples/servlet for a working example of FOP used in a servlet.
-After building the servlet, drop the fop.war into the webapps directory of Tomcat.
-Then access a URL as follows:
- </p>
-<p>http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo</p>
-<p>http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl</p>
-<p>The source code for the servlet can be found under xml-fop/examples/servlet/src/FopServlet.java.</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">
- Some versions of Internet Explorer will not automatically show the PDF.
-This is well-known to be a limitation of Internet Explorer, and is not a problem with the servlet.
-However, Internet Explorer can still be used to download the PDF so that it can be viewed later. Also, appending ".pdf" to the end of the URL may help.
- </div>
-</div>
-</div>
-
-<a name="N102F2"></a><a name="servlet-transform"></a>
-<h3>Using FOP in a Servlet with an XSLT Transformation</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- If both the source XML and XSL are read from files, use the TraxInputHandler:
- </p>
-<pre class="code">response.setContentType("application/pdf");
-XSLTInputHandler input
- =new XSLTInputHandler(new File("foo.xml"), new File("foo.xsl"));
-Driver driver=new Driver();
-driver.setOutputStream(response.getOutputStream());
-driver.setRenderer(Driver.RENDER_PDF);
-driver.render(input.getParser(), input.getInputSource());</pre>
-<p>
- This code snippet has the same problems as the one from the <a href="#servlet">section above</a>.
- </p>
-<p>
- If your source XML is generated on the fly (for example from a database, a web service, or another servlet), create a transformer object explicitly, and use a SAX event stream to feed the transformation result into FOP:
- </p>
-<pre class="code">response.setContentType("application/pdf");
-Driver driver =new Driver();
-driver.setOutputStream(response.getOutputStream());
-driver.setRenderer(Driver.RENDER_PDF);
-Transformer transformer=TransformerFactory.newInstance()
- .newTransformer(new StreamSource("foo.xsl"));
-transformer.transform(xmlsource, new SAXResult(driver.getContentHandler()));</pre>
-<p>
- You don't have to call run() or render() on the driver object.
- </p>
-<p>
- The <span class="codefrag">xmlsource</span> is a placeholder for your actual XML source.
-If you have to read the XML from a string, supply a <span class="codefrag">new StreamSource(new StringReader(xmlstring))</span>.
-Constructing and reparsing an XML string is generally less desirable than using a SAXSource if you generate your XML.
-You can alternatively supply a DOMSource as well.
-You may also use dynamically generated XSL if you like.
- </p>
-<p>
- Because you have an explicit transformer object, you can also use it to explicitly set parameters for the transformation run.
- </p>
-</div>
-
-<a name="N1031D"></a><a name="config-external"></a>
-<h3>Using a Configuration File</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- To access an external configuration:
- </p>
-<pre class="code">org.apache.fop.apps.Options options = new Options(new File("userconfig.xml"));</pre>
-<p>
- No further reference to the <span class="codefrag">options</span> variable is necessary.
- </p>
-<p>
- See <a href="#multithreading">Multithreading FOP</a> for issues related to changing configuration in a multithreaded environment.
- </p>
-</div>
-
-<a name="N10338"></a><a name="config-internal"></a>
-<h3>Setting the Configuration Programmatically</h3>
+<a name="N1034D"></a><a name="performance"></a>
+<h3>Improving performance</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
- If you wish to set configuration options from within your embedded application, use the <span class="codefrag">Configuration.put</span> method. Here is an example that sets the "baseDir" configuration in a Unix environment:
- </p>
-<pre class="code">org.apache.fop.configuration.Configuration.put("baseDir","/my/base/dir");</pre>
-<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.
+ There are several options to consider:
</p>
+<ul>
+
+<li>
+ Whenever possible, try to use SAX to couple the individual components involved
+ (parser, XSL transformer, SQL datasource etc.).
+ </li>
+
+<li>
+ Depending on the target OutputStream (in case of an FileOutputStream, but not
+ for a ByteArrayOutputStream, for example) it may improve performance considerably
+ if you buffer the OutputStream using a BufferedOutputStream:
+ <span class="codefrag">driver.setOutputStream(new java.io.BufferedOutputStream(out));</span>
+
+<br>
+ 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
+ the XSL transformation.
+ </li>
+
+<li>
+ Use an XSLT compiler like XSLTC that comes with Xalan-J.
+ </li>
+
+</ul>
</div>
-<a name="N10357"></a><a name="multithreading"></a>
+<a name="N1036E"></a><a name="multithreading"></a>
<h3>Multithreading FOP</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -693,57 +744,33 @@
</p>
<ul>
-<li>To avoid having your threads blocked, create a Driver object for each thread.</li>
+<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.
-Setup the configuration only once, preferably in the <span class="codefrag">init()</span> method of the servlet.
+<li>
+ If possible, do not change the configuration data while there is a Driver object rendering.
+ Setup the configuration only once, preferably in the <span class="codefrag">init()</span> method of the servlet.
</li>
-<li>If you must change the configuration data more often, or if you have multiple servlets within the same webapp using FOP, consider implementing a singleton class to encapsulate the configuration settings and to run FOP in synchronized methods.
+<li>
+ If you must change the configuration data more often, or if you have multiple
+ servlets within the same webapp using FOP, consider implementing a singleton
+ class to encapsulate the configuration settings and to run FOP in synchronized methods.
</li>
</ul>
</div>
-
-<a name="N10370"></a><a name="servlet-engine"></a>
-<h3>Servlet Engines</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts with existing XML/XSLT libraries.
-Servlet containers also often use their own classloaders for loading webapps, which can cause bugs and security problems.
- </p>
-<a name="N10379"></a><a name="tomcat"></a>
-<h4>Tomcat</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon.
-There are known bugs that must be addressed, particularly for Tomcat 4.0.3.
- </p>
-</div>
-<a name="N10383"></a><a name="websphere"></a>
-<h4>WebSphere 3.5</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Put a copy of a working parser in some directory where WebSphere can access it.
-For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, copy the Xerces jar into it (any other directory would also be fine).
-Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the application server which contains your web application.
-In the WebSphere administration console, click on the "environment" button in the "general" tab.
-In the "variable name" box, enter "CLASSPATH".
-In the "value" box, enter the correct path to the parser jar file (/usr/webapps/yourapp/servlets/Xerces.jar in our example here).
-Press "OK", then apply the change and restart the application server.
- </p>
-</div>
-</div>
-<a name="N1038E"></a><a name="examples"></a>
+<a name="N10387"></a><a name="examples"></a>
<h3>Examples</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
-The directory "xml-fop/examples/embedding" contains several working examples.
+The directory "{fop-fir}/examples/embedding" contains several working examples.
In contrast of 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="N10397"></a><a name="ExampleFO2PDF"></a>
+<a name="N10390"></a><a name="ExampleFO2PDF"></a>
<h4>ExampleFO2PDF.java</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -753,7 +780,7 @@
<div align="center">
<img class="figure" alt="Example XSL-FO to PDF" src="images/EmbeddingExampleFO2PDF.png"></div>
</div>
-<a name="N103A5"></a><a name="ExampleXML2FO"></a>
+<a name="N1039E"></a><a name="ExampleXML2FO"></a>
<h4>ExampleXML2FO.java</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -765,7 +792,7 @@
<div align="center">
<img class="figure" alt="Example XML to XSL-FO" src="images/EmbeddingExampleXML2FO.png"></div>
</div>
-<a name="N103B7"></a><a name="ExampleXML2PDF"></a>
+<a name="N103B0"></a><a name="ExampleXML2PDF"></a>
<h4>ExampleXML2PDF.java</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -785,7 +812,7 @@
performance is significantly higher with SAX.
</p>
</div>
-<a name="N103C8"></a><a name="ExampleObj2XML"></a>
+<a name="N103C1"></a><a name="ExampleObj2XML"></a>
<h4>ExampleObj2XML.java</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -818,7 +845,7 @@
<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="N103E3"></a><a name="ExampleObj2PDF"></a>
+<a name="N103DC"></a><a name="ExampleObj2PDF"></a>
<h4>ExampleObj2PDF.java</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -831,7 +858,7 @@
<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="N103F1"></a><a name="example-notes"></a>
+<a name="N103EA"></a><a name="example-notes"></a>
<h4>Final notes</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
1.9 +562 -650 xml-site/targets/fop/embedding.pdf
<<Binary file>>
1.31 +106 -15 xml-site/targets/fop/examples.html
Index: examples.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/examples.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- examples.html 14 May 2003 18:13:09 -0000 1.30
+++ examples.html 30 May 2003 18:37:33 -0000 1.31
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -293,10 +305,22 @@
</table>
<ul class="minitoc">
<li>
-<a href="#Examples+in+the+distribution">Examples in the distribution</a>
+<a href="#Example+Documents+Using+FOP">Example Documents Using FOP</a>
+</li>
+<li>
+<a href="#Images+Examples">Images Examples</a>
+</li>
+<li>
+<a href="#Instream+Foreign+Object+Examples">Instream Foreign Object Examples</a>
</li>
</ul>
+<a name="N101BE"></a><a name="Example+Documents+Using+FOP"></a>
+<h3>Example Documents Using FOP</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ These examples have been rendered using FOP:
+ </p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<caption>Generated examples</caption>
@@ -318,12 +342,7 @@
</tr>
</table>
-
-
-<a name="N101EC"></a><a name="Examples+in+the+distribution"></a>
-<h3>Examples in the distribution</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>Examples for the use of XSL-FO can be found in the FOP distribution in
+<p>Other basic examples on the use of XSL-FO can be found in the FOP distribution in
the subdirectory xml-fop/examples/fo. You can start transformation of all fo files into pdf
files by starting xml-fop/examples/fo/runtests (only source distribution). The resulting test
files can be found in xml-fop/examples/fo/tests
@@ -370,20 +389,92 @@
<li>readme.fo - uses an old version of FOP documentation for a longer example
</li>
-
-
-<li>Look also into the directory examples/fo/svg. There you find some very extensive SVG examples.
- </li>
-
-<li>In the directory examples/fo/pagination you find a suite of examples showing the use
- of XSL-FO pagination.
- </li>
</ul>
+<p>Also, in the directory examples/fo/pagination you will find a suite of examples showing the use
+ of XSL-FO pagination.
+ </p>
<p>
Developers will find the first steps to a test suite for all implemented
formatting objects and properties in xml-fop/test/xml/.
</p>
+</div>
+
+<a name="N1022C"></a><a name="Images+Examples"></a>
+<h3>Images Examples</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+Embedding images in FO:
+ </p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<caption>Images in FO</caption>
+
+<tr>
+
+<th colspan="1" rowspan="1">description</th>
+ <th colspan="1" rowspan="1">fo file</th>
+ <th colspan="1" rowspan="1">pdf result</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">align in larger viewport</td>
+ <td colspan="1" rowspan="1"><a href="fo/align.fo.xml">align.fo</a></td>
+ <td colspan="1" rowspan="1"><a href="fo/align.fo.pdf">align.fo.pdf</a></td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">align in smaller viewport</td>
+ <td colspan="1" rowspan="1"><a href="fo/align2.fo.xml">align2.fo</a></td>
+ <td colspan="1" rowspan="1"><a href="fo/align2.fo.pdf">align2.fo.pdf</a></td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">scaling image</td>
+ <td colspan="1" rowspan="1"><a href="fo/size.fo.xml">size.fo</a></td>
+ <td colspan="1" rowspan="1"><a href="fo/size.fo.pdf">size.fo.pdf</a></td>
+
+</tr>
+
+</table>
+<p>Look also into the directory examples/fo/svg. There you find some very extensive SVG examples.
+ </p>
+</div>
+
+<a name="N10293"></a><a name="Instream+Foreign+Object+Examples"></a>
+<h3>Instream Foreign Object Examples</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+Instream Foreign Object images in FO, there are more on the
+<a href="svg.html">SVG Page</a>:
+ </p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<caption>Embedding instream-foreign-object</caption>
+
+<tr>
+
+<th colspan="1" rowspan="1">description</th>
+ <th colspan="1" rowspan="1">fo file</th>
+ <th colspan="1" rowspan="1">pdf result</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">embedding svg in viewport</td>
+ <td colspan="1" rowspan="1"><a href="fo/embed.fo.xml">embed.fo</a></td>
+ <td colspan="1" rowspan="1"><a href="fo/embed.fo.pdf">embed.fo.pdf</a></td>
+
+</tr>
+
+</table>
</div>
</div>
1.6 +356 -137 xml-site/targets/fop/examples.pdf
<<Binary file>>
1.26 +12 -0 xml-site/targets/fop/extensions.html
Index: extensions.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/extensions.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- extensions.html 14 May 2003 18:13:09 -0000 1.25
+++ extensions.html 30 May 2003 18:37:33 -0000 1.26
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.9 +108 -134 xml-site/targets/fop/extensions.pdf
<<Binary file>>
1.30 +201 -147 xml-site/targets/fop/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/faq.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- faq.html 14 May 2003 18:13:09 -0000 1.29
+++ faq.html 30 May 2003 18:37:33 -0000 1.30
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -369,6 +381,11 @@
<a name="part-output-menu"></a><a href="#part-output">3. Problems with FOP output</a>
<ul>
<li>
+<a name="leader-expansion-menu"></a><a href="#leader-expansion">Leaders don't work anymore in 0.20.5. Instead of
+ filling the line, only three dots or a short ruler is
+ output.</a>
+</li>
+<li>
<a name="blank-page-between-page-sequences-menu"></a><a href="#blank-page-between-page-sequences">Why does FOP insert a blank page between my page sequences?</a>
</li>
<li>
@@ -395,7 +412,7 @@
<a name="page-number-align-menu"></a><a href="#page-number-align">Page numbers are not properly right aligned.</a>
</li>
<li>
-<a name="hypenation-fails-menu"></a><a href="#hypenation-fails">Hyphenation does not work.</a>
+<a name="hyphenation-fails-menu"></a><a href="#hyphenation-fails">Hyphenation does not work.</a>
</li>
</ul>
</li>
@@ -574,13 +591,13 @@
</li>
</ul>
</div>
-<a name="N101A3"></a>
+<a name="N101A8"></a>
<h3>Answers</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N101A6"></a><a name="part-general"></a>
+<a name="N101AB"></a><a name="part-general"></a>
<h4>1. General questions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N101AA"></a><a name="fop-general"></a>
+<a name="N101AF"></a><a name="fop-general"></a>
<h5>1.1. What is FOP?<span style="float: right"><a href="#fop-general-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -594,7 +611,7 @@
are supported, such as AWT, PCL, text and direct printing.
</p>
</div>
-<a name="N101B9"></a><a name="fop-functions"></a>
+<a name="N101BE"></a><a name="fop-functions"></a>
<h5>1.2. What can I do with FOP?<span style="float: right"><a href="#fop-functions-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -611,7 +628,7 @@
The library can be used in servlets and other Java applications.
</p>
</div>
-<a name="N101C7"></a><a name="fop-acronym"></a>
+<a name="N101CC"></a><a name="fop-acronym"></a>
<h5>1.3. What does "FOP" stand for?<span style="float: right"><a href="#fop-acronym-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -620,7 +637,7 @@
<strong>O</strong>bject <strong>P</strong>rocessor
</p>
</div>
-<a name="N101D8"></a><a name="fop-other-apache"></a>
+<a name="N101DD"></a><a name="fop-other-apache"></a>
<h5>1.4. How does FOP interact with other Apache Projects?<span style="float: right"><a href="#fop-other-apache-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -635,7 +652,7 @@
image</a> into a PDF document.
</p>
</div>
-<a name="N101EF"></a><a name="xsl-def"></a>
+<a name="N101F4"></a><a name="xsl-def"></a>
<h5>1.5. What is XSL?<span style="float: right"><a href="#xsl-def-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -646,7 +663,7 @@
<strong>L</strong>anguage.
</p>
</div>
-<a name="N10208"></a><a name="xslfo"></a>
+<a name="N1020D"></a><a name="xslfo"></a>
<h5>1.6. What is XSL-FO?<span style="float: right"><a href="#xslfo-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -669,7 +686,7 @@
Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
</p>
</div>
-<a name="N10220"></a><a name="XSLT"></a>
+<a name="N10225"></a><a name="XSLT"></a>
<h5>1.7. What is XSLT?<span style="float: right"><a href="#XSLT-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -683,7 +700,7 @@
Synonyms: XSL transformation, XSL:T, XSL style sheet.
</p>
</div>
-<a name="N1022E"></a><a name="contribute"></a>
+<a name="N10233"></a><a name="contribute"></a>
<h5>1.8. How can I contribute?<span style="float: right"><a href="#contribute-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -692,10 +709,10 @@
</p>
</div>
</div>
-<a name="N1023A"></a><a name="part-running"></a>
+<a name="N1023F"></a><a name="part-running"></a>
<h4>2. Problems running FOP</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1023E"></a><a name="no-page-master"></a>
+<a name="N10243"></a><a name="no-page-master"></a>
<h5>2.1. I get the error: [ERROR]: 'master-reference' for
'fo:page-sequence'matches no 'simple-page-master' or
'page-sequence-master'<span style="float: right"><a href="#no-page-master-menu">^</a></span>
@@ -713,22 +730,22 @@
definitions.
</p>
<p>
- See also <a href="relnotes.html">release notes</a>.
+ Update your FO documents and style sheets.
</p>
</div>
-<a name="N10251"></a><a name="NoClassDefFound"></a>
+<a name="N10252"></a><a name="NoClassDefFound"></a>
<h5>2.2. I get a NoClassDefFound exception.<span style="float: right"><a href="#NoClassDefFound-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
-<p>
- This is typically a problem with your classpath.</p>
+<p>This is typically a problem with your classpath.</p>
<p>If you are running FOP from the command line:</p>
<ul>
<li>
- Use the fop.bat or fop.sh command file from the FOP distribution.
- Ensure the directory where FOP and these files have been installed
- is the current working directory.
+ Use the fop.bat or fop.sh command file from the FOP
+ distribution. If you have a FOP version older than 0.20.5,
+ ensure the directory where FOP and these files have been
+ installed is the current working directory.
</li>
<li>
@@ -739,11 +756,13 @@
</ul>
<p>
- If you run FOP embedded in your servlet, web application or other
- Java application, check the classpath of the application.
+ If you run FOP embedded in your servlet, web application or
+ other Java application, check the classpath of the
+ application. Check the also the information pertaining <a href="servlets.xml#servlet-engine">servlet engines</a>
+ for further hints.
</p>
</div>
-<a name="N10268"></a><a name="NoSuchMethodException"></a>
+<a name="N1026D"></a><a name="NoSuchMethodException"></a>
<h5>2.3. I get a NoSuchMethodException or a NoSuchFieldException
exception.<span style="float: right"><a href="#NoSuchMethodException-menu">^</a></span>
</h5>
@@ -759,7 +778,7 @@
use a more recent version of Batik.
</p>
</div>
-<a name="N10273"></a><a name="OutOfMemoryException"></a>
+<a name="N10278"></a><a name="OutOfMemoryException"></a>
<h5>2.4. I get an OutOfMemoryException.<span style="float: right"><a href="#OutOfMemoryException-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -767,7 +786,7 @@
See <a href="running.html#memory">FOP Memory</a>.
</p>
</div>
-<a name="N1027F"></a><a name="MalformedURLException"></a>
+<a name="N10284"></a><a name="MalformedURLException"></a>
<h5>2.5. I get a MalformedURLException.<span style="float: right"><a href="#MalformedURLException-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -797,7 +816,7 @@
URL.
</p>
</div>
-<a name="N102AF"></a><a name="NullPointerException"></a>
+<a name="N102B4"></a><a name="NullPointerException"></a>
<h5>2.6. I get an "[ERROR]: null", or a NullPointerException.<span style="float: right"><a href="#NullPointerException-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -819,7 +838,7 @@
</p>
<p>
If you use XSLT, problems in your style sheet and in your source XML
- also often produce a NullPointerException. Run the transformation
+ also can produce a NullPointerException. Run the transformation
separately to check for this, usually you'll get a detailed error
message from the XSLT processor.
</p>
@@ -828,13 +847,13 @@
see more detailed information.
</p>
</div>
-<a name="N102C4"></a><a name="not-implemented"></a>
+<a name="N102C9"></a><a name="not-implemented"></a>
<h5>2.7. FOP returns the message "[ERROR] object|property - 'x' is not implemented yet." When will it be implemented?<span style="float: right"><a href="#not-implemented-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See the article "<a href="gethelp.html#compliance">Review FOP's Standards Compliance</a>".</p>
</div>
-<a name="N102D3"></a><a name="fop-hangs"></a>
+<a name="N102D8"></a><a name="fop-hangs"></a>
<h5>2.8. FOP hangs. FOP does not exit.<span style="float: right"><a href="#fop-hangs-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -858,7 +877,7 @@
exec'ing FOP, use the library interface instead.
</p>
</div>
-<a name="N102E9"></a><a name="boxoverflow"></a>
+<a name="N102EE"></a><a name="boxoverflow"></a>
<h5>2.9. FOP runs forever, writing lots of ">" to the log.<span style="float: right"><a href="#boxoverflow-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -873,7 +892,7 @@
remove keep-with-* properties.
</p>
</div>
-<a name="N102F1"></a><a name="cannot-find-external-graphics"></a>
+<a name="N102F6"></a><a name="cannot-find-external-graphics"></a>
<h5>2.10. FOP cannot find a file for fo:external-graphics.<span style="float: right"><a href="#cannot-find-external-graphics-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -890,13 +909,13 @@
working directory of the process which runs FOP.
</p>
</div>
-<a name="N10300"></a><a name="fonts-not-found"></a>
+<a name="N10305"></a><a name="fonts-not-found"></a>
<h5>2.11. FOP does not find my fonts.<span style="float: right"><a href="#fonts-not-found-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
Did you get: «Failed to read font metrics file C:\foo\arial.xml
- : File "C:\foo\arial.xml" not found²? The value for the
+ : File "C:\foo\arial.xml" not found»? The value for the
metrics-file attribute in the user config file is actually an URL, not
a file name. Use "file:///C:/foo/arial.xml" instead.
</p>
@@ -905,13 +924,53 @@
directory you expect. Currently FOP does not use the baseDir for
resolving relative URLs pointing to font metric files.
</p>
+<p>
+ Try also setting the fontBaseDir configuration. (FIXME: add
+ link to congfiguration page)
+ </p>
</div>
</div>
-<a name="N1030B"></a><a name="part-output"></a>
+<a name="N10313"></a><a name="part-output"></a>
<h4>3. Problems with FOP output</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1030F"></a><a name="blank-page-between-page-sequences"></a>
-<h5>3.1. Why does FOP insert a blank page between my page sequences?<span style="float: right"><a href="#blank-page-between-page-sequences-menu">^</a></span>
+<a name="N10317"></a><a name="leader-expansion"></a>
+<h5>3.1. Leaders don't work anymore in 0.20.5. Instead of
+ filling the line, only three dots or a short ruler is
+ output.<span style="float: right"><a href="#leader-expansion-menu">^</a></span>
+</h5>
+<div style="margin-left: 15 ; border: 2px">
+<p>
+ Leaders still work, in fact they work better than ever
+ before. You'll just have to add text-align="justify" and/or
+ text-align-last="justify" to the block with the leader. Be
+ sure you haven't accidentally overridden the
+ leader-length.maximum="100%" default value.
+ </p>
+<p>
+ Earlier versions of FOP used to expand a leader to fill the
+ rest of the line unconditionally, anything following it,
+ like page numbers in a TOC, was actually shifted beyong the
+ right margin.
+ </p>
+<p>
+ The new implementation uses leader-length.optimum to
+ determine where to break the line, and expands the leader
+ only further if the line should be filled, as indicated by
+ the text-aling and text-align-last properties.
+ </p>
+<p>
+ Actually due to the fuzzyness of the specification both the
+ old and the new method are conformant (although adding text
+ after the expanded leader in the old variant never was).
+ </p>
+<p>
+ If you want to have a longer ruler or space in a
+ non-justified line, you have to increase the
+ leader-length.optimum property.
+ </p>
+</div>
+<a name="N1032B"></a><a name="blank-page-between-page-sequences"></a>
+<h5>3.2. Why does FOP insert a blank page between my page sequences?<span style="float: right"><a href="#blank-page-between-page-sequences-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
@@ -934,8 +993,8 @@
<span class="codefrag">force-page-count="no-force"</span>.
</p>
</div>
-<a name="N10327"></a><a name="graphic-not-displayed"></a>
-<h5>3.2. Why is my graphic not rendered?<span style="float: right"><a href="#graphic-not-displayed-menu">^</a></span>
+<a name="N10343"></a><a name="graphic-not-displayed"></a>
+<h5>3.3. Why is my graphic not rendered?<span style="float: right"><a href="#graphic-not-displayed-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>Most commonly, the external file is not being found by FOP.
@@ -964,20 +1023,20 @@
</ul>
</div>
-<a name="N10351"></a><a name="png-fails"></a>
-<h5>3.3. My graphical images do not work properly.<span style="float: right"><a href="#png-fails-menu">^</a></span>
+<a name="N1036D"></a><a name="png-fails"></a>
+<h5>3.4. My graphical images do not work properly.<span style="float: right"><a href="#png-fails-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="graphics.html">FOP Graphics Formats</a> for a list of supported formats and related issues.</p>
</div>
-<a name="N1035D"></a><a name="graphic-resolution"></a>
-<h5>3.4. Why is my graphic rendered at a different resolution than it was created?<span style="float: right"><a href="#graphic-resolution-menu">^</a></span>
+<a name="N10379"></a><a name="graphic-resolution"></a>
+<h5>3.5. Why is my graphic rendered at a different resolution than it was created?<span style="float: right"><a href="#graphic-resolution-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="graphics.html#resolution">Graphics Resolution</a>.</p>
</div>
-<a name="N10369"></a><a name="keep-with"></a>
-<h5>3.5. Keep-with-next, keep-with-previous, keep-together
+<a name="N10385"></a><a name="keep-with"></a>
+<h5>3.6. Keep-with-next, keep-with-previous, keep-together
don't work.<span style="float: right"><a href="#keep-with-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1011,8 +1070,8 @@
</fo:table-body>
</fo:table></pre>
</div>
-<a name="N1037B"></a><a name="table-missing"></a>
-<h5>3.6. My tables are missing, or missing their content.<span style="float: right"><a href="#table-missing-menu">^</a></span>
+<a name="N10397"></a><a name="table-missing"></a>
+<h5>3.7. My tables are missing, or missing their content.<span style="float: right"><a href="#table-missing-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
@@ -1027,8 +1086,8 @@
fo:table-with-caption elements, so watch out.
</p>
</div>
-<a name="N10386"></a><a name="cells-overflow"></a>
-<h5>3.7. Text overflowing table cells and the like is not clipped. Long
+<a name="N103A2"></a><a name="cells-overflow"></a>
+<h5>3.8. Text overflowing table cells and the like is not clipped. Long
text flows into adjacent cells/block, obscuring stuff there.<span style="float: right"><a href="#cells-overflow-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1061,38 +1120,49 @@
archive</a> for how to perform these tasks.
</p>
</div>
-<a name="N103A8"></a><a name="page-number-align"></a>
-<h5>3.8. Page numbers are not properly right aligned.<span style="float: right"><a href="#page-number-align-menu">^</a></span>
+<a name="N103C4"></a><a name="page-number-align"></a>
+<h5>3.9. Page numbers are not properly right aligned.<span style="float: right"><a href="#page-number-align-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- This happens for fo:page-number-citation elements if the citation
- occurs before FOP formatted the requested page, usually in TOC or
- index pages.
+ This happens for fo:page-number-citation elements if the
+ citation occurs before FOP formatted the requested page,
+ usually in TOC or index pages. It is caused by the problem
+ that FOP has to guess how much space the yet unknown page
+ number will occupy, and usually the guesses are somewhat
+ off.
</p>
<p>
- It is caused by the problem that FOP has to guess how much space the
- yet unknown page number will occupy, and usually the guesses are
- somewhat off. You can try to use a non-proportional font like Courier
- to remedy this. However, this is likely to look ugly, and wont fix the
- problem completely.
+ The most recent FOP releases should have this problem
+ fixed. Check whether you can upgrade.
</p>
</div>
-<a name="N103B3"></a><a name="hypenation-fails"></a>
-<h5>3.9. Hyphenation does not work.<span style="float: right"><a href="#hypenation-fails-menu">^</a></span>
+<a name="N103CF"></a><a name="hyphenation-fails"></a>
+<h5>3.10. Hyphenation does not work.<span style="float: right"><a href="#hyphenation-fails-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- Set the language attribute somewhere. Check whether you use a language
- for which hyphenation is supported. Supported languages can be deduced
- from the files in the hyph directory of the FOP source distribution.
+ Set the language attribute somewhere and explicitly enable hyphenation.
+ Check whether you use a language for which hyphenation is supported.
+ Supported languages can be deduced from the files in the {fop-dir}/src/hyph
+ directory of the FOP source distribution. If you want to use a language
+ FOP currently doesn't hyphenate, please see the
+ <a href="configuration.html#hyphenation">Configuration page</a>.
+ </p>
+<p>
+ Set the language (on fo:page-sequence, fo:block or fo:character):
+ </p>
+<pre class="code"><fo:page-sequence language="fi"></pre>
+<p>
+ Enable hyphenation on a block:
</p>
+<pre class="code"><fo:block hyphenate="true"></pre>
</div>
</div>
-<a name="N103BB"></a><a name="part-embedding"></a>
+<a name="N103E9"></a><a name="part-embedding"></a>
<h4>4. Embedding FOP. Using FOP in a servlet.</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N103BF"></a><a name="servlet"></a>
+<a name="N103ED"></a><a name="servlet"></a>
<h5>4.1. How do I use FOP in a servlet?<span style="float: right"><a href="#servlet-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1100,7 +1170,7 @@
See <a href="embedding.html#servlet">Using FOP in a Servlet</a>.
</p>
</div>
-<a name="N103CB"></a><a name="servlet-with-xslt"></a>
+<a name="N103F9"></a><a name="servlet-with-xslt"></a>
<h5>4.2. How do I use FOP in a servlet with an XSLT
transformation?<span style="float: right"><a href="#servlet-with-xslt-menu">^</a></span>
</h5>
@@ -1109,7 +1179,7 @@
See <a href="embedding.html#servlet-transform">Using FOP in a Servlet with XSLT Transformation</a>.
</p>
</div>
-<a name="N103D7"></a><a name="servlet-xslt-params"></a>
+<a name="N10405"></a><a name="servlet-xslt-params"></a>
<h5>4.3. How do I pass parameters to the XSLT transformation?<span style="float: right"><a href="#servlet-xslt-params-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1117,7 +1187,7 @@
See <a href="embedding.html#servlet-transform">Using FOP in a Servlet with XSLT Transformation</a>.
</p>
</div>
-<a name="N103E3"></a><a name="servlet-nonstd-fonts"></a>
+<a name="N10411"></a><a name="servlet-nonstd-fonts"></a>
<h5>4.4. How do I use my own fonts when running FOP from a
servlet?<span style="float: right"><a href="#servlet-nonstd-fonts-menu">^</a></span>
</h5>
@@ -1127,7 +1197,7 @@
See <a href="#usercfg">loading the user configuration file</a> for further details.
</p>
</div>
-<a name="N103F2"></a><a name="servlet-baseDir"></a>
+<a name="N10420"></a><a name="servlet-baseDir"></a>
<h5>4.5. How do I set the baseDir property in a servlet environment?<span style="float: right"><a href="#servlet-baseDir-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1135,7 +1205,7 @@
See <a href="embedding.html#config-internal">Setting the Configuration Programmatically</a>.
</p>
</div>
-<a name="N103FE"></a><a name="usercfg"></a>
+<a name="N1042C"></a><a name="usercfg"></a>
<h5>4.6. How do I use a user configuration file from a servlet?<span style="float: right"><a href="#usercfg-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1143,7 +1213,7 @@
See <a href="embedding.html#config-external">Using a Configuration File in an Embedded App</a>.
</p>
</div>
-<a name="N1040A"></a><a name="servlet-NoClassDefFound"></a>
+<a name="N10438"></a><a name="servlet-NoClassDefFound"></a>
<h5>4.7. I keep getting NoClassDefFound and other exceptions. How do I
get FOP working for various servlet engines?<span style="float: right"><a href="#servlet-NoClassDefFound-menu">^</a></span>
</h5>
@@ -1152,7 +1222,7 @@
See <a href="embedding.html#servlet-engine">Servlet Engines</a>.
</p>
</div>
-<a name="N10416"></a><a name="multithreaded"></a>
+<a name="N10444"></a><a name="multithreaded"></a>
<h5>4.8. Can FOP be used in multithreaded environments?<span style="float: right"><a href="#multithreaded-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1161,23 +1231,23 @@
</p>
</div>
</div>
-<a name="N10422"></a><a name="part-svg"></a>
+<a name="N10450"></a><a name="part-svg"></a>
<h4>5. SVG specific questions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10426"></a><a name="svg-text"></a>
+<a name="N10454"></a><a name="svg-text"></a>
<h5>5.1. The rendering of SVG text in my PDF is of poor quality.
Can I control this?<span style="float: right"><a href="#svg-text-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="graphics.html#svg-pdf-text">Placing SVG Text into PDF</a>.</p>
</div>
-<a name="N10432"></a><a name="svg-headless"></a>
+<a name="N10460"></a><a name="svg-headless"></a>
<h5>5.2. How do I use FOP with SVG on headless servers?<span style="float: right"><a href="#svg-headless-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="graphics.html#batik">FOP: Graphics (Batik)</a>.</p>
</div>
-<a name="N1043E"></a><a name="svghangs"></a>
+<a name="N1046C"></a><a name="svghangs"></a>
<h5>5.3. FOP does not exit if a SVG is included.<span style="float: right"><a href="#svghangs-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1187,7 +1257,7 @@
System.exit(0) somewhere.
</p>
</div>
-<a name="N10446"></a><a name="svg-url"></a>
+<a name="N10474"></a><a name="svg-url"></a>
<h5>5.4. I have problems with SVG referring to gradients etc. using
"uri(#stuff)". I get a MalformedURLException.<span style="float: right"><a href="#svg-url-menu">^</a></span>
</h5>
@@ -1240,17 +1310,17 @@
<p>See also <a href="#MalformedURL">MalformedURLException</a>
</p>
</div>
-<a name="N10472"></a><a name="svg-scaling"></a>
+<a name="N104A0"></a><a name="svg-scaling"></a>
<h5>5.5. Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?<span style="float: right"><a href="#svg-scaling-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="graphics.html#svg-scaling">SVG Scaling</a>.</p>
</div>
</div>
-<a name="N1047E"></a><a name="part-pdf"></a>
+<a name="N104AC"></a><a name="part-pdf"></a>
<h4>6. PDF specific (includes Acrobat peculiarities)</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10482"></a><a name="pdf-embed-font"></a>
+<a name="N104B0"></a><a name="pdf-embed-font"></a>
<h5>6.1. How do I embed fonts in PDF?<span style="float: right"><a href="#pdf-embed-font-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1259,22 +1329,32 @@
about embedding fonts.
</p>
</div>
-<a name="N1048E"></a><a name="pdf-characters"></a>
+<a name="N104BC"></a><a name="pdf-characters"></a>
<h5>6.2. Some characters are not displayed, or displayed incorrectly, or
displayed as “#”.<span style="float: right"><a href="#pdf-characters-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- There are a few fonts supplied with Acrobat Reader. If you use other
- fonts, the font must be available on the machine where the PDF is
- viewed or it must have been embedded in the PDF file. See
- <a href="fonts.html">embedding fonts</a>.
+ This usually means the selected font doesn't have a glyph
+ for the character.
+ </p>
+<p>
+ The standard text fonts supplied with Acrobat Reader have
+ mostly glyphs for characters from the ISO Latin 1 character
+ set. For a variety of reasons, even those are not completely
+ guaranteed to work, for example you can't use the fi
+ ligature from the standard serif font. Check the <a href="output.html#pdf-fonts">overview</a> for the default
+ PDF fonts.
</p>
<p>
- Furthermore, if you select a certain font family, the font must
- contain glyphs for the desired character. There is an <a href="output.html#pdf-fonts">overview</a> available for the
- default PDF fonts. For most symbols, it is better to select the symbol
- font explicitely, for example in order to get the symbol for the
+ If you use your own fonts, the font must have a glyph for
+ the desired character. Furthermore the font must be
+ available on the machine where the PDF is viewed or it must
+ have been embedded in the PDF file. See <a href="fonts.html">embedding fonts</a>.
+ </p>
+<p>
+ For most symbols, it is better to select the symbol font
+ explicitely, for example in order to get the symbol for the
mathematical empty set, write:
</p>
<pre class="code"><fo:inline font-family="Symbol">&#x2205;</fo:inline></pre>
@@ -1284,13 +1364,13 @@
</p>
<pre class="code"><fo:inline font-family="Helvetica">&#x2205;</fo:inline></pre>
</div>
-<a name="N104AC"></a><a name="pdf-postprocess"></a>
+<a name="N104E0"></a><a name="pdf-postprocess"></a>
<h5>6.3. What tools are available for post-processing my PDF document?<span style="float: right"><a href="#pdf-postprocess-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="output.html#pdf-postprocess">PDF Post-processing</a>.</p>
</div>
-<a name="N104B8"></a><a name="pdf-security"></a>
+<a name="N104EC"></a><a name="pdf-security"></a>
<h5>6.4. How do I add security features (encryption, disable printing)
to my PDF document?<span style="float: right"><a href="#pdf-security-menu">^</a></span>
</h5>
@@ -1300,20 +1380,20 @@
See also <a href="output.html#pdf-postprocess">PDF Post-processing</a>.
</p>
</div>
-<a name="N104C8"></a><a name="pdf-doc-properties"></a>
+<a name="N104FC"></a><a name="pdf-doc-properties"></a>
<h5>6.5. How do I add document properties (title, author, etc.) to my
PDF document?<span style="float: right"><a href="#pdf-doc-properties-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="output.html#pdf-postprocess">PDF Post-processing</a>.</p>
</div>
-<a name="N104D4"></a><a name="pdf-watermark"></a>
+<a name="N10508"></a><a name="pdf-watermark"></a>
<h5>6.6. How do I add watermarks to my PDF document?<span style="float: right"><a href="#pdf-watermark-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="output.html#pdf-watermark">PDF Watermarks</a>.</p>
</div>
-<a name="N104E0"></a><a name="pdf-print-contortion"></a>
+<a name="N10514"></a><a name="pdf-print-contortion"></a>
<h5>6.7. The PDF is printed contorted!<span style="float: right"><a href="#pdf-print-contortion-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1325,7 +1405,7 @@
settings too.
</p>
</div>
-<a name="N104E8"></a><a name="pdf-bookmark-display"></a>
+<a name="N1051C"></a><a name="pdf-bookmark-display"></a>
<h5>6.8. How do I control the Acrobat bookmark display?<span style="float: right"><a href="#pdf-bookmark-display-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1336,46 +1416,20 @@
</p>
</div>
</div>
-<a name="N104F4"></a><a name="part-iex"></a>
+<a name="N10528"></a><a name="part-iex"></a>
<h4>7. IEx specific stuff</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N104F8"></a><a name="iex-servlet-multiple"></a>
+<a name="N1052C"></a><a name="iex-servlet-multiple"></a>
<h5>7.1. The FOP servlet is called multiple times!<span style="float: right"><a href="#iex-servlet-multiple-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
This is a problem of Internet Explorer requesting the content several
- times. Some suggestions:
+ times. Please see the <a href="servlets.html#ie">notes on Internet Explorer</a>
+ for more information.
</p>
-<ul>
-
-<li>
- Use an URL ending in <span class="codefrag">.pdf</span>, like
- <span class="codefrag">http://myserver/servlet/stuff.pdf</span>. Yes, the servlet can
- be configured to handle this. If the URL has to contain parameters,
- try to have both the base URL as well as the last parameter end in
- <span class="codefrag">.pdf</span>, if necessary append a dummy parameter, like
- <span class="codefrag">http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf</span>. The
- effect may depend on IEx version.
- </li>
-
-<li>
- Give IEx the opportunity to cache. In particular, ensure the server
- does not set any headers causing IEx not to cache the content. This
- may be a real problem if the document is sent over HTTPS. Consult
- your server manual.
- </li>
-
-<li>
- Cache in the server. Including a parameter in the URL which has a
- timestamp as the value may help you to decide whether a request is
- repeated. IEx is reported to retrieve a document up to three times,
- but never more often.
- </li>
-
-</ul>
</div>
-<a name="N10518"></a><a name="iex-pdf-print-from-browser"></a>
+<a name="N10538"></a><a name="iex-pdf-print-from-browser"></a>
<h5>7.2. How do I print PDF directly from the browser?<span style="float: right"><a href="#iex-pdf-print-from-browser-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1399,10 +1453,10 @@
</p>
</div>
</div>
-<a name="N10529"></a><a name="part-input"></a>
+<a name="N10549"></a><a name="part-input"></a>
<h4>8. General questions regarding XSLT, XSLFO, and basic XML</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1052D"></a><a name="fo-center"></a>
+<a name="N1054D"></a><a name="fo-center"></a>
<h5>8.1. (FO) How do I vertically center an image or a table (or
whatever)?<span style="float: right"><a href="#fo-center-menu">^</a></span>
</h5>
@@ -1411,7 +1465,7 @@
See <a href="fo.html#fo-center-vertical">XSL-FO Vertical Centering</a>.
</p>
</div>
-<a name="N10539"></a><a name="fo-center-table-horizon"></a>
+<a name="N10559"></a><a name="fo-center-table-horizon"></a>
<h5>8.2. (FO) How do I center a table horizontally?<span style="float: right"><a href="#fo-center-table-horizon-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1419,7 +1473,7 @@
See <a href="fo.html#fo-center-table-horizon">XSL-FO Horizontal Centering (Tables)</a>.
</p>
</div>
-<a name="N10545"></a><a name="fo-page-outer"></a>
+<a name="N10565"></a><a name="fo-page-outer"></a>
<h5>8.3. (FO) How to get page numbers printed on the "outer side" of the
page (for books, for example)?<span style="float: right"><a href="#fo-page-outer-menu">^</a></span>
</h5>
@@ -1428,7 +1482,7 @@
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content Differences</a>.
</p>
</div>
-<a name="N10551"></a><a name="oddeven"></a>
+<a name="N10571"></a><a name="oddeven"></a>
<h5>8.4. (FO) How do I use different static content for odd and even
pages?<span style="float: right"><a href="#oddeven-menu">^</a></span>
</h5>
@@ -1437,7 +1491,7 @@
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content Differences</a>.
</p>
</div>
-<a name="N1055D"></a><a name="fo-first-page-header"></a>
+<a name="N1057D"></a><a name="fo-first-page-header"></a>
<h5>8.5. (FO) How do I get a special header on the first page?<span style="float: right"><a href="#fo-first-page-header-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1445,7 +1499,7 @@
See <a href="fo.html#fo-first-page">Making the First Page Special</a>.
</p>
</div>
-<a name="N10569"></a><a name="fo-omit-headers"></a>
+<a name="N10589"></a><a name="fo-omit-headers"></a>
<h5>8.6. (FO) How do I omit my headers on a blank page? How do I write
"This page is left blank" on an intentionally blank page?<span style="float: right"><a href="#fo-omit-headers-menu">^</a></span>
</h5>
@@ -1454,7 +1508,7 @@
See <a href="fo.html#fo-blank-pages">Blank Pages</a>.
</p>
</div>
-<a name="N10575"></a><a name="fo-special-symbols"></a>
+<a name="N10595"></a><a name="fo-special-symbols"></a>
<h5>8.7. (FO) How do I print an Euro sign, a checkbox or other some other
special symbols?<span style="float: right"><a href="#fo-special-symbols-menu">^</a></span>
</h5>
@@ -1463,7 +1517,7 @@
See <a href="fo.html#xml-special-chars">Special Characters</a>.
</p>
</div>
-<a name="N10581"></a><a name="fo-preformat"></a>
+<a name="N105A1"></a><a name="fo-preformat"></a>
<h5>8.8. (FO) How do I keep linebreaks and hard spaces? How do I get
preformatted text displayed as expected?<span style="float: right"><a href="#fo-preformat-menu">^</a></span>
</h5>
@@ -1472,7 +1526,7 @@
See <a href="fo.html#fo-preformat">Preformatting Content</a>.
</p>
</div>
-<a name="N1058D"></a><a name="fo-total-pages"></a>
+<a name="N105AD"></a><a name="fo-total-pages"></a>
<h5>8.9. (FO) How do I print the total number of pages, for example "page 1
of 12"<span style="float: right"><a href="#fo-total-pages-menu">^</a></span>
</h5>
@@ -1481,7 +1535,7 @@
See <a href="fo.html#fo-total-pages">Total Document Pages</a>.
</p>
</div>
-<a name="N10599"></a><a name="fo-region-overlap"></a>
+<a name="N105B9"></a><a name="fo-region-overlap"></a>
<h5>8.10. (FO) The header overlaps body content. The body extends into
the footer.<span style="float: right"><a href="#fo-region-overlap-menu">^</a></span>
</h5>
@@ -1490,7 +1544,7 @@
See <a href="fo.html#fo-region-align">Aligning Regions</a>.
</p>
</div>
-<a name="N105A5"></a><a name="fo-lines"></a>
+<a name="N105C5"></a><a name="fo-lines"></a>
<h5>8.11. (FO) How do I get lines in the document, as separators, side
bars or folding marks?<span style="float: right"><a href="#fo-lines-menu">^</a></span>
</h5>
@@ -1499,7 +1553,7 @@
See <a href="fo.html#fo-lines">Drawing Lines</a>.
</p>
</div>
-<a name="N105B1"></a><a name="fo-validate"></a>
+<a name="N105D1"></a><a name="fo-validate"></a>
<h5>8.12. (FO) How do I validate my FO document?<span style="float: right"><a href="#fo-validate-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1507,7 +1561,7 @@
See <a href="fo.html#fo-validate">Validating XSL-FO</a>.
</p>
</div>
-<a name="N105BD"></a><a name="xml-non-breaking-space"></a>
+<a name="N105DD"></a><a name="xml-non-breaking-space"></a>
<h5>8.13. (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;.<span style="float: right"><a href="#xml-non-breaking-space-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1515,7 +1569,7 @@
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
</div>
-<a name="N105CC"></a><a name="xml-undefined-entities"></a>
+<a name="N105EC"></a><a name="xml-undefined-entities"></a>
<h5>8.14. (XML) How do I enter special characters in XML? There are complaints about undefined entities, such as &uuml;, which work in HTML. <span style="float: right"><a href="#xml-undefined-entities-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1523,16 +1577,16 @@
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
</div>
-<a name="N105DB"></a><a name="xml-illegal-entities"></a>
+<a name="N105FB"></a><a name="xml-illegal-entities"></a>
<h5>8.15. (XML) There are complaints about illegal characters and entities
in the input.<span style="float: right"><a href="#xml-illegal-entities-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- See <a href="fo.html#xml-entity-chars">XML Entity Characters</a>.
+ See <a href="fo.html#xml-entity-chars">Using HTML Character Names</a>.
</p>
</div>
-<a name="N105E7"></a><a name="xml-illegal-chars"></a>
+<a name="N10607"></a><a name="xml-illegal-chars"></a>
<h5>8.16. (XML) There are complaints about illegal bytes or characters in
the input. There are odd characters in the result.<span style="float: right"><a href="#xml-illegal-chars-menu">^</a></span>
</h5>
@@ -1542,10 +1596,10 @@
</p>
</div>
</div>
-<a name="N105F3"></a><a name="part-help"></a>
+<a name="N10613"></a><a name="part-help"></a>
<h4>9. General suggestions. How to solve problems.</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N105F7"></a><a name="bugs"></a>
+<a name="N10617"></a><a name="bugs"></a>
<h5>9.1. I think I have found a bug in FOP. What should I do?<span style="float: right"><a href="#bugs-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -1554,7 +1608,7 @@
bugs already reported and how to report new ones.
</p>
</div>
-<a name="N10603"></a><a name="postquestions"></a>
+<a name="N10623"></a><a name="postquestions"></a>
<h5>9.2. I have questions that are not addressed in this FAQ. Where
should I post them?<span style="float: right"><a href="#postquestions-menu">^</a></span>
</h5>
1.17 +6096 -5616xml-site/targets/fop/faq.pdf
<<Binary file>>
1.6 +47 -16 xml-site/targets/fop/fo.html
Index: fo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/fo.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- fo.html 14 May 2003 18:13:12 -0000 1.5
+++ fo.html 30 May 2003 18:37:36 -0000 1.6
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -343,6 +355,9 @@
<li>
<a href="#fo-validate">Validating XSL-FO</a>
</li>
+<li>
+<a href="#landscape">Producing landscape pages</a>
+</li>
</ul>
</li>
</ul>
@@ -353,14 +368,15 @@
<p>
FOP uses XSL-FO as input.
It is the responsibility of the user to make sure that the XSL-FO submitted to FOP is correct.
-The tutorial items presented here are not comprehensive, but are of the FAQ variety.
+The tutorial items presented here are not comprehensive, but are of the FAQ variety. Another
+good FAQ is <a target="_blank" href="http://www.dpawson.co.uk/xsl/xslfaq.html">Dave Pawson's XSL FAQ</a>.
</p>
</div>
-<a name="N101CB"></a><a name="xml"></a>
+<a name="N101CF"></a><a name="xml"></a>
<h3>XML Issues</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N101D1"></a><a name="xml-special-chars"></a>
+<a name="N101D5"></a><a name="xml-special-chars"></a>
<h4>Special Characters</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -399,7 +415,7 @@
An alternative to encoding the character and making it available through a font is to use an embedded graphic to represent the character: GIF, PNG, SVG, etc.
</p>
</div>
-<a name="N1020B"></a><a name="xml-entity-chars"></a>
+<a name="N1020F"></a><a name="xml-entity-chars"></a>
<h4>Entity Characters</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -415,7 +431,7 @@
Review the <a href="http://www.w3.org/XML/">XML Specification</a> or a good tutorial for details of the XML file format.
</p>
</div>
-<a name="N1021F"></a><a name="xml-encoding"></a>
+<a name="N10223"></a><a name="xml-encoding"></a>
<h4>Encoding Issues</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -427,10 +443,10 @@
</div>
</div>
-<a name="N1022E"></a><a name="xsl-fo"></a>
+<a name="N10232"></a><a name="xsl-fo"></a>
<h3>XSL-FO Issues</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10234"></a><a name="fo-center-vertical"></a>
+<a name="N10238"></a><a name="fo-center-vertical"></a>
<h4>Vertical Centering</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -464,7 +480,7 @@
</fo:page-sequence>
</fo:root></pre>
</div>
-<a name="N10246"></a><a name="fo-center-table-horizon"></a>
+<a name="N1024A"></a><a name="fo-center-table-horizon"></a>
<h4>Horizontal Centering (Tables)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -501,7 +517,7 @@
If your table is more complicated, or if defining borders on individual cells becomes too much work, use the code above and nest your table within the middle cell.
</p>
</div>
-<a name="N10257"></a><a name="fo-oddeven"></a>
+<a name="N1025B"></a><a name="fo-oddeven"></a>
<h4>Recto/Verso Static Content Differences</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -554,7 +570,7 @@
</fo:page-sequence>
</fo:root></pre>
</div>
-<a name="N1026C"></a><a name="fo-first-page"></a>
+<a name="N10270"></a><a name="fo-first-page"></a>
<h4>Making the First Page Special</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -601,7 +617,7 @@
</fo:page-sequence>
</fo:root></pre>
</div>
-<a name="N1027A"></a><a name="fo-blank-pages"></a>
+<a name="N1027E"></a><a name="fo-blank-pages"></a>
<h4>Blank Pages</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -653,7 +669,7 @@
</fo:page-sequence>
</fo:root></pre>
</div>
-<a name="N1028E"></a><a name="fo-preformat"></a>
+<a name="N10292"></a><a name="fo-preformat"></a>
<h4>Preformatting Content</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -668,7 +684,7 @@
</div>
</div>
</div>
-<a name="N102A3"></a><a name="fo-total-pages"></a>
+<a name="N102A7"></a><a name="fo-total-pages"></a>
<h4>Total Document Pages</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -742,7 +758,7 @@
</div>
</div>
</div>
-<a name="N102CE"></a><a name="fo-region-align"></a>
+<a name="N102D2"></a><a name="fo-region-align"></a>
<h4>Aligning Regions</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -758,7 +774,7 @@
This applies similarly to the extent of the after region and the bottom margin of the body region.
</p>
</div>
-<a name="N102DB"></a><a name="fo-lines"></a>
+<a name="N102DF"></a><a name="fo-lines"></a>
<h4>Drawing Lines</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -780,7 +796,7 @@
</ul>
</div>
-<a name="N102F5"></a><a name="fo-validate"></a>
+<a name="N102F9"></a><a name="fo-validate"></a>
<h4>Validating XSL-FO</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -792,6 +808,21 @@
This document can be used either to validate against the FO standard, or against the actual FOP implementation.
See the notes near the beginning of the document for instructions on how to use it.
</p>
+</div>
+<a name="N10312"></a><a name="landscape"></a>
+<h4>Producing landscape pages</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ Pages in landscape format can easily be produced by exchanging the page-height and page-width values of a simple-page-master element.
+ </p>
+<pre class="code"><fo:layout-master-set>
+ <fo:simple-page-master master-name="A4-portrait" page-height="29.7cm" page-width="21cm" [..]>
+ <fo:region-body/>
+ </fo:simple-page-master>
+ <fo:simple-page-master master-name="A4-landscape" page-height="21cm" page-width="29.7cm" [..]>
+ <fo:region-body/>
+ </fo:simple-page-master>
+</fo:layout-master-set></pre>
</div>
</div>
1.3 +654 -796 xml-site/targets/fop/fo.pdf
<<Binary file>>
1.29 +12 -0 xml-site/targets/fop/fonts.html
Index: fonts.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/fonts.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- fonts.html 14 May 2003 18:13:12 -0000 1.28
+++ fonts.html 30 May 2003 18:37:36 -0000 1.29
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.9 +233 -285 xml-site/targets/fop/fonts.pdf
<<Binary file>>
1.19 +14 -2 xml-site/targets/fop/gethelp.html
Index: gethelp.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/gethelp.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- gethelp.html 14 May 2003 18:13:12 -0000 1.18
+++ gethelp.html 30 May 2003 18:37:36 -0000 1.19
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -365,7 +377,7 @@
<h3>Review FOP User Mailing List Archive</h3>
<div style="margin-left: 0 ; border: 2px">
<p>It is possible that your question has already been answered but has not yet found its way into the FAQ.
-Links to the FOP User mailing list archives are on the <a href="resources.html#mailing-lists-fop-user">Resources</a> page.
+Links to the FOP User mailing list archives are on the <a href="maillist.html#fop-user">Mailing List</a> page.
</p>
</div>
@@ -379,7 +391,7 @@
<a name="N10218"></a><a name="user-mailing-list"></a>
<h3>Submit Question to FOP User Mailing List</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>See <a href="resources.html#mailing-lists-fop-user">FOP User Mailing List</a> for details.</p>
+<p>See <a href="maillist.html#fop-user">FOP User Mailing List</a> for details.</p>
</div>
<a name="N10226"></a><a name="enter-issue"></a>
1.9 +198 -237 xml-site/targets/fop/gethelp.pdf
<<Binary file>>
1.5 +65 -15 xml-site/targets/fop/graphics.html
Index: graphics.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/graphics.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- graphics.html 14 May 2003 18:13:12 -0000 1.4
+++ graphics.html 30 May 2003 18:37:36 -0000 1.5
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -305,7 +317,7 @@
<a href="#jimi">JIMI</a>
</li>
<li>
-<a href="#jai">JAI</a>
+<a href="#jai">JAI (Java Advanced Imaging API)</a>
</li>
<li>
<a href="#batik">Batik</a>
@@ -344,6 +356,9 @@
<li>
<a href="#resolution">Graphics Resolution</a>
</li>
+<li>
+<a href="#caching">Image caching</a>
+</li>
</ul>
<a name="N101BE"></a><a name="support-overview"></a>
@@ -374,7 +389,7 @@
<td colspan="1" rowspan="1"><a href="#eps">EPS</a> (Encapsulated PostScript)</td>
<td colspan="1" rowspan="1">metafile (both bitmap and vector), probably most frequently used for vector drawings</td>
- <td colspan="1" rowspan="1"><a href="#native">FOP native</a> (limited support)</td>
+ <td colspan="1" rowspan="1"><a href="#native">FOP native</a> (limited support, see restrictions below)</td>
</tr>
@@ -440,7 +455,7 @@
</p>
</div>
<a name="N102A7"></a><a name="jai"></a>
-<h4>JAI</h4>
+<h4>JAI (Java Advanced Imaging API)</h4>
<div style="margin-left: 0 ; border: 2px">
<div class="frame warning">
<div class="label">Warning</div>
@@ -486,22 +501,40 @@
<li>PostScript (full support).</li>
-<li>PDF (partial support). FOP embeds the EPS file into the PDF, but currently does not do so completely correctly. PostScript devices (including ghostscript) will render the EPS correctly, but Acrobat Reader will not currently display it.</li>
+<li>
+ PDF (partial support). Due to the lack of a built-in PostScript interpreter, FOP
+ can only embed the EPS file into the PDF. Acrobat Reader will not currently display
+ the EPS (it doesn't have a PostScript interpreter, either) but it will be shown
+ correctly when you print the PDF on a PostScript-capable printer. PostScript devices
+ (including GhostScript) will render the EPS correctly.
+ </li>
</ul>
+<p>
+ Other output targets can't be supported at the moment because
+ FOP lacks a PostScript interpreter.
+ </p>
</div>
-<a name="N102FA"></a><a name="jpeg"></a>
+<a name="N102FD"></a><a name="jpeg"></a>
<h3>JPEG</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>Not all variants of JPEG are supported, especially those containing unusual color lookup tables and color profiles. If you have trouble with a JPEG image in FOP, try opening it with an image processing program (such as Photoshop or Gimp) and then saving it. Specifying 24-bit color output may also help.
+<p>
+ Not all variants of JPEG are supported, especially those containing unusual color
+ lookup tables and color profiles. If you have trouble with a JPEG image in FOP, try
+ opening it with an image processing program (such as Photoshop or Gimp) and then saving
+ it. Specifying 24-bit color output may also help.
+ </p>
+<p>
+ For the PDF and PostScript renderers most JPEG images can be passed through without
+ decompression.
</p>
</div>
-<a name="N10304"></a><a name="svg"></a>
+<a name="N1030A"></a><a name="svg"></a>
<h3>SVG</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1030A"></a><a name="svg-intro"></a>
+<a name="N10310"></a><a name="svg-intro"></a>
<h4>Introduction</h4>
<div style="margin-left: 0 ; border: 2px">
<p>FOP uses <a href="#batik">Batik</a> for SVG support.
@@ -517,7 +550,7 @@
</div>
</div>
</div>
-<a name="N10325"></a><a name="svg-pdf-graphics"></a>
+<a name="N1032B"></a><a name="svg-pdf-graphics"></a>
<h4>Placing SVG Graphics into PDF</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -537,7 +570,7 @@
correctly.
</p>
</div>
-<a name="N10335"></a><a name="svg-pdf-text"></a>
+<a name="N1033B"></a><a name="svg-pdf-text"></a>
<h4>Placing SVG Text into PDF</h4>
<div style="margin-left: 0 ; border: 2px">
<p>If possible, Batik will use normal PDF text when inserting text. It does
@@ -579,7 +612,7 @@
The Acrobat viewer has both "smooth line art" and "smooth text" settings that may need to be set for SVG images to be displayed nicely on your screen (see Edit / Preferences / Display).
This setting will not affect the printing of your document, which should be OK in any case, but will only affect the quality of the screen display.</p>
</div>
-<a name="N10368"></a><a name="svg-scaling"></a>
+<a name="N1036E"></a><a name="svg-scaling"></a>
<h4>Scaling</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Currently, SVG images are rendered with the dimensions specified <em>in the SVG file</em>, within the viewport specified in the fo:external-graphic element.
@@ -587,7 +620,7 @@
The SVG standard leaves this issue as an implementation detail.
FOP will probably implement a scaling mechanism in the future.</p>
</div>
-<a name="N10375"></a><a name="svg-problems"></a>
+<a name="N1037B"></a><a name="svg-problems"></a>
<h4>Known Problems</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -629,13 +662,13 @@
</div>
</div>
-<a name="N10392"></a><a name="tiff"></a>
+<a name="N10398"></a><a name="tiff"></a>
<h3>TIFF</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>TIFF images with JPEG or CCITT content are passed through by FOP natively. Other TIFF subformats are handled by JAI.</p>
+<p>TIFF images with JPEG or CCITT content are passed through by FOP natively (PDF and PostScript only). Other TIFF subformats are handled by JAI.</p>
</div>
-<a name="N1039C"></a><a name="resolution"></a>
+<a name="N103A2"></a><a name="resolution"></a>
<h3>Graphics Resolution</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution value. Since PDF and most output formats do not have a concept of resolution, but only of absolute image units (i.e. pixels) FOP ignores the resolution values as well. Instead, FOP uses the dimensions of the image as specified in the fo:external-graphic element to render the image:</p>
@@ -653,6 +686,23 @@
<div class="label">Note</div>
<div class="content">The explanation above describes only the basic default behavior. There are other attributes of the fo:external-graphic element that can affect the behavior described above.</div>
</div>
+</div>
+
+<a name="N103BE"></a><a name="caching"></a>
+<h3>Image caching</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ FOP caches images between runs. The URL is used as a key to identify images which means that when
+ a particular URL appears again, the image is taken from the cache. If you have a servlet that
+ generates a different image each time it is called with the same URL you need to use a constantly
+ changing dummy parameter on the URL to avoid caching.
+ </p>
+<p>
+ Currently, the images are not automatically released when an OutOfMemoryError is imminent. The
+ image cache can grow to a considerable size over time when a lot of different URLs are in use.
+ Starting with version 0.20.5 you can call <span class="codefrag">org.apache.fop.image.FopImageFactory.resetCache()</span>
+ to manually empty the cache. Image caching will be improved as part of our redesign effort.
+ </p>
</div>
</div>
1.5 +466 -555 xml-site/targets/fop/graphics.pdf
<<Binary file>>
1.50 +13 -1 xml-site/targets/fop/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/index.html,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -r1.49 -r1.50
--- index.html 14 May 2003 18:13:12 -0000 1.49
+++ index.html 30 May 2003 18:37:36 -0000 1.50
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -359,7 +371,7 @@
<div class="frame note">
<div class="label">Note</div>
<div class="content">
- The PDF files on this site are created using the latest development version of FOP.
+ The PDF files on this site are created using FOP.
</div>
</div>
1.9 +118 -144 xml-site/targets/fop/index.pdf
<<Binary file>>
1.34 +12 -0 xml-site/targets/fop/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/license.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- license.html 14 May 2003 18:13:12 -0000 1.33
+++ license.html 30 May 2003 18:37:36 -0000 1.34
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.6 +97 -123 xml-site/targets/fop/license.pdf
<<Binary file>>
1.11 +13 -1 xml-site/targets/fop/logocontest.html
Index: logocontest.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/logocontest.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- logocontest.html 14 May 2003 18:13:12 -0000 1.10
+++ logocontest.html 30 May 2003 18:37:36 -0000 1.11
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -334,7 +346,7 @@
<a name="N101E8"></a><a name="How+to+participate"></a>
<h3>How to participate</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>Submit your image or link to it to <a href="http://xml.apache.org/fop/resources.html#xpointer(/document[1]/body[1]/section[1]/section[1])">fop-user</a> mail list.
+<p>Submit your image or link to it to <a href="maillist.html#fop-user">fop-user</a> mail list.
Vote for a logo you like the most at FOP logo contest <a href="http://vote.sparklit.com/web_poll.spark/714566">Web Poll</a>.
</p>
</div>
1.3 +81 -94 xml-site/targets/fop/logocontest.pdf
<<Binary file>>
1.19 +12 -0 xml-site/targets/fop/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/news.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- news.html 14 May 2003 18:13:12 -0000 1.18
+++ news.html 30 May 2003 18:37:37 -0000 1.19
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.10 +175 -201 xml-site/targets/fop/news.pdf
<<Binary file>>
1.21 +12 -0 xml-site/targets/fop/output.html
Index: output.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/output.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- output.html 14 May 2003 18:13:12 -0000 1.20
+++ output.html 30 May 2003 18:37:37 -0000 1.21
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.10 +389 -467 xml-site/targets/fop/output.pdf
<<Binary file>>
1.12 +36 -18 xml-site/targets/fop/pdfencryption.html
Index: pdfencryption.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/pdfencryption.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- pdfencryption.html 14 May 2003 18:13:12 -0000 1.11
+++ pdfencryption.html 30 May 2003 18:37:37 -0000 1.12
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -318,13 +330,13 @@
</div>
<p>
FOP supports encryption of PDF output, thanks to Patrick
- C. Lankswert. This feature is commonly used to prevent unauthorized
- viewing, printing, editing and copying text from the document
- annotations. It is also possible to ask the user for a password in order
- to view the contents. Note that there already exist third party
- applications which can decrypt an encrypted PDF without effort and allow
- the aforementioned operations, therefore the degree of protection is
- limited.
+ C. Lankswert. This feature is commonly used to prevent
+ unauthorized viewing, printing, editing, copying text from the
+ document and doing annotations. It is also possible to ask the
+ user for a password in order to view the contents. Note that
+ there already exist third party applications which can decrypt
+ an encrypted PDF without effort and allow the aforementioned
+ operations, therefore the degree of protection is limited.
</p>
<p>
For further information about features and restrictions regarding PDF
@@ -341,13 +353,15 @@
options.
</p>
<p>
- An owner password with the <span class="codefrag">-o</span> option. This password is
- actually used as encryption key. Usually it is also used by most tools
- to disregard any restriction imposed on the PDF document.
+ An owner password is set with the <span class="codefrag">-o</span> option. This
+ password is actually used as encryption key. Many tools for
+ PDF processing ask for this password to disregard any
+ restriction imposed on the PDF document.
</p>
<p>
If no owner password has been supplied but FOP was asked to apply some
- restrictions, a random password is used.
+ restrictions, a random password is used. In this case it is obviously
+ impossiible to disregard restrictions in PDF processing tools.
</p>
<p>
A user password, supplied with the <span class="codefrag">-u</span> option, will
@@ -367,12 +381,12 @@
<h3>Environment</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
- In order to use PDF encryption, FOP has to be compiled with cryptography
- support. Currently, only <a href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html">JCE</a>
- is supported. JCE is part of JDK 1.4. For earlier JDKs, it can be
- installed separately. The build process automatically senses JCE
- presence and installs PDF support if possible, otherwise, a stub is
- compiled in.
+ In order to use PDF encryption, FOP has to be compiled with
+ cryptography support. Currently, only <a href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html">JCE</a>
+ is supported. JCE is part of JDK 1.4. For earlier JDKs, it can
+ be installed separately. The build process automatically
+ detects JCE presence and installs PDF encryption support if
+ possible, otherwise a stub is compiled in.
</p>
<p>
Cryptography support must also be present at run time. In particular, a
@@ -382,7 +396,7 @@
</p>
<pre class="code">"Cannot find any provider supporting RC4"</pre>
<p>
- then you don't have the needed support.
+ then you don't have the needed infrastructure.
</p>
<p>
There are several commercial and a few Open Source packages which
@@ -423,6 +437,10 @@
</li>
</ol>
+<p>
+ If you have any experience with Mozilla JSS or any other
+ cryptography provider, please post it to the fop-user list.
+ </p>
</div>
</div>
1.5 +156 -195 xml-site/targets/fop/pdfencryption.pdf
<<Binary file>>
1.21 +12 -0 xml-site/targets/fop/relnotes.html
Index: relnotes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/relnotes.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- relnotes.html 14 May 2003 18:13:12 -0000 1.20
+++ relnotes.html 30 May 2003 18:37:37 -0000 1.21
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.8 +123 -149 xml-site/targets/fop/relnotes.pdf
<<Binary file>>
1.32 +37 -177 xml-site/targets/fop/resources.html
Index: resources.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/resources.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- resources.html 14 May 2003 18:13:12 -0000 1.31
+++ resources.html 30 May 2003 18:37:37 -0000 1.32
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Resources</title>
+<title>FOP: Other Resources</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -285,7 +297,7 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Resources</h1>
+<h1>FOP: Other Resources</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="resources.pdf"><img alt="printer" src="skin/images/printer.gif" border="0"><br>
print-friendly<br>
PDF</a></td>
@@ -294,26 +306,6 @@
<h3>Resources useful for developing and using FOP</h3>
<ul class="minitoc">
<li>
-<a href="#mailing-lists">Mailing Lists and Archives</a>
-<ul class="minitoc">
-<li>
-<a href="#mailing-lists-general">General Information</a>
-</li>
-<li>
-<a href="#mailing-lists-fop-user">FOP User Mailing List</a>
-</li>
-<li>
-<a href="#mailing-lists-w3c-xslfo">XSL-FO Mailing List (at W3C)</a>
-</li>
-<li>
-<a href="#mailing-lists-yahoogroups-xslfo">XSL-FO Mailing List (at YahooGroups)</a>
-</li>
-<li>
-<a href="#mailing-lists-xslt-mulberry">XSLT List (Mulberry Tech)</a>
-</li>
-</ul>
-</li>
-<li>
<a href="#specs">Specifications</a>
<ul class="minitoc">
<li>
@@ -378,144 +370,10 @@
</li>
</ul>
-<a name="N101C2"></a><a name="mailing-lists"></a>
-<h3>Mailing Lists and Archives</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N101C8"></a><a name="mailing-lists-general"></a>
-<h4>General Information</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Before posting questions to any list, review "<a target="_top" href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</a>".</p>
-<p>Be sure to set your email client to send plain text email messages to any mailing lists.
-Please do <em>not</em> send html or rtf email, as they do not work well with the archive engines.
-If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.</p>
-<p>For help in understanding email acronyms, see the <a target="_top" href="http://www.lingo2word.com/lists/acronym_listA.html">Lingo2Word Acronym List</a>, or the <a target="_top" href="http://www.keno.org/web_design/acronyms.htm">Keno Internet Services Internet Glossary</a>.</p>
-</div>
-<a name="N101E7"></a><a name="mailing-lists-fop-user"></a>
-<h4>FOP User Mailing List</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Use this forum to discuss topics of interest to FOP users.</p>
-<a name="N101F0"></a><a name="ml-fop-user-archive"></a>
-<h5>Archives</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>To review the archives, you have several options:</p>
-<ul>
-
-<li>The <a target="_top" href="http://marc.theaimsgroup.com/?l=fop-user&r=1&w=2">Mailing list ARChives </a> (MARC) at the AIMS group (search).</li>
-
-<li>The <a target="_top" href="http://nagoya.apache.org/eyebrowse/SummarizeList?listName=fop-user@xml.apache.org">Apache Eyebrowse</a> archive (search, list by date, author, subject, or thread).</li>
-
-<li>The <a href="http://xml.apache.org/mail/fop-user">Apache Mailing List archive</a> (gzip files).</li>
-
-</ul>
-</div>
-<a name="N10212"></a><a name="ml-fop-user-subscribe"></a>
-<h5>Subscription Information</h5>
-<div style="margin-left: 0 ; border: 2px">
-<ul>
-
-<li>See <a href="http://xml.apache.org/mail.html#fop-user">Apache XML Mailing Lists</a> for detailed subscription information.</li>
-
-<li>To subscribe (digest only): Send email to <a href="mailto:fop-user-digest-subscribe.at.xml.apache.org">fop-user-digest-subscribe@xml.apache.org</a>.</li>
-
-<li>To subscribe fully: Send email to <a href="mailto:fop-user-subscribe.at.xml.apache.org">fop-user-subscribe@xml.apache.org</a>.</li>
-
-<li>For standard help: Send email to <a href="mailto:fop-user-help.at.xml.apache.org">fop-user-help@xml.apache.org</a>.</li>
-
-<li>To unsubscribe: Send email to <a href="mailto:fop-user-unsubscribe.at.xml.apache.org">fop-user-unsubscribe@xml.apache.org</a>.</li>
-
-</ul>
-</div>
-<a name="N1023F"></a><a name="ml-fop-user-policy"></a>
-<h5>Sumitting a Question</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>FOP support is primarily <em>self-service</em>. The FOP User Mailing List serves as a backup to the self-service documentation for cases where either the documentation is deficient or where users have unusual circumstances. FOP developers and users are happy to help answer questions that are <em>appropriate to the forum</em> (i.e. FOP-specific), and that are <em>submitted after appropriate preparation</em>. To ensure that your question is not <strong>abusive</strong> of this policy, please use the following checklist:</p>
-<ul>
-
-<li>Have you followed the <a href="gethelp.html">Getting Help</a> checklist? If not, please do so before submitting your question.</li>
-
-<li>Is your question appropriate to the forum? If it is really an XSL-FO question, XSLT question, or PDF question, please see the other resources on this page that are intended to help you get those questions answered.</li>
-
-<li>Have you read <a href="#mailing-lists-general">Mailing List General Information</a>? If not please do so before proceeding.</li>
-
-<li>Have you stated the version of FOP you are using? Please do so.</li>
-
-<li>Have you included any detailed error messages? Please do so.</li>
-
-<li>Does a proper understanding of your question require inclusion of XSLT code, DocBook source, or other semantic XML? If so, the question is <em>almost certainly not appropriate to this list</em>. In general, the only input documents that are appropriate on this list are XSL-FO snippets. See <a href="running.html#running_xalan">Running Xalan</a> for instructions about capturing the XSL-FO document that is actually submitted to FOP. If you haven't examined the XSL-FO document yourself, then you are not yet prepared to formulate a FOP-specific question.</li>
-
-<li>If you are providing one or more XSL-FO snippets:
- <ul>
-
-<li>Have you reduced them to the shortest possible complete, <strong>self-contained</strong> document that demonstrates the problem? Please do so.</li>
-
-<li>Have you removed images that are not an integral part of the question? Please do so.</li>
-
-<li>Have you filtered out confidential material? Please do so.</li>
-
-</ul>
-
-</li>
-
-<li>If you are including a stack trace:
- <ul>
-
-<li>Is it helpful in finding the problem? If not, please do not submit it.</li>
-
-<li>Have you included only those portions that are relevant to the question? If not, please do so.</li>
-
-</ul>
-
-</li>
-
-<li>Are you attaching large PDF files or screen shots to your message? If so, please consider attaching a minimal, appropriate B&W GIF, JPG or PNG that conveys the necessary information instead.</li>
-
-</ul>
-</div>
-</div>
-<a name="N1029B"></a><a name="mailing-lists-w3c-xslfo"></a>
-<h4>XSL-FO Mailing List (at W3C)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Use this forum to ask general XSL-FO questions.</p>
-<ul>
-
-<li>To review the archive: <a target="_top" href="http://lists.w3.org/Archives/Public/www-xsl-fo/">W3C XSL-FO Archives</a>.</li>
-
-<li>Before posting questions to any list, see "<a href="#mailing-lists-general">General Information</a>".</li>
-
-<li>Subscription administration information can be found at <a target="_top" href="http://www.w3.org/Mail/Request">W3C Mailing List Administrativia</a>.
-After reviewing the instructions there, send your subscribe or unsubscribe request to <a href="mailto:www-xsl-fo-request.at.w3.org">www-xsl-fo-request@w3.org</a>.</li>
-
-</ul>
-</div>
-<a name="N102C1"></a><a name="mailing-lists-yahoogroups-xslfo"></a>
-<h4>XSL-FO Mailing List (at YahooGroups)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Use this forum to ask general XSL-FO questions.</p>
-<ul>
-
-<li>Before posting questions to any list, see "<a href="#mailing-lists-general">General Information</a>".</li>
-
-<li>The home page for this groups is <a target="_top" href="http://groups.yahoo.com/group/XSL-FO">XSL-FO - discussion of XSL Formatting Objects</a>.</li>
-
-</ul>
-</div>
-<a name="N102DC"></a><a name="mailing-lists-xslt-mulberry"></a>
-<h4>XSLT List (Mulberry Tech)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<ul>
-
-<li>Before posting questions to any list, see "<a href="#mailing-lists-general">General Information</a>".</li>
-
-<li>Information for using and subscribing can be found at <a target="_top" href="http://www.mulberrytech.com/xsl/xsl-list">XSL-List -- Open Forum on XSL</a>.</li>
-
-</ul>
-</div>
-</div>
-
-<a name="N102F5"></a><a name="specs"></a>
+<a name="N101C2"></a><a name="specs"></a>
<h3>Specifications</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N102FB"></a><a name="specs-xslfo"></a>
+<a name="N101C8"></a><a name="specs-xslfo"></a>
<h4>XSL-FO</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -529,7 +387,7 @@
</ul>
</div>
-<a name="N10310"></a><a name="specs-xslt"></a>
+<a name="N101DD"></a><a name="specs-xslt"></a>
<h4>XSLT</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -540,7 +398,7 @@
</ul>
</div>
-<a name="N1031F"></a><a name="specs-xml"></a>
+<a name="N101EC"></a><a name="specs-xml"></a>
<h4>XML</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -563,7 +421,7 @@
</ul>
</div>
-<a name="N1033D"></a><a name="specs-java"></a>
+<a name="N1020A"></a><a name="specs-java"></a>
<h4>Java</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -574,7 +432,7 @@
</ul>
</div>
-<a name="N1034C"></a><a name="specs-pdf"></a>
+<a name="N10219"></a><a name="specs-pdf"></a>
<h4>PDF</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -586,7 +444,7 @@
</ul>
</div>
-<a name="N1035C"></a><a name="specs-other"></a>
+<a name="N10229"></a><a name="specs-other"></a>
<h4>Other</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -599,10 +457,10 @@
</div>
</div>
-<a name="N1036C"></a><a name="documents"></a>
+<a name="N10239"></a><a name="documents"></a>
<h3>Books, Tutorials, Articles</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10372"></a><a name="documents-xslfo"></a>
+<a name="N1023F"></a><a name="documents-xslfo"></a>
<h4>XSL-FO</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -627,7 +485,7 @@
</ul>
</div>
-<a name="N103BB"></a><a name="documents-xslt"></a>
+<a name="N10288"></a><a name="documents-xslt"></a>
<h4>XSLT</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -638,7 +496,7 @@
<li>[book] <a target="_top" href="http://www.oreilly.com/catalog/xsltckbk">XSLT Cookbook</a>, by Sal Mangano, O'Reilly & Associates, 2002, ISBN 0-596-00372-2.</li>
-<li>[article] <a target="_top" href="http://www.dpawson.co.uk/xsl/xslfaq.html">Dave Pawson's XSLT FAQ</a>.</li>
+<li>[article] <a target="_top" href="http://www.dpawson.co.uk/xsl/xslfaq.html">Dave Pawson's XSL FAQ</a>.</li>
<li>[book] <a target="_top" href="http://www.oreilly.com/catalog/xpathpointer">XPath and XPointer: Locating Content in XML Documents</a>, by John E. Simpson, O'Reilly & Associates, 2002, ISBN 0-596-00291-2.</li>
@@ -648,7 +506,7 @@
</ul>
</div>
-<a name="N103F6"></a><a name="documents-xml"></a>
+<a name="N102C3"></a><a name="documents-xml"></a>
<h4>XML</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -661,7 +519,7 @@
</ul>
</div>
-<a name="N10415"></a><a name="documents-java"></a>
+<a name="N102E2"></a><a name="documents-java"></a>
<h4>Java</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -670,7 +528,7 @@
</ul>
</div>
-<a name="N10426"></a><a name="documents-pdf"></a>
+<a name="N102F3"></a><a name="documents-pdf"></a>
<h4>PDF</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -684,7 +542,7 @@
</ul>
</div>
-<a name="N10444"></a><a name="documents-ps"></a>
+<a name="N10311"></a><a name="documents-ps"></a>
<h4>PostScript</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -698,10 +556,10 @@
</div>
</div>
-<a name="N1045C"></a><a name="products"></a>
+<a name="N10329"></a><a name="products"></a>
<h3>Related/Useful Products</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10462"></a><a name="products-fop-add-ons"></a>
+<a name="N1032F"></a><a name="products-fop-add-ons"></a>
<h4>FOP add-ons</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -716,7 +574,7 @@
</ul>
</div>
-<a name="N10488"></a><a name="products-pdf"></a>
+<a name="N10355"></a><a name="products-pdf"></a>
<h4>PDF post-processors</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -729,7 +587,7 @@
</ul>
</div>
-<a name="N104A7"></a><a name="products-editors"></a>
+<a name="N10374"></a><a name="products-editors"></a>
<h4>XSL-FO editors</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -738,7 +596,7 @@
<li>[software] <a target="_top" href="http://www.scruffyware.com/products/foeditor/">FOEditor</a> by Scruffy Software (Shareware)</li>
-<li>[software] <a target="_top" href="http://www.inventivedesigners.com/products/scriptura.html">Scriptura</a> by Inventive Designers (commercial)</li>
+<li>[software] <a target="_top" href="http://www.scriptura-xsl.com">Scriptura</a> by Inventive Designers (commercial)</li>
<li>[software] <a target="_top" href="http://www.xslfast.com">XSLfast</a> by jCatalog Software AG (commercial)</li>
@@ -746,7 +604,7 @@
</ul>
</div>
-<a name="N104D4"></a><a name="products-other"></a>
+<a name="N103A1"></a><a name="products-other"></a>
<h4>Other products</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -754,6 +612,8 @@
<li>[software] <a target="_top" href="http://html2fo.sourceforge.net/">html2fo</a> is a converter from HTML to XSL-FO (GPL).</li>
<li>[software] <a target="_top" href="http://wh2fo.sourceforge.net/">wh2fo</a> is a converter from Word HTML to XSL-FO (MPL).</li>
+
+<li>[software] <a target="_top" href="http://www.rtf2fo.com">RTF2FO</a> is a converter from RTF to XSL-FO by Novosoft (commercial).</li>
<li>[software] <a target="_top" href="http://www.vbxml.com/xpathvisualizer">The XPath Visualizer</a>. Web site says: "This is a full blown Visual XPath Interpreter for the evaluation of any XPath expression and visual presentation of the resulting nodeset or scalar value." (freeware)</li>
1.14 +354 -1274 xml-site/targets/fop/resources.pdf
<<Binary file>>
1.41 +19 -1 xml-site/targets/fop/running.html
Index: running.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/running.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- running.html 14 May 2003 18:13:13 -0000 1.40
+++ running.html 30 May 2003 18:37:38 -0000 1.41
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -244,6 +252,10 @@
<li>
<a href="todo.html">Todo</a>
</li>
+
+<li>
+<a href="team.html">Team</a>
+</li>
</ul>
</li>
@@ -509,6 +521,12 @@
With headers and footers, consider integrating them as normal table rows, or, if they are used at page breaks, try to put the information into static content.
You can then use markers to change them.
</li>
+
+<li>
+Clear the image cache. At the moment, images in the cache are not released automatically when an OutOfMemoryError is imminent.
+Starting with version 0.20.5 however, you can call <span class="codefrag">org.apache.fop.image.FopImageFactory.resetCache()</span> to empty the
+<a target="_top" href="graphics.html#caching">image cache</a>.
+ </li>
</ul>
<p>
@@ -523,7 +541,7 @@
</p>
</div>
-<a name="N102D7"></a><a name="problems"></a>
+<a name="N102E1"></a><a name="problems"></a>
<h3>Problems</h3>
<div style="margin-left: 0 ; border: 2px">
<p>If you have problems running FOP, please see the <a target="_top" href="gethelp.html">"How to get Help" page</a>.</p>
1.11 +308 -373 xml-site/targets/fop/running.pdf
<<Binary file>>
1.16 +12 -0 xml-site/targets/fop/status.html
Index: status.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/status.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- status.html 14 May 2003 18:13:13 -0000 1.15
+++ status.html 30 May 2003 18:37:38 -0000 1.16
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<a href="todo.html">Todo</a>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.6 +139 -178 xml-site/targets/fop/status.pdf
<<Binary file>>
1.24 +12 -0 xml-site/targets/fop/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/todo.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- todo.html 14 May 2003 18:13:13 -0000 1.23
+++ todo.html 30 May 2003 18:37:39 -0000 1.24
@@ -152,6 +152,10 @@
</li>
<li>
+<a href="servlets.html">Servlets</a>
+</li>
+
+<li>
<a href="anttask.html">Ant task</a>
</li>
@@ -208,6 +212,10 @@
</li>
<li>
+<a href="maillist.html">Mailing Lists</a>
+</li>
+
+<li>
<a href="bugs.html">Bugs</a>
</li>
@@ -243,6 +251,10 @@
<li>
<span class="sel"><font color="#ffcc00">Todo</font></span>
+</li>
+
+<li>
+<a href="team.html">Team</a>
</li>
</ul>
1.7 +71 -84 xml-site/targets/fop/todo.pdf
<<Binary file>>
1.1 xml-site/targets/fop/cleeds@medata.com.html
Index: cleeds@medata.com.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>cleeds@medata.com</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/cleeds@medata.com.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 xml-site/targets/fop/glenmazza@yahoo.com.html
Index: glenmazza@yahoo.com.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>glenmazza@yahoo.com</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/glenmazza@yahoo.com.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 xml-site/targets/fop/jaccoud@petrobras.com.br.html
Index: jaccoud@petrobras.com.br.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>jaccoud@petrobras.com.br</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/jaccoud@petrobras.com.br.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 xml-site/targets/fop/jtauber@jtauber.com.html
Index: jtauber@jtauber.com.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>jtauber@jtauber.com</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/jtauber@jtauber.com.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 xml-site/targets/fop/maillist.html
Index: maillist.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>FOP: Mailing List Resources</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://xml.apache.org/"><img border="0" class="logoImage" alt="Apache XML" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/fop/"><img border="0" class="logoImage" alt="FOP" src="images/logo.jpg"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></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"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache XML site
</font></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="dev/index.html"><font face="Arial, Helvetica, Sans-serif">Development</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/index.html"><font face="Arial, Helvetica, Sans-serif">Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/alt.design/index.html"><font face="Arial, Helvetica, Sans-serif">Alt Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Home</font>
<ul>
<li>
<a href="index.html">Introduction</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Using FOP</font>
<ul>
<li>
<a href="relnotes.html">Release Notes</a>
</li>
<li>
<a href="download.html">Download</a>
</li>
<li>
<a href="compiling.html">Build</a>
</li>
<li>
<a href="configuration.html">Configure</a>
</li>
<li>
<a href="running.html">Run</a>
</li>
<li>
<a href="embedding.html">Embed</a>
</li>
<li>
<a href="servlets.html">Servlets</a>
</li>
<li>
<a href="anttask.html">Ant task</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Features</font>
<ul>
<li>
<a href="compliance.html">Compliance</a>
</li>
<li>
<a href="output.html">Output Targets</a>
</li>
<li>
<a href="pdfencryption.html">PDF encryption</a>
</li>
<li>
<a href="graphics.html">Graphics</a>
</li>
<li>
<a href="fonts.html">Fonts</a>
</li>
<li>
<a href="extensions.html">Extensions</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Resources</font>
<ul>
<li>
<a href="gethelp.html">Getting Help</a>
</li>
<li>
<a href="faq.html">FAQs</a>
</li>
<li>
<a href="fo.html">XSL-FO</a>
</li>
<li>
<a href="examples.html">Examples</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Mailing Lists</font></span>
</li>
<li>
<a href="bugs.html">Bugs</a>
</li>
<li>
<a href="license.html">License</a>
</li>
<li>
<a href="resources.html">Other</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Project</font>
<ul>
<li>
<a href="news.html">News</a>
</li>
<li>
<a href="logocontest.html">Logo contest</a>
</li>
<li>
<a href="status.html">Status</a>
</li>
<li>
<a href="changes.html">Changes</a>
</li>
<li>
<a href="todo.html">Todo</a>
</li>
<li>
<a href="team.html">Team</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<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" border="0" alt="" src="skin/images/spacer.gif"></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"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>FOP: Mailing List Resources</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="maillist.pdf"><img alt="printer" src="skin/images/printer.gif" border="0"><br>
print-friendly<br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#general">General Information</a>
</li>
<li>
<a href="#fop-user">FOP User Mailing List</a>
<ul class="minitoc">
<li>
<a href="#fop-user-archive">Archives</a>
</li>
<li>
<a href="#fop-user-subscribe">Subscription Information</a>
</li>
<li>
<a href="#fop-user-policy">Submitting a Question</a>
</li>
</ul>
</li>
<li>
<a href="#w3c-xslfo">XSL-FO Mailing List (at W3C)</a>
</li>
<li>
<a href="#yahoogroups-xslfo">XSL-FO Mailing List (at YahooGroups)</a>
</li>
<li>
<a href="#xslt-mulberry">XSLT List (Mulberry Tech)</a>
</li>
</ul>
<a name="N101BE"></a><a name="general"></a>
<h3>General Information</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Before posting questions to any list, review "<a target="_top" href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</a>".</p>
<p>Be sure to set your email client to send plain text email messages to any mailing lists.
Please do <em>not</em> send html or rtf email, as they do not work well with the archive engines.
If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.</p>
<p>For help in understanding email acronyms, see the <a target="_top" href="http://www.lingo2word.com/lists/acronym_listA.html">Lingo2Word Acronym List</a>, or the <a target="_top" href="http://www.keno.org/web_design/acronyms.htm">Keno Internet Services Internet Glossary</a>.</p>
</div>
<a name="N101DD"></a><a name="fop-user"></a>
<h3>FOP User Mailing List</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Use this forum to discuss topics of interest to FOP users.</p>
<a name="N101E6"></a><a name="fop-user-archive"></a>
<h4>Archives</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To review the archives, you have several options:</p>
<ul>
<li>The <a target="_top" href="http://marc.theaimsgroup.com/?l=fop-user&r=1&w=2">Mailing list ARChives </a> (MARC) at the AIMS group (search).</li>
<li>The <a target="_top" href="http://nagoya.apache.org/eyebrowse/SummarizeList?listName=fop-user@xml.apache.org">Apache Eyebrowse</a> archive (search, list by date, author, subject, or thread).</li>
<li>The <a href="http://xml.apache.org/mail/fop-user">Apache Mailing List archive</a> (gzip files).</li>
</ul>
</div>
<a name="N10208"></a><a name="fop-user-subscribe"></a>
<h4>Subscription Information</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>See <a href="http://xml.apache.org/mail.html#fop-user">Apache XML Mailing Lists</a> for detailed subscription information.</li>
<li>To subscribe (digest only): Send email to <a href="mailto:fop-user-digest-subscribe.at.xml.apache.org">fop-user-digest-subscribe@xml.apache.org</a>.</li>
<li>To subscribe fully: Send email to <a href="mailto:fop-user-subscribe.at.xml.apache.org">fop-user-subscribe@xml.apache.org</a>.</li>
<li>For standard help: Send email to <a href="mailto:fop-user-help.at.xml.apache.org">fop-user-help@xml.apache.org</a>.</li>
<li>To unsubscribe: Send email to <a href="mailto:fop-user-unsubscribe.at.xml.apache.org">fop-user-unsubscribe@xml.apache.org</a>.</li>
</ul>
</div>
<a name="N10235"></a><a name="fop-user-policy"></a>
<h4>Submitting a Question</h4>
<div style="margin-left: 0 ; border: 2px">
<p>FOP support is primarily <em>self-service</em>. The FOP User Mailing List serves as a backup to the self-service documentation for cases where either the documentation is deficient or where users have unusual circumstances. FOP developers and users are happy to help answer questions that are <em>appropriate to the forum</em> (i.e. FOP-specific), and that are <em>submitted after appropriate preparation</em>. To ensure that your question is not <strong>abusive</strong> of this policy, please use the following checklist:</p>
<ul>
<li>Have you followed the <a href="gethelp.html">Getting Help</a> checklist? If not, please do so before submitting your question.</li>
<li>Is your question appropriate to the forum? If it is really an XSL-FO question, XSLT question, or PDF question, please see the other resources on this page that are intended to help you get those questions answered.</li>
<li>Have you read <a href="#general">Mailing List General Information</a>? If not please do so before proceeding.</li>
<li>Have you stated the version of FOP you are using? Please do so.</li>
<li>Have you included any detailed error messages? Please do so.</li>
<li>Does a proper understanding of your question require inclusion of XSLT code, DocBook source, or other semantic XML? If so, the question is <em>almost certainly not appropriate to this list</em>. In general, the only input documents that are appropriate on this list are XSL-FO snippets. See <a href="running.html#running_xalan">Running Xalan</a> for instructions about capturing the XSL-FO document that is actually submitted to FOP. If you haven't examined the XSL-FO document yourself, then you are not yet prepared to formulate a FOP-specific question.</li>
<li>If you are providing one or more XSL-FO snippets:
<ul>
<li>Have you reduced them to the shortest possible complete, <strong>self-contained</strong> document that demonstrates the problem? Please do so.</li>
<li>Have you removed images that are not an integral part of the question? Please do so.</li>
<li>Have you filtered out confidential material? Please do so.</li>
</ul>
</li>
<li>If you are including a stack trace:
<ul>
<li>Is it helpful in finding the problem? If not, please do not submit it.</li>
<li>Have you included only those portions that are relevant to the question? If not, please do so.</li>
</ul>
</li>
<li>Are you attaching large PDF files or screen shots to your message? If so, please consider attaching a minimal, appropriate B&W GIF, JPG or PNG that conveys the necessary information instead.</li>
</ul>
</div>
</div>
<a name="N10291"></a><a name="w3c-xslfo"></a>
<h3>XSL-FO Mailing List (at W3C)</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Use this forum to ask general XSL-FO questions.</p>
<ul>
<li>To review the archive: <a target="_top" href="http://lists.w3.org/Archives/Public/www-xsl-fo/">W3C XSL-FO Archives</a>.</li>
<li>Before posting questions to any list, see "<a href="#general">General Information</a>".</li>
<li>Subscription administration information can be found at <a target="_top" href="http://www.w3.org/Mail/Request">W3C Mailing List Administrativia</a>.
After reviewing the instructions there, send your subscribe or unsubscribe request to <a href="mailto:www-xsl-fo-request.at.w3.org">www-xsl-fo-request@w3.org</a>.</li>
</ul>
</div>
<a name="N102B7"></a><a name="yahoogroups-xslfo"></a>
<h3>XSL-FO Mailing List (at YahooGroups)</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Use this forum to ask general XSL-FO questions.</p>
<ul>
<li>Before posting questions to any list, see "<a href="#general">General Information</a>".</li>
<li>The home page for this groups is <a target="_top" href="http://groups.yahoo.com/group/XSL-FO">XSL-FO - discussion of XSL Formatting Objects</a>.</li>
</ul>
</div>
<a name="N102D2"></a><a name="xslt-mulberry"></a>
<h3>XSLT List (Mulberry Tech)</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>Before posting questions to any list, see "<a href="#general">General Information</a>".</li>
<li>Information for using and subscribing can be found at <a target="_top" href="http://www.mulberrytech.com/xsl/xsl-list">XSL-List -- Open Forum on XSL</a>.</li>
</ul>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
1999-2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 xml-site/targets/fop/maillist.pdf
<<Binary file>>
1.1 xml-site/targets/fop/servlets.html
Index: servlets.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Servlets</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://xml.apache.org/"><img border="0" class="logoImage" alt="Apache XML" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/fop/"><img border="0" class="logoImage" alt="FOP" src="images/logo.jpg"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></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"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache XML site
</font></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="dev/index.html"><font face="Arial, Helvetica, Sans-serif">Development</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/index.html"><font face="Arial, Helvetica, Sans-serif">Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/alt.design/index.html"><font face="Arial, Helvetica, Sans-serif">Alt Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Home</font>
<ul>
<li>
<a href="index.html">Introduction</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Using FOP</font>
<ul>
<li>
<a href="relnotes.html">Release Notes</a>
</li>
<li>
<a href="download.html">Download</a>
</li>
<li>
<a href="compiling.html">Build</a>
</li>
<li>
<a href="configuration.html">Configure</a>
</li>
<li>
<a href="running.html">Run</a>
</li>
<li>
<a href="embedding.html">Embed</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Servlets</font></span>
</li>
<li>
<a href="anttask.html">Ant task</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Features</font>
<ul>
<li>
<a href="compliance.html">Compliance</a>
</li>
<li>
<a href="output.html">Output Targets</a>
</li>
<li>
<a href="pdfencryption.html">PDF encryption</a>
</li>
<li>
<a href="graphics.html">Graphics</a>
</li>
<li>
<a href="fonts.html">Fonts</a>
</li>
<li>
<a href="extensions.html">Extensions</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Resources</font>
<ul>
<li>
<a href="gethelp.html">Getting Help</a>
</li>
<li>
<a href="faq.html">FAQs</a>
</li>
<li>
<a href="fo.html">XSL-FO</a>
</li>
<li>
<a href="examples.html">Examples</a>
</li>
<li>
<a href="maillist.html">Mailing Lists</a>
</li>
<li>
<a href="bugs.html">Bugs</a>
</li>
<li>
<a href="license.html">License</a>
</li>
<li>
<a href="resources.html">Other</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Project</font>
<ul>
<li>
<a href="news.html">News</a>
</li>
<li>
<a href="logocontest.html">Logo contest</a>
</li>
<li>
<a href="status.html">Status</a>
</li>
<li>
<a href="changes.html">Changes</a>
</li>
<li>
<a href="todo.html">Todo</a>
</li>
<li>
<a href="team.html">Team</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<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" border="0" alt="" src="skin/images/spacer.gif"></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"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>Servlets</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="servlets.pdf"><img alt="printer" src="skin/images/printer.gif" border="0"><br>
print-friendly<br>
PDF</a></td>
</tr>
</table>
<h3>How to use FOP in a Servlet</h3>
<ul class="minitoc">
<li>
<a href="#overview">Overview</a>
</li>
<li>
<a href="#example-servlets">Example Servlets in the FOP distribution</a>
</li>
<li>
<a href="#servlet">Create your own Servlet</a>
<ul class="minitoc">
<li>
<a href="#minimal-servlet">A minimal Servlet</a>
</li>
<li>
<a href="#xslt">Adding XSL tranformation (XSLT)</a>
</li>
<li>
<a href="#cfg">Custom configuration</a>
</li>
<li>
<a href="#performance">Improving performance</a>
</li>
</ul>
</li>
<li>
<a href="#ie">Notes on Microsoft Internet Explorer</a>
</li>
<li>
<a href="#servlet-engine">Servlet Engines</a>
<ul class="minitoc">
<li>
<a href="#tomcat">Tomcat</a>
</li>
<li>
<a href="#websphere">WebSphere 3.5</a>
</li>
</ul>
</li>
<li>
<a href="#complex-usecases">Handling complex use cases</a>
</li>
</ul>
<a name="N101C1"></a><a name="overview"></a>
<h3>Overview</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
This page discusses topic all around using FOP in a servlet environment.
</p>
</div>
<a name="N101CB"></a><a name="example-servlets"></a>
<h3>Example Servlets in the FOP distribution</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
In the directory {fop-dir}/examples/servlet, you'll find a working example
of a FOP-enabled servlet.
</p>
<p>
You can build the servlet easily by using the supplied Ant script. After building
the servlet, drop fop.war into the webapps directory of Tomcat. Then, you can use
URLs like the following to generate PDF files:
</p>
<ul>
<li>http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo</li>
<li>http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl</li>
</ul>
<p></p>
<p>The source code for the servlet can be found under {fop-dir}/examples/servlet/src/FopServlet.java.</p>
</div>
<a name="N101E6"></a><a name="servlet"></a>
<h3>Create your own Servlet</h3>
<div style="margin-left: 0 ; border: 2px">
<div class="frame note">
<div class="label">Note</div>
<div class="content">
This section assumes you are familiar with <a href="embedding.html">embedding FOP</a>.
</div>
</div>
<a name="N101F3"></a><a name="minimal-servlet"></a>
<h4>A minimal Servlet</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Here is a minimal code snippet to demonstrate the basics:
</p>
<pre class="code">public void doGet(HttpServletRequest request,
HttpServletResponse response) throws ServletException {
try {
response.setContentType("application/pdf");
Driver driver = new Driver(new InputSource("foo.fo"),
response.getOutputStream());
driver.setRenderer(Driver.RENDER_PDF);
driver.run();
} catch (Exception ex) {
throw new ServletException(ex);
}
}</pre>
<div class="frame note">
<div class="label">Note</div>
<div class="content">
There are numerous problems with the code snippet above.
Its purpose is only to demonstrate the basic concepts.
See below for details.
</div>
</div>
</div>
<a name="N10204"></a><a name="xslt"></a>
<h4>Adding XSL tranformation (XSLT)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
A common requirement is the to transform an XML source to
XSLFO using an XSL transformation. It is recommended to use
JAXP for this task. The following snippet shows the basic
code:
</p>
<pre class="code">
protected Logger log;
protected TransformerFactory transformerFactory;
public void init() throws ServletException {
this.log = new ConsoleLogger(ConsoleLogger.LEVEL_WARN);
this.transformerFactory = TransformerFactory.newInstance();
}
[..]
//Setup FOP
Driver driver = new Driver();
driver.setLogger(this.log);
driver.setRenderer(Driver.RENDER_PDF);
//Setup a buffer to obtain the content length
ByteArrayOutputStream out = new ByteArrayOutputStream();
driver.setOutputStream(out);
//Setup Transformer
Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl"));
Transformer transformer = this.transformerFactory.newTransformer(xsltSrc);
//Make sure the XSL transformation's result is piped through to FOP
Result res = new SAXResult(driver.getContentHandler());
//Setup input
Source src = new StreamSource(new File("foo.xml"));
//Start the transformation and rendering process
transformer.transform(src, res);
//Prepare response
response.setContentType("application/pdf");
response.setContentLength(out.size());
//Send content to Browser
response.getOutputStream().write(out.toByteArray());
response.getOutputStream().flush();</pre>
<div class="frame note">
<div class="label">Note</div>
<div class="content">
Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential
problems with the Acrobat Reader Plug-in in IEx.
</div>
</div>
<p>
The <span class="codefrag">Source</span> instance used above is simply an
example. If you have to read the XML from a string, supply
a <span class="codefrag">new StreamSource(new
StringReader(xmlstring))</span>. Constructing and reparsing
an XML string is generally less desirable than using a
SAXSource if you generate your XML. You can alternatively
supply a DOMSource as well. You may also use dynamically
generated XSL if you like.
</p>
<p>
Because you have an explicit <span class="codefrag">Transformer</span> object, you can also use it to
explicitly set parameters for the transformation run.
</p>
</div>
<a name="N10224"></a><a name="cfg"></a>
<h4>Custom configuration</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
If you need to supply a special configuration do this in the <span class="codefrag">init()</span>
method so it will only be done once and to avoid multithreading problems.
</p>
<pre class="code">public void init() throws ServletException {
[..]
new Options(new File("userconfig.xml"));
//or
Configuration.put("baseDir", "/my/base/dir");
}</pre>
</div>
<a name="N10235"></a><a name="performance"></a>
<h4>Improving performance</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
There are several options to consider:
</p>
<ul>
<li>
Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream
implementation from the Jakarta Commons IO project which allocates less memory.
</li>
<li>
In certain cases it can help to write the generated PDF to a temporary file so
you can quickly reuse the file. This is especially useful, if Internet Explorer
calls the servlet multiple times with the same request or if you often generate
equal PDFs.
</li>
</ul>
<p>
Of course, the
<a href="embedding.html#performance">performance hints from the Embedding page</a>
apply here, too.
</p>
</div>
</div>
<a name="N10250"></a><a name="ie"></a>
<h3>Notes on Microsoft Internet Explorer</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times.
These are well-known limitations of Internet Explorer and are not a problem of the servlet.
However, Internet Explorer can still be used to download the PDF so that it can be viewed later.
Here are some suggestions in this context:
</p>
<ul>
<li>
Use an URL ending in <span class="codefrag">.pdf</span>, like
<span class="codefrag">http://myserver/servlet/stuff.pdf</span>. Yes, the servlet can
be configured to handle this. If the URL has to contain parameters,
try to have <strong>both</strong> the base URL as well as the last parameter end in
<span class="codefrag">.pdf</span>, if necessary append a dummy parameter, like
<span class="codefrag">http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf</span>. The
effect may depend on IEx version.
</li>
<li>
Give IEx the opportunity to cache. In particular, ensure the
server does not set any headers causing IEx not to cache the
content. This may be a real problem if the document is sent
over HTTPS, because most IEx installations will by default
<em>not</em> cache any content retrieved over HTTPS.
Setting the <span class="codefrag">Expires</span> header entry may help in
this case:<br>
<span class="codefrag">response.setDateHeader("Expires",
System.currentTimeMillis() + cacheExpiringDuration *
1000);</span>
<br> Consult your server manual and the
relevant RFCs for further details on HTTP headers and
caching.
</li>
<li>
Cache in the server. It may help to include a parameter in
the URL which has a timestamp as the value min order to
decide whether a request is repeated. IEx is reported to
retrieve a document up to three times, but never more often.
</li>
</ul>
</div>
<a name="N10281"></a><a name="servlet-engine"></a>
<h3>Servlet Engines</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts
with existing XML/XSLT libraries. Servlet containers also often use their own classloaders
for loading webapps, which can cause bugs and security problems.
</p>
<a name="N1028A"></a><a name="tomcat"></a>
<h4>Tomcat</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon.
There are known bugs that must be addressed, particularly for Tomcat 4.0.3.
</p>
</div>
<a name="N10294"></a><a name="websphere"></a>
<h4>WebSphere 3.5</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Put a copy of a working parser in some directory where WebSphere can access it.
For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets,
copy the Xerces jar into it (any other directory would also be fine).
Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the
application server which contains your web application.
In the WebSphere administration console, click on the "environment" button in the
"general" tab. In the "variable name" box, enter "CLASSPATH".
In the "value" box, enter the correct path to the parser jar file
(/usr/webapps/yourapp/servlets/Xerces.jar in our example here).
Press "OK", then apply the change and restart the application server.
</p>
</div>
</div>
<a name="N1029F"></a><a name="complex-usecases"></a>
<h3>Handling complex use cases</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
Sometimes the requirements for a servlet get quite sophisticated: SQL data sources,
multiple XSL transformations, merging of several datasources etc. In such a case
consider using <a target="_blank" href="http://cocoon.apache.org">Apache Cocoon</a> instead
of a custom servlet to accomplish your goal.
</p>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
1999-2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 xml-site/targets/fop/servlets.pdf
<<Binary file>>
1.1 xml-site/targets/fop/servlets.xml.html
Index: servlets.xml.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>servlets.xml</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/servlets.xml.html</pre></p><hr size="1" noshade="true"/></body></html>
1.22 +0 -0 xml-site/targets/fop/svg.html
1.1 xml-site/targets/fop/team.html
Index: team.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>FOP: Development Team</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://xml.apache.org/"><img border="0" class="logoImage" alt="Apache XML" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/fop/"><img border="0" class="logoImage" alt="FOP" src="images/logo.jpg"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></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"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache XML site
</font></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="dev/index.html"><font face="Arial, Helvetica, Sans-serif">Development</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/index.html"><font face="Arial, Helvetica, Sans-serif">Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td><td width="8"><img alt="" height="8" width="8" 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 href="design/alt.design/index.html"><font face="Arial, Helvetica, Sans-serif">Alt Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Home</font>
<ul>
<li>
<a href="index.html">Introduction</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Using FOP</font>
<ul>
<li>
<a href="relnotes.html">Release Notes</a>
</li>
<li>
<a href="download.html">Download</a>
</li>
<li>
<a href="compiling.html">Build</a>
</li>
<li>
<a href="configuration.html">Configure</a>
</li>
<li>
<a href="running.html">Run</a>
</li>
<li>
<a href="embedding.html">Embed</a>
</li>
<li>
<a href="servlets.html">Servlets</a>
</li>
<li>
<a href="anttask.html">Ant task</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Features</font>
<ul>
<li>
<a href="compliance.html">Compliance</a>
</li>
<li>
<a href="output.html">Output Targets</a>
</li>
<li>
<a href="pdfencryption.html">PDF encryption</a>
</li>
<li>
<a href="graphics.html">Graphics</a>
</li>
<li>
<a href="fonts.html">Fonts</a>
</li>
<li>
<a href="extensions.html">Extensions</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Resources</font>
<ul>
<li>
<a href="gethelp.html">Getting Help</a>
</li>
<li>
<a href="faq.html">FAQs</a>
</li>
<li>
<a href="fo.html">XSL-FO</a>
</li>
<li>
<a href="examples.html">Examples</a>
</li>
<li>
<a href="maillist.html">Mailing Lists</a>
</li>
<li>
<a href="bugs.html">Bugs</a>
</li>
<li>
<a href="license.html">License</a>
</li>
<li>
<a href="resources.html">Other</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Project</font>
<ul>
<li>
<a href="news.html">News</a>
</li>
<li>
<a href="logocontest.html">Logo contest</a>
</li>
<li>
<a href="status.html">Status</a>
</li>
<li>
<a href="changes.html">Changes</a>
</li>
<li>
<a href="todo.html">Todo</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Team</font></span>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<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" border="0" alt="" src="skin/images/spacer.gif"></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"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>FOP: Development Team</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="team.pdf"><img alt="printer" src="skin/images/printer.gif" border="0"><br>
print-friendly<br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#commit-active">Active Committers</a>
</li>
<li>
<a href="#contribute-active">Active Contributors</a>
</li>
<li>
<a href="#founder">Founder</a>
</li>
<li>
<a href="#commit-former">Former Committers</a>
</li>
<li>
<a href="#expertise">Areas of Expertise</a>
</li>
</ul>
<p>All lists on this page are in alphabetical order. Some of them may be incomplete. If you know of an error or omission, please send a message to the <a href="mailto:fop-dev.at.xml.apache.org">fop-dev</a> mailing list.</p>
<a name="N101C5"></a><a name="commit-active"></a>
<h3>Active Committers</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>
<a name="bd"></a><a href="mailto:bdelacretaz.at.apache.org">Bertrand Delacrétaz</a> (BD)</li>
<li>
<a name="cg"></a><a href="mailto:chrisg.at.apache.org">Christian Geisert</a> (CG)</li>
<li>
<a name="kl"></a><a href="mailto:klease.at.apache.org">Karen Lease</a> (KL)</li>
<li>
<a name="kll"></a><a href="mailto:keiron.at.apache.org">Keiron Liddle</a> (KLL)</li>
<li>
<a name="jm"></a><a href="mailto:jeremias.at.apache.org">Jeremias Märki</a> (JM)
is a software engineer from Lucerne, Switzerland. He is currently enjoying a longer period of
"independence" and is having fun working on open source projects like Apache FOP. He's also
the creator of <a target="_blank" href="http://www.krysalis.org/barcode">Krysalis Barcode</a>.
</li>
<li>
<a name="wvm"></a><a href="mailto:vmote.at.apache.org">Victor Mote</a> (WVM) is the founder and manager of <a target="_top" href="http://www.outfitr.com">Enterprise Outfitters</a>, a business software company, and of <a target="_top" href="http://www.portagepub.com">Portage Publications</a>, a republisher of old documents. Both are located in Colorado Springs, Colorado, USA.</li>
<li>
<a name="jp"></a><a href="mailto:pietsch.at.apache.org">Jörg Pietschmann</a> (JP)</li>
<li>
<a name="as"></a><a href="mailto:arved.at.apache.org">Arved Sandstrom</a> (AS)</li>
<li>
<a name="ot"></a><a href="mailto:olegt.at.apache.org">Oleg Tkachenko</a> (OT)</li>
<li>
<a name="pbw"></a><a href="mailto:pbwest.at.apache.org">Peter B. West</a> (PBW)</li>
</ul>
</div>
<a name="N10221"></a><a name="contribute-active"></a>
<h3>Active Contributors</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>
<a href="mailto:jaccoud.at.petrobras.com.br">Marcelo Jaccoud Amaral</a>
</li>
<li>
<a href="mailto:wlight.at.weatherlight.com">Rhett Aultman</a>
</li>
<li>
<a href="mailto:cleeds.at.medata.com">Clay Leeds</a>
</li>
<li>
<a href="mailto:glenmazza.at.yahoo.com">Glen Mazza</a>
</li>
<li>
<a href="mailto:atagunov.at.mail.cnt.ru">Anton Tagunov</a>
</li>
<li>
<a href="mailto:yidaomao.at.yahoo.com">Zhong (George) Yi</a>
</li>
</ul>
</div>
<a name="N10249"></a><a name="founder"></a>
<h3>Founder</h3>
<div style="margin-left: 0 ; border: 2px">
<p>FOP was originally created and donated to the Apache Software Foundation by <a href="jtauber@jtauber.com.html">James Tauber</a>. Information about him can be found at <a target="_top" href="http://www.jtauber.com">his website</a>.</p>
</div>
<a name="N1025B"></a><a name="commit-former"></a>
<h3>Former Committers</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>
<a name="kc"></a><a href="mailto:kellyc.at.apache.org">Kelly Campbell</a>
</li>
<li>
<a name="sc"></a><a href="mailto:gears.at.apache.org">Steven Coffman</a>
</li>
<li>
<a name="te"></a><a href="mailto:tore.at.apache.org">Tore Engvig</a>
</li>
<li>
<a name="sg"></a><a href="mailto:stanislav.at.apache.org">Stanislav Gorkhover</a>
</li>
<li>
<a name="fj"></a><a href="mailto:fotis.at.apache.org">Fotis Jannidis</a>
</li>
<li>
<a name="jn"></a><a href="mailto:jordan.at.apache.org">Jordan Naftolin</a>
</li>
<li>
<a name="es"></a><a href="mailto:eschaeffer.at.apache.org">Eric Schaeffer</a>
</li>
<li>
<a name="aw"></a><a href="mailto:artw.at.apache.org">Art Welch</a>
</li>
</ul>
</div>
<a name="N10295"></a><a name="expertise"></a>
<h3>Areas of Expertise</h3>
<div style="margin-left: 0 ; border: 2px">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1"></th>
<th colspan="1" rowspan="1">BD </th>
<th colspan="1" rowspan="1">CG </th>
<th colspan="1" rowspan="1">KL </th>
<th colspan="1" rowspan="1">KLL</th>
<th colspan="1" rowspan="1">JM </th>
<th colspan="1" rowspan="1">WVM</th>
<th colspan="1" rowspan="1">JP </th>
<th colspan="1" rowspan="1">AS </th>
<th colspan="1" rowspan="1">OT </th>
<th colspan="1" rowspan="1">PBW</th>
</tr>
<tr>
<td colspan="1" rowspan="1">PMC representation</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
</tr>
<tr>
<td colspan="1" rowspan="1">Release manager</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">XSL-FO tree</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
</tr>
<tr>
<td colspan="1" rowspan="1">Layout</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">Fonts</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">SVG</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">Java2D (AWT)</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PDF</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PostScript</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PCL</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">RTF</td>
<td colspan="1" rowspan="1">X</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
<tr>
<td colspan="1" rowspan="1">MIF</td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
<td colspan="1" rowspan="1"></td>
</tr>
</table>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
1999-2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 xml-site/targets/fop/team.pdf
<<Binary file>>
1.9 +354 -419 xml-site/targets/fop/design/areas.pdf
<<Binary file>>
1.6 +311 -389 xml-site/targets/fop/design/breakpos.pdf
<<Binary file>>
1.7 +195 -234 xml-site/targets/fop/design/embedding.pdf
<<Binary file>>
1.7 +132 -158 xml-site/targets/fop/design/extending.pdf
<<Binary file>>
1.7 +274 -326 xml-site/targets/fop/design/fotree.pdf
<<Binary file>>
1.2 +212 -251 xml-site/targets/fop/design/images.pdf
<<Binary file>>
1.8 +216 -255 xml-site/targets/fop/design/index.pdf
<<Binary file>>
1.9 +638 -755 xml-site/targets/fop/design/layout.pdf
<<Binary file>>
1.6 +55 -68 xml-site/targets/fop/design/optimise.pdf
<<Binary file>>
1.3 +163 -189 xml-site/targets/fop/design/parsing.pdf
<<Binary file>>
1.2 +142 -168 xml-site/targets/fop/design/pdf-library.pdf
<<Binary file>>
1.9 +428 -532 xml-site/targets/fop/design/properties.pdf
<<Binary file>>
1.9 +307 -372 xml-site/targets/fop/design/renderers.pdf
<<Binary file>>
1.2 +87 -100 xml-site/targets/fop/design/startup.pdf
<<Binary file>>
1.2 +119 -145 xml-site/targets/fop/design/svg.pdf
<<Binary file>>
1.6 +86 -112 xml-site/targets/fop/design/useragent.pdf
<<Binary file>>
1.25 +0 -0 xml-site/targets/fop/design/alt.design/FOPropertySets.html
Index: FOPropertySets.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/FOPropertySets.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.16 +0 -0 xml-site/targets/fop/design/alt.design/FoXMLEvent.html
Index: FoXMLEvent.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/FoXMLEvent.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
1.16 +0 -0 xml-site/targets/fop/design/alt.design/SyncedFoXmlEventsBuffer.html
Index: SyncedFoXmlEventsBuffer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/SyncedFoXmlEventsBuffer.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
1.16 +0 -0 xml-site/targets/fop/design/alt.design/XMLNamespaces.html
Index: XMLNamespaces.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/XMLNamespaces.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
1.15 +0 -0 xml-site/targets/fop/design/alt.design/codedisplay.js
Index: codedisplay.js
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/codedisplay.js,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
1.4 +83 -109 xml-site/targets/fop/design/alt.design/compound-properties.pdf
<<Binary file>>
1.4 +97 -123 xml-site/targets/fop/design/alt.design/coroutines.pdf
<<Binary file>>
1.4 +160 -199 xml-site/targets/fop/design/alt.design/footnotes.pdf
<<Binary file>>
1.4 +238 -277 xml-site/targets/fop/design/alt.design/galleys.pdf
<<Binary file>>
1.4 +114 -140 xml-site/targets/fop/design/alt.design/index.pdf
<<Binary file>>
1.4 +105 -131 xml-site/targets/fop/design/alt.design/keeps.pdf
<<Binary file>>
1.4 +201 -240 xml-site/targets/fop/design/alt.design/spaces.pdf
<<Binary file>>
1.4 +328 -367 xml-site/targets/fop/design/alt.design/traits.pdf
<<Binary file>>
1.4 +1236 -1418xml-site/targets/fop/design/alt.design/user-agent-refs.pdf
<<Binary file>>
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/AbstractPropertyValue.html
Index: AbstractPropertyValue.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/AbstractPropertyValue.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/FOAttributes.html
Index: FOAttributes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/FOAttributes.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropNames.html
Index: PropNames.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropNames.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/Property.html
Index: Property.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/Property.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertyConsts.html
Index: PropertyConsts.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyConsts.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertyParser.html
Index: PropertyParser.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyParser.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertySets.html
Index: PropertySets.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertySets.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertyTokenizer.html
Index: PropertyTokenizer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyTokenizer.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertyValue.html
Index: PropertyValue.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyValue.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/PropertyValueList.html
Index: PropertyValueList.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyValueList.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.25 +0 -0 xml-site/targets/fop/design/alt.design/properties/ShorthandPropSets.html
Index: ShorthandPropSets.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/ShorthandPropSets.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
1.15 +0 -0 xml-site/targets/fop/design/alt.design/properties/codedisplay.js
Index: codedisplay.js
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/codedisplay.js,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
1.2 +163 -202 xml-site/targets/fop/design/alt.design/properties/introduction.pdf
<<Binary file>>
1.3 +1 -13 xml-site/targets/fop/dev/api-doc.html
Index: api-doc.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/api-doc.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- api-doc.html 14 May 2003 18:13:18 -0000 1.2
+++ api-doc.html 30 May 2003 18:37:48 -0000 1.3
@@ -200,24 +200,12 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
-</li>
</ul>
</li>
@@ -296,7 +284,7 @@
</ul>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">If the links return an "Object not found!" message or otherwise do not work properly, it is probably because of a build error. Please raise a question on the <a href="../resources.html#mailing-lists-fop-user">fop-user mailing list</a> so that any problems can be fixed before the next build.</div>
+<div class="content">If the links return an "Object not found!" message or otherwise do not work properly, it is probably because of a build error. Please raise a question on the <a href="../maillist.html#fop-user">fop-user mailing list</a> so that any problems can be fixed before the next build.</div>
</div>
</div>
1.3 +93 -106 xml-site/targets/fop/dev/api-doc.pdf
<<Binary file>>
1.5 +0 -12 xml-site/targets/fop/dev/doc.html
Index: doc.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/doc.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- doc.html 14 May 2003 18:13:18 -0000 1.4
+++ doc.html 30 May 2003 18:37:48 -0000 1.5
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.4 +317 -369 xml-site/targets/fop/dev/doc.pdf
<<Binary file>>
1.15 +1 -389 xml-site/targets/fop/dev/examples.html
Index: examples.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/examples.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- examples.html 5 May 2003 20:10:44 -0000 1.14
+++ examples.html 30 May 2003 18:37:48 -0000 1.15
@@ -1,389 +1 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>FO Examples</title>
-<link type="text/css" href="../skin/page.css" rel="stylesheet">
-</head>
-<body text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
-<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
-<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org/"><img border="0" class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/fop/"><img border="0" class="logoImage" alt="FOP" src="../images/logo.jpg"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
-<form target="_blank" action="http://www.google.com/search" method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
-<tr>
-<td colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></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"><input name="Search" value="Search" type="submit">
-<br>
-<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache XML site
-
-
- </font></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img alt="" border="0" height="10" width="9" src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../skin/images/search-right.gif"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td width="8"><img alt="" height="8" width="8" 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 href="../index.html"><font face="Arial, Helvetica, Sans-serif">Home</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
-</tr>
-</table>
-</td><td width="8"><img alt="" height="8" width="8" src="../skin/images/spacer.gif"></td><td valign="bottom">
-<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="index.html"><font color="#000000">Development</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-right.gif"></td>
-</tr>
-</table>
-</td><td width="8"><img alt="" height="8" width="8" 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 href="../design/index.html"><font face="Arial, Helvetica, Sans-serif">Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
-</tr>
-</table>
-</td><td width="8"><img alt="" height="8" width="8" 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 href="../design/alt.design/index.html"><font face="Arial, Helvetica, Sans-serif">Alt Design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-</div>
-<!--================= end Tabs ==================-->
-</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
-<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top">
-<table summary="menu" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<!--================= start left top NavBar ==================-->
-<td rowspan="3" valign="top">
-<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
-</tr>
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td>
-<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
-<div class="menu">
-<ul>
-<li>
-<font color="#CFDCED">Introduction</font>
-<ul>
-
-<li>
-<a href="index.html">Basics</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Design</font>
-<ul>
-
-<li>
-<a href="../design/index.html">Resolved</a>
-</li>
-
-<li>
-<a target="_blank" href="http://nagoya.apache.org/wiki/apachewiki.cgi?FOPProjectPages">Unresolved (Wiki)</a>
-</li>
-
-<li>
-<a href="svg.html">SVG</a>
-</li>
-
-<li>
-<a href="fonts.html">Fonts</a>
-</li>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Develop</font>
-<ul>
-
-<li>
-<a href="api-doc.html">API Doc</a>
-</li>
-
-<li>
-<a href="implement.html">Walk-Thru</a>
-</li>
-
-<li>
-<a target="_blank" href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=%5BPATCH%5D&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&namedcmd=Fop+all&newqueryname=fop+patch+queue&tofooter=1&order=Reuse+same+sort+as+last+time">Patch queue</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Test</font>
-<ul>
-
-<li>
-<a href="testing.html">Testing</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Deploy</font>
-<ul>
-
-<li>
-<a href="doc.html">Doc Mgmt</a>
-</li>
-
-<li>
-<a target="_blank" href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.component">Bugs</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Resources</font>
-<ul>
-
-<li>
-<a href="faq.html">FAQs</a>
-</li>
-
-<li>
-<span class="sel"><font color="#ffcc00">Examples</font></span>
-</li>
-
-<li>
-<a href="tools.html">Tools</a>
-</li>
-
-<li>
-<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
-</li>
-
-</ul>
-</li>
-</ul>
-</div>
-<!--================= end Menu items ==================-->
-</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<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" border="0" alt="" src="../skin/images/spacer.gif"></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"></td>
-</tr>
-</table>
-</td><td valign="top" width="100%">
-<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
-<!--================= start middle NavBar ==================-->
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
-
-
- </font><img width="10" height="8" alt="" src="../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
-
-
- </font><img width="10" height="8" alt="" src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
-<tr>
-<td align="left" width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td><td align="left" width="100%">
-<div class="content">
-<table class="title" summary="">
-<tr>
-<td valign="middle">
-<h1>FO Examples</h1>
-</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="examples.pdf"><img alt="printer" src="../skin/images/printer.gif" border="0"><br>
- print-friendly<br>
- PDF</a></td>
-</tr>
-</table>
-<ul class="minitoc">
-<li>
-<a href="#Example+Documents+Using+FOP">Example Documents Using FOP</a>
-</li>
-<li>
-<a href="#Images+Examples">Images Examples</a>
-</li>
-<li>
-<a href="#Instream+Foreign+Object+Examples">Instream Foreign Object Examples</a>
-</li>
-</ul>
-
-<a name="N101BE"></a><a name="Example+Documents+Using+FOP"></a>
-<h3>Example Documents Using FOP</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- These examples have been rendered using FOP.
- </p>
-</div>
-
-<a name="N101C8"></a><a name="Images+Examples"></a>
-<h3>Images Examples</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-Embedding images in FO:
- </p>
-<table class="ForrestTable" cellspacing="1" cellpadding="4">
-
-<caption>Images in FO</caption>
-
-<tr>
-
-<th colspan="1" rowspan="1">description</th>
- <th colspan="1" rowspan="1">fo file</th>
- <th colspan="1" rowspan="1">pdf result</th>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">align in larger viewport</td>
- <td colspan="1" rowspan="1"><a href="../fo/align.fo.xml">align.fo</a></td>
- <td colspan="1" rowspan="1"><a href="../fo/align.fo.pdf">align.fo.pdf</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">align in smaller viewport</td>
- <td colspan="1" rowspan="1"><a href="../fo/align2.fo.xml">align2.fo</a></td>
- <td colspan="1" rowspan="1"><a href="../fo/align2.fo.pdf">align2.fo.pdf</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">scaling image</td>
- <td colspan="1" rowspan="1"><a href="../fo/size.fo.xml">size.fo</a></td>
- <td colspan="1" rowspan="1"><a href="../fo/size.fo.pdf">size.fo.pdf</a></td>
-
-</tr>
-
-</table>
-</div>
-
-<a name="N1022C"></a><a name="Instream+Foreign+Object+Examples"></a>
-<h3>Instream Foreign Object Examples</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-Instream Foreign Object images in FO, there are more on the
-<a href="svg.html">SVG Page</a>:
- </p>
-<table class="ForrestTable" cellspacing="1" cellpadding="4">
-
-<caption>Embedding instream-foreign-object</caption>
-
-<tr>
-
-<th colspan="1" rowspan="1">description</th>
- <th colspan="1" rowspan="1">fo file</th>
- <th colspan="1" rowspan="1">pdf result</th>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">embedding svg in viewport</td>
- <td colspan="1" rowspan="1"><a href="../fo/embed.fo.xml">embed.fo</a></td>
- <td colspan="1" rowspan="1"><a href="../fo/embed.fo.pdf">embed.fo.pdf</a></td>
-
-</tr>
-
-</table>
-</div>
-
-</div>
-</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end Content==================-->
-</table>
-</td>
-</tr>
-</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
-<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
-<tr>
-<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../skin/images/spacer.gif"><a href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a href="../skin/images/chapter.gif"></a><a href="../skin/images/chapter_open.gif"></a><a href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
-</tr>
-<tr>
-<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 1999-2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
- document.write(" - "+"Last Published: " + document.lastModified);
- // --></script></font></td>
-</tr>
-<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
-</tr>
-</table>
-<!--================= end Footer ==================-->
-</body>
-</html>
+<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>dev/examples.html</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/dev/examples.html</pre></p><hr size="1" noshade="true"/></body></html>
\ No newline at end of file
1.16 +0 -12 xml-site/targets/fop/dev/extensions.html
Index: extensions.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/extensions.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- extensions.html 5 May 2003 20:10:44 -0000 1.15
+++ extensions.html 30 May 2003 18:37:48 -0000 1.16
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.9 +72 -85 xml-site/targets/fop/dev/extensions.pdf
<<Binary file>>
1.16 +0 -12 xml-site/targets/fop/dev/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/faq.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- faq.html 5 May 2003 20:10:44 -0000 1.15
+++ faq.html 30 May 2003 18:37:48 -0000 1.16
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.9 +200 -226 xml-site/targets/fop/dev/faq.pdf
<<Binary file>>
1.13 +0 -12 xml-site/targets/fop/dev/fonts.html
Index: fonts.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/fonts.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- fonts.html 5 May 2003 20:10:44 -0000 1.12
+++ fonts.html 30 May 2003 18:37:49 -0000 1.13
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.5 +298 -324 xml-site/targets/fop/dev/fonts.pdf
<<Binary file>>
1.6 +0 -12 xml-site/targets/fop/dev/implement.html
Index: implement.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/implement.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- implement.html 5 May 2003 20:10:44 -0000 1.5
+++ implement.html 30 May 2003 18:37:49 -0000 1.6
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.3 +164 -203 xml-site/targets/fop/dev/implement.pdf
<<Binary file>>
1.17 +2 -14 xml-site/targets/fop/dev/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/index.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- index.html 5 May 2003 20:10:44 -0000 1.16
+++ index.html 30 May 2003 18:37:49 -0000 1.17
@@ -200,24 +200,12 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
-</li>
</ul>
</li>
@@ -393,7 +381,7 @@
<h4>Subscribe to the fop-dev Mailing List</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Use this forum to discuss topics related to FOP development, including patch submissions, bug reports, and design issues. Please <em>do not</em> use it for XML support, XSLT support, XSL-FO support, or even FOP support.
-Resources for these and other topics can be found on the <a href="../resources.html">FOP User Resources</a> page.
+Appropriate mailing lists for these topics can be found on the <a href="../maillist.html">FOP Mailing List</a> page.
</p>
<ul>
@@ -416,7 +404,7 @@
</li>
-<li>Before posting questions to any list, see "<a href="../resources.html#mailing-lists-general">General Information</a>".</li>
+<li>Before posting questions to any list, see "<a href="../maillist.html#general">General Information</a>".</li>
<li>
See <a href="http://xml.apache.org/mail.html#fop-dev_fop-cvs">Apache XML Mailing Lists</a>
1.12 +458 -523 xml-site/targets/fop/dev/index.pdf
<<Binary file>>
1.16 +0 -12 xml-site/targets/fop/dev/svg.html
Index: svg.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/svg.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- svg.html 5 May 2003 20:10:44 -0000 1.15
+++ svg.html 30 May 2003 18:37:49 -0000 1.16
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.9 +161 -187 xml-site/targets/fop/dev/svg.pdf
<<Binary file>>
1.6 +0 -12 xml-site/targets/fop/dev/testing.html
Index: testing.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/testing.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- testing.html 5 May 2003 20:10:44 -0000 1.5
+++ testing.html 30 May 2003 18:37:49 -0000 1.6
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.3 +148 -174 xml-site/targets/fop/dev/testing.pdf
<<Binary file>>
1.8 +0 -12 xml-site/targets/fop/dev/tools.html
Index: tools.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/tools.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- tools.html 5 May 2003 20:10:44 -0000 1.7
+++ tools.html 30 May 2003 18:37:49 -0000 1.8
@@ -200,23 +200,11 @@
</li>
<li>
-<a href="examples.html">Examples</a>
-</li>
-
-<li>
<span class="sel"><font color="#ffcc00">Tools</font></span>
</li>
<li>
<a target="_blank" href="http://cvs.apache.org/viewcvs.cgi/xml-fop">ViewCVS</a>
-</li>
-
-<li>
-<a href="pdf.html">PDF</a>
-</li>
-
-<li>
-<a href="ps.html">Postscript</a>
</li>
</ul>
1.3 +191 -230 xml-site/targets/fop/dev/tools.pdf
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org