jefft 2003/04/22 20:40:21
Modified: targets/fop anttask.html bugs.html changes.html
compiling.html compliance.html configuration.html
download.html embedding.html examples.html
extensions.html extensions.pdf faq.html faq.pdf
fo.html fonts.html gethelp.html index.html
license.html logocontest.html news.html output.html
output.pdf pdfencryption.html relnotes.html
resources.html running.html status.html svg.html
todo.html
targets/fop/design areas.html areas.pdf breakpos.html
embedding.html extending.html fotree.html
fotree.pdf index.html index.pdf layout.html
layout.pdf optimise.html properties.html
properties.pdf renderers.html renderers.pdf
useragent.html
targets/fop/design/alt.design FOPropertySets.html
FoXMLEvent.html SyncedFoXmlEventsBuffer.html
XMLNamespaces.html codedisplay.js
compound-properties.html coroutines.html
footnotes.html galleys.html index.html keeps.html
spaces.html traits.html user-agent-refs.html
xml-parsing.html
targets/fop/design/alt.design/properties
AbstractPropertyValue.html FOAttributes.html
PropNames.html Property.html
PropertyConsts-class.html PropertyConsts.html
PropertyParser.html PropertySets.html
PropertyTokenizer.html PropertyValue.html
PropertyValueList.html ShorthandPropSets.html
classes-overview.html codedisplay.js
enumerated-values.html getInitialValue.html
introduction.html propertyExpressions.html
simple-properties.html
targets/fop/design/understanding images.html
pdf_library.html svg.html xml_parsing.html
xml_parsing.pdf
targets/fop/dev examples.html extensions.html extensions.pdf
faq.html fonts.html implement.html index.html
pdf.html ps.html svg.html testing.html testing.pdf
tools.html
Added: targets/fop graphics.html graphics.pdf
targets/fop/design/alt.design traits.pdf.html
targets/fop/dev doc.html doc.pdf
Log:
Automatic publish at Wed Apr 23 05:40:03 CEST 2003 from
http://forrestbot.cocoondev.org.
Revision Changes Path
1.5 +2 -2 xml-site/targets/fop/anttask.html
Index: anttask.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/anttask.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- anttask.html 14 Apr 2003 23:35:37 -0000 1.4
+++ anttask.html 23 Apr 2003 03:40:00 -0000 1.5
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.27 +2 -2 xml-site/targets/fop/bugs.html
Index: bugs.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/bugs.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- bugs.html 14 Apr 2003 23:35:37 -0000 1.26
+++ bugs.html 23 Apr 2003 03:40:00 -0000 1.27
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.14 +2 -2 xml-site/targets/fop/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/changes.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- changes.html 21 Apr 2003 00:50:29 -0000 1.13
+++ changes.html 23 Apr 2003 03:40:00 -0000 1.14
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.32 +2 -2 xml-site/targets/fop/compiling.html
Index: compiling.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/compiling.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- compiling.html 14 Apr 2003 23:35:38 -0000 1.31
+++ compiling.html 23 Apr 2003 03:40:00 -0000 1.32
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.13 +2 -2 xml-site/targets/fop/compliance.html
Index: compliance.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/compliance.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- compliance.html 21 Apr 2003 00:50:29 -0000 1.12
+++ compliance.html 23 Apr 2003 03:40:00 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.11 +2 -2 xml-site/targets/fop/configuration.html
Index: configuration.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/configuration.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- configuration.html 14 Apr 2003 23:35:38 -0000 1.10
+++ configuration.html 23 Apr 2003 03:40:00 -0000 1.11
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.33 +2 -2 xml-site/targets/fop/download.html
Index: download.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/download.html,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- download.html 14 Apr 2003 23:35:38 -0000 1.32
+++ download.html 23 Apr 2003 03:40:00 -0000 1.33
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.35 +2 -2 xml-site/targets/fop/embedding.html
Index: embedding.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/embedding.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- embedding.html 21 Apr 2003 00:50:29 -0000 1.34
+++ embedding.html 23 Apr 2003 03:40:00 -0000 1.35
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.27 +2 -2 xml-site/targets/fop/examples.html
Index: examples.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/examples.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- examples.html 14 Apr 2003 23:35:40 -0000 1.26
+++ examples.html 23 Apr 2003 03:40:01 -0000 1.27
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.22 +24 -68 xml-site/targets/fop/extensions.html
Index: extensions.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/extensions.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- extensions.html 14 Apr 2003 23:35:40 -0000 1.21
+++ extensions.html 23 Apr 2003 03:40:01 -0000 1.22
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Extensions</title>
+<title>Standard FOP Extensions</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
@@ -285,54 +285,43 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Extensions</h1>
+<h1>Standard FOP Extensions</h1>
</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="extensions.pdf"><img alt="PDF" src="skin/images/pdfdoc.gif"
border="0"><br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
-<a href="#Default+Extensions">Default Extensions</a>
-<ul class="minitoc">
-<li>
-<a href="#SVG">SVG</a>
+<a href="#svg">SVG</a>
</li>
<li>
-<a href="#Bookmarks">Bookmarks</a>
+<a href="#bookmarks">PDF Bookmarks</a>
</li>
<li>
-<a href="#Continued-label+%28for+table-header%2F-footer">Continued-label
(for table-header/-footer</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Adding+Your+Own">Adding Your Own</a>
+<a href="#table-continue-label">Continued-label (for table-header/-footer</a>
</li>
</ul>
-<p>
-Sometimes it is desirable to have extensions to XSL-FO in order to support
-some feature of the output format which isn't covered by the XSL-FO
-specification.
- </p>
+<p>By "extension", we mean any data that can be placed in the input XML
document that is not addressed by the XSL-FO standard.
+By having a mechanism for supporting extensions, FOP is able to add features
that are not covered in the specification.</p>
+
+<p>The extensions documented here are included with FOP, and are
automatically available to you. If you wish to add an extension of your own to
FOP, please see the <a href="dev/extensions.html">Developers' Extension
Page</a>.</p>
-<a name="N101C1"></a><a name="Default+Extensions"></a>
-<h3>Default Extensions</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-These extension are available by default. They are automatically loaded
-and you only need to provide the correct namespace for your embedded
-XML markup.
- </p>
-<a name="N101CA"></a><a name="SVG"></a>
-<h4>SVG</h4>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">All extensions required the correct use of an
appropriate namespace in your input document.</div>
+</div>
+
+<a name="N101CB"></a><a name="svg"></a>
+<h3>SVG</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
Please see the <a href="svg.html#svg">SVG documentation</a> for more details.
</p>
</div>
-<a name="N101D8"></a><a name="Bookmarks"></a>
-<h4>Bookmarks</h4>
+
+<a name="N101D9"></a><a name="bookmarks"></a>
+<h3>PDF Bookmarks</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
To use this standard FOP extension, you need to add a namespace entry for
@@ -360,46 +349,13 @@
examples/fo/basic for a more complete example.
</p>
</div>
-<a name="N101EC"></a><a
name="Continued-label+%28for+table-header%2F-footer"></a>
-<h4>Continued-label (for table-header/-footer</h4>
+
+<a name="N101ED"></a><a name="table-continue-label"></a>
+<h3>Continued-label (for table-header/-footer</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
Please see examples/fo/basic/contlabel.fo
</p>
-</div>
-</div>
-
-<a name="N101F7"></a><a name="Adding+Your+Own"></a>
-<h3>Adding Your Own</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-To add your own extension you need to do the following things.
- </p>
-<ol>
-
-<li>
-Write code that implements your extension functionality. The easiest place to
-start is by looking at the code in org.apache.fop.extension.
- </li>
-
-<li>
-Create a jar file with your classes, it must also include the following file
-"/META-INF/services/org.apache.fop.fo.ElementMapping". In this file you need
-to put the fully qualified classname of your element mappings class. This
-class must implement the "org.apache.fop.fo.ElementMapping" interface.
- </li>
-
-<li>
-Create your XSL-FO file with the extra XML data embedded in the file with the
-correct name space. The examples for SVG and pdfoutline.fo show how this can
-be done.
- </li>
-
-<li>
-Put your jar file in the classpath and then run fop over the XSL-FO file.
- </li>
-
-</ol>
</div>
</div>
1.7 +115 -122 xml-site/targets/fop/extensions.pdf
<<Binary file>>
1.26 +133 -124 xml-site/targets/fop/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/faq.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- faq.html 21 Apr 2003 00:50:30 -0000 1.25
+++ faq.html 23 Apr 2003 03:40:01 -0000 1.26
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
@@ -371,9 +371,15 @@
<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>
+<a name="graphic-not-displayed-menu"></a><a href="#graphic-not-displayed">A
graphic is not displayed.</a>
+</li>
+<li>
<a name="png-fails-menu"></a><a href="#png-fails">My graphical images do not
work properly.</a>
</li>
<li>
+<a name="graphic-resolution-menu"></a><a href="#graphic-resolution">Why is
my graphic rendered at a different resolution than it was created?</a>
+</li>
+<li>
<a name="keep-with-menu"></a><a href="#keep-with">Keep-with-next,
keep-with-previous, keep-together
don't work.</a>
</li>
@@ -388,9 +394,6 @@
<a name="page-number-align-menu"></a><a href="#page-number-align">Page
numbers are not properly right aligned.</a>
</li>
<li>
-<a name="graphic-not-displayed-menu"></a><a href="#graphic-not-displayed">A
graphic is not displayed.</a>
-</li>
-<li>
<a name="hypenation-fails-menu"></a><a href="#hypenation-fails">Hyphenation
does not work.</a>
</li>
</ul>
@@ -567,13 +570,13 @@
</li>
</ul>
</div>
-<a name="N10199"></a>
+<a name="N1019E"></a>
<h3>Answers</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1019C"></a><a name="part-general"></a>
+<a name="N101A1"></a><a name="part-general"></a>
<h4>1. General questions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N101A0"></a><a name="fop-general"></a>
+<a name="N101A5"></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">
@@ -587,7 +590,7 @@
are supported, such as AWT, PCL, text and direct printing.
</p>
</div>
-<a name="N101AF"></a><a name="fop-functions"></a>
+<a name="N101B4"></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">
@@ -604,7 +607,7 @@
The library can be used in servlets and other Java applications.
</p>
</div>
-<a name="N101BD"></a><a name="fop-acronym"></a>
+<a name="N101C2"></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">
@@ -613,7 +616,7 @@
<strong>O</strong>bject <strong>P</strong>rocessor
</p>
</div>
-<a name="N101CE"></a><a name="fop-other-apache"></a>
+<a name="N101D3"></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">
@@ -628,7 +631,7 @@
image</a> into a PDF document.
</p>
</div>
-<a name="N101E5"></a><a name="xsl-def"></a>
+<a name="N101EA"></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">
@@ -639,7 +642,7 @@
<strong>L</strong>anguage.
</p>
</div>
-<a name="N101FE"></a><a name="xslfo"></a>
+<a name="N10203"></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">
@@ -662,7 +665,7 @@
Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
</p>
</div>
-<a name="N10216"></a><a name="XSLT"></a>
+<a name="N1021B"></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">
@@ -676,7 +679,7 @@
Synonyms: XSL transformation, XSL:T, XSL style sheet.
</p>
</div>
-<a name="N10224"></a><a name="contribute"></a>
+<a name="N10229"></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">
@@ -685,10 +688,10 @@
</p>
</div>
</div>
-<a name="N10230"></a><a name="part-running"></a>
+<a name="N10235"></a><a name="part-running"></a>
<h4>2. Problems running FOP</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10234"></a><a name="no-page-master"></a>
+<a name="N10239"></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>
@@ -709,7 +712,7 @@
See also <a href="relnotes.html">release notes</a>.
</p>
</div>
-<a name="N10247"></a><a name="NoClassDefFound"></a>
+<a name="N1024C"></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">
@@ -736,7 +739,7 @@
Java application, check the classpath of the application.
</p>
</div>
-<a name="N1025E"></a><a name="NoSuchMethodException"></a>
+<a name="N10263"></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>
@@ -752,7 +755,7 @@
use a more recent version of Batik.
</p>
</div>
-<a name="N10269"></a><a name="OutOfMemoryException"></a>
+<a name="N1026E"></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">
@@ -760,7 +763,7 @@
See <a href="running.html#memory">FOP Memory</a>.
</p>
</div>
-<a name="N10275"></a><a name="MalformedURLException"></a>
+<a name="N1027A"></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">
@@ -790,7 +793,7 @@
URL.
</p>
</div>
-<a name="N102A5"></a><a name="NullPointerException"></a>
+<a name="N102AA"></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">
@@ -821,13 +824,13 @@
see more detailed information.
</p>
</div>
-<a name="N102BA"></a><a name="not-implemented"></a>
+<a name="N102BF"></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="N102C9"></a><a name="fop-hangs"></a>
+<a name="N102CE"></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">
@@ -851,7 +854,7 @@
exec'ing FOP, use the library interface instead.
</p>
</div>
-<a name="N102DF"></a><a name="boxoverflow"></a>
+<a name="N102E4"></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">
@@ -866,7 +869,7 @@
remove keep-with-* properties.
</p>
</div>
-<a name="N102E7"></a><a name="cannot-find-external-graphics"></a>
+<a name="N102EC"></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">
@@ -883,7 +886,7 @@
working directory of the process which runs FOP.
</p>
</div>
-<a name="N102F6"></a><a name="fonts-not-found"></a>
+<a name="N102FB"></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">
@@ -900,10 +903,10 @@
</p>
</div>
</div>
-<a name="N10301"></a><a name="part-output"></a>
+<a name="N10306"></a><a name="part-output"></a>
<h4>3. Problems with FOP output</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10305"></a><a name="blank-page-between-page-sequences"></a>
+<a name="N1030A"></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>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -927,14 +930,57 @@
<span class="codefrag">force-page-count="no-force"</span>.
</p>
</div>
-<a name="N1031D"></a><a name="png-fails"></a>
-<h5>3.2. My graphical images do not work properly.<span style="float:
right"><a href="#png-fails-menu">^</a></span>
+<a name="N10322"></a><a name="graphic-not-displayed"></a>
+<h5>3.2. A graphic is not displayed.<span style="float: right"><a
href="#graphic-not-displayed-menu">^</a></span>
+</h5>
+<div style="margin-left: 15 ; border: 2px">
+<p>
+ The most common reason is that the file is not found because of an
+ empty or wrong baseDir setting, spelling errors in the file name,
in
+ particular using the wrong case, or, if the image is retrieved over
+ HTTP, the image was not delivered because of security settings in
the
+ server, missing cookies or other authorization information, or
+ because of server misconfigurations. One way to check this is to
+ cut&paste the source URL from the fo:external-graphic into the
+ Location field of a browser <strong>on the machine where the FOP
+ process will be running</strong>.
+ </p>
+<p>
+ Several other possibilities:
+ </p>
+<ul>
+
+<li>
+ The graphic is too large to fit into the intended space.
+ </li>
+
+<li>
+ Some image format subclasses can't be handled, try to convert the
+ graphic to a format subclass known to work. (Sorry, no list of
+ formats known to work)
+ </li>
+
+<li>
+ Something else obscures the graphic, for example stuff from a
+ static content (very rare, but has happened).
+ </li>
+
+</ul>
+</div>
+<a name="N1033C"></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>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>See <a href="svg.html">Graphical Formats</a>.</p>
</div>
-<a name="N10329"></a><a name="keep-with"></a>
-<h5>3.3. Keep-with-next, keep-with-previous, keep-together
+<a name="N10348"></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>
+</h5>
+<div style="margin-left: 15 ; border: 2px">
+<p>See <a href="graphics.html#resolution">Graphics Resolution</a>.</p>
+</div>
+<a name="N10354"></a><a name="keep-with"></a>
+<h5>3.5. 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">
@@ -968,8 +1014,8 @@
</fo:table-body>
</fo:table></pre>
</div>
-<a name="N1033B"></a><a name="table-missing"></a>
-<h5>3.4. My tables are missing, or missing their content.<span style="float:
right"><a href="#table-missing-menu">^</a></span>
+<a name="N10366"></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>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
@@ -984,8 +1030,8 @@
fo:table-with-caption elements, so watch out.
</p>
</div>
-<a name="N10346"></a><a name="cells-overflow"></a>
-<h5>3.5. Text overflowing table cells and the like is not clipped. Long
+<a name="N10371"></a><a name="cells-overflow"></a>
+<h5>3.7. 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">
@@ -1018,8 +1064,8 @@
archive</a> for how to perform these tasks.
</p>
</div>
-<a name="N10368"></a><a name="page-number-align"></a>
-<h5>3.6. Page numbers are not properly right aligned.<span style="float:
right"><a href="#page-number-align-menu">^</a></span>
+<a name="N10393"></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>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
@@ -1035,45 +1081,8 @@
problem completely.
</p>
</div>
-<a name="N10373"></a><a name="graphic-not-displayed"></a>
-<h5>3.7. A graphic is not displayed.<span style="float: right"><a
href="#graphic-not-displayed-menu">^</a></span>
-</h5>
-<div style="margin-left: 15 ; border: 2px">
-<p>
- The most common reason is that the file is not found because of an
- empty or wrong baseDir setting, spelling errors in the file name,
in
- particular using the wrong case, or, if the image is retrieved over
- HTTP, the image was not delivered because of security settings in
the
- server, missing cookies or other authorization information, or
- because of server misconfigurations. One way to check this is to
- cut&paste the source URL from the fo:external-graphic into the
- Location field of a browser <strong>on the machine where the FOP
- process will be running</strong>.
- </p>
-<p>
- Several other possibilities:
- </p>
-<ul>
-
-<li>
- The graphic is too large to fit into the intended space.
- </li>
-
-<li>
- Some image format subclasses can't be handled, try to convert the
- graphic to a format subclass known to work. (Sorry, no list of
- formats known to work)
- </li>
-
-<li>
- Something else obscures the graphic, for example stuff from a
- static content (very rare, but has happened).
- </li>
-
-</ul>
-</div>
-<a name="N1038D"></a><a name="hypenation-fails"></a>
-<h5>3.8. Hyphenation does not work.<span style="float: right"><a
href="#hypenation-fails-menu">^</a></span>
+<a name="N1039E"></a><a name="hypenation-fails"></a>
+<h5>3.9. Hyphenation does not work.<span style="float: right"><a
href="#hypenation-fails-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
@@ -1083,10 +1092,10 @@
</p>
</div>
</div>
-<a name="N10395"></a><a name="part-embedding"></a>
+<a name="N103A6"></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="N10399"></a><a name="servlet"></a>
+<a name="N103AA"></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">
@@ -1094,7 +1103,7 @@
See <a href="embedding.html#servlet">Using FOP in a Servlet</a>.
</p>
</div>
-<a name="N103A5"></a><a name="servlet-with-xslt"></a>
+<a name="N103B6"></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>
@@ -1103,7 +1112,7 @@
See <a href="embedding.html#servlet-transform">Using FOP in a
Servlet with XSLT Transformation</a>.
</p>
</div>
-<a name="N103B1"></a><a name="servlet-xslt-params"></a>
+<a name="N103C2"></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">
@@ -1111,7 +1120,7 @@
See <a href="embedding.html#servlet-transform">Using FOP in a
Servlet with XSLT Transformation</a>.
</p>
</div>
-<a name="N103BD"></a><a name="servlet-nonstd-fonts"></a>
+<a name="N103CE"></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>
@@ -1121,7 +1130,7 @@
See <a href="#usercfg">loading the user configuration file</a> for further
details.
</p>
</div>
-<a name="N103CC"></a><a name="servlet-baseDir"></a>
+<a name="N103DD"></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">
@@ -1129,7 +1138,7 @@
See <a href="embedding.html#config-internal">Setting the
Configuration Programmatically</a>.
</p>
</div>
-<a name="N103D8"></a><a name="usercfg"></a>
+<a name="N103E9"></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">
@@ -1137,7 +1146,7 @@
See <a href="embedding.html#config-external">Using a Configuration
File in an Embedded App</a>.
</p>
</div>
-<a name="N103E4"></a><a name="servlet-NoClassDefFound"></a>
+<a name="N103F5"></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>
@@ -1146,7 +1155,7 @@
See <a href="embedding.html#servlet-engine">Servlet Engines</a>.
</p>
</div>
-<a name="N103F0"></a><a name="multithreaded"></a>
+<a name="N10401"></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">
@@ -1155,17 +1164,17 @@
</p>
</div>
</div>
-<a name="N103FC"></a><a name="part-svg"></a>
+<a name="N1040D"></a><a name="part-svg"></a>
<h4>5. Batik/SVG specific questions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10400"></a><a name="svg-text"></a>
+<a name="N10411"></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="svg.html#svg-pdf-text">Placing SVG Text into PDF</a>.</p>
</div>
-<a name="N1040C"></a><a name="svg-headless"></a>
+<a name="N1041D"></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">
@@ -1198,7 +1207,7 @@
</ul>
</div>
-<a name="N10427"></a><a name="svghangs"></a>
+<a name="N10438"></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">
@@ -1208,7 +1217,7 @@
System.exit(0) somewhere.
</p>
</div>
-<a name="N1042F"></a><a name="svg-url"></a>
+<a name="N10440"></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>
@@ -1262,10 +1271,10 @@
</p>
</div>
</div>
-<a name="N1045B"></a><a name="part-pdf"></a>
+<a name="N1046C"></a><a name="part-pdf"></a>
<h4>6. PDF specific (includes Acrobat peculiarities)</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1045F"></a><a name="pdf-embed-font"></a>
+<a name="N10470"></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">
@@ -1274,7 +1283,7 @@
about embedding fonts.
</p>
</div>
-<a name="N1046B"></a><a name="pdf-characters"></a>
+<a name="N1047C"></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>
@@ -1299,13 +1308,13 @@
</p>
<pre class="code"><fo:inline
font-family="Helvetica">&#x2205;</fo:inline></pre>
</div>
-<a name="N10489"></a><a name="pdf-postprocess"></a>
+<a name="N1049A"></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="N10495"></a><a name="pdf-security"></a>
+<a name="N104A6"></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>
@@ -1315,20 +1324,20 @@
See also <a href="output.html#pdf-postprocess">PDF
Post-processing</a>.
</p>
</div>
-<a name="N104A5"></a><a name="pdf-doc-properties"></a>
+<a name="N104B6"></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="N104B1"></a><a name="pdf-watermark"></a>
+<a name="N104C2"></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="N104BD"></a><a name="pdf-print-contortion"></a>
+<a name="N104CE"></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">
@@ -1340,7 +1349,7 @@
settings too.
</p>
</div>
-<a name="N104C5"></a><a name="pdf-bookmark-display"></a>
+<a name="N104D6"></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">
@@ -1351,10 +1360,10 @@
</p>
</div>
</div>
-<a name="N104D1"></a><a name="part-iex"></a>
+<a name="N104E2"></a><a name="part-iex"></a>
<h4>7. IEx specific stuff</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N104D5"></a><a name="iex-servlet-multiple"></a>
+<a name="N104E6"></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">
@@ -1390,7 +1399,7 @@
</ul>
</div>
-<a name="N104F5"></a><a name="iex-pdf-print-from-browser"></a>
+<a name="N10506"></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">
@@ -1414,10 +1423,10 @@
</p>
</div>
</div>
-<a name="N10506"></a><a name="part-input"></a>
+<a name="N10517"></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="N1050A"></a><a name="fo-center"></a>
+<a name="N1051B"></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>
@@ -1426,7 +1435,7 @@
See <a href="fo.html#fo-center-vertical">XSL-FO Vertical
Centering</a>.
</p>
</div>
-<a name="N10516"></a><a name="fo-center-table-horizon"></a>
+<a name="N10527"></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">
@@ -1434,7 +1443,7 @@
See <a href="fo.html#fo-center-table-horizon">XSL-FO Horizontal
Centering (Tables)</a>.
</p>
</div>
-<a name="N10522"></a><a name="fo-page-outer"></a>
+<a name="N10533"></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>
@@ -1443,7 +1452,7 @@
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content
Differences</a>.
</p>
</div>
-<a name="N1052E"></a><a name="oddeven"></a>
+<a name="N1053F"></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>
@@ -1452,7 +1461,7 @@
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content
Differences</a>.
</p>
</div>
-<a name="N1053A"></a><a name="fo-first-page-header"></a>
+<a name="N1054B"></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">
@@ -1460,7 +1469,7 @@
See <a href="fo.html#fo-first-page">Making the First Page
Special</a>.
</p>
</div>
-<a name="N10546"></a><a name="fo-omit-headers"></a>
+<a name="N10557"></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>
@@ -1469,7 +1478,7 @@
See <a href="fo.html#fo-blank-pages">Blank Pages</a>.
</p>
</div>
-<a name="N10552"></a><a name="fo-special-symbols"></a>
+<a name="N10563"></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>
@@ -1478,7 +1487,7 @@
See <a href="fo.html#xml-special-chars">Special Characters</a>.
</p>
</div>
-<a name="N1055E"></a><a name="fo-preformat"></a>
+<a name="N1056F"></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>
@@ -1487,7 +1496,7 @@
See <a href="fo.html#fo-preformat">Preformatting Content</a>.
</p>
</div>
-<a name="N1056A"></a><a name="fo-total-pages"></a>
+<a name="N1057B"></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>
@@ -1496,7 +1505,7 @@
See <a href="fo.html#fo-total-pages">Total Document Pages</a>.
</p>
</div>
-<a name="N10576"></a><a name="fo-region-overlap"></a>
+<a name="N10587"></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>
@@ -1505,7 +1514,7 @@
See <a href="fo.html#fo-region-align">Aligning Regions</a>.
</p>
</div>
-<a name="N10582"></a><a name="fo-lines"></a>
+<a name="N10593"></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>
@@ -1514,7 +1523,7 @@
See <a href="fo.html#fo-lines">Drawing Lines</a>.
</p>
</div>
-<a name="N1058E"></a><a name="fo-validate"></a>
+<a name="N1059F"></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">
@@ -1522,7 +1531,7 @@
See <a href="fo.html#fo-validate">Validating XSL-FO</a>.
</p>
</div>
-<a name="N1059A"></a><a name="xml-non-breaking-space"></a>
+<a name="N105AB"></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">
@@ -1530,7 +1539,7 @@
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
</div>
-<a name="N105A9"></a><a name="xml-undefined-entities"></a>
+<a name="N105BA"></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">
@@ -1538,7 +1547,7 @@
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
</div>
-<a name="N105B8"></a><a name="xml-illegal-entities"></a>
+<a name="N105C9"></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>
@@ -1547,7 +1556,7 @@
See <a href="fo.html#xml-entity-chars">XML Entity Characters</a>.
</p>
</div>
-<a name="N105C4"></a><a name="xml-illegal-chars"></a>
+<a name="N105D5"></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>
@@ -1557,10 +1566,10 @@
</p>
</div>
</div>
-<a name="N105D0"></a><a name="part-help"></a>
+<a name="N105E1"></a><a name="part-help"></a>
<h4>9. General suggestions. How to solve problems.</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N105D4"></a><a name="bugs"></a>
+<a name="N105E5"></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">
@@ -1569,7 +1578,7 @@
bugs already reported and how to report new ones.
</p>
</div>
-<a name="N105E0"></a><a name="postquestions"></a>
+<a name="N105F1"></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.14 +5728 -5199xml-site/targets/fop/faq.pdf
<<Binary file>>
1.2 +2 -2 xml-site/targets/fop/fo.html
Index: fo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/fo.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- fo.html 14 Apr 2003 23:35:41 -0000 1.1
+++ fo.html 23 Apr 2003 03:40:03 -0000 1.2
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.25 +2 -2 xml-site/targets/fop/fonts.html
Index: fonts.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/fonts.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- fonts.html 21 Apr 2003 00:50:30 -0000 1.24
+++ fonts.html 23 Apr 2003 03:40:03 -0000 1.25
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.15 +2 -2 xml-site/targets/fop/gethelp.html
Index: gethelp.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/gethelp.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- gethelp.html 14 Apr 2003 23:35:41 -0000 1.14
+++ gethelp.html 23 Apr 2003 03:40:03 -0000 1.15
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.46 +2 -2 xml-site/targets/fop/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/index.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- index.html 14 Apr 2003 23:35:41 -0000 1.45
+++ index.html 23 Apr 2003 03:40:03 -0000 1.46
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.30 +2 -2 xml-site/targets/fop/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/license.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- license.html 14 Apr 2003 23:35:41 -0000 1.29
+++ license.html 23 Apr 2003 03:40:03 -0000 1.30
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.7 +2 -2 xml-site/targets/fop/logocontest.html
Index: logocontest.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/logocontest.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- logocontest.html 14 Apr 2003 23:35:41 -0000 1.6
+++ logocontest.html 23 Apr 2003 03:40:03 -0000 1.7
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.15 +2 -2 xml-site/targets/fop/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/news.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- news.html 21 Apr 2003 00:50:30 -0000 1.14
+++ news.html 23 Apr 2003 03:40:03 -0000 1.15
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.17 +19 -33 xml-site/targets/fop/output.html
Index: output.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/output.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- output.html 14 Apr 2003 23:35:42 -0000 1.16
+++ output.html 23 Apr 2003 03:40:04 -0000 1.17
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
@@ -301,9 +301,6 @@
<a href="#general-fonts">Fonts</a>
</li>
<li>
-<a href="#general-resolution">Graphics Resolution</a>
-</li>
-<li>
<a href="#general-direct-output">Output to a Printer or Other Device</a>
</li>
</ul>
@@ -382,18 +379,7 @@
The net effect is that the layout of a given FO document can be quite
different between renderers that do not use the same font information.
</p>
</div>
-<a name="N101DD"></a><a name="general-resolution"></a>
-<h4>Graphics Resolution</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-This is an important issue when creating output for printing.
-The dpi is used to convert measurements into points. For example 1in
-= 2.54cm = 72 points. It is also used when determining the size of
-images and the rendering of certain graphics in the output. Currently
-FOP uses a value of 72dpi.
- </p>
-</div>
-<a name="N101E7"></a><a name="general-direct-output"></a>
+<a name="N101DD"></a><a name="general-direct-output"></a>
<h4>Output to a Printer or Other Device</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -417,7 +403,7 @@
</div>
</div>
-<a name="N1020B"></a><a name="pdf"></a>
+<a name="N10201"></a><a name="pdf"></a>
<h3>PDF</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -430,7 +416,7 @@
compatible.
</p>
<p>Note that FOP does not currently support "tagged pdf".</p>
-<a name="N10217"></a><a name="pdf-fonts"></a>
+<a name="N1020D"></a><a name="pdf-fonts"></a>
<h4>Fonts</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -446,7 +432,7 @@
</p>
</div>
-<a name="N10224"></a><a name="pdf-postprocess"></a>
+<a name="N1021A"></a><a name="pdf-postprocess"></a>
<h4>Post-processing</h4>
<div style="margin-left: 0 ; border: 2px">
<p>FOP does not currently support several desirable PDF features: document
properties (title, author, etc.), and watermarks. One workaround is to use
Adobe Acrobat (the full version, not the Reader) to process the file manually
or with scripting that it supports.</p>
@@ -502,7 +488,7 @@
<p>Check the iText tutorial and documentation for setting access flags,
password, encryption strength and other parameters.
</p>
</div>
-<a name="N10246"></a><a name="pdf-watermark"></a>
+<a name="N1023C"></a><a name="pdf-watermark"></a>
<h4>Watermarks</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -528,7 +514,7 @@
</div>
</div>
-<a name="N1025E"></a><a name="pcl"></a>
+<a name="N10254"></a><a name="pcl"></a>
<h3>PCL</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -543,7 +529,7 @@
This should allow any device fully supporting PCL 5 to be able to
print the output generated by the PCLRenderer.
</p>
-<a name="N1026A"></a><a name="pcl-limitations"></a>
+<a name="N10260"></a><a name="pcl-limitations"></a>
<h4>Limitations</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -570,7 +556,7 @@
</ul>
</div>
-<a name="N10292"></a><a name="pcl-additional"></a>
+<a name="N10288"></a><a name="pcl-additional"></a>
<h4>Additional Features</h4>
<div style="margin-left: 0 ; border: 2px">
<p>There are some special features that are controlled by some public
variables on the PCLRenderer class.</p>
@@ -599,7 +585,7 @@
</div>
</div>
-<a name="N102B4"></a><a name="ps"></a>
+<a name="N102AA"></a><a name="ps"></a>
<h3>PostScript</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -609,7 +595,7 @@
renderer generates PostScript Level 3 with most DSC comments. Actually,
the only Level 3 feature used is FlateDecode, everthing else is Level 2.
</p>
-<a name="N102BD"></a><a name="ps-limitations"></a>
+<a name="N102B3"></a><a name="ps-limitations"></a>
<h4>Limitations</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -630,7 +616,7 @@
</div>
</div>
-<a name="N102DA"></a><a name="rtf"></a>
+<a name="N102D0"></a><a name="rtf"></a>
<h3>RTF</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -641,7 +627,7 @@
</p>
</div>
-<a name="N102E4"></a><a name="svg"></a>
+<a name="N102DA"></a><a name="svg"></a>
<h3>SVG</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -656,7 +642,7 @@
</p>
</div>
-<a name="N102EE"></a><a name="xml"></a>
+<a name="N102E4"></a><a name="xml"></a>
<h3>XML</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -666,7 +652,7 @@
</p>
</div>
-<a name="N102F8"></a><a name="print"></a>
+<a name="N102EE"></a><a name="print"></a>
<h3>Print</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -675,7 +661,7 @@
</p>
</div>
-<a name="N10302"></a><a name="awt"></a>
+<a name="N102F8"></a><a name="awt"></a>
<h3>AWT</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -686,7 +672,7 @@
</p>
</div>
-<a name="N1030C"></a><a name="mif"></a>
+<a name="N10302"></a><a name="mif"></a>
<h3>MIF</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -695,7 +681,7 @@
</p>
</div>
-<a name="N10316"></a><a name="txt"></a>
+<a name="N1030C"></a><a name="txt"></a>
<h3>TXT</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
1.9 +359 -438 xml-site/targets/fop/output.pdf
<<Binary file>>
1.8 +2 -2 xml-site/targets/fop/pdfencryption.html
Index: pdfencryption.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/pdfencryption.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- pdfencryption.html 14 Apr 2003 23:35:42 -0000 1.7
+++ pdfencryption.html 23 Apr 2003 03:40:04 -0000 1.8
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.17 +2 -2 xml-site/targets/fop/relnotes.html
Index: relnotes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/relnotes.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- relnotes.html 14 Apr 2003 23:35:42 -0000 1.16
+++ relnotes.html 23 Apr 2003 03:40:04 -0000 1.17
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.28 +2 -2 xml-site/targets/fop/resources.html
Index: resources.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/resources.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- resources.html 21 Apr 2003 00:50:30 -0000 1.27
+++ resources.html 23 Apr 2003 03:40:04 -0000 1.28
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.37 +2 -2 xml-site/targets/fop/running.html
Index: running.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/running.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- running.html 21 Apr 2003 00:50:30 -0000 1.36
+++ running.html 23 Apr 2003 03:40:04 -0000 1.37
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.12 +2 -2 xml-site/targets/fop/status.html
Index: status.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/status.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- status.html 14 Apr 2003 23:35:42 -0000 1.11
+++ status.html 23 Apr 2003 03:40:04 -0000 1.12
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.20 +1 -716 xml-site/targets/fop/svg.html
Index: svg.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/svg.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- svg.html 14 Apr 2003 23:35:42 -0000 1.19
+++ svg.html 23 Apr 2003 03:40:04 -0000 1.20
@@ -1,716 +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>FOP Graphics Formats</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">Redesign</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">About</font>
-<ul>
-
-<li>
-<a href="index.html">Home</a>
-</li>
-
-<li>
-<a href="news.html">News</a>
-</li>
-
-<li>
-<a href="logocontest.html">Logo contest</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Project</font>
-<ul>
-
-<li>
-<a href="status.html">Status</a>
-</li>
-
-<li>
-<a href="changes.html">Changes</a>
-</li>
-
-<li>
-<a href="todo.html">Todo</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">Compile</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="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>
-<span class="sel"><font color="#ffcc00">Graphic Formats</font></span>
-</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="bugs.html">Bugs</a>
-</li>
-
-<li>
-<a href="license.html">License</a>
-</li>
-
-<li>
-<a href="resources.html">Other</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 Graphics Formats</h1>
-</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="svg.pdf"><img alt="PDF" src="skin/images/pdfdoc.gif" border="0"><br>
- PDF</a></td>
-</tr>
-</table>
-<ul class="minitoc">
-<li>
-<a href="#Overview+of+Graphics+Support">Overview of Graphics Support</a>
-</li>
-<li>
-<a href="#packages">Graphics Packages</a>
-<ul class="minitoc">
-<li>
-<a href="#native">FOP Native</a>
-</li>
-<li>
-<a href="#jimi">JIMI</a>
-</li>
-<li>
-<a href="#jai">JAI</a>
-</li>
-<li>
-<a href="#batik">Batik</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#jpeg">JPEG</a>
-</li>
-<li>
-<a href="#svg">SVG</a>
-<ul class="minitoc">
-<li>
-<a href="#svg-intro">Introduction</a>
-</li>
-<li>
-<a href="#svg-pdf-conversion">Converting SVG to a PDF Document</a>
-</li>
-<li>
-<a href="#svg-pdf-graphics">Placing SVG Graphics into PDF</a>
-</li>
-<li>
-<a href="#svg-pdf-text">Placing SVG Text into PDF</a>
-</li>
-<li>
-<a href="#svg-problems">Known Problems</a>
-</li>
-</ul>
-</li>
-</ul>
-
-<a name="N101BE"></a><a name="Overview+of+Graphics+Support"></a>
-<h3>Overview of Graphics Support</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- The table below summarizes the <em>theoretical</em> support for
graphical formats within FOP. In other words, within the constraints of the
limitations listed here, these formats <em>should</em> work. However, many of
them have not been tested, and there may be limitations that have not yet been
discovered or documented. The packages needed to support some formats are not
included in the FOP distribution and must be installed separately. Follow the
links in the "Support Thru" column for more details.
- </p>
-<table class="ForrestTable" cellspacing="1" cellpadding="4">
-
-<tr>
-
-<th colspan="1" rowspan="1">Format</th>
- <th colspan="1" rowspan="1">Type</th>
- <th colspan="1" rowspan="1">Support Thru</th>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">BMP</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">CUR</td>
- <td colspan="1" rowspan="1">unknown</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">GIF</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#native">FOP native</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">FPX</td>
- <td colspan="1" rowspan="1">unknown</td>
- <td colspan="1" rowspan="1"><a href="#jai">JAI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">ICO (Sun Icon)</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1"><a href="#jpeg">JPEG</a></td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#native">FOP native</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PCX</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PICT (Macintosh PICT)</td>
- <td colspan="1" rowspan="1">metafile</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PNG</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PNM</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jai">JAI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PSD (Adobe Photoshop)</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">Sunraster</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1"><a href="#svg">SVG</a></td>
- <td colspan="1" rowspan="1">vector (with embedded bitmaps)</td>
- <td colspan="1" rowspan="1"><a href="#batik">Batik</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">Targa</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">TIFF</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">XBM</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">XPM</td>
- <td colspan="1" rowspan="1">bitmap</td>
- <td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
-
-</tr>
-
-</table>
-</div>
-
-<a name="N10347"></a><a name="packages"></a>
-<h3>Graphics Packages</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N1034D"></a><a name="native"></a>
-<h4>FOP Native</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- FOP has native ability to handle some graphic file formats.
- </p>
-</div>
-<a name="N10357"></a><a name="jimi"></a>
-<h4>JIMI</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Because of licensing issues, the JIMI image library is not
included in the FOP distribution. First, <a target="_blank"
href="http://java.sun.com/products/jimi";>download</a> and install it.
-Then, copy the file "JimiProClasses.zip" from the archive to
xml-fop/lib/jimi-1.0.jar. Please note that FOP binary distributions are
compiled with JIMI support, so there is no need for you to build FOP to add the
support. If jimi-1.0.jar is installed in the right place, it will automatically
be used by FOP, otherwise it will not.
- </p>
-</div>
-<a name="N10365"></a><a name="jai"></a>
-<h4>JAI</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- FOP has been compiled with JAI support, but JAI is not included in
the FOP distribution.
-To use it, simply install <a
href="http://java.sun.com/products/java-media/jai";>JAI</a>.
-JAI is much faster than JIMI, but is not available for all platforms. See <a
href="http://java.sun.com/products/java-media/jai/forDevelopers/jaifaq.html#platforms";>What
platforms are supported?</a> on the JAI FAQ page for more details.
- </p>
-</div>
-<a name="N10377"></a><a name="batik"></a>
-<h4>Batik</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- FOP distributions include a batik.jar file. No installation is
required.
- </p>
-</div>
-</div>
-
-<a name="N10382"></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>
-</div>
-
-<a name="N1038C"></a><a name="svg"></a>
-<h3>SVG</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10392"></a><a name="svg-intro"></a>
-<h4>Introduction</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-FOP uses the SVG library from <a
href="http://xml.apache.org/batik/";>Batik</a> to handle SVG.
-This format can be handled as an <span
class="codefrag">fo:instream-foreign-object</span> or in a separate
-file referenced with <span class="codefrag">fo:external-graphic</span>.
Either way the SVG document will be
-read in and converted into a DOM in Batik. This DOM will then be used by the
renderer to
-create the graphical image.
- </p>
-<p>
-The AWT and Print renderers simply use batik to draw the SVG into a graphic.
- </p>
-<p>
-In the case of the PDF renderer there is a PDFGraphics2D class that Batik
uses
-to render the image into. This class converts the drawing instructions into
-PDF markup which is placed into the current PDF document.
- </p>
-</div>
-<a name="N103AC"></a><a name="svg-pdf-conversion"></a>
-<h4>Converting SVG to a PDF Document</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-It is possible to convert a standalone SVG document directly into a simple
page PDF document.
-This is possible through the use of Batik's transcoder mechanism.<br>
-
-<span class="codefrag">java org.apache.batik.apps.rasterizer.Main -m
application/pdf document.svg</span>
-
-<br>
-This will output the svg document as "document.pdf" containing a PDF
rendering of
-the SVG file.
- </p>
-<p>
-It is also possible to specify the width and/or height of the PDF document
on the command line with -w and -h or if you are using the transcoder api you
can use the transcoding hints.
- </p>
-<p>
-Currently the SVG image is drawn at the SVG document size and simply scaled
in PDF to the new size. So the result may not be the best possible. For example
if you have any images or effects it will draw them at the original resolution
of the svg document. When this is viewed in the pdf it will have an incorrect
resolution for the size of the pdf.
- </p>
-<p>
-The size of the pdf file will also remain the same regardless of what size
the page is.
- </p>
-<p>
-For more information see <a href="http://xml.apache.org/batik/";>Batik</a> for
-how transcoders work.
- </p>
-</div>
-<a name="N103CD"></a><a name="svg-pdf-graphics"></a>
-<h4>Placing SVG Graphics into PDF</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-The svg is inserted into PDF by using PDF commands to draw and fill
-lines and curves. This means that the graphical objects created with
-this remain as vector graphics.
- </p>
-<p>
-There are a number of SVG things that cannot be converted directly into
-PDF. Parts of the graphic such as effects, patterns and images are inserted
-into the PDF as a raster graphic. The resolution of this graphic may not
-be ideal depending on the FOP dpi (72dpi) and the scaling for that graphic.
-This needs to be improved.</p>
-<p>
-Currently transparency is not supported in PDF so many svg images that
-contain effects or graphics with transparent areas will not be displayed
-correctly.
- </p>
-</div>
-<a name="N103DD"></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
-this by checking if the text can be drawn normally and the font is
-supported. This example svg <a href="dev/svg/text.svg">text.svg</a> /
-<a href="dev/svg/text.pdf">text.pdf</a>
-shows how various types and effects with text are handled.
-Note that tspan and outlined text are not yet implemented.</p>
-<p>
-Otherwise, text is converted and drawn as a set of shapes by batik, using
the stroking text painter.
-This means that a typical character will
-have about 10 curves (each curve consists of at least 20 characters).
-This can make the pdf files large and when the pdf is viewed the
-viewer does not normally draw those fine curves very well (turning on
-Smooth Line Art in the Acrobat preferences will fix this).
-If the text is inserted into the PDF using the inbuilt text commands
-for PDF it will use a single character.
- </p>
-<p>
-It is possible to make sure that all text is drawn into PDF using the
-PDF text commands (instead of the graphical shapes), by adding the following
to the user config:
- </p>
-<pre class="code"><entry>
- <key>strokeSVGText</key>
- <value>false</value>
-</entry></pre>
-<p>In a servlet environment, you can set it directly:</p>
-<pre
class="code">org.apache.fop.configuration.Configuration.put("strokeSVGText",
Boolean.FALSE);</pre>
-<p>For information on using a configuration file in a servlet, see the <a
href="faq.html#usercfg">FAQ</a> on that topic.</p>
-<p>Note that this configuration setting works only for the PDF renderer.</p>
-<p>
-The drawback to forcing text to be rendered as text is that it will be
confined to text that is
-possible for PDF fonts (including embedded fonts) and implemented with
-this workaround. The fonts available are the standard pdf fonts and any
-fonts that you have embedded using FOP. The font sizes will be rounded
-to an integer value. In future this will be improved.
- </p>
-<p>Note that because SVG text can be rendered as either text or a vector
graphic, you may need to consider settings in your viewer for both.
-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="N10410"></a><a name="svg-problems"></a>
-<h4>Known Problems</h4>
-<div style="margin-left: 0 ; border: 2px">
-<ul>
-
-<li>
-soft mask transparency is combined with white so that it looks better
-on pdf 1.3 viewers but this causes the soft mask to be slightly lighter
-or darker on pdf 1.4 viewers
- </li>
-
-<li>
-there is some problem with a gradient inside a pattern causing a pdf
-error when viewed in acrobat 5
- </li>
-
-<li>
-text is not always handled correctly, it may select the wrong font
-especially if characters have multiple fonts in the font list
- </li>
-
-<li>
-more pdf text handling could be implemented
-It could draw the string using the attributed character iterator
-to handle tspans and other simple changes of text.
- </li>
-
-<li>
-JPEG images are not inserted directly into the pdf document
-This area has not been implemented yet since the appropriate
-method in batik is static
- </li>
-
-<li>
-Uniform transparency for images and other svg elements that are converted
-into a raster graphic are not drawn properly in PDF. The image is opaque.
- </li>
-
-</ul>
-</div>
-</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>svg.html</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/svg.html</pre></p><hr
size="1" noshade="true"/></body></html>
\ No newline at end of file
1.20 +2 -2 xml-site/targets/fop/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/todo.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- todo.html 14 Apr 2003 23:35:42 -0000 1.19
+++ todo.html 23 Apr 2003 03:40:04 -0000 1.20
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
+<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">
@@ -200,7 +200,7 @@
</li>
<li>
-<a href="svg.html">Graphic Formats</a>
+<a href="graphics.html">Graphics</a>
</li>
<li>
1.1 xml-site/targets/fop/graphics.html
Index: graphics.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 Graphics Formats</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">About</font>
<ul>
<li>
<a href="index.html">Home</a>
</li>
<li>
<a href="news.html">News</a>
</li>
<li>
<a href="logocontest.html">Logo contest</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Project</font>
<ul>
<li>
<a href="status.html">Status</a>
</li>
<li>
<a href="changes.html">Changes</a>
</li>
<li>
<a href="todo.html">Todo</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">Compile</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="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>
<span class="sel"><font color="#ffcc00">Graphics</font></span>
</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="bugs.html">Bugs</a>
</li>
<li>
<a href="license.html">License</a>
</li>
<li>
<a href="resources.html">Other</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 Graphics Formats</h1>
</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="graphics.pdf"><img alt="PDF" src="skin/images/pdfdoc.gif" border="0"><br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#support-overview">Overview of Graphics Support</a>
</li>
<li>
<a href="#packages">Graphics Packages</a>
<ul class="minitoc">
<li>
<a href="#native">FOP Native</a>
</li>
<li>
<a href="#jimi">JIMI</a>
</li>
<li>
<a href="#jai">JAI</a>
</li>
<li>
<a href="#batik">Batik</a>
</li>
</ul>
</li>
<li>
<a href="#jpeg">JPEG</a>
</li>
<li>
<a href="#svg">SVG</a>
<ul class="minitoc">
<li>
<a href="#svg-intro">Introduction</a>
</li>
<li>
<a href="#svg-pdf-conversion">Converting SVG to a PDF Document</a>
</li>
<li>
<a href="#svg-pdf-graphics">Placing SVG Graphics into PDF</a>
</li>
<li>
<a href="#svg-pdf-text">Placing SVG Text into PDF</a>
</li>
<li>
<a href="#svg-problems">Known Problems</a>
</li>
</ul>
</li>
<li>
<a href="#resolution">Graphics Resolution</a>
</li>
</ul>
<a name="N101BE"></a><a name="support-overview"></a>
<h3>Overview of Graphics Support</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
The table below summarizes the <em>theoretical</em> support for
graphical formats within FOP. In other words, within the constraints of the
limitations listed here, these formats <em>should</em> work. However, many of
them have not been tested, and there may be limitations that have not yet been
discovered or documented. The packages needed to support some formats are not
included in the FOP distribution and must be installed separately. Follow the
links in the "Support Thru" column for more details.
</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1">Format</th>
<th colspan="1" rowspan="1">Type</th>
<th colspan="1" rowspan="1">Support Thru</th>
</tr>
<tr>
<td colspan="1" rowspan="1">BMP</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">CUR</td>
<td colspan="1" rowspan="1">unknown</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">GIF</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#native">FOP native</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">FPX</td>
<td colspan="1" rowspan="1">unknown</td>
<td colspan="1" rowspan="1"><a href="#jai">JAI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">ICO (Sun Icon)</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1"><a href="#jpeg">JPEG</a></td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#native">FOP native</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PCX</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PICT (Macintosh PICT)</td>
<td colspan="1" rowspan="1">metafile</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PNG</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PNM</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jai">JAI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">PSD (Adobe Photoshop)</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">Sunraster</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1"><a href="#svg">SVG</a></td>
<td colspan="1" rowspan="1">vector (with embedded bitmaps)</td>
<td colspan="1" rowspan="1"><a href="#batik">Batik</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">Targa</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">TIFF</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a> or <a
href="#jai">JAI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">XBM</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">XPM</td>
<td colspan="1" rowspan="1">bitmap</td>
<td colspan="1" rowspan="1"><a href="#jimi">JIMI</a></td>
</tr>
</table>
</div>
<a name="N10347"></a><a name="packages"></a>
<h3>Graphics Packages</h3>
<div style="margin-left: 0 ; border: 2px">
<a name="N1034D"></a><a name="native"></a>
<h4>FOP Native</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
FOP has native ability to handle some graphic file formats.
</p>
</div>
<a name="N10357"></a><a name="jimi"></a>
<h4>JIMI</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Because of licensing issues, the JIMI image library is not included
in the FOP distribution. First, <a target="_blank"
href="http://java.sun.com/products/jimi";>download</a> and install it.
Then, copy the file "JimiProClasses.zip" from the archive to
xml-fop/lib/jimi-1.0.jar. Please note that FOP binary distributions are
compiled with JIMI support, so there is no need for you to build FOP to add the
support. If jimi-1.0.jar is installed in the right place, it will automatically
be used by FOP, otherwise it will not.
</p>
</div>
<a name="N10365"></a><a name="jai"></a>
<h4>JAI</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
FOP has been compiled with JAI support, but JAI is not included in
the FOP distribution.
To use it, simply install <a
href="http://java.sun.com/products/java-media/jai";>JAI</a>.
JAI is much faster than JIMI, but is not available for all platforms. See <a
href="http://java.sun.com/products/java-media/jai/forDevelopers/jaifaq.html#platforms";>What
platforms are supported?</a> on the JAI FAQ page for more details.
</p>
</div>
<a name="N10377"></a><a name="batik"></a>
<h4>Batik</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
FOP distributions include a batik.jar file. No installation is
required.
</p>
</div>
</div>
<a name="N10382"></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>
</div>
<a name="N1038C"></a><a name="svg"></a>
<h3>SVG</h3>
<div style="margin-left: 0 ; border: 2px">
<a name="N10392"></a><a name="svg-intro"></a>
<h4>Introduction</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
FOP uses the SVG library from <a
href="http://xml.apache.org/batik/";>Batik</a> to handle SVG.
This format can be handled as an <span
class="codefrag">fo:instream-foreign-object</span> or in a separate
file referenced with <span class="codefrag">fo:external-graphic</span>.
Either way the SVG document will be
read in and converted into a DOM in Batik. This DOM will then be used by the
renderer to
create the graphical image.
</p>
<p>
The AWT and Print renderers simply use batik to draw the SVG into a graphic.
</p>
<p>
In the case of the PDF renderer there is a PDFGraphics2D class that Batik uses
to render the image into. This class converts the drawing instructions into
PDF markup which is placed into the current PDF document.
</p>
</div>
<a name="N103AC"></a><a name="svg-pdf-conversion"></a>
<h4>Converting SVG to a PDF Document</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
It is possible to convert a standalone SVG document directly into a simple
page PDF document.
This is possible through the use of Batik's transcoder mechanism.<br>
<span class="codefrag">java org.apache.batik.apps.rasterizer.Main -m
application/pdf document.svg</span>
<br>
This will output the svg document as "document.pdf" containing a PDF
rendering of
the SVG file.
</p>
<p>
It is also possible to specify the width and/or height of the PDF document on
the command line with -w and -h or if you are using the transcoder api you can
use the transcoding hints.
</p>
<p>
Currently the SVG image is drawn at the SVG document size and simply scaled
in PDF to the new size. So the result may not be the best possible. For example
if you have any images or effects it will draw them at the original resolution
of the svg document. When this is viewed in the pdf it will have an incorrect
resolution for the size of the pdf.
</p>
<p>
The size of the pdf file will also remain the same regardless of what size
the page is.
</p>
<p>
For more information see <a href="http://xml.apache.org/batik/";>Batik</a> for
how transcoders work.
</p>
</div>
<a name="N103CD"></a><a name="svg-pdf-graphics"></a>
<h4>Placing SVG Graphics into PDF</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
The svg is inserted into PDF by using PDF commands to draw and fill
lines and curves. This means that the graphical objects created with
this remain as vector graphics.
</p>
<p>
There are a number of SVG things that cannot be converted directly into
PDF. Parts of the graphic such as effects, patterns and images are inserted
into the PDF as a raster graphic. The resolution of this graphic may not
be ideal depending on the FOP dpi (72dpi) and the scaling for that graphic.
This needs to be improved.</p>
<p>
Currently transparency is not supported in PDF so many svg images that
contain effects or graphics with transparent areas will not be displayed
correctly.
</p>
</div>
<a name="N103DD"></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
this by checking if the text can be drawn normally and the font is
supported. This example svg <a href="dev/svg/text.svg">text.svg</a> /
<a href="dev/svg/text.pdf">text.pdf</a>
shows how various types and effects with text are handled.
Note that tspan and outlined text are not yet implemented.</p>
<p>
Otherwise, text is converted and drawn as a set of shapes by batik, using the
stroking text painter.
This means that a typical character will
have about 10 curves (each curve consists of at least 20 characters).
This can make the pdf files large and when the pdf is viewed the
viewer does not normally draw those fine curves very well (turning on
Smooth Line Art in the Acrobat preferences will fix this).
If the text is inserted into the PDF using the inbuilt text commands
for PDF it will use a single character.
</p>
<p>
It is possible to make sure that all text is drawn into PDF using the
PDF text commands (instead of the graphical shapes), by adding the following
to the user config:
</p>
<pre class="code"><entry>
<key>strokeSVGText</key>
<value>false</value>
</entry></pre>
<p>In a servlet environment, you can set it directly:</p>
<pre
class="code">org.apache.fop.configuration.Configuration.put("strokeSVGText",
Boolean.FALSE);</pre>
<p>For information on using a configuration file in a servlet, see the <a
href="faq.html#usercfg">FAQ</a> on that topic.</p>
<p>Note that this configuration setting works only for the PDF renderer.</p>
<p>
The drawback to forcing text to be rendered as text is that it will be
confined to text that is
possible for PDF fonts (including embedded fonts) and implemented with
this workaround. The fonts available are the standard pdf fonts and any
fonts that you have embedded using FOP. The font sizes will be rounded
to an integer value. In future this will be improved.
</p>
<p>Note that because SVG text can be rendered as either text or a vector
graphic, you may need to consider settings in your viewer for both.
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="N10410"></a><a name="svg-problems"></a>
<h4>Known Problems</h4>
<div style="margin-left: 0 ; border: 2px">
<ul>
<li>
soft mask transparency is combined with white so that it looks better
on pdf 1.3 viewers but this causes the soft mask to be slightly lighter
or darker on pdf 1.4 viewers
</li>
<li>
there is some problem with a gradient inside a pattern causing a pdf
error when viewed in acrobat 5
</li>
<li>
text is not always handled correctly, it may select the wrong font
especially if characters have multiple fonts in the font list
</li>
<li>
more pdf text handling could be implemented
It could draw the string using the attributed character iterator
to handle tspans and other simple changes of text.
</li>
<li>
JPEG images are not inserted directly into the pdf document
This area has not been implemented yet since the appropriate
method in batik is static
</li>
<li>
Uniform transparency for images and other svg elements that are converted
into a raster graphic are not drawn properly in PDF. The image is opaque.
</li>
</ul>
</div>
</div>
<a name="N1042D"></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>
<ul>
<li>If no dimensions are given, FOP uses a default value of 72 dpi to compute
the graphic's dimensions. For example, suppose a graphic 300 pixels wide and
400 pixels high. FOP will render the graphic at 4.167 inches wide, 5.555 inches
high, with an apparent resolution of 72 dpi.</li>
<li>If only one dimension is given, FOP by default uses the same aspect ratio
to compute the other dimension (to avoid the appearance of stretching). For
example, suppose a graphic 300 pixels wide and 400 pixels high, for which
content-width = ".5in". FOP will compute the content-height = .667 inches, and
will render the graphic at that size, with an apparent resolution of 600
dpi.</li>
<li>If both dimensions are given, FOP simply renders the image in that space.
For example, suppose a graphic 300 pixels wide and 400 pixels high, for which
content-width = "3in" and content-height = "4in". FOP will render the graphic
at that size, with an apparent resolution of 100 dpi.</li>
</ul>
<div class="frame note">
<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>
</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/graphics.pdf
<<Binary file>>
1.10 +187 -173 xml-site/targets/fop/design/areas.html
Index: areas.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/areas.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- areas.html 21 Apr 2003 00:50:31 -0000 1.9
+++ areas.html 23 Apr 2003 03:40:07 -0000 1.10
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -228,229 +246,225 @@
</p>
<ul class="minitoc">
<li>
-<a href="#Structure">Structure</a>
+<a href="#structure">Structure</a>
+</li>
+<li>
+<a href="#page">Page</a>
</li>
<li>
-<a href="#Page">Page</a>
+<a href="#block">Block Areas</a>
</li>
<li>
-<a href="#Block+Areas">Block Areas</a>
+<a href="#line-area">Line Areas</a>
</li>
<li>
-<a href="#Line+Areas">Line Areas</a>
+<a href="#inline">Inline Areas</a>
</li>
<li>
-<a href="#Inline+Areas">Inline Areas</a>
+<a href="#repeated-area">Repeated Areas</a>
</li>
<li>
-<a href="#Repeated+Areas">Repeated Areas</a>
+<a href="#traits">Traits</a>
</li>
<li>
-<a href="#Classes">Classes</a>
+<a href="#classes">Classes</a>
<ul class="minitoc">
<li>
-<a href="#Page+Area+Classes">Page Area Classes</a>
+<a href="#classes-page">Page Area Classes</a>
</li>
<li>
-<a href="#Block+Area+Classes">Block Area Classes</a>
+<a href="#classes-block">Block Area Classes</a>
</li>
<li>
-<a href="#Inline+Area+Classes">Inline Area Classes</a>
+<a href="#classes-inline">Inline Area Classes</a>
</li>
</ul>
</li>
<li>
-<a href="#Rendering+Area+Tree">Rendering Area Tree</a>
+<a href="#forward-references">Forward References</a>
+</li>
+<li>
+<a href="#caching">Caching</a>
+</li>
+<li>
+<a href="#extensions">Extensions</a>
+</li>
+<li>
+<a href="#handlers">Area Tree Handlers</a>
</li>
</ul>
-
-<p>
-The code to implement the area tree matches the areas
-defined in the specification. This makes it easier to understand and
-correspond with the specification.
- </p>
-
-<p>
-The area tree is created by the layout managers once the layout is decided
-for a page. Once a completed page is finished it can then be added to the
-area tree. The area tree model can then handle the new page. The data in
-the area tree must be minimal and independant. This means that the data
-uses less memory and can be serialized to an output stream if needed.
- </p>
-
-<a name="N101CE"></a><a name="Structure"></a>
+
+<p>The Area Tree is an internal representation of the result document,
representing pages and their contents.
+To make the concepts clearer and easier to understand, the code to implement
the area tree matches the areas defined in the XSL-FO specification.</p>
+
+<p>The area tree is created by the layout managers once the layout is
decided for a page.
+Once a completed page is finished it can then be added to the area tree.
+From that point forward, the area tree model can then handle the new page.
+The data in the area tree must be minimal and independant.
+This means that the data uses less memory and can be serialized to an output
stream if needed.</p>
+
+<p>The Area Tree consists of a set of pages, which the actual implemenation
places in a set of page sequences.</p>
+
+<a name="N101D1"></a><a name="structure"></a>
<h3>Structure</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The area tree is a root element that has a list of page-viewport-areas.
-Each page viewport has a page-reference-area which holds the contents of
-the page. To handle the processing better FOP does not maintain a list
-at the root level but lets the area tree model handle each page as it is
added.
- </p>
+<p>The area tree is a root element that has a list of page-viewport-areas.
+Each page viewport has a page-reference-area which holds the contents of the
page.
+To handle the processing better FOP does not maintain a list at the root
level but lets the area tree model handle each page as it is added.</p>
</div>
-
-<a name="N101D8"></a><a name="Page"></a>
+
+<a name="N101DB"></a><a name="page"></a>
<h3>Page</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-A page is made up of five area regions. These are before, start, body,
-end and after. Each region has a viewport and contains the areas
-produced from the children in the FO object heirarchy.
- </p>
-<p>
-For the body area there are more subdivisions for before floats,
-footnotes and the main reference area. The main reference area is
-made from span areas which have normal flow reference areas as
-children. The flow areas are then created inside these normal flow
-reference areas.
- </p>
-<p>
-Since the layout is done inside a page, the page is created from the
-pagemaster with all the appropriate areas. The layout manager then
-uses the page to add areas into the normal flow reference areas
-and floats and footnotes. After adding the areas for the body region
-then the other regions can be done layed out and added.
- </p>
+<p>A page consists of a page+viewport pair.</p>
+<p>The PageViewPort and Page with the regions is created by the
+LayoutMasterSet.
+The contents are then placed by the layout managers.
+Once the layout of a page is complete then it is added to the Area Tree.</p>
+<p>Inside the page is a set of RegionViewport+Region pairs for each region on
+the page.</p>
+<p>A page is made up of five area regions.
+These are before, start, body, end and after.
+Each region has a viewport and contains the areas produced from the children
in the FO object heirarchy.</p>
+<p>For the body area there are more subdivisions for before floats,
footnotes and the main reference area.
+The main reference area is made from span areas which have normal flow
reference areas as children.
+The flow areas are then created inside these normal flow reference areas.</p>
+<p>Since the layout is done inside a page, the page is created from the
pagemaster with all the appropriate areas.
+The layout manager then uses the page to add areas into the normal flow
reference areas and floats and footnotes.
+After adding the areas for the body region then the other regions can be
done layed out and added.</p>
</div>
-
-<a name="N101E8"></a><a name="Block+Areas"></a>
+
+<a name="N101F4"></a><a name="block"></a>
<h3>Block Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Block areas are created and/or returned by all top level elements
-in the flow. The spacing between block areas is handled by an
-empty block area. A block area is stacked with other block
-areas in a particular direction, it has a size and it contains
-line areas made from a group of inline areas and/or block areas.
- </p>
+<p>Block level areas contain either other blocks or line areas (which is a
+special block area).</p>
+<p>A block is either positoned or stacked with other block areas.</p>
+<p>Block areas are created and/or returned by all top level elements in the
flow.
+The spacing between block areas is handled by an empty block area.
+A block area is stacked with other block areas in a particular direction, it
has a size and it contains line areas made from a group of inline areas and/or
block areas.</p>
</div>
-
-<a name="N101F2"></a><a name="Line+Areas"></a>
+
+<a name="N10204"></a><a name="line-area"></a>
<h3>Line Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-A line areas is simply a collection of inline areas that are stacked
-in the inline progression direction. A line area has a height and
-a start position. The line area is rendered by handling each inline
-area.
- </p>
-<p>
-A line area gets a set of inline areas added until complete then
-it is justified and vertically alignedi when adding the areas.
-If the line area contains unresolved areas then there will
-be a line resolver that retains the justification information until
-all areas in the line are resolved.
- </p>
+<p>A line areas is simply a collection of inline areas that are stacked in
the inline progression direction.
+A line area has a height and a start position.
+The line area is rendered by handling each inline area.</p>
+<p>A line area gets a set of inline areas added until complete then it is
justified and vertically alignedi when adding the areas.
+If the line area contains unresolved areas then there will be a line
resolver that retains the justification information until all areas in the line
are resolved.</p>
</div>
-
-<a name="N101FF"></a><a name="Inline+Areas"></a>
+
+<a name="N10211"></a><a name="inline"></a>
<h3>Inline Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-There are a few different types of inline areas. All inline areas
-have a height and width.
- </p>
-<p>
-Unresolved areas can reserve some space to allow for possible
-sizes once it is resolved. Then the line can be re-justified
-and finalised.
- </p>
+<p>There are a few different types of inline areas.
+All inline areas have a height and width.</p>
+<p>Unresolved areas can reserve some space to allow for possible sizes once
it is resolved.
+Then the line can be re-justified and finalised.</p>
+<p>Inline areas are stacked in a line area.
+Inline areas are objects such as character, viewport, inline-container,
leader and space.
+A special inline area Word is also used for a group of consecutive
characters.</p>
+<p>The image and instream foreign object areas are placed inside a viewport.
+The leader (with use content) and unresolved page number areas are resolved
to other inline areas.</p>
+<p>Once a LineArea is filled with inline areas then the inline areas need to
be aligned and adjusted to fill the line properly.</p>
</div>
-
-<a name="N1020C"></a><a name="Repeated+Areas"></a>
+
+<a name="N10227"></a><a name="repeated-area"></a>
<h3>Repeated Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-There are cases where the same subtree could be repeated in the area
-tree. These areas will be returned by the same layout managers.
-So it is possible to put a flag on the created areas so that
-the subtree data can be cached in the output. Examples of this are:
-static areas, table header/footer, svg.
- </p>
+<p>There are cases where the same subtree could be repeated in the area tree.
+These areas will be returned by the same layout managers.
+So it is possible to put a flag on the created areas so that the subtree
data can be cached in the output.
+Examples of this are: static areas, table header/footer, svg.</p>
+</div>
+
+<a name="N10231"></a><a name="traits"></a>
+<h3>Traits</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>A trait is information associated with an area.
+This could be information such as text colour or is-first.</p>
+<p>Traits provide information about an area.
+The traits are derived from properties on the formatting object or are
generated during the layout
+process.
+Many of the layout traits do not have actual values but can be derived from
the Area Tree.
+Other traits that apply when rendering the areas are set on the area.
+Since setting the same value on every area would use a lot of memory then
the traits are derived from default or parent values.</p>
+<p>A dominant trait on a block area is set, for example font colour, so that
+every line area with the same dominant value can derive it.
+The text inline areas then get the font colour set on the inline area or
from the line area or from the block area.</p>
</div>
-
-<a name="N10216"></a><a name="Classes"></a>
+
+<a name="N10241"></a><a name="classes"></a>
<h3>Classes</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The following class structure will be used to represent the area
-tree.
- </p>
-<a name="N1021F"></a><a name="Page+Area+Classes"></a>
+<p>The following class structure will be used to represent the area tree.</p>
+<a name="N1024A"></a><a name="classes-page"></a>
<h4>Page Area Classes</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The page area classes hold the top level layout of a page. The
-areas are created by the page master and should be ready to have
-flow areas added.
- </p>
+<p>The page area classes hold the top level layout of a page.
+The areas are created by the page master and should be ready to have flow
areas added.</p>
</div>
-<a name="N10229"></a><a name="Block+Area+Classes"></a>
+<a name="N10254"></a><a name="classes-block"></a>
<h4>Block Area Classes</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The block areas hold other block areas and/or line areas. The
-child areas are stacked in a particular direction.
- </p>
-<p>
-Areas for tables, lists and block container have their child
-block areas stacked in different ways. These areas a placed
-with an absolute positioning. The absolute positioning is where
-the blocks are placed with an offset from the parent reference area.
- </p>
+<p>The block areas hold other block areas and/or line areas.
+The child areas are stacked in a particular direction.</p>
+<p>Areas for tables, lists and block container have their child block areas
stacked in different ways.
+These areas a placed with an absolute positioning.
+The absolute positioning is where the blocks are placed with an offset from
the parent reference area.</p>
</div>
-<a name="N10236"></a><a name="Inline+Area+Classes"></a>
+<a name="N10261"></a><a name="classes-inline"></a>
<h4>Inline Area Classes</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The inline areas are used to make up a line area. An inline area
-typically has a height, width and some content. The inline area
-is offset from the baseline of the current line area. The content
-of the inline area can be other inline areas or a simple atomic
-object.
- </p>
+<p>The inline areas are used to make up a line area.
+An inline area typically has a height, width and some content.
+The inline area is offset from the baseline of the current line area.
+The content of the inline area can be other inline areas or a simple atomic
object.</p>
</div>
</div>
-
-
-<a name="N10241"></a><a name="Rendering+Area+Tree"></a>
-<h3>Rendering Area Tree</h3>
+
+<a name="N1026C"></a><a name="forward-references"></a>
+<h3>Forward References</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The rendering of an area tree is done by rendering each page
-to a suitable output. The regions are rendered in order and each
-region is contained by a viewport.
- </p>
-<p>
-The relevent structures that will need to be rendered are:
-Page
-Viewport
-Region
-Span
-Block
-Line
-Inline
- </p>
-<p>
-A renderer implementation does the following:
- </p>
-<ul>
-
-<li>render each individual page</li>
-
-<li>clip and align child areas to a viewport</li>
-
-<li>handle all types of inline area, text, image etc.</li>
-
-<li>draw various lines and rectangles</li>
-
-</ul>
-<p>
-An abstract renderer will be able to handle the generic positioning
-of child areas, iterating through areas that have child areas.
- </p>
+<p>The Area Tree maintains a set of mappings from the reference to pages.</p>
+<p>The PageViewPort holds the list of forward references that need resolving
so that if a references is resolved during layout the page can be easily found
and then fixed.
+Once all the forward references are resolved then the page is ready to be
rendered.</p>
+<p>To layout a page any areas that cannot be resolved need to reserve space.
+Once the inline area is resolved then the complete line should be adjusted
to accomodate any change in space used by the area.</p>
+</div>
+
+<a name="N1027C"></a><a name="caching"></a>
+<h3>Caching</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>We may need to cache pages due to forward references or when keeping all
+pages.</p>
+<p>This is done by serializing the Page.
+The PageViewport is retained to be used as a key for page references and
backward references.
+The Page is serialized to an object stream and then all of the page contents
are released.
+The Page is then recoved by reading from the object stream.</p>
+<p>The PageViewport retains information about id areas for easy access.</p>
+</div>
+
+<a name="N1028C"></a><a name="extensions"></a>
+<h3>Extensions</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The Area Tree holds the Output Document extensions.
+This is information such as pdf bookmarks or other output document specific
information that
+is not handled by XSL:FO.</p>
+<p>It is also possible to create custom areas that extend a normal area.
+The actual data that is rendered could be set in a different way or depend
on resolving a forward reference.</p>
+</div>
+
+<a name="N10299"></a><a name="handlers"></a>
+<h3>Area Tree Handlers</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>To handle different situations the handler for the Area Tree handles each
+page as it is added.</p>
+<p>The RenderPagesModel sends the page directly to the renderer if the page
is ready to be rendered. Once a page is rendered it is discarded. The
StorePagesModel stores all the pages so that any page can be later accessed.</p>
+<p>The Area Tree retains the concept of page sequences (this is not in the
area tree in the spec) so that this information can be passed to the renderer.
+This is useful for setting the title and organising the groups of page
sequences.</p>
</div>
-
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
1.6 +433 -167 xml-site/targets/fop/design/areas.pdf
<<Binary file>>
1.11 +24 -6 xml-site/targets/fop/design/breakpos.html
Index: breakpos.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/breakpos.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- breakpos.html 21 Apr 2003 00:50:31 -0000 1.10
+++ breakpos.html 23 Apr 2003 03:40:07 -0000 1.11
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -149,6 +149,24 @@
<li>
<a href="renderers.html">Renderers</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
</li>
</ul>
1.15 +24 -6 xml-site/targets/fop/design/embedding.html
Index: embedding.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/embedding.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- embedding.html 21 Apr 2003 00:50:31 -0000 1.14
+++ embedding.html 23 Apr 2003 03:40:07 -0000 1.15
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -149,6 +149,24 @@
<li>
<a href="renderers.html">Renderers</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
</li>
</ul>
1.12 +24 -6 xml-site/targets/fop/design/extending.html
Index: extending.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/extending.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- extending.html 21 Apr 2003 00:50:31 -0000 1.11
+++ extending.html 23 Apr 2003 03:40:07 -0000 1.12
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -149,6 +149,24 @@
<li>
<a href="renderers.html">Renderers</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
</li>
</ul>
1.13 +165 -56 xml-site/targets/fop/design/fotree.html
Index: fotree.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/fotree.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- fotree.html 21 Apr 2003 00:50:31 -0000 1.12
+++ fotree.html 23 Apr 2003 03:40:07 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<span class="sel"><font color="#ffcc00">FO Tree</font></span>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -228,62 +246,101 @@
</p>
<ul class="minitoc">
<li>
-<a href="#Introduction">Introduction</a>
-<ul class="minitoc">
+<a href="#intro">Introduction</a>
+</li>
<li>
-<a href="#FONode">FONode</a>
+<a href="#fonode">FONode</a>
</li>
<li>
-<a href="#Making+FO%27s">Making FO's</a>
+<a href="#create-fo">Making FO's</a>
</li>
<li>
-<a href="#Foreign+XML">Foreign XML</a>
+<a href="#properties">Properties</a>
</li>
<li>
-<a href="#Extensions">Extensions</a>
+<a href="#foreign">Foreign XML</a>
</li>
-</ul>
+<li>
+<a href="#unknown">Unknown Elements</a>
+</li>
+<li>
+<a href="#extensions">Extensions</a>
+</li>
+<li>
+<a href="#page-master">Page Masters</a>
+</li>
+<li>
+<a href="#flow">Flow</a>
+</li>
+<li>
+<a href="#other-elements">Other Elements</a>
</li>
</ul>
-
-<a name="N101C8"></a><a name="Introduction"></a>
+
+<a name="N101C8"></a><a name="intro"></a>
<h3>Introduction</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The FO Tree is an internal representation of the input FO document.
-The tree is created by building the elements and attributes from
-the SAX events.
- </p>
-<p>
-The FO Tree is used as an intermediatory structure which is converted
+<p>The FO Tree is an internal representation of the input XSL-FO document.
+The tree is created by building the elements and attributes from the SAX
events.
+The process of building the FO Tree corresponds to the
<strong>Objectify</strong> step from the spec.
+The <strong>Refinement</strong> step is part of reading and using the
properties which may happen immediately or during the layout process.</p>
+<p>The FO Tree is used as an intermediatory structure which is converted
into the area tree. The complete FO tree should not be held in memory
-since FOP should be able to handle FO documents of any size.
- </p>
-<a name="N101D4"></a><a name="FONode"></a>
-<h4>FONode</h4>
+since FOP should be able to handle FO documents of any size.</p>
+<p>The FO Tree is simply a heirarchy of java objects that represent the fo
elements from xml.
+The traversal is done by the layout or structure process only in the flow
elements.</p>
+</div>
+
+<a name="N101DE"></a><a name="fonode"></a>
+<h3>FONode</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The class inheritance described above only describes the nature of the
+<p>The base class for all objects in the tree is FONode. The base class for
+all FO Objects is FObj.</p>
+<p>The class inheritance described above only describes the nature of the
content. Every FO in FOP also has a parent, and a Vector of children. The
parent attribute (in the Java sense), in particular, is used to enforce
-constraints required by the FO hierarchy.
-</p>
-<p>
-FONode, among other things, ensures that FO's have a parent and that they
-may have children.
+constraints required by the FO hierarchy.</p>
+<p>FONode, among other things, ensures that FO's have a parent and that they
+may have children.</p>
+<p>Each xml element is represented by a java object. For pagination the
+classes are in <span class="codefrag">org.apache.fop.fo.pagination.*</span>,
for elements in the flow
+they are in <span class="codefrag">org.apache.fop.fo.flow.*</span> and some
others are in
+<span class="codefrag">org.apache.fop.fo.*.</span>
</p>
</div>
-<a name="N101E1"></a><a name="Making+FO%27s"></a>
-<h4>Making FO's</h4>
+
+<a name="N101F9"></a><a name="create-fo"></a>
+<h3>Making FO's</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-An FO maker is read from a hashmap lookup using the namespace and
+<p>There is a class for each element in the FO set. An object is created for
+each element in the FO Tree. This object holds the properties for the FO
+Object.</p>
+<p>Some validity checking is done during these steps. The user can be warned
of the error and processing can continue if possible.</p>
+<p>When the object is created it is setup.
+It is given its element name, the FOUserAgent - for resolving properties
etc. - the logger and the attributes.
+The methods <span class="codefrag">handleAttributes()</span> and <span
class="codefrag">setuserAgent()</span>, common to <span
class="codefrag">FONode</span>, are used in this process.
+The object will then be given any text data or child elements.
+Then the <span class="codefrag">end()</span> method is called.
+The end method is used by a number of elements to indicate that it can do
certain processing since all the children have been added.</p>
+<p>An FO maker is read from a hashmap lookup using the namespace and
element name. This maker is then used to create a new class that
represents an FO element. This is then added to the FO tree as a child
-of the current parent.
-</p>
-<p>
-Properties (recall that FO's have properties, areas have traits, and XML
+of the current parent.</p>
+</div>
+
+<a name="N10218"></a><a name="properties"></a>
+<h3>Properties</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The XML attributes on each element are passed to the object. The objects
+that represent FO objects then convert the attributes into properties.</p>
+<p>Since properties can be inherited the PropertyList class handles resolving
+properties for a particular element.
+All properties are specified in an XML file. Classes are created
+automatically during the build process.</p>
+<p>In some cases the element may be moved to have a different parent, for
+example markers, or the inheritance could be different, for example
+initial property set.</p>
+<p>Properties (recall that FO's have properties, areas have traits, and XML
nodes have attributes) are also a concern of <em>FOTreeBuilder</em>. It
accomplishes this by using a <em>PropertyListBuilder</em>. There is a
separate <em>PropertyListBuilder</em> for each namespace encountered
@@ -296,33 +353,85 @@
<p>The base class for all
properties is <em>Property</em>, and all the property makers extend
<em>Property.Maker</em>. A more complete discussion of the property
-architecture may be found in <a target="_top"
href="properties.html">Properties</a>.
-</p>
+architecture may be found in <a target="_top"
href="properties.html">Properties</a>.</p>
</div>
-<a name="N10210"></a><a name="Foreign+XML"></a>
-<h4>Foreign XML</h4>
+
+<a name="N1024D"></a><a name="foreign"></a>
+<h3>Foreign XML</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-FOP supports the handlingof foreign XML.
+<p>FOP supports the handlingof foreign XML.
The XML is converted internally into a DOM, this is then available to
the FO tree to convert the DOM into another format which can be rendered.
In the case of SVG the DOM needs to be created with Batik, so an element
mapping is used to read all elements in the SVG namespace and pass them
-into the Batik DOM.
-</p>
+into the Batik DOM.</p>
+<p>The base class for foreign XML is XMLObj. This class handles creating a
+DOM Element and the setting of attributes. It also can create a DOM
+Document if it is a top level element, class XMLElement.
+This class must be extended for the namespace of the XML elements. For
+unknown namespaces the class is UnknowXMLObj.</p>
+<p>If some special processing is needed then the top level element can extend
+the XMLObj. For example the SVGElement makes the special DOM required for
+batik and gets the size of the svg.</p>
+<p>Foreign XML will usually be in an fo:instream-foreign-object, the XML will
+be passed to the render as a DOM where the render will be able to handle
+it. Other XML from an unknwon namespace will be ignored.</p>
+<p>By using element mappings it is possible to read other XML and either</p>
+<ul>
+
+<li>set information on the area tree</li>
+
+<li>create pseudo FO Objects that create areas in the area tree</li>
+
+<li>create FO Objects</li>
+
+</ul>
+</div>
+
+<a name="N1026F"></a><a name="unknown"></a>
+<h3>Unknown Elements</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>If an element is in a known namespace but the element is unknown then an
+Unknown object is created. This is mainly to provide information to the
+user.
+This could happen if the fo document contains an element from a different
+version or the element is misspelt.</p>
</div>
-<a name="N1021A"></a><a name="Extensions"></a>
-<h4>Extensions</h4>
+
+<a name="N10279"></a><a name="extensions"></a>
+<h3>Extensions</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-It is possible to add extensions to FOP so that you can extend the ability of
+<p>It is possible to add extensions to FOP so that you can extend the
ability of
FOP with respect to render output, document specific information or extended
-layout functionality.
-</p>
+layout functionality.</p>
+</div>
+
+<a name="N10283"></a><a name="page-master"></a>
+<h3>Page Masters</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The first elements in a document are the elements for the page master
setup.
+This is usually only a small number and will be used throughout the document
to create new pages.
+These elements are kept as a factory to create the page and appropriate
regions whenever a new page is requested by the layout.
+The objects in the FO Tree that represent these elements are themselves the
factory.
+The root element keeps these objects as a factory for the page sequences.</p>
</div>
+
+<a name="N1028D"></a><a name="flow"></a>
+<h3>Flow</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The elements that are in the flow of the document are a set of elements
+that is needed for the layout process. Each element is important in the
+creation of areas.</p>
</div>
-
+<a name="N10297"></a><a name="other-elements"></a>
+<h3>Other Elements</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The remaining FO Objects are things like page-sequence, title and
color-profile.
+These are handled by their parent element; i.e. the root looks after the
declarations and the declarations maintains a list of colour profiles.
+The page-sequences are direct descendents of root.</p>
+</div>
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
</tr>
1.5 +391 -102 xml-site/targets/fop/design/fotree.pdf
<<Binary file>>
1.14 +228 -49 xml-site/targets/fop/design/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/index.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- index.html 21 Apr 2003 00:50:31 -0000 1.13
+++ index.html 23 Apr 2003 03:40:07 -0000 1.14
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>FOP Design</title>
+<title>Introduction to FOP Design</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<span class="sel"><font color="#ffcc00">Introduction</font></span>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -217,12 +235,11 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>FOP Design</h1>
+<h1>Introduction to FOP Design</h1>
</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="index.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
PDF</a></td>
</tr>
</table>
-<h3>Design Approach to FOP</h3>
<p>
<font size="-2">by Keiron Liddle</font>
</p>
@@ -231,58 +248,220 @@
<a href="#Introduction">Introduction</a>
<ul class="minitoc">
<li>
-<a href="#Aims">Aims</a>
+<a href="#Overview">Overview</a>
+</li>
+<li>
+<a href="#Stages">Stages</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#primary-goals">Primary Design Goals</a>
+<ul class="minitoc">
+<li>
+<a href="#pri-goal-conformance">Conformance to the XSL-FO Specification</a>
+</li>
+<li>
+<a href="#pri-goal-unlimited-size">Process Files of Arbitrary Size</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#secondary-goals">Secondary Design Goals</a>
+<ul class="minitoc">
+<li>
+<a href="#sec-goal-memory">Keep Memory Minimal</a>
</li>
</ul>
</li>
+<li>
+<a href="#issues">Design Issues</a>
+<ul class="minitoc">
+<li>
+<a href="#issue-input">Use SAX as Input</a>
+</li>
+<li>
+<a href="#issue-fo-recycle">Process FO Elements ASAP</a>
+</li>
+<li>
+<a href="#issue-fo-serialize">Serialize FO Tree as Necessary</a>
+</li>
+<li>
+<a href="#issue-simple-layout">Keep Layouts Simple</a>
+</li>
+<li>
+<a href="#issue-simple-id-refs">Keep ID References Simple</a>
+</li>
+<li>
+<a href="#issue-area-recycle">Render Pages ASAP</a>
+</li>
+<li>
+<a href="#issue-renderers-responsible">Renderers are Responsible</a>
+</li>
+<li>
+<a href="#issue-output-stream">Send Output to a Stream</a>
+</li>
</ul>
+</li>
+</ul>
+
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The articles in this section pertain to the
<em>redesign</em> or <em>trunk</em> line of development.
+The redesign is mainly focusing on parts of the layout process (converting
the FO tree into the Area Tree).</div>
+</div>
-<a name="N101C8"></a><a name="Introduction"></a>
+
+
+<a name="N101CE"></a><a name="Introduction"></a>
<h3>Introduction</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The information here describes the design and architecture details for FOP.
-Currently this is part of a redesign process for some of the core parts of
-FOP.
- </p>
-<p>
-The redesign is mainly focusing on some particular process involved
-with the layout process when converting the FO tree into the Area Tree.
- </p>
-<a name="N101D4"></a><a name="Aims"></a>
-<h4>Aims</h4>
+<a name="N101D4"></a><a name="Overview"></a>
+<h4>Overview</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The main aim for FOP is to comply with the spec and to be able to
-process files of any size.
- </p>
-<p>
-In achieving this aim we need to understand the problem and break it
-into small problems that can be solved.
- </p>
+<p>FOP takes an xml file does its magic and then writes a document to a
+ stream.</p>
+<p>xml -> [FOP] -> document</p>
+<p>The document could be pdf, ps etc. or directed to a printer or the
+ screen. The principle remains the same. The xml document must be in
the XSL:FO
+ format.</p>
+<p>For convenience we provide a mechanism to handle XML+XSL as
+ input.</p>
+<p>The xml document is always handled internally as SAX. The SAX events
+ are used to read the elements, attributes and text data of the FO
document.
+ After the manipulation of the data the renderer writes out the pages
in the
+ appropriate format. It may write as it goes, a page at a time or the
whole
+ document at once. Once finished the document should contain all the
data in the
+ chosen format ready for whatever use.</p>
+</div>
+<a name="N101EA"></a><a name="Stages"></a>
+<h4>Stages</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The fo data goes through a few stages. Each piece
+ of data will generally go through the process in the same way but some
+ information may be used a number of times or in a different order. To
reduce
+ memory one stage will start before the previous is completed.</p>
+<p>SAX Handler -> FO Tree -> Layout Managers -> Area Tree
+ -> Render -> document</p>
+<p>In the case of rtf, mif etc. <br>SAX Handler -> FO Tree ->
+ Structure Renderer -> document</p>
+<p>The FO Tree is constructed from the xml document. It is an internal
+ representation of the xml document and it is like a DOM with some
differences.
+ The Layout Managers use the FO Tree do their layout stuff and create
an Area
+ Tree. The Area Tree is a representation of the final result. It is a
+ representation of a set of pages containing the text and other
graphics. The
+ Area Tree is then given to a Renderer. The Renderer can read the Area
Tree and
+ convert the information into the render format. For example the PDF
Renderer
+ creates a PDF Document. For each page in the Area Tree the renderer
creates a
+ PDF Page and places the contents of the page into the PDF Page. Once
a PDF Page
+ is complete then it can be written to the output stream.</p>
+<p>For the structure documents the Structure listener will read
+ directly from the FO Tree and create the document. These documents do
not need
+ the layout process or the Area Tree.</p>
+</div>
+</div>
+
+<a name="N10203"></a><a name="primary-goals"></a>
+<h3>Primary Design Goals</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>A discussion of project design properly begins with a list of the goals
of the project. Out of these goals will flow the design issues and details, and
eventually, the implementation.</p>
+<a name="N1020C"></a><a name="pri-goal-conformance"></a>
+<h4>Conformance to the XSL-FO Specification</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The current design goal is to reach the "basic" level of conformance, and
to have enough flexibility in the design to reach "complete" conformance
without major rewriting.
+After "basic" conformance is achieved, it is probably that higher levels of
conformance will be sought.</p>
+</div>
+<a name="N10216"></a><a name="pri-goal-unlimited-size"></a>
+<h4>Process Files of Arbitrary Size</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Except for user storage limitations, the design goal is to be able to
process files of any size.</p>
+</div>
+</div>
+
+<a name="N10221"></a><a name="secondary-goals"></a>
+<h3>Secondary Design Goals</h3>
+<div style="margin-left: 0 ; border: 2px">
+<a name="N10227"></a><a name="sec-goal-memory"></a>
+<h4>Keep Memory Minimal</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Many FOP design decisions revolve around trying to minimize the use of
memory.
+The primary purpose here is to reduce the amount of data that must be
serialized to storage during processing.
+Since our primary design goals include the ability to process files of
arbitrary size, there is no way to avoid the need to serialize.
+However, many FOP users provide web access to documents that are created in
real time.
+Performance is therefore an important issue in these real-world applications.
+To the extent that it can be done so without jeopardizing the primary design
goals, FOP developers have identified keeping a small memory footprint as being
an important secondary goal.</p>
+</div>
+</div>
+
+<a name="N10232"></a><a name="issues"></a>
+<h3>Design Issues</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>As with any significant programming project, we need to first understand
the big problem, then break it into smaller solvable problems.
+To achieve our design goals, we have identified and attempted to resolve
some design issues.
+Since they are in support of the primary and secondary goals, they are not
necessarily written in stone.
+However, most of them have been discussed at length among the developers,
and are reasonably well settled.</p>
+<a name="N1023B"></a><a name="issue-input"></a>
+<h4>Use SAX as Input</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The two standard ways of dealing with XML input are SAX and DOM. SAX
basically creates events as it parses an XML document in a serial fashion; a
program using SAX (and not storing anything internally) will only see a small
window of the document at any point in time, and can never look forward in the
document. DOM creates and stores a tree representation of the document,
allowing a view of the entire document as an integrated whole. One issue that
may seem counter-intuitive to some new FOP developers, and which has from time
to time been contentious, is that FOP uses SAX for input. (DOM can be used as
input as well, but it is converted into SAX events before entering FOP,
effectively negating its advantages).</p>
+<p>Since FOP essentially needs a tree representation of the FO input, at
first glance it seems to make sense to use DOM. Instead, FOP takes SAX events
and builds its own tree-like structure. Why?</p>
<ul>
-
-<li>use SAX as input</li>
-
-<li>process FO elements ASAP</li>
-
-<li>dispose of unused memory, keep memory minimal</li>
-
-<li>layout handles floats, footnotes and keeps in a simple straight forward
way</li>
-
-<li>id references are kept simple</li>
-
-<li>pages are rendered ASAP, can be cached until resolved</li>
-
-<li>renderers are totally responsible for their output format</li>
-
-<li>output is sent to a stream</li>
-
+
+<li>DOM has a relatively large memory footprint. FOP's FO Tree is a
lighter-weight structure.</li>
+
+<li>DOM contains an entire document. FOP is able to process individual
fo:page-sequence objects discretely, without the need to have the entire
document in memory. For documents that have only one fo:page-sequence object,
FOP's approach is no advantage, but in other cases it is a huge advantage. A
500-page book that is broken into 100 5-page chapters, each in its own
fo:page-sequence, essentially needs only 1% of the document memory that would
be required if using DOM as input.</li>
+
+</ul>
+</div>
+<a name="N10251"></a><a name="issue-fo-recycle"></a>
+<h4>Process FO Elements ASAP</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The issue here is that we wish to recycle FO Tree memory as much as
possible. There are at least three possible places that FO Tree fragments can
be passed to the Layout process, and their memory recycled:</p>
+<ul>
+
+<li>
+
+<strong>fo:block</strong> It might be tempting to start laying out pages as
soon as the first fo:block object is finished. However, there are many
downstream things that can affect the placement of that block on a page, such
as graphics and footnotes. So, in order to maintain conformance to the XSL-FO
specification, and create high-quality output, we must see more of the
document.</li>
+
+<li>
+
+<strong>fo:root</strong> The other extreme is to wait until the entire
document is read in before processing any of it. This essentially means that
there is no memory recycling. Processing the document correctly is more
important than saving memory, so this option would be used if there were no
better alternative.</li>
+
+<li>
+
+<strong>fo:page-sequence</strong> The page-sequence object provides a nice
clean break in the document. Content from one page-sequence will never
interfere with nor affect the placement of the content of another. FOP uses
this option as the optimum way to maintain compliance with the standard and to
minimize memory consumption.</li>
+
</ul>
</div>
+<a name="N10270"></a><a name="issue-fo-serialize"></a>
+<h4>Serialize FO Tree as Necessary</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This issue is implied by the requirement to process documents of
arbitrary size. Unless some arbitrary limit is placed on the size of
page-sequence objects, FOP must be able to serialize FO tree fragments as
necessary.</p>
</div>
-
-
+<a name="N1027A"></a><a name="issue-simple-layout"></a>
+<h4>Keep Layouts Simple</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Layout should handle floats, footnotes and keeps in a simple,
straightforward way.</p>
+</div>
+<a name="N10284"></a><a name="issue-simple-id-refs"></a>
+<h4>Keep ID References Simple</h4>
+<div style="margin-left: 0 ; border: 2px"></div>
+<a name="N1028B"></a><a name="issue-area-recycle"></a>
+<h4>Render Pages ASAP</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The issue here is that we wish to recycle the Area Tree memory as much as
possible. The problem is that forward references prevent pages from being
resolved until the forward references are resolved. If memory is insufficient
to store unresolved pages, Area Tree fragments must be serialized until
resolved.</p>
+<p>FOP developers have discussed adding the capability of using an Area Tree
to render to more than one output target in the same run, which would be a
complicating factor in disposal of pages as they are rendered.</p>
+</div>
+<a name="N10298"></a><a name="issue-renderers-responsible"></a>
+<h4>Renderers are Responsible</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Each renderer is totally responsible for its output format.</p>
+</div>
+<a name="N102A2"></a><a name="issue-output-stream"></a>
+<h4>Send Output to a Stream</h4>
+<div style="margin-left: 0 ; border: 2px"></div>
+</div>
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
</tr>
1.5 +715 -60 xml-site/targets/fop/design/index.pdf
<<Binary file>>
1.13 +277 -440 xml-site/targets/fop/design/layout.html
Index: layout.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/layout.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- layout.html 21 Apr 2003 00:50:31 -0000 1.12
+++ layout.html 23 Apr 2003 03:40:07 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -228,585 +246,404 @@
</p>
<ul class="minitoc">
<li>
-<a href="#Layout+Managers">Layout Managers</a>
+<a href="#lm">Layout Managers</a>
</li>
<li>
-<a href="#Creating+Managers">Creating Managers</a>
+<a href="#creating">Creating Managers</a>
</li>
<li>
-<a href="#Using+Managers">Using Managers</a>
+<a href="#using">Using Managers</a>
</li>
<li>
-<a href="#Page+Layout">Page Layout</a>
+<a href="#page">Page Layout</a>
</li>
<li>
-<a href="#Balancing+Page">Balancing Page</a>
+<a href="#page-balance">Balancing Page</a>
</li>
<li>
-<a href="#Finding+Break">Finding Break</a>
+<a href="#finding-break">Finding Break</a>
</li>
<li>
-<a href="#Optimising">Optimising</a>
+<a href="#optimize">Optimising</a>
</li>
<li>
-<a href="#Multi-Column+Pages">Multi-Column Pages</a>
+<a href="#multi-column">Multi-Column Pages</a>
</li>
<li>
-<a href="#Completing+Page">Completing Page</a>
+<a href="#page-complete">Completing Page</a>
</li>
<li>
-<a href="#Line+Areas">Line Areas</a>
+<a href="#line-area">Line Areas</a>
</li>
<li>
-<a href="#Before+Floats+and+Footnotes">Before Floats and Footnotes</a>
+<a href="#before-float-footnote">Before Floats and Footnotes</a>
</li>
<li>
-<a href="#Side+Floats">Side Floats</a>
+<a href="#side-float">Side Floats</a>
</li>
<li>
-<a href="#Unresolved+Areas">Unresolved Areas</a>
+<a href="#unresolved-area">Unresolved Areas</a>
</li>
<li>
-<a href="#ID+and+Link+Areas">ID and Link Areas</a>
+<a href="#id-link-area">ID and Link Areas</a>
</li>
<li>
-<a href="#Inline+Areas">Inline Areas</a>
+<a href="#inline-area">Inline Areas</a>
</li>
<li>
-<a href="#Fixed+Areas">Fixed Areas</a>
+<a href="#fixed-area">Fixed Areas</a>
</li>
<li>
-<a href="#Stretch+Areas">Stretch Areas</a>
+<a href="#stretch-area">Stretch Areas</a>
</li>
<li>
-<a href="#Character+Areas">Character Areas</a>
+<a href="#character-area">Character Areas</a>
</li>
<li>
-<a href="#Anchor+Areas">Anchor Areas</a>
+<a href="#anchor-area">Anchor Areas</a>
</li>
<li>
-<a href="#Unresolved+Page+Numbers">Unresolved Page Numbers</a>
+<a href="#unresolved-page-num">Unresolved Page Numbers</a>
</li>
<li>
-<a href="#Block+Areas">Block Areas</a>
+<a href="#block-area">Block Areas</a>
</li>
<li>
-<a href="#Page+Areas">Page Areas</a>
+<a href="#page-area">Page Areas</a>
</li>
<li>
-<a href="#Test+Cases">Test Cases</a>
+<a href="#test-cases">Test Cases</a>
<ul class="minitoc">
<li>
-<a href="#Simple+Pages">Simple Pages</a>
+<a href="#test-simple">Simple Pages</a>
</li>
<li>
-<a href="#Before+Floats%2FFootnotes">Before Floats/Footnotes</a>
+<a href="#test-before-float-footnote">Before Floats/Footnotes</a>
</li>
<li>
-<a href="#Multicolumn">Multicolumn</a>
+<a href="#test-multi-column">Multicolumn</a>
</li>
<li>
-<a href="#Last+Page">Last Page</a>
+<a href="#test-last-page">Last Page</a>
</li>
</ul>
</li>
</ul>
-
-<p>
-The aim of the layout system is to be self contained and allow for
-easy changes or extensions for future development. For example the
-line breaking should be decided at a particular point in the process
-that makes it easier to handle other languages.
- </p>
-
-<p>
-The layout begins once the hierarchy of FO objects has been constructed.
-Note: it may be possible to start immediately after a block formatting
-object has been added to the flow but this is not currently in the scope
-of the layout. It is also possible to layout all pages in a page sequence
-after each page sequence has been added from the xml.
- </p>
-
-<p>
-The layout process is handled by a set of layout managers. The block
-level layout managers are used to create the block areas which are
-added to the region area of a page.
- </p>
-
-<a name="N101D1"></a><a name="Layout+Managers"></a>
+
+<p>The role of the layout managers is to build the Area Tree by using the
information from the FO Tree.
+The layout managers decide where information is placed in the area tree.</p>
+
+<p>A layout manager is typically associated with an FO Object but not
always.</p>
+
+<p>The layout managers are in between the FO Tree and the Area Tree.
+They get information from the FO Tree and create areas and build the pages.
+They hold the state of the layout process as it builds up the areas and
pages.
+They also manage the handling of breaks and spacing between areas.</p>
+
+<p>FO Objects can have two types of properties, ones that relate to the
layout and ones that relate to the rendering.
+The layout related properties area used by the layout managers to determine
how and where to create the areas.
+The render related properties should be passed through to the renderer in
the most efficient way possible.</p>
+
+<p>The aim of the layout system is to be self contained and allow for easy
changes or extensions for future development.
+For example the line breaking should be decided at a particular point in the
process that makes it easier to handle other languages.</p>
+
+<p>The layout begins once the hierarchy of FO objects has been constructed.
+Note: it may be possible to start immediately after a block formatting
object has been added to the flow but this is not currently in the scope of the
layout.
+It is also possible to layout all pages in a page sequence after each page
sequence has been added from the xml.</p>
+
+<p>The layout process is handled by a set of layout managers.
+The block level layout managers are used to create the block areas which are
added to the region area of a page.</p>
+
+<a name="N101DD"></a><a name="lm"></a>
<h3>Layout Managers</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The layout managers are set up from the hierarchy of the formatting
-object tree. A manager represents a hierachy of area producing objects.
-A manager is able to handle the block area(s) that it creates and
-organise or split areas for page breaks.
- </p>
-<p>
-Normally any object that creates a block area will have an associated
-layout manager. Other cases are tables and lists, these objects will
-also have layout managers that will manager the group of layout managers
-that make up the object.
- </p>
-<p>
-A layout manager is also able to determine height (min/max/optimum)
-and keep status. This will be used when organising the layout on
-a page. The manager will be able to determine the next place a break
-can be made and then be able to organise the height.
- </p>
-<p>
-A layout manager is essentially a bridge between the formatting objects
-and the area tree. It will keep a list of line areas inside block areas.
-Each line area will contain a list of inline areas that is able to be
-adjusted if the need arises.
- </p>
-<p>
-The objects in the area tree that are organised by the manager will mostly
-contain the information about there layout such as spacing and keeps, this
-information will be thrown away once the layout for a page is finalised.
- </p>
+<p>The layout managers are set up from the hierarchy of the formatting
object tree.
+A manager represents a hierachy of area producing objects.
+A manager is able to handle the block area(s) that it creates and organise
or split areas for page breaks.</p>
+<p>Normally any object that creates a block area will have an associated
layout manager.
+Other cases are tables and lists, these objects will also have layout
managers that will manager the group of layout managers that make up the
object.</p>
+<p>A layout manager is also able to determine height (min/max/optimum) and
keep status.
+This will be used when organising the layout on a page.
+The manager will be able to determine the next place a break can be made and
then be able to organise the height.</p>
+<p>A layout manager is essentially a bridge between the formatting objects
and the area tree.
+It will keep a list of line areas inside block areas.
+Each line area will contain a list of inline areas that is able to be
adjusted if the need arises.</p>
+<p>The objects in the area tree that are organised by the manager will
mostly contain the information about there layout such as spacing and keeps,
this information will be thrown away once the layout for a page is
finalised.</p>
</div>
-
-<a name="N101E7"></a><a name="Creating+Managers"></a>
+
+<a name="N101F3"></a><a name="creating"></a>
<h3>Creating Managers</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The managers are created by the page sequence. The top level manager
-is the Page manager. This asks the flow to add all managers in this
-page sequence.
- </p>
-<p>
-For block level objects they have a layout manager. Neutral objects
-don't represent any areas but are used to contain a block level
-area and as such these objects will ask the appropriate child to
-create a layout manager.
- </p>
-<p>
-Any nested block areas or inline areas may be handled by the layout
-manager at a later stage.
- </p>
+<p>The managers are created by the page sequence.
+The top level manager is the Page manager.
+This asks the flow to add all managers in this page sequence.</p>
+<p>For block level objects they have a layout manager.
+Neutral objects don't represent any areas but are used to contain a block
level area and as such these objects will ask the appropriate child to create a
layout manager.</p>
+<p>Any nested block areas or inline areas may be handled by the layout
manager at a later stage.</p>
</div>
-
-<a name="N101F7"></a><a name="Using+Managers"></a>
+
+<a name="N10203"></a><a name="using"></a>
<h3>Using Managers</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Block area layout managers are used to create a block area, other block
-level managers may ask their child layout managers to create block areas
-which are then added to the area tree (subset).
- </p>
-<p>
-A manager is used to add areas to a page until the page is full,
-then the manages contain all the information necessary to make
-the decision about page break and spacing. A manager can split an
-area that it has created will keep a status about what has been
-added to the current area tree.
- </p>
+<p>Block area layout managers are used to create a block area, other block
level managers may ask their child layout managers to create block areas which
are then added to the area tree(subset).</p>
+<p>A manager is used to add areas to a page until the page is full, then the
manages contain all the information necessary to make the decision about page
break and spacing.
+A manager can split an area that it has created will keep a status about
what has been added to the current area tree.</p>
</div>
-
-<a name="N10204"></a><a name="Page+Layout"></a>
+
+<a name="N10210"></a><a name="page"></a>
<h3>Page Layout</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Once the Page layout manager, belonging to the page sequence, is ready
-then we can start laying out each page. The page sequence will create
-the current page to put the page data, the next page and if it exists
-a last page.
- </p>
-<p>
-The current page will have the areas added to it from the block layout
-managers. The next page will be used when splitting a block that goes
-over the page break. Note: any page break overrides the layout decided
-here. The last page will be necessary if the last block area is added
-to this page. The size of the last page will be considered and the
-areas will be added to the last page instead.
- </p>
-<p>
-The first step is to add areas to the current page until the area is full
-and the lines of the last block area contain at least n(orphans) and at least
-n(orphans) + n(widows) in total. This will only be relevant for areas at
-the start or end of a particular reference area.
- </p>
-<p>
- <!--img src="page.svg" alt="Diagram of Page Layout"/-->
-
-</p>
-<p>
-The spacing between the areas (including spacing in block areas inside
-an inline-container) will be set to the minimum values. This will allow
-the page to have at least all the information it needs to organise the
-page properly.
- </p>
-<p>
-This should handle the situation where there are keeps on some
-block areas that go over the end of the page better. It is possible that
-fitting the blocks on the page using a spacing between min and optimum
-would give a closer value to the optimum than putting the blocks on the
-next page and the spacing being between optimum and max. So if the objects
-are placed first at optimum then you will need to keep going to see if
-there is a lower keep further on that has a spacing that is closer to the
-optimum.
- </p>
-<p>
-The spacing and keep information is stored so that the area positions
-and sizes can be adjusted.
- </p>
+<p>Once the Page layout manager, belonging to the page sequence, is ready
then we can start laying out each page.
+The page sequence will create the current page to put the page data, the
next page and if it exists
+a last page.</p>
+<p>The current page will have the areas added to it from the block layout
+managers.
+The next page will be used when splitting a block that goes over the page
break.
+Note: any page break overrides the layout decided here.
+The last page will be necessary if the last block area is added to this page.
+The size of the last page will be considered and the areas will be added to
the last page instead.</p>
+<p>The first step is to add areas to the current page until the area is full
and the lines of the last block area contain at least n(orphans) and at least
n(orphans) + n(widows) in total.
+This will only be relevant for areas at the start or end of a particular
reference area.</p>
+<p>The spacing between the areas (including spacing in block areas inside an
inline-container) will be set to the minimum values.
+This will allow the page to have at least all the information it needs to
organise the page properly.</p>
+<p>This should handle the situation where there are keeps on some block
areas that go over the end of the page better.
+It is possible that fitting the blocks on the page using a spacing between
min and optimum would give a closer value to the optimum than putting the
blocks on the next page and the spacing being between optimum and max.
+So if the objects are placed first at optimum then you will need to keep
going to see if there is a lower keep further on that has a spacing that is
closer to the optimum.</p>
+<p>The spacing and keep information is stored so that the area positions
+and sizes can be adjusted.</p>
</div>
-
-<a name="N10222"></a><a name="Balancing+Page"></a>
+
+<a name="N1022B"></a><a name="page-balance"></a>
<h3>Balancing Page</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The page is vertically justified so that it distributes the areas
-on the page for the best result when considering keeps and spacing.
- </p>
+<p>The page is vertically justified so that it distributes the areas on the
page for the best result when considering keeps and spacing.</p>
</div>
-
-<a name="N1022C"></a><a name="Finding+Break"></a>
+
+<a name="N10235"></a><a name="finding-break"></a>
<h3>Finding Break</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-First the keeps are checked. The available space on the page may have
-changed due to the presence of before floats or footnotes. The page break
-will need to be at a height <= the available space on the page.
- </p>
-<p>
-A page break should be made at the first available position that
-has the lowest keep value when searching from the bottom. Once the first
-possible break is found then the next possible break, with equally low
-keep value, is considered. If the height of the page is closer to the
-optimal spacing then this break will be used instead.
- </p>
-<p>
-Keep values include implicit and explicit values when trying to
-split a block area into more than one area. Implicit keeps may
-be such things as widows/orphans.
- </p>
-<p>
-If the page contains before floats or footnotes then as each area or line
-area is removed the float/footnote should also be removed. This will
-change the available space and is a one way operation. The footnote
-should be removed first as a footnote may be placed on the next page.
-The lowest keep value may need to be reassessed as each conditional
-area is removed.
- </p>
-<p>
-The before float and footnote regions are managed so that the separator
-regions will be present if it contains at least one area.
- </p>
+<p>First the keeps are checked.
+The available space on the page may have changed due to the presence of
before floats or footnotes.
+The page break will need to be at a height <= the available space on the
page.</p>
+<p>A page break should be made at the first available position that has the
lowest keep value when searching from the bottom.
+Once the first possible break is found then the next possible break, with
equally low keep value, is considered.
+If the height of the page is closer to the optimal spacing then this break
will be used instead.</p>
+<p>Keep values include implicit and explicit values when trying to split a
block area into more than one area.
+Implicit keeps may be such things as widows/orphans.</p>
+<p>If the page contains before floats or footnotes then as each area or line
area is removed the float/footnote should also be removed.
+This will change the available space and is a one way operation.
+The footnote should be removed first as a footnote may be placed on the next
page.
+The lowest keep value may need to be reassessed as each conditional area is
removed.</p>
+<p>The before float and footnote regions are managed so that the separator
+regions will be present if it contains at least one area.</p>
</div>
-
-<a name="N10242"></a><a name="Optimising"></a>
+
+<a name="N1024B"></a><a name="optimize"></a>
<h3>Optimising</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Once the areas for the page are finalised then the spacing will
-need to be adjusted. The available height on the page is compared
-with the min and max spacing. All of the spacing in all the areas
-on the page is then adjusted by the appropriate percentage value.
- </p>
+<p>Once the areas for the page are finalised then the spacing will need to
be adjusted.
+The available height on the page is compared with the min and max spacing.
+All of the spacing in all the areas on the page is then adjusted by the
appropriate percentage value.</p>
</div>
-
-<a name="N1024C"></a><a name="Multi-Column+Pages"></a>
+
+<a name="N10255"></a><a name="multi-column"></a>
<h3>Multi-Column Pages</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-In the case of multi-column pages the column breaks and eventually
-the page break must be found in a slightly different way.
- </p>
-<p>
-The columns need to be layed out completely from first to last but
-this can only be done after a rough estimate of all the elements
-on the page in case of before floats or footnotes.
- </p>
-<p>
-So first the complete page is layed out with all columns filled
-with areas and the spacing at a minimum. Then if there are any
-before floats or footnotes then the availabe space is adjusted.
-Then each the best break is found for each column starting from
-the first column. If any before floats or footnotes are removed
-as a result of the new breaks and optimised spacing then all the
-columns should still be layed out for the same column height.
- </p>
+<p>In the case of multi-column pages the column breaks and eventually the
page break must be found in a slightly different way.</p>
+<p>The columns need to be layed out completely from first to last but this
can only be done after a rough estimate of all the elements on the page in case
of before floats or footnotes.</p>
+<p>So first the complete page is layed out with all columns filled with
areas and the spacing at a minimum.
+Then if there are any before floats or footnotes then the availabe space is
adjusted.
+Then each the best break is found for each column starting from the first
column.
+If any before floats or footnotes are removed as a result of the new breaks
and optimised spacing then all the columns should still be layed out for the
same column height.</p>
</div>
-
-<a name="N1025C"></a><a name="Completing+Page"></a>
+
+<a name="N10265"></a><a name="page-complete"></a>
<h3>Completing Page</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-After the region body has been finished the static areas can be
-layed out. The width of the static area is set and the height is
-inifinite, that is all block areas should be placed in the area
-and their visibility is controlled be other factors.
- </p>
-<p>
-The area tree for the region body will contain the information
-about markers that may be necessary for the retrieve marker.
- </p>
-<p>
-The ordering of the area tree must be adjusted so that the areas are
-before, start, body, end and after in that order. The body region
-should be in the order before float, main then footnote.
- </p>
+<p>After the region body has been finished the static areas can be layed out.
+The width of the static area is set and the height is inifinite, that is all
block areas should be placed in the area and their visibility is controlled be
other factors.</p>
+<p>The area tree for the region body will contain the information about
markers that may be necessary for the retrieve marker.</p>
+<p>The ordering of the area tree must be adjusted so that the areas are
before, start, body, end and after in that order.
+The body region should be in the order before float, main then footnote.</p>
</div>
-
-<a name="N1026C"></a><a name="Line+Areas"></a>
+
+<a name="N10275"></a><a name="line-area"></a>
<h3>Line Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Creating a line areas uses a similair concept. Each inline area
-is placed across the available space until there is no room left.
-The line is then split by considering all keeps and spacing.
- </p>
-<p>
-Each word (group of adjacent character inline areas) will have keeps
-based on hyphenation. The line break is at the lowest keep value
-starting from the end of the line.
- </p>
-<p>
-Once a line has been layed out for a particular width
-then that line is fixed for the page (except for unresolved
-page references).
- </p>
+<p>Creating a line areas uses a similair concept.
+Each inline area is placed across the available space until there is no room
left.
+The line is then split by considering all keeps and spacing.</p>
+<p>Each word (group of adjacent character inline areas) will have keeps
based on hyphenation.
+The line break is at the lowest keep value starting from the end of the
line.</p>
+<p>Once a line has been layed out for a particular width then that line is
fixed for the page (except for unresolved page references).</p>
</div>
-
-<a name="N1027C"></a><a name="Before+Floats+and+Footnotes"></a>
+
+<a name="N10285"></a><a name="before-float-footnote"></a>
<h3>Before Floats and Footnotes</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The before float region and footnote region are handled by the page
-layoutmanger. These regions will handle the addition and removal
-of the separator regions when before floats/footnotes area added
-and removed.
- </p>
+<p>The before float region and footnote region are handled by the page
layoutmanger.
+These regions will handle the addition and removal of the separator regions
when before floats/footnotes area added and removed.</p>
+<p>Footnotes and Before Floats are placed in special areas in the body region
+of the page.
+The size of these areas is determined by the content.
+This in turn effects the available size of the main reference area that
contains the flow.</p>
+<p>A layout manager handles the adding and removing of footnotes/floats,
this in turn effects the available space in the main reference area.</p>
</div>
-
-<a name="N10286"></a><a name="Side+Floats"></a>
+
+<a name="N10295"></a><a name="side-float"></a>
<h3>Side Floats</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-If a float anchor is present in a particular line area then the available
-space for that line (and other in the block) will be reduced. The side float
-adds to the height of the block area and this height also depends
-on the clear value of subsequent blocks. The keep status of the block is
-also effected as there must be enough space on the page to fit the
-side float.
- </p>
-<p>
-<!--img src="float.svg" alt="Diagram of Float"/-->
-
-</p>
+<p>If a float anchor is present in a particular line area then the available
space for that line (and other in the block) will be reduced.
+The side float adds to the height of the block area and this height also
depends on the clear value of subsequent blocks.
+The keep status of the block is also effected as there must be enough space
on the page to fit the
+side float.</p>
+<p>Side floats alter the length of the inline progression dimension for the
+current line and following lines for the size of the float.</p>
+<p>This means that the float needs to be handled by the block layout manager
+so that it can adjust the available inline progression dimension for the
+relevant line areas.</p>
</div>
-
-<a name="N10295"></a><a name="Unresolved+Areas"></a>
+
+<a name="N102A7"></a><a name="unresolved-area"></a>
<h3>Unresolved Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Once the layout of the page is complete there may be unresolved areas.
- </p>
-<p>
-Page number citations and links may require following pages to be
-layed out before they can be resolved. These will remain in the
-area tree as unresolved areas.
- </p>
-<p>
-As each page is completed the list of unresolved id's will be checked
-and if the id can be resolved it will be. Once all id's are resolved
-then the page can be rendered.
- </p>
-<p>
-Each page contains a map of all unresolved id's and the corresponding
-areas.
- </p>
-<p>
-In the case of page number citations. The areas reserves the equivalent
-of 3 number nines in the current font. When the area is resolved
-then the area is adjusted to its proper size and the line area is
-re-aligned to accomodate the change.
- </p>
+<p>Once the layout of the page is complete there may be unresolved areas.</p>
+<p>Page number citations and links may require following pages to be layed
out before they can be resolved.
+These will remain in the area tree as unresolved areas.</p>
+<p>As each page is completed the list of unresolved id's will be checked and
if the id can be resolved it will be.
+Once all id's are resolved then the page can be rendered.</p>
+<p>Each page contains a map of all unresolved id's and the corresponding
areas.</p>
+<p>In the case of page number citations, the areas reserves the equivalent
of 3 number nines in the current font.
+When the area is resolved then the area is adjusted to its proper size and
the line area is
+re-aligned to accomodate the change.</p>
</div>
-
-<a name="N102AB"></a><a name="ID+and+Link+Areas"></a>
+
+<a name="N102BD"></a><a name="id-link-area"></a>
<h3>ID and Link Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Any formatting object that has an ID or any inline link defines an area
-that will be required when rendering and resolving id references.
- </p>
-<p>
-This area is stored in the parent area and may be a shape that exists
-in more than one page, for example over a page break. This shape consists
-of the boundary of all inline (or block) areas that the shape is defined
-for.
- </p>
+<p>Any formatting object that has an ID or any inline link defines an area
that will be required when rendering and resolving id references.</p>
+<p>This area is stored in the parent area and may be a shape that exists
+in more than one page, for example over a page break.
+This shape consists of the boundary of all inline (or block) areas that the
shape is defined for.</p>
</div>
-
-<a name="N102B8"></a><a name="Inline+Areas"></a>
+
+<a name="N102CA"></a><a name="inline-area"></a>
<h3>Inline Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-This is the definition of all inline areas that will exist in the
-area.
- </p>
+<p>This is the definition of all inline areas that will exist in the
area.</p>
</div>
-
-<a name="N102C2"></a><a name="Fixed+Areas"></a>
+
+<a name="N102D4"></a><a name="fixed-area"></a>
<h3>Fixed Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-instream-foreign-object, external-graphic, inline-container
- </p>
-<p>
-These areas have a fixed width and height. They also have a viewport.
- </p>
+<p>instream-foreign-object, external-graphic, inline-container</p>
+<p>These areas have a fixed width and height. They also have a viewport.</p>
</div>
-
-<a name="N102CF"></a><a name="Stretch+Areas"></a>
+
+<a name="N102E1"></a><a name="stretch-area"></a>
<h3>Stretch Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-leader, inline space
- </p>
-<p>
-These areas have a fixed height but the width may vary.
- </p>
+<p>leader, inline space</p>
+<p>These areas have a fixed height but the width may vary.</p>
</div>
-
-<a name="N102DC"></a><a name="Character+Areas"></a>
+
+<a name="N102EE"></a><a name="character-area"></a>
<h3>Character Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-character
- </p>
-<p>
-This is an simple character that has fixed properties according to
-the current font. There are implicit keeps with adjacent characters.
- </p>
+<p>character</p>
+<p>This is an simple character that has fixed properties according to the
current font.
+There are implicit keeps with adjacent characters.</p>
</div>
-
-<a name="N102E9"></a><a name="Anchor+Areas"></a>
+
+<a name="N102FB"></a><a name="anchor-area"></a>
<h3>Anchor Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-float anchor, footnote anchor
- </p>
-<p>
-This area has no size. It keeps the position for footnotes and floats
-and has a keep with the associated inline area.
- </p>
+<p>float anchor, footnote anchor</p>
+<p>This area has no size.
+It keeps the position for footnotes and floats and has a keep with the
associated inline area.</p>
</div>
-
-<a name="N102F6"></a><a name="Unresolved+Page+Numbers"></a>
+
+<a name="N10308"></a><a name="unresolved-page-num"></a>
<h3>Unresolved Page Numbers</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-page-number-citation
- </p>
-<p>
-A page number area that needs resolving, behaves as a character and
-has the space of 3 normal characters reserved. The size will adjust
-when the value is resolved.
- </p>
+<p>page-number-citation</p>
+<p>A page number area that needs resolving, behaves as a character and has
the space of 3 normal characters reserved.
+The size will adjust when the value is resolved.</p>
</div>
-
-<a name="N10303"></a><a name="Block+Areas"></a>
+
+<a name="N10315"></a><a name="block-area"></a>
<h3>Block Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-The block area has info about the following:
- </p>
+<p>When a block creating element is complete then it is possible to build the
+block area and add it to the paprent.</p>
+<p>A block area will contain either more block areas or line areas, which are
+special block areas.
+The line areas are created by the LineLayoutManager in which the inline
areas flow into.</p>
+<p>So a block area manager handles the lines or blocks as its children and
determines things like spacing and breaks.</p>
+<p>In the case of tables and lists the blocks are stacked in a specific way
that needs to be handled by the layout manager.</p>
+<p>The block area has info about the following:</p>
<ul>
-
+
<li>all anchors including which lines they are on</li>
-
+
<li>unresolved page references with line info</li>
-
+
<li>id and link areas</li>
-
+
<li>height (min/max/optimum) or area including floats</li>
-
+
<li>holds space before/after and keep information</li>
-
+
<li>widows and orphans</li>
-
+
</ul>
-<p>
-Once the layout has been finalised then this information can be
-discarded.
- </p>
+<p>Once the layout has been finalised then this information can be
discarded.</p>
</div>
-
-<a name="N10325"></a><a name="Page+Areas"></a>
+
+<a name="N10343"></a><a name="page-area"></a>
<h3>Page Areas</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Contains inforamtion about all the block areas in the body,
-before area and footer area.
- </p>
-<p>
-Has a list of the unresolved page references and a list of id refences
-that can be used to obtain the area associated with that id.
- </p>
+<p>Contains inforamtion about all the block areas in the body, before area
and footer area.</p>
+<p>Has a list of the unresolved page references and a list of id refences
that can be used to obtain the area associated with that id.</p>
</div>
-
-<a name="N10332"></a><a name="Test+Cases"></a>
+
+<a name="N10350"></a><a name="test-cases"></a>
<h3>Test Cases</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-Here a few layout possibilities areas explored to determine how the
-layout process will handle these situations.
- </p>
-<a name="N1033B"></a><a name="Simple+Pages"></a>
+<p>Here a few layout possibilities areas explored to determine how the
layout process will handle these situations.</p>
+<a name="N10359"></a><a name="test-simple"></a>
<h4>Simple Pages</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-All blocks (including nested) are placed on the page with minimum spacing
-and the last block has the minimum number of lines past the page end.
-The lowest keep value is then found within the body area limits. Then the
next
-equally low keep is found to determine if the spacing will be closer to
-the optimum values.
- </p>
+<p>All blocks (including nested) are placed on the page with minimum spacing
and the last block has the minimum number of lines past the page end.
+The lowest keep value is then found within the body area limits.
+Then the next equally low keep is found to determine if the spacing will be
closer to the optimum values.</p>
</div>
-<a name="N10345"></a><a name="Before+Floats%2FFootnotes"></a>
+<a name="N10363"></a><a name="test-before-float-footnote"></a>
<h4>Before Floats/Footnotes</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-After filling the page with the block areas then the new body height
-is used to find the best position to break. Before each line area or block
-area is remove any associated before floats and footnotes are removed.
-This will then adjust the available space on the page and may allow
-for a different breaking point. Areas are removed towards the new
-breaking point until the areas fit on the page. When finding the
-optimum spacing the removal of before floats and footnotes must also
-be considered.
- </p>
+<p>After filling the page with the block areas then the new body height is
used to find the best position to break.
+Before each line area or block area is remove any associated before floats
and footnotes are removed.
+This will then adjust the available space on the page and may allow for a
different breaking point.
+Areas are removed towards the new breaking point until the areas fit on the
page.
+When finding the optimum spacing the removal of before floats and footnotes
must also be onsidered.</p>
</div>
-<a name="N1034F"></a><a name="Multicolumn"></a>
+<a name="N1036D"></a><a name="test-multi-column"></a>
<h4>Multicolumn</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-First the page is filled with all columns for the intial page area.
-Then each column is adjusted for the new height starting from the
-first column. The best break for the column is found then the next
-column is considered, any left over areas a pre-pended to the next
-column. Once all the columns are finished then all the columns are
-adjusted to fit in the same height columns. This handles the situation
-where before floats or footnotes may have been removed.
- </p>
+<p>First the page is filled with all columns for the intial page area.
+Then each column is adjusted for the new height starting from the first
column.
+The best break for the column is found then the next column is considered,
any left over areas a pre-pended to the next column.
+Once all the columns are finished then all the columns are adjusted to fit
in the same height columns.
+This handles the situation where before floats or footnotes may have been
removed.</p>
</div>
-<a name="N10359"></a><a name="Last+Page"></a>
+<a name="N10377"></a><a name="test-last-page"></a>
<h4>Last Page</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
-If in the process of adding areas to a page it is found that there
-are no more areas in the flow then this page will need to be changed to
-the last page (if applicable). The areas are then placed on a last
-page.
- </p>
+<p>If in the process of adding areas to a page it is found that there are no
more areas in the flow then this page will need to be changed to the last page
(if applicable).
+The areas are then placed on a last page.</p>
</div>
</div>
-
-
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
</tr>
1.6 +179 -179 xml-site/targets/fop/design/layout.pdf
<<Binary file>>
1.13 +24 -6 xml-site/targets/fop/design/optimise.html
Index: optimise.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/optimise.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- optimise.html 21 Apr 2003 00:50:31 -0000 1.12
+++ optimise.html 23 Apr 2003 03:40:07 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -149,6 +149,24 @@
<li>
<a href="renderers.html">Renderers</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
</li>
</ul>
1.13 +177 -76 xml-site/targets/fop/design/properties.html
Index: properties.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/properties.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- properties.html 21 Apr 2003 00:50:31 -0000 1.12
+++ properties.html 23 Apr 2003 03:40:08 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -228,64 +246,83 @@
</p>
<ul class="minitoc">
<li>
-<a href="#Property+datatypes">Property datatypes</a>
+<a href="#datatypes">Property datatypes</a>
+</li>
+<li>
+<a href="#makers">Property Makers</a>
+</li>
+<li>
+<a href="#attribute-list">Processing the attribute list</a>
</li>
<li>
-<a href="#Property+Makers">Property Makers</a>
+<a href="#maker-design">How the Property Maker works</a>
</li>
<li>
-<a href="#XML+property+specification+format">XML property specification
format</a>
+<a href="#property-list-struct">Structure of the PropertyList</a>
+</li>
+<li>
+<a href="#property-spec">XML property specification format</a>
<ul class="minitoc">
<li>
-<a href="#Generic+properties">Generic properties</a>
+<a href="#generic">Generic properties</a>
</li>
<li>
-<a href="#Element-specific+properties">Element-specific properties</a>
+<a href="#element-specific">Element-specific properties</a>
</li>
<li>
-<a href="#Reference+properties">Reference properties</a>
+<a href="#reference">Reference properties</a>
</li>
<li>
-<a href="#Corresponding+properties">Corresponding properties</a>
+<a href="#corresponding">Corresponding properties</a>
</li>
</ul>
</li>
<li>
-<a href="#Mapping">Mapping</a>
+<a href="#mapping">Mapping</a>
</li>
<li>
-<a href="#Enumerated+values">Enumerated values</a>
+<a href="#enumerated">Enumerated values</a>
</li>
<li>
-<a href="#Compound+property+types">Compound property types</a>
+<a href="#compound">Compound property types</a>
</li>
</ul>
-
-
-<a name="N101C8"></a><a name="Property+datatypes"></a>
+
+<p>During XML Parsing, the FO tree is constructed. For each FO object (some
+subclass of FObj), the tree builder then passes the list of all
+attributes specified on the FO element to the handleAttrs method. This
+method converts the attribute specifications into a PropertyList.</p>
+
+<p>The actual work is done by a PropertyListBuilder (PLB for short). The
+basic idea of the PLB is to handle each attribute in the list in turn,
+find an appropriate "Maker" for it, call the Maker to convert the
+attribute value into a Property object of the correct type, and store
+that Property in the PropertyList.</p>
+
+<a name="N101CE"></a><a name="datatypes"></a>
<h3>Property datatypes</h3>
<div style="margin-left: 0 ; border: 2px">
<p>The property datatypes are defined in the
org.apache.fop.datatypes package, except Number and String which are java
primitives. The FOP datatypes are:</p>
<ul>
-
+
<li>Number</li>
-
+
<li>String</li>
-
+
<li>ColorType</li>
-
+
<li>Length (has several subclasses)</li>
-
+
<li>CondLength (compound)</li>
-
+
<li>LengthRange (compound)</li>
-
+
<li>Space (compound)</li>
-
+
<li>Keep (compound)</li>
-
+
</ul>
<p>The <em>org.apache.fop.fo.Property</em> class is the superclass for all
Property subclasses. There is a subclass for each kind of property
@@ -308,9 +345,8 @@
reasonable value for other accessor types. For example, a
SpaceProperty will return the optimum value if asked for a Length.</p>
</div>
-
-
-<a name="N101FC"></a><a name="Property+Makers"></a>
+
+<a name="N10202"></a><a name="makers"></a>
<h3>Property Makers</h3>
<div style="margin-left: 0 ; border: 2px">
<p>The Property class contains a nested class called
@@ -332,12 +368,88 @@
substitutions, whether the property can be inherited or not, which
enumerated values are legal, default values, corresponding properties
and specific datatype conversions.</p>
+<p>The PLB finds a "Maker" for the property based on the attribute name and
+the element name. Most Makers are generic and handle the attribute on
+any element, but it's possible to set up an element-specific property
+Maker. The attribute name to Maker mappings are automatically created
+during the code generation phase by processing the XML property
+description files.</p>
</div>
-
-<a name="N1020F"></a><a name="XML+property+specification+format"></a>
+
+<a name="N10218"></a><a name="attribute-list"></a>
+<h3>Processing the attribute list</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The PLB first looks to see if the font-size property is specified, since
+it sets up relative units which can be used in other property
+specifications. Each attribute is then handled in turn. If the attribute
+specifies part of a compound property such as space-before.optimum, the
+PLB looks to see if the attribute list also contains the "base" property
+(space-before in this case) and processes that first.</p>
+</div>
+
+<a name="N10222"></a><a name="maker-design"></a>
+<h3>How the Property Maker works</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>There is a family of Maker objects for each of the property datatypes,
+such as Length, Number, Enumerated, Space, etc. But since each Property
+has specific aspects such as whether it's inherited, its default value,
+its corresponding properties, etc. there is usually a specific Maker for
+each Property. All these Maker classes are created during the code
+generation phase by processing (using XSLT) the XML property description
+files to create Java classes.</p>
+<p>The Maker first checks for "keyword" values for a property. These are
+things like "thin, medium, thick" for the border-width property. The
+datatype is really a Length but it can be specified using these keywords
+whose actual value is determined by the "User Agent" rather than being
+specified in the XSL standard. For FOP, these values are currently
+defined in foproperties.xml. The keyword value is just a string, so it
+still needs to be parsed as described next.</p>
+<p>The Maker also checks to see if the property is an Enumerated type and
+then checks whether the value matches one of the specified enumeration
+values.</p>
+<p>Otherwise the Maker uses the property parser in the fo.expr package to
+evaluate the attribute value and return a Property object. The parser
+interprets the expression language and performs numeric operations and
+function call evaluations.</p>
+<p>If the returned Property value is of the correct type (specificed in
+foproperties.xml, where else?), the Maker returns it. Otherwise, it may
+be able to convert the returned type into the correct type.</p>
+<p>Some kinds of property values can't be fully resolved during FO tree
+building because they depend on layout information. This is the case of
+length values specified as percentages and of the special
+proportional-column-width(x) specification for table-column widths.
+These are stored as special kinds of Length objects which are evaluated
+during layout. Expressions involving "em" units which are relative to
+font-size _are_ resolved during the FO tree building however.</p>
+</div>
+
+<a name="N1023B"></a><a name="property-list-struct"></a>
+<h3>Structure of the PropertyList</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The PropertyList extends HashMap and its basic function is to associate
+Property value objects with Property names. The Property objects are all
+subclasses of the base Property class. Each one simply contains a
+reference to one of the property datatype objects. Property provides
+accessors for all known datatypes and various subclasses override the
+accessor(s) which are reasonable for the datatype they store.</p>
+<p>The PropertyList itself provides various ways of looking up Property
+values to handle such issues as inheritance and corresponding
+properties.</p>
+<p>The main logic is:<br>If the property is a writing-mode relative property
(using start, end,
+before or after in its name), the corresponding absolute property value
+is returned if it's explicitly set on this FO. <br>Otherwise, the
+writing-mode relative value is returned if it's explicitly set. If the
+property is inherited, the process repeats using the PropertyList of the
+FO's parent object. (This is easy because each PropertyList points to
+the PropertyList of the nearest ancestor FO.) If the property isn't
+inherited or no value is found at any level, the initial value is
+returned.</p>
+</div>
+
+<a name="N1024F"></a><a name="property-spec"></a>
<h3>XML property specification format</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10215"></a><a name="Generic+properties"></a>
+<a name="N10255"></a><a name="generic"></a>
<h4>Generic properties</h4>
<div style="margin-left: 0 ; border: 2px">
<p>In the properties xml files, one can define generic property
@@ -348,15 +460,14 @@
the inherited or default elements, these should be set in each property
which is based on GenericColor. Here is an example:</p>
<p>
-
-<span class="codefrag">
- <property type='generic'>
+
+<span class="codefrag"><property type='generic'>
<name>background-color</name>
<use-generic>GenericColor</use-generic>
<inherited>false</inherited>
<default>transparent</default>
- </property>
-</span>
+ </property></span>
+
</p>
<p>A generic property specification can include all of the elements
defined for the property element in the DTD, including the description
@@ -367,23 +478,20 @@
An example is GenericCondPadding template which is based on the
GenericCondLength definition but which extends it by adding an inherited
element and a default value for the length component.</p>
-<p>
-Generic properties can specify enumerated values, as in the
+<p>Generic properties can specify enumerated values, as in the
GenericBorderStyle template. This means that the list of values, which
is used by 8 properties (the "absolute" and "writing-mode-relative"
variants for each BorderStyle property) is only specified one time.</p>
-<p>
-When a property includes a "use-generic" element and includes no other
+<p>When a property includes a "use-generic" element and includes no other
elements (except the "name" element), then no class is generated for the
property. Instead the generated mapping will associate this
property directly with an instance of the generic Maker.</p>
-<p>
-A generic class may also be hand-coded, rather than generated from the
+<p>A generic class may also be hand-coded, rather than generated from the
properties file.
Properties based on such a generic class are indicated by the
attribute <span class="codefrag">ispropclass='true'</span> on the
<em>use-generic</em> element.</p>
-<p> This is illustrated by the SVG properties, most of
+<p>This is illustrated by the SVG properties, most of
which use one of the Property subclasses defined in the
<em>org.apache.fop.svg</em>
package. Although all of these properties are now declared in
@@ -391,7 +499,7 @@
generated for those SVG properties which are not based on generic
classes defined in svg.</p>
</div>
-<a name="N1023F"></a><a name="Element-specific+properties"></a>
+<a name="N10280"></a><a name="element-specific"></a>
<h4>Element-specific properties</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Properties may be defined for all flow objects or only for
@@ -402,15 +510,15 @@
files. The <span class="codefrag">localname</span> element children of this
element specify for
which flow-object elements the property should be registered.</p>
<p>
+
<em>NOTE</em>: All the properties for an object or set of objects
must be specified in a single element-property-list element. If the
same localname appears in several element lists, the later set of
properties will hide the earlier ones! Use the <em>ref</em>
functionality if the same property is to be used in different sets of
-element-specific mappings.
-</p>
+element-specific mappings.</p>
</div>
-<a name="N10257"></a><a name="Reference+properties"></a>
+<a name="N10299"></a><a name="reference"></a>
<h4>Reference properties</h4>
<div style="margin-left: 0 ; border: 2px">
<p>A property element may have a type attribute with the value
@@ -427,7 +535,7 @@
reference the defined FO properties. The generating mapping for the
SVG properties will use the FO Maker classes.</p>
</div>
-<a name="N10270"></a><a name="Corresponding+properties"></a>
+<a name="N102B2"></a><a name="corresponding"></a>
<h4>Corresponding properties</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Some properties have both <em>absolute</em> and
@@ -438,26 +546,23 @@
was specified on the FO; otherwise the corresponding relative property
will be used if it was specified. However, a request for a relative
form will only use the specified relative value if the corresponding
-absolute value was <em>not</em> specified for that FO.
-</p>
+absolute value was <em>not</em> specified for that FO.</p>
<p>Corresponding properties are specified in the properties.xml files
using the element <span class="codefrag">corresponding</span>, which has at
least one
<span class="codefrag">propval</span> child and may have a <span
class="codefrag">propexpr</span> child,
if the corresponding
value is calculated based on several other properties, as for
-<span class="codefrag">start-indent</span>.
-</p>
+<span class="codefrag">start-indent</span>.</p>
<p>
+
<em>NOTE</em>: most current FOP code accesses the absolute variants
of these properties, notably for padding, border, height and width
attributes. However it does use start-indent and end-indent, rather
-than the "absolute" margin properties.
-</p>
+than the "absolute" margin properties.</p>
</div>
</div>
-
-
-<a name="N10298"></a><a name="Mapping"></a>
+
+<a name="N102DB"></a><a name="mapping"></a>
<h3>Mapping</h3>
<div style="margin-left: 0 ; border: 2px">
<p>The XSL script <span class="codefrag">propmap.xsl</span> is used to
generate
@@ -475,9 +580,8 @@
<p>The property generation also handles element-specific property
mappings as specified in the properties XML files.</p>
</div>
-
-
-<a name="N102AB"></a><a name="Enumerated+values"></a>
+
+<a name="N102EE"></a><a name="enumerated"></a>
<h3>Enumerated values</h3>
<div style="margin-left: 0 ; border: 2px">
<p>For any property whose datatype is <span class="codefrag">Enum</span> or
which
@@ -502,9 +606,8 @@
these two constants. An example of a reference in code to the constant
is <span class="codefrag">KeepTogether.WithinPage.AUTO</span>.</p>
</div>
-
-
-<a name="N102C4"></a><a name="Compound+property+types"></a>
+
+<a name="N10307"></a><a name="compound"></a>
<h3>Compound property types</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Some XSL FO properties are specified by compound datatypes. In the FO
file,
@@ -513,22 +616,21 @@
<span class="codefrag">space-before.minimum</span>. These are several
compound
datatypes:</p>
<ul>
-
+
<li>LengthConditional, with components length and conditionality</li>
-
+
<li>LengthRange, with components minimum, optimum, and maximum</li>
-
+
<li>Space, with components minimum, optimum, maximum, precedence and
conditionality </li>
-
+
<li>Keep, with components within-line, within-column and within-page</li>
-
+
</ul>
<p>These are described in the properties.xml files using the element
<span class="codefrag">compound</span> which has <span
class="codefrag">subproperty</span> children. A subproperty element is much
like a property element, although it may not have an <span
class="codefrag">inherited</span> child
-element, as only a complete property object may be inherited.
-</p>
+element, as only a complete property object may be inherited.</p>
<p>Specific datatype classes exist for each compound property. Each
component of a compound datatype is itself stored as a Property
object. Individual components may be accessed either by directly
@@ -537,10 +639,9 @@
property, eg. <span class="codefrag">get("space-before").getOptimum()</span>.
In either case,
the result is a Property object, and the actual value may be accessed
-(in this example) by using the "getLength()" accessor.
-</p>
+(in this example) by using the "getLength()" accessor.</p>
</div>
-
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
</tr>
1.6 +436 -186 xml-site/targets/fop/design/properties.pdf
<<Binary file>>
1.13 +275 -27 xml-site/targets/fop/design/renderers.html
Index: renderers.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/renderers.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- renderers.html 21 Apr 2003 00:50:31 -0000 1.12
+++ renderers.html 23 Apr 2003 03:40:08 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -154,6 +154,24 @@
</ul>
</li>
<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
<font color="#CFDCED">Miscellaneous</font>
<ul>
@@ -228,36 +246,266 @@
</p>
<ul class="minitoc">
<li>
-<a href="#Introduction">Introduction</a>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#fonts">Fonts</a>
+</li>
+<li>
+<a href="#context">Render Context</a>
+</li>
+<li>
+<a href="#XML+Handling">XML Handling</a>
+</li>
+<li>
+<a href="#Extensions">Extensions</a>
+</li>
+<li>
+<a href="#implement">Renderer Implementations</a>
+</li>
+<li>
+<a href="#add">Adding a Renderer</a>
+</li>
+<li>
+<a href="#multiple">Multiple Renderers</a>
</li>
</ul>
-
-<a name="N101C8"></a><a name="Introduction"></a>
+
+<a name="N101C8"></a><a name="intro"></a>
<h3>Introduction</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>
-A renderer is primarily designed to convert a given area tree into the output
+<p>A renderer is primarily designed to convert a given area tree into the
output
document format. It should be able to produce pages and fill the pages
with the text and graphical content. Usually the output is sent to
-an output stream.
- </p>
-<p>
-Some output formats may support extra information that is not available
-from the area tree or depends on the destination of the document.
- </p>
-<p>
-Each renderer is given an area tree to render to its output format.
+an output stream.</p>
+<p>Some output formats may support extra information that is not available
+from the area tree or depends on the destination of the document.</p>
+<p>Each renderer is given an area tree to render to its output format.
The area tree is simply a representation of the pages and the placement
-of text and graphical objects on those pages.
- </p>
-<p>
-The renderer will be given each page as it is ready and an output stream
-to write the data out. The renderer is responsible for managing the
-output format and associated data and flow.
- </p>
+of text and graphical objects on those pages.</p>
+<p>The renderer will be given each page as it is ready and an output stream
+to write the data out.
+All pages are supplied in the order they appear in the document.
+In order to save memory it is
+possble to render the pages out of order. Any page that is not ready to
+be rendered is setup by the renderer first so that it can reserve a space
+or reference for when the page is ready to be rendered.The renderer is
responsible for managing the
+output format and associated data and flow.</p>
+</div>
+
+<a name="N101DB"></a><a name="fonts"></a>
+<h3>Fonts</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Because font metrics (and therefore layout) are obtained in two different
ways depending on the renderer, the renderer actually sets up the fonts being
used. The font metrics are used
+during the layout process to determine the size of characters.</p>
+</div>
+
+<a name="N101E5"></a><a name="context"></a>
+<h3>Render Context</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The render context is used by handlers.
+It contains information about the current state of the renderer, such as the
page, the position, and any other miscellanous objects that are required to
draw into the page.</p>
+</div>
+
+<a name="N101EF"></a><a name="XML+Handling"></a>
+<h3>XML Handling</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>A document may contain information in the form of XML for an image or
instream foreign object.
+This XML is handled through the user agent.
+A standard extension for PDF is the SVG handler.</p>
+<p>If there is XML in the SVG namespace it is given to the handler which
renders the SVG into the pdf document at the given location.
+This separation means that other XML handlers can easily be added.</p>
+</div>
+
+<a name="N101FC"></a><a name="Extensions"></a>
+<h3>Extensions</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Document level extensions are handled with an extension handler.
+This handles the information from the AreaTree and adds renders it to the
document.
+An example is the pdf bookmarks. This information first needs to have all
references resolved.
+Then the extension handler is ready to put the information into the pdf
document.</p>
+</div>
+
+<a name="N10206"></a><a name="implement"></a>
+<h3>Renderer Implementations</h3>
+<div style="margin-left: 0 ; border: 2px">
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">Name</th>
+ <th colspan="1" rowspan="1">Type</th>
+ <th colspan="1" rowspan="1">Font Source</th>
+ <th colspan="1" rowspan="1">Font Embedding?</th>
+ <th colspan="1" rowspan="1">Out of Order Rendering?</th>
+ <th colspan="1" rowspan="1">Notes</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">PDF</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">FOP</td>
+ <td colspan="1" rowspan="1">Yes</td>
+ <td colspan="1" rowspan="1">Yes</td>
+ <td colspan="1" rowspan="1">Uses the PDFDocument classes to create
a PDF document. Most of the work is to insert text or create lines. SVG is
handled by the XML handler that uses the PDFGraphics2D and batik to
+draw the svg into the pdf page.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">PostScript</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">FOP</td>
+ <td colspan="1" rowspan="1">Not implemented</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">Similar to PDF.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">PCL</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">FOP</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">Similar to PDF.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">SVG</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">Creates a single svg document that
contains all the pages rendered
+with page sequences horizontally and pages vertically. Adds
+links between the pages so that it can be viewed by clicking on the page
+to go to the next page.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">TXT</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">Outputs to a text document.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">AWT</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">AWT</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">This draws the pages into an AWT
graphic.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">XML</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">FOP</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">Creates an XML file that represents
the AreaTree.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">Print</td>
+ <td colspan="1" rowspan="1">Paginated</td>
+ <td colspan="1" rowspan="1">AWT</td>
+ <td colspan="1" rowspan="1">?</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">Prints the document using the java
printing facitlities. The AWT
+rendering is used to draw the pages onto the printjob.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">RTF</td>
+ <td colspan="1" rowspan="1">Structural</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">Structural format uses a different
rendering mechanism.</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">MIF</td>
+ <td colspan="1" rowspan="1">Structural</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">N/A</td>
+ <td colspan="1" rowspan="1">No</td>
+ <td colspan="1" rowspan="1">Structural format uses a different
rendering mechanism.</td>
+
+</tr>
+
+</table>
</div>
-
+<a name="N1037B"></a><a name="add"></a>
+<h3>Adding a Renderer</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>You can add other renderers by implementing the Renderer interface.
+However, the AbstractRenderer does most of what is needed, including
iterating through the tree parts, so it is probably better to extend this.
+This means that you only need to implement the basic functionality such as
text, images, and lines.
+AbstractRenderer's methods can easily be overridden to handle things in a
different way or do some extra processing.</p>
+<p>The relevent AreaTree structures that will need to be rendered are:</p>
+<ul>
+
+<li>Page</li>
+
+<li>Viewport</li>
+
+<li>Region</li>
+
+<li>Span</li>
+
+<li>Block</li>
+
+<li>Line</li>
+
+<li>Inline</li>
+
+</ul>
+<p>A renderer implementation does the following:</p>
+<ul>
+
+<li>render each individual page</li>
+
+<li>clip and align child areas to a viewport</li>
+
+<li>handle all types of inline area, text, image etc.</li>
+
+<li>draw various lines and rectangles</li>
+
+</ul>
+</div>
+
+<a name="N103B2"></a><a name="multiple"></a>
+<h3>Multiple Renderers</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>The layout of the document depends mainly on the font being used.
+If two renderers have the same font metrics then it is possible to use the
same Area Tree to render both. This can be handled by the AreaTree Handler.</p>
+</div>
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
</tr>
1.6 +463 -48 xml-site/targets/fop/design/renderers.pdf
<<Binary file>>
1.13 +24 -6 xml-site/targets/fop/design/useragent.html
Index: useragent.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/useragent.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- useragent.html 21 Apr 2003 00:50:31 -0000 1.12
+++ useragent.html 23 Apr 2003 03:40:08 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -120,18 +120,18 @@
<li>
<a href="index.html">Introduction</a>
</li>
-
-<li>
-<a href="understanding/index.html">Understanding</a>
-</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Sections</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
+<a href="understanding/xml_parsing.html">XML Parsing</a>
+</li>
+
+<li>
<a href="fotree.html">FO Tree</a>
</li>
@@ -149,6 +149,24 @@
<li>
<a href="renderers.html">Renderers</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Extras</font>
+<ul>
+
+<li>
+<a href="understanding/images.html">Images</a>
+</li>
+
+<li>
+<a href="understanding/pdf_library.html">PDF Library</a>
+</li>
+
+<li>
+<a href="understanding/svg.html">SVG</a>
</li>
</ul>
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.12 +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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
1.12 +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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
1.12 +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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
1.11 +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.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
1.11 +1 -1
xml-site/targets/fop/design/alt.design/compound-properties.html
Index: compound-properties.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/compound-properties.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- compound-properties.html 7 Apr 2003 18:54:46 -0000 1.10
+++ compound-properties.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.8 +1 -1 xml-site/targets/fop/design/alt.design/coroutines.html
Index: coroutines.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/coroutines.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- coroutines.html 7 Apr 2003 18:54:46 -0000 1.7
+++ coroutines.html 23 Apr 2003 03:40:12 -0000 1.8
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +1 -1 xml-site/targets/fop/design/alt.design/footnotes.html
Index: footnotes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/footnotes.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- footnotes.html 7 Apr 2003 18:54:46 -0000 1.10
+++ footnotes.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +1 -1 xml-site/targets/fop/design/alt.design/galleys.html
Index: galleys.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/galleys.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- galleys.html 7 Apr 2003 18:54:46 -0000 1.10
+++ galleys.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.12 +1 -1 xml-site/targets/fop/design/alt.design/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/index.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- index.html 7 Apr 2003 18:54:46 -0000 1.11
+++ index.html 23 Apr 2003 03:40:12 -0000 1.12
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +1 -1 xml-site/targets/fop/design/alt.design/keeps.html
Index: keeps.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/keeps.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- keeps.html 7 Apr 2003 18:54:46 -0000 1.10
+++ keeps.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +1 -1 xml-site/targets/fop/design/alt.design/spaces.html
Index: spaces.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/spaces.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- spaces.html 7 Apr 2003 18:54:46 -0000 1.10
+++ spaces.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +1 -1 xml-site/targets/fop/design/alt.design/traits.html
Index: traits.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/traits.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- traits.html 7 Apr 2003 18:54:46 -0000 1.10
+++ traits.html 23 Apr 2003 03:40:12 -0000 1.11
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.10 +1 -1
xml-site/targets/fop/design/alt.design/user-agent-refs.html
Index: user-agent-refs.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/user-agent-refs.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- user-agent-refs.html 7 Apr 2003 18:54:46 -0000 1.9
+++ user-agent-refs.html 23 Apr 2003 03:40:12 -0000 1.10
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.13 +1 -1 xml-site/targets/fop/design/alt.design/xml-parsing.html
Index: xml-parsing.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/xml-parsing.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- xml-parsing.html 7 Apr 2003 18:54:46 -0000 1.12
+++ xml-parsing.html 23 Apr 2003 03:40:13 -0000 1.13
@@ -68,7 +68,7 @@
</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="../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../skin/images/tab-right.gif"></td>
+<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">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">
1.1 xml-site/targets/fop/design/alt.design/traits.pdf.html
Index: traits.pdf.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>design/alt.design/traits.pdf</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/design/alt.design/traits.pdf.html</pre></p><hr
size="1" noshade="true"/></body></html>
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.7 +1 -1
xml-site/targets/fop/design/alt.design/properties/PropertyConsts-class.html
Index: PropertyConsts-class.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyConsts-class.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- PropertyConsts-class.html 7 Apr 2003 18:54:47 -0000 1.6
+++ PropertyConsts-class.html 23 Apr 2003 03:40:15 -0000 1.7
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.21 +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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
1.6 +1 -1
xml-site/targets/fop/design/alt.design/properties/classes-overview.html
Index: classes-overview.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/classes-overview.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- classes-overview.html 7 Apr 2003 18:54:47 -0000 1.5
+++ classes-overview.html 23 Apr 2003 03:40:16 -0000 1.6
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.11 +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.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
1.6 +1 -1
xml-site/targets/fop/design/alt.design/properties/enumerated-values.html
Index: enumerated-values.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/enumerated-values.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- enumerated-values.html 7 Apr 2003 18:54:47 -0000 1.5
+++ enumerated-values.html 23 Apr 2003 03:40:16 -0000 1.6
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.6 +1 -1
xml-site/targets/fop/design/alt.design/properties/getInitialValue.html
Index: getInitialValue.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/getInitialValue.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- getInitialValue.html 7 Apr 2003 18:54:47 -0000 1.5
+++ getInitialValue.html 23 Apr 2003 03:40:16 -0000 1.6
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.5 +1 -1
xml-site/targets/fop/design/alt.design/properties/introduction.html
Index: introduction.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/introduction.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- introduction.html 7 Apr 2003 18:54:47 -0000 1.4
+++ introduction.html 23 Apr 2003 03:40:16 -0000 1.5
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.6 +1 -1
xml-site/targets/fop/design/alt.design/properties/propertyExpressions.html
Index: propertyExpressions.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/propertyExpressions.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- propertyExpressions.html 7 Apr 2003 18:54:47 -0000 1.5
+++ propertyExpressions.html 23 Apr 2003 03:40:16 -0000 1.6
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.6 +1 -1
xml-site/targets/fop/design/alt.design/properties/simple-properties.html
Index: simple-properties.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/alt.design/properties/simple-properties.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- simple-properties.html 7 Apr 2003 18:54:47 -0000 1.5
+++ simple-properties.html 23 Apr 2003 03:40:16 -0000 1.6
@@ -68,7 +68,7 @@
</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="../../index.html"><font face="Arial, Helvetica,
Sans-serif">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../../../skin/images/tab-right.gif"></td>
+<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">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">
1.8 +35 -13 xml-site/targets/fop/design/understanding/images.html
Index: images.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/understanding/images.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- images.html 7 Apr 2003 18:54:48 -0000 1.7
+++ images.html 23 Apr 2003 03:40:17 -0000 1.8
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -114,45 +114,41 @@
<div class="menu">
<ul>
<li>
-<font color="#CFDCED">Index</font>
+<font color="#CFDCED">About</font>
<ul>
<li>
-<a href="../../index.html">FOP Home</a>
+<a href="../index.html">Introduction</a>
</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Understanding the Design</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
-<a href="index.html">Understanding</a>
-</li>
-
-<li>
<a href="xml_parsing.html">XML Parsing</a>
</li>
<li>
-<a href="fo_tree.html">FO Tree</a>
+<a href="../fotree.html">FO Tree</a>
</li>
<li>
-<a href="properties.html">Properties</a>
+<a href="../properties.html">Properties</a>
</li>
<li>
-<a href="layout_managers.html">Layout Managers</a>
+<a href="../layout.html">Layout</a>
</li>
<li>
-<a href="area_tree.html">Area Tree</a>
+<a href="../areas.html">Area Tree</a>
</li>
<li>
-<a href="renderers.html">Renderers</a>
+<a href="../renderers.html">Renderers</a>
</li>
</ul>
@@ -171,6 +167,32 @@
<li>
<a href="svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Miscellaneous</font>
+<ul>
+
+<li>
+<a href="../embedding.html">Embedding</a>
+</li>
+
+<li>
+<a href="../extending.html">Extending</a>
+</li>
+
+<li>
+<a href="../breakpos.html">Break Possibility</a>
+</li>
+
+<li>
+<a href="../optimise.html">Optimisations</a>
+</li>
+
+<li>
+<a href="../useragent.html">User Agent</a>
</li>
</ul>
1.8 +35 -13
xml-site/targets/fop/design/understanding/pdf_library.html
Index: pdf_library.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/understanding/pdf_library.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- pdf_library.html 7 Apr 2003 18:54:49 -0000 1.7
+++ pdf_library.html 23 Apr 2003 03:40:17 -0000 1.8
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -114,45 +114,41 @@
<div class="menu">
<ul>
<li>
-<font color="#CFDCED">Index</font>
+<font color="#CFDCED">About</font>
<ul>
<li>
-<a href="../../index.html">FOP Home</a>
+<a href="../index.html">Introduction</a>
</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Understanding the Design</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
-<a href="index.html">Understanding</a>
-</li>
-
-<li>
<a href="xml_parsing.html">XML Parsing</a>
</li>
<li>
-<a href="fo_tree.html">FO Tree</a>
+<a href="../fotree.html">FO Tree</a>
</li>
<li>
-<a href="properties.html">Properties</a>
+<a href="../properties.html">Properties</a>
</li>
<li>
-<a href="layout_managers.html">Layout Managers</a>
+<a href="../layout.html">Layout</a>
</li>
<li>
-<a href="area_tree.html">Area Tree</a>
+<a href="../areas.html">Area Tree</a>
</li>
<li>
-<a href="renderers.html">Renderers</a>
+<a href="../renderers.html">Renderers</a>
</li>
</ul>
@@ -171,6 +167,32 @@
<li>
<a href="svg.html">SVG</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Miscellaneous</font>
+<ul>
+
+<li>
+<a href="../embedding.html">Embedding</a>
+</li>
+
+<li>
+<a href="../extending.html">Extending</a>
+</li>
+
+<li>
+<a href="../breakpos.html">Break Possibility</a>
+</li>
+
+<li>
+<a href="../optimise.html">Optimisations</a>
+</li>
+
+<li>
+<a href="../useragent.html">User Agent</a>
</li>
</ul>
1.8 +35 -13 xml-site/targets/fop/design/understanding/svg.html
Index: svg.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/design/understanding/svg.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- svg.html 7 Apr 2003 18:54:49 -0000 1.7
+++ svg.html 23 Apr 2003 03:40:17 -0000 1.8
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -114,45 +114,41 @@
<div class="menu">
<ul>
<li>
-<font color="#CFDCED">Index</font>
+<font color="#CFDCED">About</font>
<ul>
<li>
-<a href="../../index.html">FOP Home</a>
+<a href="../index.html">Introduction</a>
</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Understanding the Design</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
-<a href="index.html">Understanding</a>
-</li>
-
-<li>
<a href="xml_parsing.html">XML Parsing</a>
</li>
<li>
-<a href="fo_tree.html">FO Tree</a>
+<a href="../fotree.html">FO Tree</a>
</li>
<li>
-<a href="properties.html">Properties</a>
+<a href="../properties.html">Properties</a>
</li>
<li>
-<a href="layout_managers.html">Layout Managers</a>
+<a href="../layout.html">Layout</a>
</li>
<li>
-<a href="area_tree.html">Area Tree</a>
+<a href="../areas.html">Area Tree</a>
</li>
<li>
-<a href="renderers.html">Renderers</a>
+<a href="../renderers.html">Renderers</a>
</li>
</ul>
@@ -171,6 +167,32 @@
<li>
<span class="sel"><font color="#ffcc00">SVG</font></span>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Miscellaneous</font>
+<ul>
+
+<li>
+<a href="../embedding.html">Embedding</a>
+</li>
+
+<li>
+<a href="../extending.html">Extending</a>
+</li>
+
+<li>
+<a href="../breakpos.html">Break Possibility</a>
+</li>
+
+<li>
+<a href="../optimise.html">Optimisations</a>
+</li>
+
+<li>
+<a href="../useragent.html">User Agent</a>
</li>
</ul>
1.8 +82 -133
xml-site/targets/fop/design/understanding/xml_parsing.html
Index: xml_parsing.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/fop/design/understanding/xml_parsing.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- xml_parsing.html 7 Apr 2003 18:54:49 -0000 1.7
+++ xml_parsing.html 23 Apr 2003 03:40:17 -0000 1.8
@@ -68,7 +68,7 @@
</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">Redesign</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>
+<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">Design</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">
@@ -114,45 +114,41 @@
<div class="menu">
<ul>
<li>
-<font color="#CFDCED">Index</font>
+<font color="#CFDCED">About</font>
<ul>
<li>
-<a href="../../index.html">FOP Home</a>
+<a href="../index.html">Introduction</a>
</li>
</ul>
</li>
<li>
-<font color="#CFDCED">Understanding the Design</font>
+<font color="#CFDCED">Compliance</font>
<ul>
<li>
-<a href="index.html">Understanding</a>
-</li>
-
-<li>
<span class="sel"><font color="#ffcc00">XML Parsing</font></span>
</li>
<li>
-<a href="fo_tree.html">FO Tree</a>
+<a href="../fotree.html">FO Tree</a>
</li>
<li>
-<a href="properties.html">Properties</a>
+<a href="../properties.html">Properties</a>
</li>
<li>
-<a href="layout_managers.html">Layout Managers</a>
+<a href="../layout.html">Layout</a>
</li>
<li>
-<a href="area_tree.html">Area Tree</a>
+<a href="../areas.html">Area Tree</a>
</li>
<li>
-<a href="renderers.html">Renderers</a>
+<a href="../renderers.html">Renderers</a>
</li>
</ul>
@@ -175,6 +171,32 @@
</ul>
</li>
+<li>
+<font color="#CFDCED">Miscellaneous</font>
+<ul>
+
+<li>
+<a href="../embedding.html">Embedding</a>
+</li>
+
+<li>
+<a href="../extending.html">Extending</a>
+</li>
+
+<li>
+<a href="../breakpos.html">Break Possibility</a>
+</li>
+
+<li>
+<a href="../optimise.html">Optimisations</a>
+</li>
+
+<li>
+<a href="../useragent.html">User Agent</a>
+</li>
+
+</ul>
+</li>
</ul>
</div>
<!--================= end Menu items ==================-->
@@ -220,9 +242,6 @@
</table>
<ul class="minitoc">
<li>
-<a href="#XML+Parsing">XML Parsing</a>
-<ul class="minitoc">
-<li>
<a href="#XML+Input">XML Input</a>
</li>
<li>
@@ -232,136 +251,66 @@
<a href="#Tree+Building">Tree Building</a>
</li>
</ul>
-</li>
-</ul>
-
-<a name="N101BE"></a><a name="XML+Parsing"></a>
-<h3>XML Parsing</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>Since everyone knows the basics we can get
- into the various stages starting with the XML handling.</p>
-<a name="N101C7"></a><a name="XML+Input"></a>
-<h4>XML Input</h4>
+
+<a name="N101BE"></a><a name="XML+Input"></a>
+<h3>XML Input</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>FOP can take the input XML in a number of ways:
- </p>
+<p>FOP can take the input XML in a number of ways:</p>
<ul>
-
-<li>SAX Events through SAX Handler
- <ul>
-
-<li>
-
-<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>
-
-</ul>
-
-</li>
-
-<li>
- DOM which is converted into SAX Events
- <ul>
-
-<li>
- The conversion of a DOM tree is done via the
- <span class="codefrag">render(Document)</span> method on
- <span class="codefrag">Driver</span>.
- </li>
-
-</ul>
-
-</li>
-
+
<li>
- data source which is parsed and converted into SAX Events
- <ul>
-
-<li>
- 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>
-
-</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>
- XML+XSLT which is transformed using an XSLT Processor and
- the result is fired as SAX Events
- <ul>
-
+<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>
-
-<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>
-
-</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>XML+XSLT Transformation (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>The SAX Events which are fired on the SAX Handler, class
- <span class="codefrag">FOTreeBuilder</span>, must
represent an XSL:FO document. If not there will be an
- error. Any problems with the XML being well formed
are handled here.</p>
+<p>The SAX Events which are fired on the SAX Handler, class <span
class="codefrag">FOTreeBuilder</span>, must represent an XSL:FO document.
+If not there will be an error.
+Any problems with the XML being well-formed are also handled here.</p>
</div>
-<a name="N10228"></a><a name="Element+Mappings"></a>
-<h4>Element Mappings</h4>
+
+<a name="N1020C"></a><a name="Element+Mappings"></a>
+<h3>Element Mappings</h3>
<div style="margin-left: 0 ; border: 2px">
-<p> The element mapping is a hashmap of all
- the elements in a particular namespace. This makes
it easy to create a
- different object for each element. Element mappings
are static to save on
- memory. </p>
-<p>To add an extension a developer can put in the classpath a jar
- that contains the file <span
class="codefrag">/META-INF/services/org.apache.fop.fo.ElementMapping</span>.
- This must contain a line with the fully qualified
name of a class that
- implements the
<em>org.apache.fop.fo.ElementMapping</em> interface. This will then be
- loaded automatically at the start. Internal
mappings are: FO, SVG and Extension
- (pdf bookmarks)</p>
+<p>The element mapping is a hashmap of all the elements in a particular
namespace.
+This makes it easy to create a different object for each element.
+Element mappings are static to save on memory.</p>
+<p>To add an extension a developer can put in the classpath a jar that
contains the file <span
class="codefrag">/META-INF/services/org.apache.fop.fo.ElementMapping</span>.
+This must contain a line with the fully qualified name of a class that
implements the <em>org.apache.fop.fo.ElementMapping</em> interface.
+This will then be loaded automatically at the start.
+Internal mappings are: FO, SVG and Extension (pdf bookmarks).</p>
</div>
-<a name="N10239"></a><a name="Tree+Building"></a>
-<h4>Tree Building</h4>
+
+<a name="N1021F"></a><a name="Tree+Building"></a>
+<h3>Tree Building</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>The SAX Events will fire all the information
- for the document with start element, end element,
text data etc. This
- information is used to build up a representation of
the FO document. To do this
- for a namespace there is a set of element mappings.
When an element + namepsace
- mapping is found then it can create an object for
that element. If the element
- is not found then it creates a dummy object or a
generic DOM for unknown
- namespaces.</p>
+<p>The SAX Events will fire all the information for the document with start
element, end element, text data etc.
+This information is used to build up a representation of the FO document.
+To do this for a namespace there is a set of element mappings.
+When an element + namepsace mapping is found then it can create an object
for that element.
+If the element is not found then it creates a dummy object or a generic DOM
for unknown namespaces.</p>
<p>The object is then setup and then given attributes for the element.
- For the FO Tree the attributes are converted into
properties. The FO objects
- use a property list mapping to convert the
attributes into a list of properties
- for the element. For other XML, for example SVG, a
DOM of the XML is
- constructed. This DOM can then be passed through to
the renderer. Other element
- mappings can be used in different ways, for example
to create elements that
- create areas during the layout process or setup
information for the renderer
- etc.</p>
-<p>
- While the tree building is mainly about creating the FO Tree
- there are some stages that can propagate to the renderer. At
- the end of a page sequence we know that all pages in the
- page sequence can be laid out without being effected by any
- further XML. The significance of this is that the FO Tree
- for the page sequence may be able to be disposed of. The
- end of the XML document also tells us that we can finalise
- the output document. (The layout of individual pages is
- accomplished by the layout managers page at a time;
- i.e. they do not need to wait for the end of the page
- sequence. The page may not yet be complete, however,
- containing forward page number references, for example.)
- </p>
-</div>
+For the FO Tree the attributes are converted into properties.
+The FO objects use a property list mapping to convert the attributes into a
list of properties for the element.
+For other XML, for example SVG, a DOM of the XML is constructed.
+This DOM can then be passed through to the renderer.
+Other element mappings can be used in different ways, for example to create
elements that create areas during the layout process or setup information for
the renderer etc.</p>
+<p>While the tree building is mainly about creating the FO Tree there are
some stages that can propagate to the renderer.
+At the end of a page sequence we know that all pages in the page sequence
can be laid out without being effected by any further XML.
+The significance of this is that the FO Tree for the page sequence may be
able to be disposed of.
+The end of the XML document also tells us that we can finalise the output
document.
+(The layout of individual pages is accomplished by the layout managers page
at a time; i.e. they do not need to wait for the end of the page sequence.
+The page may not yet be complete, however, containing forward page number
references, for example.)</p>
</div>
-
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../../skin/images/spacer.gif"></td>
</tr>
1.4 +62 -79 xml-site/targets/fop/design/understanding/xml_parsing.pdf
<<Binary file>>
1.12 +9 -19 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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- examples.html 21 Apr 2003 00:50:33 -0000 1.11
+++ examples.html 23 Apr 2003 03:40:18 -0000 1.12
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.13 +48 -113 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- extensions.html 21 Apr 2003 00:50:33 -0000 1.12
+++ extensions.html 23 Apr 2003 03:40:18 -0000 1.13
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Extensions to FOP</title>
+<title>Adding an Extension to FOP</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<span class="sel"><font color="#ffcc00">Extensions</font></span>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Extensions</font></span>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -202,6 +188,10 @@
</li>
<li>
+<a href="doc.html">Doc Mgmt</a>
+</li>
+
+<li>
<a target="_blank"
href="http://cvs.apache.org/viewcvs.cgi/xml-fop";>ViewCVS</a>
</li>
@@ -245,122 +235,67 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Extensions to FOP</h1>
+<h1>Adding an Extension to FOP</h1>
</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="extensions.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
border="0"><br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
-<a href="#Overview">Overview</a>
+<a href="#overview">Overview</a>
</li>
<li>
-<a href="#Default+Extensions">Default Extensions</a>
-<ul class="minitoc">
-<li>
-<a href="#SVG">SVG</a>
-</li>
-<li>
-<a href="#PDF+Bookmarks">PDF Bookmarks</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Adding+Your+Own">Adding Your Own</a>
+<a href="#adding">Adding Your Own</a>
</li>
</ul>
-<a name="N101BE"></a><a name="Overview"></a>
+<a name="N101BE"></a><a name="overview"></a>
<h3>Overview</h3>
<div style="margin-left: 0 ; border: 2px">
+<p>For documentation of standard FOP extenstions, see the <a
href="../extensions.html">User FOP Extensions</a> document.</p>
<p>
If the default funtionality of FOP needs to be extended for
-some reason then you can write an extensions.
+some reason then you can write an extension.
</p>
-<p>
-There are three types of extensions possible. An output document
-extensions such as the PDF bookmarks, an instream-foreign-object
-extensions such as SVG and an fo extension that creates an
-area in the area tree where normal xsl:fo is not possible.
- </p>
-</div>
-
-<a name="N101CB"></a><a name="Default+Extensions"></a>
-<h3>Default Extensions</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-These extension are available by default. They are automatically loaded
-and you only need to provide the correct namespace for your embedded
-xml markup.
- </p>
-<a name="N101D4"></a><a name="SVG"></a>
-<h4>SVG</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-Please see the <a href="svg.html">SVG page</a> for more details.
- </p>
-<p>
-The SVG extensions gets all the xml elements in the SVG namespace
-and builds an SVG DOM with batik. The SVG DOM is then rendered
-to the output format using a handler for the XML content of
-the instream-foreign-object.
- </p>
-</div>
-<a name="N101E5"></a><a name="PDF+Bookmarks"></a>
-<h4>PDF Bookmarks</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-To use this standard FOP extension, you need to add a namespace entry for
- http://xml.apache.org/fop/extensions on the root element. </p>
-<p>You can provide outlines inside the root object (but outside
- any page-sequences or
- other formatting objects). Here's an example of an outline entry:</p>
-<pre class="code">
-<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format";
- xmlns:fox="http://xml.apache.org/fop/extensions">
- <fox:bookmarks>
- <fox:outline internal-destination="sec3">
- <fox:label>Running FOP</fox:label>
-
- <fox:outline internal-destination="sec3-1">
- <fox:label>Prerequisites</fox:label>
- </fox:outline>
- <fox:outline>
- </fox:bookmarks>
-</fo:root></pre>
-<p>It works similarly to a basic-link. There is also an external-destination
- property, but it isn't supported currently. The documents
- on the fop-site use this extension so you can see it in action.
- </p>
-</div>
+<p>There are three types of extensions possible:</p>
+<ul>
+
+<li>An output document extension such as the PDF bookmarks</li>
+
+<li>an instream-foreign-object extensions such as SVG</li>
+
+<li>an fo extension that creates an area in the area tree where normal
xsl:fo is not possible</li>
+
+</ul>
</div>
-<a name="N101FA"></a><a name="Adding+Your+Own"></a>
+<a name="N101DE"></a><a name="adding"></a>
<h3>Adding Your Own</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
To add your own extension you need to do the following things.
</p>
-<p>
-Write code that implements your extension functionality.
-There are some examples in the contrib/ directory.
-</p>
-<p>
-Create a jar file with your classes, it must also include the
-following file "/META-INF/services/org.apache.fop.fo.ElementMapping".
-In this file you need to put the fully qualified classname of
-your element mappings class. This class must implement the
-"org.apache.fop.fo.ElementMapping" interface.
-</p>
-<p>
-Create your fo file with the extra xml data embedded in the file
-with the correct name space. The pdf documents on the fob site
-use this extension, see <a href="examples.html">Examples</a>
-for more examples.
-</p>
-<p>
-Put your jar file in the classpath and then run fop over the fo file.
- </p>
+<ol>
+
+<li>Write code that implements your extension functionality. The easiest
place to
+start is by looking at the code in org.apache.fop.extension, and by looking
at the examples in the <span class="codefrag">contrib</span> directory.</li>
+
+<li>Create a jar file with your classes, it must also include the following
file
+"/META-INF/services/org.apache.fop.fo.ElementMapping". In this file you need
+to put the fully qualified classname of your element mappings class. This
+class must implement the "org.apache.fop.fo.ElementMapping" interface.</li>
+
+<li>Create your XSL-FO file with the extra XML data embedded in the file
with the
+correct name space.
+The examples for SVG and pdfoutline.fo show how this can be done.
+The pdf documents on the FOP site use this extension.
+See also <a href="examples.html">Examples</a> for more examples.</li>
+
+<li>Put your jar file in the classpath</li>
+
+<li>Run FOP using your XSL-FO file as input.</li>
+
+</ol>
</div>
</div>
1.7 +88 -212 xml-site/targets/fop/dev/extensions.pdf
<<Binary file>>
1.13 +9 -19 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- faq.html 21 Apr 2003 00:50:33 -0000 1.12
+++ faq.html 23 Apr 2003 03:40:18 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.10 +9 -19 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.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- fonts.html 21 Apr 2003 00:50:33 -0000 1.9
+++ fonts.html 23 Apr 2003 03:40:18 -0000 1.10
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<span class="sel"><font color="#ffcc00">Fonts</font></span>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.3 +9 -19 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.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- implement.html 21 Apr 2003 00:50:33 -0000 1.2
+++ implement.html 23 Apr 2003 03:40:18 -0000 1.3
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.14 +19 -29 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.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- index.html 21 Apr 2003 00:50:33 -0000 1.13
+++ index.html 23 Apr 2003 03:40:18 -0000 1.14
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -202,6 +188,10 @@
</li>
<li>
+<a href="doc.html">Doc Mgmt</a>
+</li>
+
+<li>
<a target="_blank"
href="http://cvs.apache.org/viewcvs.cgi/xml-fop";>ViewCVS</a>
</li>
@@ -258,16 +248,16 @@
<a href="#lines">Development Lines</a>
</li>
<li>
-<a href="#Getting+Involved">Getting Involved</a>
+<a href="#involved">Getting Involved</a>
<ul class="minitoc">
<li>
<a href="#apache-roles">Understand Apache Roles</a>
</li>
<li>
-<a href="#Understand+FOP+Development+Tasks">Understand FOP Development
Tasks</a>
+<a href="#fop-tasks">Understand FOP Development Tasks</a>
</li>
<li>
-<a href="#Understand+FOP-related+standards">Understand FOP-related
standards</a>
+<a href="#fop-standards">Understand FOP-related standards</a>
</li>
<li>
<a href="#doc">Review the Developer Documentation</a>
@@ -282,13 +272,13 @@
<a href="#mail-fop-cvs">Subscribe to the fop-cvs Mailing List</a>
</li>
<li>
-<a href="#Download+and+Use+the+Developers%27+Code+Using+CVS">Download and
Use the Developers' Code Using CVS</a>
+<a href="#dev-code">Download and Use the Developers' Code Using CVS</a>
</li>
<li>
<a href="#patches">Submitting Patches</a>
</li>
<li>
-<a href="#Coding+Conventions">Coding Conventions</a>
+<a href="#code-conventions">Coding Conventions</a>
</li>
</ul>
</li>
@@ -319,7 +309,7 @@
<p>Because there is a fair amount of common information between the
maintenance and trunk development lines, we attempt to document them together,
highlighting differences only where needed.</p>
</div>
-<a name="N101EF"></a><a name="Getting+Involved"></a>
+<a name="N101EF"></a><a name="involved"></a>
<h3>Getting Involved</h3>
<div style="margin-left: 0 ; border: 2px">
<a name="N101F5"></a><a name="apache-roles"></a>
@@ -327,7 +317,7 @@
<div style="margin-left: 0 ; border: 2px">
<p>Review the <a href="http://xml.apache.org/roles.html";>Apache Project
Roles and Responsibilities</a> document for an understanding of the various
roles of contributors within the community.</p>
</div>
-<a name="N10203"></a><a name="Understand+FOP+Development+Tasks"></a>
+<a name="N10203"></a><a name="fop-tasks"></a>
<h4>Understand FOP Development Tasks</h4>
<div style="margin-left: 0 ; border: 2px">
<p>There are many different ways that you can help with FOP development. The
following is a non-exhaustive list of ways that <em>non-programmers</em> can
help. Remember that an hour spent on the tasks below is an hour that a
programmer can devote to fixing bugs or adding features instead:</p>
@@ -359,7 +349,7 @@
</ul>
</div>
-<a name="N10237"></a><a name="Understand+FOP-related+standards"></a>
+<a name="N10237"></a><a name="fop-standards"></a>
<h4>Understand FOP-related standards</h4>
<div style="margin-left: 0 ; border: 2px">
<p>At the moment FOP is mainly a tool to render XSL-FO files to pdf.
Therefore if you want to contribute to FOP you should become familiar with
these standards. You can find links at <a
href="../resources.html#specs">Specifications</a>.</p>
@@ -438,7 +428,7 @@
</ul>
</div>
-<a name="N102C0"></a><a
name="Download+and+Use+the+Developers%27+Code+Using+CVS"></a>
+<a name="N102C0"></a><a name="dev-code"></a>
<h4>Download and Use the Developers' Code Using CVS</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Between releases the newest code can be accessed via cvs. To do this you
need to install a cvs
@@ -466,7 +456,7 @@
</ul>
<p>One of the committers will test your patch and consider its implications
for the project. They will then either commit it to the repository or explain
on the issue why they did not. Depending on the work load and skill-sets of the
various committers, it may take some time before a a submitted patch is
addressed.</p>
</div>
-<a name="N102F8"></a><a name="Coding+Conventions"></a>
+<a name="N102F8"></a><a name="code-conventions"></a>
<h4>Coding Conventions</h4>
<div style="margin-left: 0 ; border: 2px">
<p>As mentioned in <a href="http://xml.apache.org/source.html";>Apache XML
Project Guidelines</a>,
1.4 +9 -19 xml-site/targets/fop/dev/pdf.html
Index: pdf.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/pdf.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- pdf.html 21 Apr 2003 00:50:33 -0000 1.3
+++ pdf.html 23 Apr 2003 03:40:18 -0000 1.4
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.3 +9 -19 xml-site/targets/fop/dev/ps.html
Index: ps.html
===================================================================
RCS file: /home/cvs/xml-site/targets/fop/dev/ps.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ps.html 21 Apr 2003 00:50:33 -0000 1.2
+++ ps.html 23 Apr 2003 03:40:19 -0000 1.3
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.13 +9 -19 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- svg.html 21 Apr 2003 00:50:33 -0000 1.12
+++ svg.html 23 Apr 2003 03:40:19 -0000 1.13
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.3 +51 -41 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.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- testing.html 21 Apr 2003 00:50:33 -0000 1.2
+++ testing.html 23 Apr 2003 03:40:20 -0000 1.3
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<a href="tools.html">Tools</a>
</li>
@@ -202,6 +188,10 @@
</li>
<li>
+<a href="doc.html">Doc Mgmt</a>
+</li>
+
+<li>
<a target="_blank"
href="http://cvs.apache.org/viewcvs.cgi/xml-fop";>ViewCVS</a>
</li>
@@ -252,6 +242,12 @@
</table>
<ul class="minitoc">
<li>
+<a href="#build">"Build" Testing</a>
+</li>
+<li>
+<a href="#functional">Functional Testing</a>
+<ul class="minitoc">
+<li>
<a href="#Running+and+Using+Tests">Running and Using Tests</a>
</li>
<li>
@@ -270,9 +266,31 @@
<a href="#SVG+Testing">SVG Testing</a>
</li>
</ul>
-
-<a name="N101BE"></a><a name="Running+and+Using+Tests"></a>
-<h3>Running and Using Tests</h3>
+</li>
+</ul>
+
+<a name="N101BE"></a><a name="build"></a>
+<h3>"Build" Testing</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Apache projects use an automated build tool called "gump" to create
nightly builds from the CVS repository. Gump sends "nag" messages if the build
fails. This can be considered a sort of basic test of the build process. To
view the most recent logs of the gump builds:</p>
+<ul>
+
+<li>
+<a href="http://gump.cocoondev.org/xml-fop.html";>Gump build for the Trunk</a>
+</li>
+
+<li>
+<a href="http://gump.cocoondev.org/xml-fop-maintenance.html";>Gump build for
the Maintenance Branch</a>
+</li>
+
+</ul>
+</div>
+
+<a name="N101D5"></a><a name="functional"></a>
+<h3>Functional Testing</h3>
+<div style="margin-left: 0 ; border: 2px">
+<a name="N101DB"></a><a name="Running+and+Using+Tests"></a>
+<h4>Running and Using Tests</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Testing is an important part of getting FOP to operate correctly and conform
to the
@@ -289,10 +307,8 @@
loaded to create the reference output.
</p>
</div>
-
-
-<a name="N101CE"></a><a name="W3C+TestSuite"></a>
-<h3>W3C TestSuite</h3>
+<a name="N101EB"></a><a name="W3C+TestSuite"></a>
+<h4>W3C TestSuite</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
The testing is set up so that you can download the testsuite from
@@ -301,10 +317,8 @@
Then you can uncomment the lines in the build.xml file in the test target
and itwill run through all the tests in the testsuite distribution.
</p>
</div>
-
-
-<a name="N101DC"></a><a name="Writing+a+Test"></a>
-<h3>Writing a Test</h3>
+<a name="N101F9"></a><a name="Writing+a+Test"></a>
+<h4>Writing a Test</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
A test belongs to one of a few catagories. A basic test should excercise one
@@ -326,9 +340,8 @@
some elements that will be placed into the flow of a standard document.
</p>
</div>
-
-<a name="N101EF"></a><a name="Submitting+a+Test"></a>
-<h3>Submitting a Test</h3>
+<a name="N1020C"></a><a name="Submitting+a+Test"></a>
+<h4>Submitting a Test</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
If you have a test which you think would be useful you should supply the
@@ -336,10 +349,8 @@
test works as would be expected against the current build.
</p>
</div>
-
-
-<a name="N101F9"></a><a name="How+Testing+Works"></a>
-<h3>How Testing Works</h3>
+<a name="N10216"></a><a name="How+Testing+Works"></a>
+<h4>How Testing Works</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
The tests are stored in the "<cvs_repository>/test" directory.
@@ -367,16 +378,15 @@
XML renderer. The XML files are then compared to see if there are any
differences.
</p>
</div>
-
-
-<a name="N10214"></a><a name="SVG+Testing"></a>
-<h3>SVG Testing</h3>
+<a name="N10231"></a><a name="SVG+Testing"></a>
+<h4>SVG Testing</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
The testing of SVG is not part of this testing system. SVG is tested for its
rendering
accuracy by using the transcoding mechanism via Batik. So that the only part
that needs
testing is how the SVG image is embedded inside the flow of the fo document.
</p>
+</div>
</div>
</div>
1.2 +335 -133 xml-site/targets/fop/dev/testing.pdf
<<Binary file>>
1.5 +9 -19 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.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- tools.html 21 Apr 2003 00:50:33 -0000 1.4
+++ tools.html 23 Apr 2003 03:40:20 -0000 1.5
@@ -68,7 +68,7 @@
</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">Redesign</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="../skin/images/tab-right.gif"></td>
+<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">
@@ -136,20 +136,6 @@
</ul>
</li>
<li>
-<font color="#CFDCED">Using</font>
-<ul>
-
-<li>
-<a href="extensions.html">Extensions</a>
-</li>
-
-<li>
-<a href="configuration.html">Configuration</a>
-</li>
-
-</ul>
-</li>
-<li>
<font color="#CFDCED">Extras</font>
<ul>
@@ -160,6 +146,10 @@
<li>
<a href="fonts.html">Fonts</a>
</li>
+
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
</ul>
</li>
@@ -186,10 +176,6 @@
</li>
<li>
-<a href="../design/index.html">Design</a>
-</li>
-
-<li>
<span class="sel"><font color="#ffcc00">Tools</font></span>
</li>
@@ -199,6 +185,10 @@
<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>
+
+<li>
+<a href="doc.html">Doc Mgmt</a>
</li>
<li>
1.1 xml-site/targets/fop/dev/doc.html
Index: doc.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>Managing FOP Documentation</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">About</font>
<ul>
<li>
<a href="index.html">Introduction</a>
</li>
<li>
<a href="faq.html">FAQs</a>
</li>
<li>
<a href="examples.html">Examples</a>
</li>
<li>
<a href="implement.html">Walk-Thru</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">Extras</font>
<ul>
<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">Output</font>
<ul>
<li>
<a href="pdf.html">PDF</a>
</li>
<li>
<a href="ps.html">Postscript</a>
</li>
</ul>
</li>
<li>
<font color="#CFDCED">General</font>
<ul>
<li>
<a target="_blank"
href="http://nagoya.apache.org/wiki/apachewiki.cgi?FOPProjectPages";>FOP Wiki</a>
</li>
<li>
<a href="tools.html">Tools</a>
</li>
<li>
<a href="testing.html">Testing</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>
<li>
<span class="sel"><font color="#ffcc00">Doc Mgmt</font></span>
</li>
<li>
<a target="_blank"
href="http://cvs.apache.org/viewcvs.cgi/xml-fop";>ViewCVS</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>Managing FOP Documentation</h1>
</td><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="doc.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
PDF</a></td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#general">General Information</a>
</li>
<li>
<a href="#web">Website</a>
<ul class="minitoc">
<li>
<a href="#web-background">Background</a>
</li>
<li>
<a href="#web-forrestbot-refresh">Forrestbot "refresh" Step-by-Step</a>
</li>
<li>
<a href="#web-forrestbot-publish">Forrestbot "publish" Step-by-Step</a>
</li>
<li>
<a href="#web-live-update">Live Site Update</a>
</li>
<li>
<a href="#web-local-forrest">Using a Local Forrest</a>
</li>
<li>
<a href="#web-manual">Updating the FOP Web Repository Manually
(Deprecated)</a>
</li>
</ul>
</li>
</ul>
<a name="N101BE"></a><a name="general"></a>
<h3>General Information</h3>
<div style="margin-left: 0 ; border: 2px">
<p>All raw documentation content is managed in the FOP CVS repository.
Updates should be committed to the repository, then the repository files are
used to generate usable output.
The remaining discussions on this page assume that the CVS repository is the
starting place for processing.
The path to the documentation is xml-fop/src/documentation/content/xdocs.</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">All documentation is maintained on the trunk.
Although we are currently maintaining two sets of code (trunk and
maintenance), there is only one set of documentation.
Most of the user and developer doc is common to the two environments, and
differences are highlighted where necessary.
The major exception to this rule is the design doc, which currently
exclusively pertains to the trunk (redesign).
Maintenance branch releases either copy the trunk content to the maintenance
branch or use the trunk content directly for doc builds.</div>
</div>
<p>Basic documents are stored in XML files, and use DTDs provided by Apache
Forrest.</p>
</div>
<a name="N101CE"></a><a name="web"></a>
<h3>Website</h3>
<div style="margin-left: 0 ; border: 2px">
<a name="N101D4"></a><a name="web-background"></a>
<h4>Background</h4>
<div style="margin-left: 0 ; border: 2px">
<p>The FOP web site and documentation are generated using <a
href="http://xml.apache.org/forrest";>Apache Forrest</a>.</p>
<p>The following table summarizes the flow of data to the FOP website in
chronological order:</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1">Processes</th>
<th colspan="1" rowspan="1">Files</th>
<th colspan="1" rowspan="1">State</th>
<th colspan="1" rowspan="1">Views</th>
</tr>
<tr>
<td colspan="1" rowspan="1">Developer commits code to FOP repository.</td>
<td colspan="1" rowspan="1">FOP source repository (cvs) at
icarus.apache.org/home/cvs/xml-fop</td>
<td colspan="1" rowspan="1">Raw XML and other content</td>
<td colspan="1" rowspan="1"><a
href="http://cvs.apache.org/viewcvs.cgi/xml-fop/src/documentation/content/xdocs/";>ViewCVS</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">
<a href="#forrestbot-refresh">Forrestbot "refresh"</a>.
Automatically done every six hours. Can be manually refreshed by authorized
users at <a href="http://forrestbot.cocoondev.org";>the Forrestbot Web
Interface</a>.
</td>
<td colspan="1" rowspan="1">Physical location unknown and
unimportant to us</td>
<td colspan="1" rowspan="1">web-ready</td>
<td colspan="1" rowspan="1">Content can be viewed <a
href="http://forrestbot.cocoondev.org/sites/xml-fop";>here</a>.</td>
</tr>
<tr>
<td colspan="1" rowspan="1"><a href="#forrestbot-publish">Forrestbot
"publish"</a>. Always done manually at <a
href="http://forrestbot.cocoondev.org";>the Forrestbot Web Interface</a>.</td>
<td colspan="1" rowspan="1">FOP web repository (cvs) at
icarus.apache.org/home/cvs/xml-site/targets/fop</td>
<td colspan="1" rowspan="1">web-ready</td>
<td colspan="1" rowspan="1"><a
href="http://cvs.apache.org/viewcvs.cgi/xml-site/targets/fop/";>ViewCVS</a></td>
</tr>
<tr>
<td colspan="1" rowspan="1">Automatic Live Site Update every six hours
(midnight, 6am, noon, 6pm Pacific time).</td>
<td colspan="1" rowspan="1">FOP live web site, somewhere on
daedalus.apache.org</td>
<td colspan="1" rowspan="1">web-ready</td>
<td colspan="1" rowspan="1"><a
href="http://xml.apache.org/fop";>FOP Web Site</a></td>
</tr>
</table>
</div>
<a name="N10274"></a><a name="web-forrestbot-refresh"></a>
<h4>Forrestbot "refresh" Step-by-Step</h4>
<div style="margin-left: 0 ; border: 2px">
<div class="frame note">
<div class="label">Note</div>
<div class="content">The Forrestbot "refresh" is automatically run on the
server every six hours. Only follow the steps below if you need to check the
results more promptly than that allows, or if you need to "refresh" in
preparation for a "publish".</div>
</div>
<p>To manually use the Forrestbot "refresh", simply follow these steps:</p>
<ul>
<li>Make sure your changes are committed to the FOP source repository.</li>
<li>Open http://forrestbot.cocoondev.org in your browser.</li>
<li>Login.</li>
<li>In the "Select a module" box, select "xml-fop".</li>
<li>Click the "refresh" button to have the interim site built.
On-screen instructions tell you how to view the log as the build
progresses.</li>
</ul>
</div>
<a name="N10293"></a><a name="web-forrestbot-publish"></a>
<h4>Forrestbot "publish" Step-by-Step</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To "publish" the Forrestbot output to the FOP Web repository:</p>
<ul>
<li>Make sure you are satisfied with the "refreshed" site.</li>
<li>Open http://forrestbot.cocoondev.org in your browser.</li>
<li>Login.</li>
<li>In the "Select a module" box, select "xml-fop".</li>
<li>Click the "publish" button.
On-screen instructions tell you how to view the log as the build
progresses.</li>
<li>Wait for the next 6-hour live-site update cycle and check your
changes.</li>
</ul>
</div>
<a name="N102B2"></a><a name="web-live-update"></a>
<h4>Live Site Update</h4>
<div style="margin-left: 0 ; border: 2px">
<p>If there are problems with the live site update (the process of copying
the web site contents from the FOP web repository to the live site:</p>
<ul>
<li>The CVS update logs can be viewed at
http://www.apache.org/~rubys/updatesite.logx, where "x" is a number from 1-4,
these four files being the updates done over the past 24 hours.
Review the most recent log file for clues.</li>
<li>The script is maintained by Sam Ruby ([EMAIL PROTECTED]).
Contact him for further help.</li>
</ul>
</div>
<a name="N102C5"></a><a name="web-local-forrest"></a>
<h4>Using a Local Forrest</h4>
<div style="margin-left: 0 ; border: 2px">
<div class="frame note">
<div class="label">Note</div>
<div class="content">Most documentation content changes do not require a
local copy of Forrest.
In general, use the Forrestbot instead. Forrestbot is easy to use, always
uses the "approved" methodology, and has fewer error-prone manual steps.</div>
</div>
<p>There are some situations where you may want to have a local Forrest
installation. For example, you do not want to tie up server resources testing
major changes, such as sitemap building, that may require many
edit/build/test/debug cycles. After you are done testing, use the forrestbot to
"refresh" and "publish" the site.</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">Forrest needs to be run on a machine with a graphical
environment.
It will fail in a headless environment when it tries to use FOP to generate
the PDF files.</div>
</div>
<p>To use a local Forrest:</p>
<ul>
<li>checkout the xml-forrest module (same repository as xml-fop)</li>
<li>checkout the xml-site/targets/fop module (same repository as xml-fop)</li>
<li>you will also need access to a current xml-fop sandbox (you probably
already
have one)</li>
<li>cd to xml-forrest</li>
<li>run: build.sh(bat) dist to build forrest</li>
<li>set environment variable FORREST_HOME=~/xml-forrest/build/dist/shbat
where ~ is the directory in which xml-forrest is installed (see
http://xml.apache.org/forrest/your-project.html for details)</li>
<li>set environment variable PATH=$PATH:$FORREST_HOME/bin</li>
<li>cd to xml-fop directory</li>
<li>run forrest(.bat), which will build the web-site documents in
xml-fop/build/site.</li>
</ul>
</div>
<a name="N102F6"></a><a name="web-manual"></a>
<h4>Updating the FOP Web Repository Manually (Deprecated)</h4>
<div style="margin-left: 0 ; border: 2px">
<div class="frame warning">
<div class="label">Warning</div>
<div class="content">The steps in this section should not ordinarily be used.
They are documented here for historical reasons, and for emergencies.</div>
</div>
<ul>
<li>Copy (or sym-link) the documents generated by Forrest (in
xml-fop/build/site) to xml-site/targets/fop on your local machine.</li>
<li>Commit xml-site/targets/fop.</li>
</ul>
</div>
</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/dev/doc.pdf
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
