You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlgraphics.apache.org by sp...@apache.org on 2011/08/25 10:04:32 UTC
svn commit: r1161429 [8/12] - in /xmlgraphics/site/deploy/fop: ./ 0.95/ 1.0/
dev/ dev/design/ skin/ trunk/
Modified: xmlgraphics/site/deploy/fop/dev/testing.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/dev/testing.html?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/dev/testing.html (original)
+++ xmlgraphics/site/deploy/fop/dev/testing.html Thu Aug 25 08:04:24 2011
@@ -3,7 +3,7 @@
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>FOP Development: Testing</title>
<link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -185,7 +185,7 @@ document.write("Last Published: " + docu
<a href="../dev/implement.html">Walk-Thru</a>
</div>
<div class="menuitem">
-<a href="http://issues.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>
+<a href="http://issues.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>
</div>
<div class="menuitem">
<a href="../dev/conventions.html">Conventions</a>
@@ -206,7 +206,7 @@ document.write("Last Published: " + docu
<a href="../dev/release.html">Release</a>
</div>
<div class="menuitem">
-<a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bug_severity%2Cpriority%20DESC">Bugs</a>
+<a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bug_severity%2Cpriority%20DESC">Bugs</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.6', '../skin/')" id="menu_1.6Title" class="menutitle">Resources</div>
@@ -258,6 +258,7 @@ document.write("Last Published: " + docu
<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>FOP Development: Testing</h1>
+<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
@@ -294,8 +295,9 @@ document.write("Last Published: " + docu
</li>
</ul>
</div>
+</div>
-<a name="N10011"></a><a name="build"></a>
+<a name="build"></a>
<h2 class="underlined_10">"Build" Testing</h2>
<div class="section">
<p>Apache projects use an automated build tool called "gump" to create nightly builds from the SVN 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>
@@ -312,7 +314,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10028"></a><a name="basic"></a>
+<a name="basic"></a>
<h2 class="underlined_10">Basic/API Testing</h2>
<div class="section">
<p>There is a group of basic API tests that are included in the build process.
@@ -321,7 +323,7 @@ The build will then report error(s) if t
The tests do not check the output, but only ensure that something is generated and without exceptions.</p>
</div>
-<a name="N10032"></a><a name="layoutengine"></a>
+<a name="layoutengine"></a>
<h2 class="underlined_10">Layout Engine Testing</h2>
<div class="section">
<p>
@@ -332,14 +334,14 @@ The tests do not check the output, but o
</p>
</div>
-<a name="N10045"></a><a name="functional"></a>
+<a name="functional"></a>
<h2 class="underlined_10">Functional Testing</h2>
<div class="section">
<div class="warning">
<div class="label">Warning</div>
<div class="content">The "functional" testing section on this page is currently inoperative.</div>
</div>
-<a name="N1004E"></a><a name="Running+and+Using+Tests"></a>
+<a name="Running+and+Using+Tests"></a>
<h3 class="underlined_5">Running and Using Tests</h3>
<p>
Testing is an important part of getting FOP to operate correctly and conform to the
@@ -355,7 +357,7 @@ To setup the testing the developer must
"<cvs_repository>/test/reference/" directory. This jar will be dynamically
loaded to create the reference output.
</p>
-<a name="N1005E"></a><a name="W3C+TestSuite"></a>
+<a name="W3C+TestSuite"></a>
<h3 class="underlined_5">W3C TestSuite</h3>
<p>
The testing is set up so that you can download the testsuite from
@@ -363,7 +365,7 @@ The testing is set up so that you can do
unzip the file into the base directory of FOP.
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>
-<a name="N1006C"></a><a name="Writing+a+Test"></a>
+<a name="Writing+a+Test"></a>
<h3 class="underlined_5">Writing a Test</h3>
<p>
A test belongs to one of a few catagories. A basic test should excercise one
@@ -384,14 +386,14 @@ elements together.
A test can consist of a complete fo document or a part of the document such as
some elements that will be placed into the flow of a standard document.
</p>
-<a name="N1007F"></a><a name="Submitting+a+Test"></a>
+<a name="Submitting+a+Test"></a>
<h3 class="underlined_5">Submitting a Test</h3>
<p>
If you have a test which you think would be useful you should supply the
test and a diff to the appropriate test suite xml file. Make sure that the
test works as would be expected against the current build.
</p>
-<a name="N10089"></a><a name="How+Testing+Works"></a>
+<a name="How+Testing+Works"></a>
<h3 class="underlined_5">How Testing Works</h3>
<p>
The tests are stored in the "<svn_repository>/test" directory.
@@ -420,7 +422,7 @@ such as if the test has passed and any c
For FOP the testing is done by rendering all the testing documents using the
XML renderer. The XML files are then compared to see if there are any differences.
</p>
-<a name="N100AB"></a><a name="SVG+Testing"></a>
+<a name="SVG+Testing"></a>
<h3 class="underlined_5">SVG Testing</h3>
<p>
The testing of SVG is not part of this testing system. SVG is tested for its rendering
@@ -450,7 +452,10 @@ document.write("Last Published: " + docu
<div class="copyright">
Copyright ©
1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
-</div>
+<br>
+ Apache, Apache FOP, the Apache feather logo, and the Apache FOP
+ logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
<!--+
|end bottomstrip
+-->
Modified: xmlgraphics/site/deploy/fop/dev/testing.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/dev/testing.pdf?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/dev/testing.pdf (original) and xmlgraphics/site/deploy/fop/dev/testing.pdf Thu Aug 25 08:04:24 2011 differ
Modified: xmlgraphics/site/deploy/fop/dev/tools.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/dev/tools.html?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/dev/tools.html (original)
+++ xmlgraphics/site/deploy/fop/dev/tools.html Thu Aug 25 08:04:24 2011
@@ -3,7 +3,7 @@
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>FOP Development: Developer Tools</title>
<link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -185,7 +185,7 @@ document.write("Last Published: " + docu
<a href="../dev/implement.html">Walk-Thru</a>
</div>
<div class="menuitem">
-<a href="http://issues.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>
+<a href="http://issues.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>
</div>
<div class="menuitem">
<a href="../dev/conventions.html">Conventions</a>
@@ -206,7 +206,7 @@ document.write("Last Published: " + docu
<a href="../dev/release.html">Release</a>
</div>
<div class="menuitem">
-<a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bug_severity%2Cpriority%20DESC">Bugs</a>
+<a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Fop&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bug_severity%2Cpriority%20DESC">Bugs</a>
</div>
</div>
<div onclick="SwitchMenu('menu_selected_1.6', '../skin/')" id="menu_selected_1.6Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Resources</div>
@@ -258,6 +258,7 @@ document.write("Last Published: " + docu
<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>FOP Development: Developer Tools</h1>
+<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
@@ -291,6 +292,7 @@ document.write("Last Published: " + docu
</li>
</ul>
</div>
+</div>
<p>
This page documents items that may be helpful to other developers,
@@ -300,7 +302,7 @@ document.write("Last Published: " + docu
tools, especially "gotchas", and to help developers get jump-started.
</p>
-<a name="N10014"></a><a name="checklist"></a>
+<a name="checklist"></a>
<h2 class="underlined_10">Developer Checklist</h2>
<div class="section">
<p>
@@ -322,7 +324,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10044"></a><a name="general"></a>
+<a name="general"></a>
<h2 class="underlined_10">General Developer Information</h2>
<div class="section">
<p>
@@ -332,10 +334,10 @@ document.write("Last Published: " + docu
</p>
</div>
-<a name="N10052"></a><a name="svn"></a>
+<a name="svn"></a>
<h2 class="underlined_10">Subversion (SVN)</h2>
<div class="section">
-<a name="N10058"></a><a name="svn_general"></a>
+<a name="svn_general"></a>
<h3 class="underlined_5">General</h3>
<p>
Visit <a href="http://xmlgraphics.apache.org/repo.html">Apache XML Graphics Code Repositories</a>
@@ -351,7 +353,7 @@ document.write("Last Published: " + docu
For Microsoft Windows we recommend <a class="external" href="http://tortoisesvn.tigris.org">TortoiseSVN</a>.
The command-line client that comes with Subversion is also very easy to use.
</p>
-<a name="N10075"></a><a name="svn_download"></a>
+<a name="svn_download"></a>
<h3 class="underlined_5">Step-by-step instruction for downloading FOP using the SVN command-line client</h3>
<p>
On the command-line (Windows or Unix), simply run:
@@ -362,7 +364,7 @@ svn co http://svn.apache.org/repos/asf/x
<p>
This will download the FOP trunk into the directory "fop-trunk".
</p>
-<a name="N10086"></a><a name="tortoisesvn_download"></a>
+<a name="tortoisesvn_download"></a>
<h3 class="underlined_5">Step-by-step instructions for downloading FOP using TortoiseSVN (on Windows)</h3>
<ul>
@@ -375,7 +377,7 @@ svn co http://svn.apache.org/repos/asf/x
<li>Click "OK" and the download should begin.</li>
</ul>
-<a name="N1009F"></a><a name="patches"></a>
+<a name="patches"></a>
<h3 class="underlined_5">Creating Patches</h3>
<ul>
@@ -400,7 +402,7 @@ svn co http://svn.apache.org/repos/asf/x
<li>If you are running TortoiseSVN, you can select "Create Patch..." in the TortoiseSVN context menu.</li>
</ul>
-<a name="N100C3"></a><a name="svn-doc"></a>
+<a name="svn-doc"></a>
<h3 class="underlined_5">Documentation</h3>
<ul>
@@ -415,7 +417,7 @@ Note that this manual applies to the com
</ul>
</div>
-<a name="N100E2"></a><a name="ide"></a>
+<a name="ide"></a>
<h2 class="underlined_10">Integrated Development Environments (IDEs)</h2>
<div class="section">
<p>An IDE is not required, but will generally be found to be helpful, especially for serious debugging and refactoring.</p>
@@ -444,7 +446,10 @@ document.write("Last Published: " + docu
<div class="copyright">
Copyright ©
1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
-</div>
+<br>
+ Apache, Apache FOP, the Apache feather logo, and the Apache FOP
+ logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
<!--+
|end bottomstrip
+-->
Modified: xmlgraphics/site/deploy/fop/dev/tools.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/dev/tools.pdf?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/dev/tools.pdf (original) and xmlgraphics/site/deploy/fop/dev/tools.pdf Thu Aug 25 08:04:24 2011 differ
Modified: xmlgraphics/site/deploy/fop/download.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/download.html?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/download.html (original)
+++ xmlgraphics/site/deploy/fop/download.html Thu Aug 25 08:04:24 2011
@@ -3,7 +3,7 @@
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>Apache FOP: Downloading A Distribution</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -201,6 +201,7 @@ document.write("Last Published: " + docu
<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>Apache FOP: Downloading A Distribution</h1>
+<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
@@ -217,8 +218,9 @@ document.write("Last Published: " + docu
</li>
</ul>
</div>
+</div>
-<a name="N10011"></a><a name="dist-type"></a>
+<a name="dist-type"></a>
<h2 class="underlined_10">Binary or Source?</h2>
<div class="section">
<p>
@@ -247,7 +249,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10027"></a><a name="binary"></a>
+<a name="binary"></a>
<h2 class="underlined_10">Binary Download</h2>
<div class="section">
<p>
@@ -258,7 +260,7 @@ document.write("Last Published: " + docu
</p>
</div>
-<a name="N10039"></a><a name="source"></a>
+<a name="source"></a>
<h2 class="underlined_10">Source Download</h2>
<div class="section">
<p>
@@ -400,7 +402,7 @@ document.write("Last Published: " + docu
</p>
</div>
-<a name="N1010B"></a><a name="archives"></a>
+<a name="archives"></a>
<h2 class="underlined_10">Archive Download</h2>
<div class="section">
<p>
@@ -431,7 +433,10 @@ document.write("Last Published: " + docu
<div class="copyright">
Copyright ©
1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
-</div>
+<br>
+ Apache, Apache FOP, the Apache feather logo, and the Apache FOP
+ logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
<!--+
|end bottomstrip
+-->
Modified: xmlgraphics/site/deploy/fop/download.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/download.pdf?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/download.pdf (original) and xmlgraphics/site/deploy/fop/download.pdf Thu Aug 25 08:04:24 2011 differ
Modified: xmlgraphics/site/deploy/fop/examples.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/examples.html?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/examples.html (original)
+++ xmlgraphics/site/deploy/fop/examples.html Thu Aug 25 08:04:24 2011
@@ -3,7 +3,7 @@
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>Examples</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -201,6 +201,7 @@ document.write("Last Published: " + docu
<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>Examples</h1>
+<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
@@ -214,8 +215,9 @@ document.write("Last Published: " + docu
</li>
</ul>
</div>
+</div>
-<a name="N10011"></a><a name="Example+Documents+Using+FOP"></a>
+<a name="Example+Documents+Using+FOP"></a>
<h2 class="underlined_10">Example Documents Using FOP</h2>
<div class="section">
<p>
@@ -300,7 +302,7 @@ formatting objects and properties in tes
</p>
</div>
-<a name="N1007F"></a><a name="Images+Examples"></a>
+<a name="Images+Examples"></a>
<h2 class="underlined_10">Images Examples</h2>
<div class="section">
<p>
@@ -347,7 +349,7 @@ Embedding images in FO:
</p>
</div>
-<a name="N100E6"></a><a name="Instream+Foreign+Object+Examples"></a>
+<a name="Instream+Foreign+Object+Examples"></a>
<h2 class="underlined_10">Instream Foreign Object Examples</h2>
<div class="section">
<p>
@@ -397,7 +399,10 @@ document.write("Last Published: " + docu
<div class="copyright">
Copyright ©
1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
-</div>
+<br>
+ Apache, Apache FOP, the Apache feather logo, and the Apache FOP
+ logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
<!--+
|end bottomstrip
+-->
Modified: xmlgraphics/site/deploy/fop/examples.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/examples.pdf?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/examples.pdf (original) and xmlgraphics/site/deploy/fop/examples.pdf Thu Aug 25 08:04:24 2011 differ
Modified: xmlgraphics/site/deploy/fop/faq.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/faq.html?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/faq.html (original)
+++ xmlgraphics/site/deploy/fop/faq.html Thu Aug 25 08:04:24 2011
@@ -3,7 +3,7 @@
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>FOP FAQ</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -201,12 +201,10 @@ document.write("Last Published: " + docu
<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>FOP FAQ</h1>
+<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
-<a href="#Questions">Questions</a>
-<ul class="minitoc">
-<li>
<a href="#part-general">1. General questions</a>
<ul class="minitoc">
<li>
@@ -548,20 +546,13 @@ Can I control this?</a>
</ul>
</li>
</ul>
-</li>
-</ul>
</div>
-<a name="N10009"></a><a name="Questions"></a>
-<h2 class="underlined_10">Questions</h2>
-<div class="section">
-<a name="N1000D"></a><a name="part-general"></a>
-<h3 class="underlined_5">1. General questions</h3>
-<a name="N10011"></a><a name="fop-general"></a>
-<h4 class="faq">1.1. What is FOP?</h4>
-<div align="right">
-<a href="#fop-general-menu">^</a>
</div>
-<div style="margin-left: 15px">
+<a name="part-general"></a>
+<h2 class="underlined_10">1. General questions</h2>
+<div class="section">
+<a name="fop-general"></a>
+<h3 class="underlined_5">1.1. What is FOP?</h3>
<p>
FOP is a print formatter for <a href="#XSLFO">XSL formatting
objects</a>.
@@ -571,13 +562,8 @@ Can I control this?</a>
into a page layout. The main target is PDF but other rendering targets
are supported, such as AWT, PCL, text and direct printing.
</p>
-</div>
-<a name="N10020"></a><a name="fop-functions"></a>
-<h4 class="faq">1.2. What can I do with FOP?</h4>
-<div align="right">
-<a href="#fop-functions-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fop-functions"></a>
+<h3 class="underlined_5">1.2. What can I do with FOP?</h3>
<p>
FOP provides both an application and a library that converts an XSL FO
document into paginated output.
@@ -590,24 +576,14 @@ Can I control this?</a>
<p>
The library can be used in servlets and other Java applications.
</p>
-</div>
-<a name="N1002E"></a><a name="fop-acronym"></a>
-<h4 class="faq">1.3. What does "FOP" stand for?</h4>
-<div align="right">
-<a href="#fop-acronym-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fop-acronym"></a>
+<h3 class="underlined_5">1.3. What does "FOP" stand for?</h3>
<p>
FOP is an acronym for <strong>F</strong>ormatting
<strong>O</strong>bject <strong>P</strong>rocessor
</p>
-</div>
-<a name="N1003F"></a><a name="fop-other-apache"></a>
-<h4 class="faq">1.4. How does FOP interact with other Apache Projects?</h4>
-<div align="right">
-<a href="#fop-other-apache-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fop-other-apache"></a>
+<h3 class="underlined_5">1.4. How does FOP interact with other Apache Projects?</h3>
<p>
FOP is distributed with <a class="external" href="http://xml.apache.org/cocoon">Cocoon</a> as a PDF serializer
for XSL (FO) documents.
@@ -618,26 +594,16 @@ Can I control this?</a>
FOP to <a href="http://xmlgraphics.apache.org/batik/svgrasterizer.html">transcode an SVG
image</a> into a PDF document.
</p>
-</div>
-<a name="N10056"></a><a name="xsl-def"></a>
-<h4 class="faq">1.5. What is XSL?</h4>
-<div align="right">
-<a href="#xsl-def-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xsl-def"></a>
+<h3 class="underlined_5">1.5. What is XSL?</h3>
<p>
XSL is a W3C standard concerned with publishing XML documents. It
consists of two parts: <a href="#XSLT">XSLT</a> and <a href="#XSLFO">XSL-FO</a>. The acronym expands to
e<strong>X</strong>tensible <strong>S</strong>tylesheet
<strong>L</strong>anguage.
</p>
-</div>
-<a name="N1006F"></a><a name="xslfo"></a>
-<h4 class="faq">1.6. What is XSL-FO?</h4>
-<div align="right">
-<a href="#xslfo-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xslfo"></a>
+<h3 class="underlined_5">1.6. What is XSL-FO?</h3>
<p>
XSLFO (aka XSL-FO) is an XML vocabulary that is used to specify a pagination and
other styling for page layout output. The acronym “FO”
@@ -656,13 +622,8 @@ Can I control this?</a>
<p>
Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
</p>
-</div>
-<a name="N10087"></a><a name="XSLT"></a>
-<h4 class="faq">1.7. What is XSLT?</h4>
-<div align="right">
-<a href="#XSLT-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="XSLT"></a>
+<h3 class="underlined_5">1.7. What is XSLT?</h3>
<p>
XSLT describes the transformation of arbitrary XML input into other
XML (like XSLFO), HTML or plain text. The “T” comes from
@@ -672,21 +633,11 @@ Can I control this?</a>
<p>
Synonyms: XSL transformation, XSL:T, XSL style sheet.
</p>
-</div>
-<a name="N10095"></a><a name="when"></a>
-<h4 class="faq">1.8. When will feature X be implemented?</h4>
-<div align="right">
-<a href="#when-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="when"></a>
+<h3 class="underlined_5">1.8. When will feature X be implemented?</h3>
<p>The short answer is "Don't ask." For more details, see <a href="gethelp.html#limitations">Understand FOP's Limitations</a>.</p>
-</div>
-<a name="N100A1"></a><a name="next-release"></a>
-<h4 class="faq">1.9. When is the next released planned?</h4>
-<div align="right">
-<a href="#next-release-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="next-release"></a>
+<h3 class="underlined_5">1.9. When is the next released planned?</h3>
<p>
When it's ready and the committers have enough time to go
through the time-consuming process of creating a release. We
@@ -694,13 +645,8 @@ Can I control this?</a>
1.1 when we accumulated enough additions and bug fixes. If
you want to speed up the process, consider <a href="dev/index.html#involved">contributing</a> to
FOP.</p>
-</div>
-<a name="N100AD"></a><a name="redesign"></a>
-<h4 class="faq">1.10. Why did you redesign FOP?</h4>
-<div align="right">
-<a href="#redesign-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="redesign"></a>
+<h3 class="underlined_5">1.10. Why did you redesign FOP?</h3>
<p>The code redesign of FOP was necessary in order to be able to adress following issues:</p>
<ul>
@@ -715,27 +661,19 @@ Can I control this?</a>
<li>Table Layout</li>
</ul>
-</div>
-<a name="N100C7"></a><a name="contribute"></a>
-<h4 class="faq">1.11. How can I contribute?</h4>
-<div align="right">
-<a href="#contribute-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="contribute"></a>
+<h3 class="underlined_5">1.11. How can I contribute?</h3>
<p>
There are numerous ways that you can help. They are outlined in the <a href="dev/index.html">Developer's Introduction</a> page.
</p>
</div>
-<a name="N100D3"></a><a name="part-running"></a>
-<h3 class="underlined_5">2. Problems running FOP</h3>
-<a name="N100D7"></a><a name="no-page-master"></a>
-<h4 class="faq">2.1. I get the error: [ERROR]: 'master-reference' for
+<a name="part-running"></a>
+<h2 class="underlined_10">2. Problems running FOP</h2>
+<div class="section">
+<a name="no-page-master"></a>
+<h3 class="underlined_5">2.1. I get the error: [ERROR]: 'master-reference' for
'fo:page-sequence' matches no 'simple-page-master' or
- 'page-sequence-master'</h4>
-<div align="right">
-<a href="#no-page-master-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+ 'page-sequence-master'</h3>
<p>
FOP was changed to be in accordance with the latest standard (see
<a href="resources.html#specs-xslfo">XSL standard</a>).The page
@@ -750,13 +688,8 @@ Can I control this?</a>
<p>
Update your FO documents and style sheets.
</p>
-</div>
-<a name="N100E6"></a><a name="NoClassDefFound"></a>
-<h4 class="faq">2.2. I get a NoClassDefFound exception.</h4>
-<div align="right">
-<a href="#NoClassDefFound-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="NoClassDefFound"></a>
+<h3 class="underlined_5">2.2. I get a NoClassDefFound exception.</h3>
<p>This is typically a problem with your classpath.</p>
<p>If you are running FOP from the command line:</p>
<ul>
@@ -784,14 +717,9 @@ Can I control this?</a>
from the repository, remember you have to build the FOP jars
first.
</p>
-</div>
-<a name="N10113"></a><a name="NoSuchMethodException"></a>
-<h4 class="faq">2.3. I get a NoSuchMethodException or a NoSuchFieldException
- exception.</h4>
-<div align="right">
-<a href="#NoSuchMethodException-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="NoSuchMethodException"></a>
+<h3 class="underlined_5">2.3. I get a NoSuchMethodException or a NoSuchFieldException
+ exception.</h3>
<p>
This is usually caused by an older version of one of the FOP jars or
old XML tools in the classpath. Check in particular for parser.jar,
@@ -802,23 +730,13 @@ Can I control this?</a>
version of Batik that comes with FOP. It is not always possible to
use a more recent version of Batik.
</p>
-</div>
-<a name="N1011E"></a><a name="OutOfMemoryException"></a>
-<h4 class="faq">2.4. I get an OutOfMemoryException.</h4>
-<div align="right">
-<a href="#OutOfMemoryException-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="OutOfMemoryException"></a>
+<h3 class="underlined_5">2.4. I get an OutOfMemoryException.</h3>
<p>
See <a href="1.0/running.html#memory">FOP Memory</a>.
</p>
-</div>
-<a name="N1012A"></a><a name="MalformedURLException"></a>
-<h4 class="faq">2.5. I get a MalformedURLException.</h4>
-<div align="right">
-<a href="#MalformedURLException-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="MalformedURLException"></a>
+<h3 class="underlined_5">2.5. I get a MalformedURLException.</h3>
<a name="MalformedURL" id="MalformedURL"></a>
<p>
What you probably think of as "file names" are usually URLs, in
@@ -844,13 +762,8 @@ Can I control this?</a>
resolving process, which transforms it into an absolute
URL.
</p>
-</div>
-<a name="N1015F"></a><a name="NullPointerException"></a>
-<h4 class="faq">2.6. I get an "[ERROR]: null", or a NullPointerException.</h4>
-<div align="right">
-<a href="#NullPointerException-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="NullPointerException"></a>
+<h3 class="underlined_5">2.6. I get an "[ERROR]: null", or a NullPointerException.</h3>
<p>
This is often caused by an invalid FO document. Currently only very
common errors are intercepted and produce a comprehensible error
@@ -877,21 +790,11 @@ Can I control this?</a>
If you turn on debugging with the "<span class="codefrag">-d</span>" option you may be able to
see more detailed information.
</p>
-</div>
-<a name="N1018A"></a><a name="not-implemented"></a>
-<h4 class="faq">2.7. FOP returns the message "[ERROR] object|property - 'x' is not implemented yet." When will it be implemented?</h4>
-<div align="right">
-<a href="#not-implemented-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="not-implemented"></a>
+<h3 class="underlined_5">2.7. FOP returns the message "[ERROR] object|property - 'x' is not implemented yet." When will it be implemented?</h3>
<p>See FOP's Standards <a href="compliance.html">Compliance</a> page.</p>
-</div>
-<a name="N10199"></a><a name="fop-hangs"></a>
-<h4 class="faq">2.8. FOP hangs. FOP does not exit.</h4>
-<div align="right">
-<a href="#fop-hangs-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fop-hangs"></a>
+<h3 class="underlined_5">2.8. FOP hangs. FOP does not exit.</h3>
<p>
The most likely reason is a known problem with the Java run time
environment which is triggered by rendering SVGs. Suns JDK 1.4 does
@@ -911,13 +814,8 @@ Can I control this?</a>
the FOP output regularly to empty the pipe buffer. It is best to avoid
exec'ing FOP, use the library interface instead.
</p>
-</div>
-<a name="N101AF"></a><a name="boxoverflow"></a>
-<h4 class="faq">2.9. FOP runs forever, writing lots of ">" to the log.</h4>
-<div align="right">
-<a href="#boxoverflow-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="boxoverflow"></a>
+<h3 class="underlined_5">2.9. FOP runs forever, writing lots of ">" to the log.</h3>
<p>
There is something too large to fit into the intended place, usually a
large image, a table whose rows are kept together or a block with a
@@ -928,21 +826,11 @@ Can I control this?</a>
increase the dimension of the enclosing element or container, or
remove keep-with-* properties.
</p>
-</div>
-<a name="N101B7"></a><a name="cannot-find-external-graphics"></a>
-<h4 class="faq">2.10. FOP cannot find a file for fo:external-graphics.</h4>
-<div align="right">
-<a href="#cannot-find-external-graphics-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="cannot-find-external-graphics"></a>
+<h3 class="underlined_5">2.10. FOP cannot find a file for fo:external-graphics.</h3>
<p>The src attribute of the <span class="codefrag">fo:external-graphics</span> element requires a URI, not a file name. See <a href="fo.html#external-resources">External Resources</a> for more information about specifying URIs.</p>
-</div>
-<a name="N101C6"></a><a name="fonts-not-found"></a>
-<h4 class="faq">2.11. FOP does not find my fonts.</h4>
-<div align="right">
-<a href="#fonts-not-found-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fonts-not-found"></a>
+<h3 class="underlined_5">2.11. FOP does not find my fonts.</h3>
<p>
Did you get: “Failed to read font metrics file C:\foo\arial.xml
: File "C:\foo\arial.xml" not found”? The value for the
@@ -958,14 +846,9 @@ Can I control this?</a>
Try also setting the <a href="1.0/configuration.html#general-elements">font-base
configuration</a>.
</p>
-</div>
-<a name="N101D8"></a><a name="saxexception-mismatch"></a>
-<h4 class="faq">2.12. I get a SAXException: Mismatch: page-sequence vs. root
- (or similar).</h4>
-<div align="right">
-<a href="#saxexception-mismatch-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="saxexception-mismatch"></a>
+<h3 class="underlined_5">2.12. I get a SAXException: Mismatch: page-sequence vs. root
+ (or similar).</h3>
<p>
The full exception usually looks similar to this:
</p>
@@ -1001,17 +884,12 @@ public class DefaultErrorListener implem
}
}</pre>
-</div>
-<a name="N101FA"></a><a name="faq-N1026C"></a>
-<h4 class="faq">2.13. The following message appears after recently upgrading FOP:
+<a name="faq-N1026C"></a>
+<h3 class="underlined_5">2.13. The following message appears after recently upgrading FOP:
"I/O exception while reading font cache (org.apache.fop.fonts.EmbedFontInfo;
local class incompatible: stream classdesc serialVersionUID =
-9075848379822693399, local class serialVersionUID = 8755432068669997367).
- Discarding font cache file."</h4>
-<div align="right">
-<a href="#faq-N1026C-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+ Discarding font cache file."</h3>
<p>
This message is a warning that FOP failed to read from the Font cache.
Which means any Font auto detection or Font directories will be re-scanned.
@@ -1024,16 +902,13 @@ public class DefaultErrorListener implem
the option "use-cache."
</p>
</div>
-<a name="N10209"></a><a name="part-output"></a>
-<h3 class="underlined_5">3. Problems with FOP output</h3>
-<a name="N1020D"></a><a name="leader-expansion"></a>
-<h4 class="faq">3.1. Leaders don't work in current FOP. Instead of
+<a name="part-output"></a>
+<h2 class="underlined_10">3. Problems with FOP output</h2>
+<div class="section">
+<a name="leader-expansion"></a>
+<h3 class="underlined_5">3.1. Leaders don't work in current FOP. Instead of
filling the line, only three dots or a short ruler is
- output.</h4>
-<div align="right">
-<a href="#leader-expansion-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+ output.</h3>
<p>
Leaders still work, in fact they work better than ever
before. You'll just have to add <span class="codefrag">text-align="justify"</span> and/or
@@ -1063,13 +938,8 @@ public class DefaultErrorListener implem
non-justified line, you have to increase the
leader-length.optimum property.
</p>
-</div>
-<a name="N1022A"></a><a name="blank-page-between-page-sequences"></a>
-<h4 class="faq">3.2. Why does FOP insert a blank page between my page sequences?</h4>
-<div align="right">
-<a href="#blank-page-between-page-sequences-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="blank-page-between-page-sequences"></a>
+<h3 class="underlined_5">3.2. Why does FOP insert a blank page between my page sequences?</h3>
<p>
This is because spec conformance has been improved.
</p>
@@ -1089,13 +959,8 @@ public class DefaultErrorListener implem
If you don't want to have this blank page, use
<span class="codefrag">force-page-count="no-force"</span>.
</p>
-</div>
-<a name="N10242"></a><a name="graphic-not-displayed"></a>
-<h4 class="faq">3.3. Why is my graphic not rendered?</h4>
-<div align="right">
-<a href="#graphic-not-displayed-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="graphic-not-displayed"></a>
+<h3 class="underlined_5">3.3. Why is my graphic not rendered?</h3>
<p>Most commonly, the external file is not being found by FOP.
Check the following:</p>
<ul>
@@ -1129,31 +994,16 @@ Check the following:</p>
</li>
</ul>
-</div>
-<a name="N1026C"></a><a name="png-fails"></a>
-<h4 class="faq">3.4. My graphical images do not work properly.</h4>
-<div align="right">
-<a href="#png-fails-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="png-fails"></a>
+<h3 class="underlined_5">3.4. My graphical images do not work properly.</h3>
<p>See <a href="1.0/graphics.html">FOP Graphics Formats</a> for a
list of supported graphics formats and related issues.</p>
-</div>
-<a name="N10278"></a><a name="graphic-resolution"></a>
-<h4 class="faq">3.5. Why is my graphic rendered at a different resolution than it was created?</h4>
-<div align="right">
-<a href="#graphic-resolution-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="graphic-resolution"></a>
+<h3 class="underlined_5">3.5. Why is my graphic rendered at a different resolution than it was created?</h3>
<p>See <a href="1.0/graphics.html#resolution">Graphics Resolution</a>.</p>
-</div>
-<a name="N10284"></a><a name="keep-with"></a>
-<h4 class="faq">3.6. Keep-with-next, keep-with-previous, keep-together
- don't work.</h4>
-<div align="right">
-<a href="#keep-with-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="keep-with"></a>
+<h3 class="underlined_5">3.6. Keep-with-next, keep-with-previous, keep-together
+ don't work.</h3>
<p>
Current FOP releases have extensive support for
these properties. The current release, FOP 1.0, still supports the
@@ -1187,13 +1037,8 @@ Check the following:</p>
<p>
Consider upgrading to the latest version which supports keeps.
</p>
-</div>
-<a name="N10299"></a><a name="table-missing"></a>
-<h4 class="faq">3.7. My tables are missing, or missing their content.</h4>
-<div align="right">
-<a href="#table-missing-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="table-missing"></a>
+<h3 class="underlined_5">3.7. My tables are missing, or missing their content.</h3>
<p>
Check for <span class="codefrag">fo:table-body</span> around the rows. Usually FOP will catch this problem.
</p>
@@ -1203,14 +1048,9 @@ Check the following:</p>
message for this problem. Older DocBook style sheets generate
<span class="codefrag">fo:table-with-caption</span> elements, so watch out.
</p>
-</div>
-<a name="N102AD"></a><a name="cells-overflow"></a>
-<h4 class="faq">3.8. Text overflowing table cells and the like is not clipped. Long
- text flows into adjacent cells/block, obscuring stuff there.</h4>
-<div align="right">
-<a href="#cells-overflow-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="cells-overflow"></a>
+<h3 class="underlined_5">3.8. Text overflowing table cells and the like is not clipped. Long
+ text flows into adjacent cells/block, obscuring stuff there.</h3>
<p>
Since the <span class="codefrag">overflow</span> property doesn't apply to table-cell, you
can wrap the cell content in a block-container and specify
@@ -1241,36 +1081,21 @@ Check the following:</p>
<a class="external" href="http://www.mulberrytech.com/xsl/xsl-list/">XSL list
archive</a> for how to perform these tasks.
</p>
-</div>
-<a name="N102D2"></a><a name="table-cell-wrap"></a>
-<h4 class="faq">3.9. The contents of table cells don’t wrap</h4>
-<div align="right">
-<a href="#table-cell-wrap-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="table-cell-wrap"></a>
+<h3 class="underlined_5">3.9. The contents of table cells don’t wrap</h3>
<p>You probably have <span class="codefrag">keep-together="always"</span> set on the table cell. See <a href="#keep-together">next question</a>.</p>
-</div>
-<a name="N102E1"></a><a name="keep-together"></a>
-<h4 class="faq">3.10. FOP behaves differently from earlier versions when keep-together="always"
- is set on table cells</h4>
-<div align="right">
-<a href="#keep-together-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="keep-together"></a>
+<h3 class="underlined_5">3.10. FOP behaves differently from earlier versions when keep-together="always"
+ is set on table cells</h3>
<p>Support for inline-level keeps has been added in FOP 0.95, and setting
<span class="codefrag">keep-together="always"</span> also implicitly sets
<span class="codefrag">keep-together.within-line="always"</span>, which forbids FOP
to break the text into multiple lines. Set
<span class="codefrag">keep-together.within-column="always"</span> on table-cell instead. It’s a good idea
not to use the shorthand <span class="codefrag">keep-together="always"</span> at all!</p>
-</div>
-<a name="N102F8"></a><a name="row-height-constraint"></a>
-<h4 class="faq">3.11. FOP tells me: "The contents of row 1 are taller than they should be".
- What does that mean?</h4>
-<div align="right">
-<a href="#row-height-constraint-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="row-height-constraint"></a>
+<h3 class="underlined_5">3.11. FOP tells me: "The contents of row 1 are taller than they should be".
+ What does that mean?</h3>
<p>
This is usually caused by setting a "height" on a table-row or table-cell and when
the content is higher than the specified height. By setting "height" (a so-called
@@ -1288,13 +1113,8 @@ Check the following:</p>
right solution is to specify block-progression-dimension.minimum="14pt" instead of
height="14pt".
</p>
-</div>
-<a name="N10307"></a><a name="page-number-align"></a>
-<h4 class="faq">3.12. Page numbers are not properly right aligned.</h4>
-<div align="right">
-<a href="#page-number-align-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="page-number-align"></a>
+<h3 class="underlined_5">3.12. Page numbers are not properly right aligned.</h3>
<p>
This happens for <span class="codefrag">fo:page-number-citation</span> elements if the
citation occurs before FOP formatted the requested page,
@@ -1307,25 +1127,15 @@ Check the following:</p>
The most recent FOP releases should have this problem
fixed. Check whether you can upgrade.
</p>
-</div>
-<a name="N10315"></a><a name="hyphenation-fails"></a>
-<h4 class="faq">3.13. Hyphenation does not work.</h4>
-<div align="right">
-<a href="#hyphenation-fails-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="hyphenation-fails"></a>
+<h3 class="underlined_5">3.13. Hyphenation does not work.</h3>
<p>Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):</p>
<pre class="code"><fo:page-sequence language="fi"></pre>
<p>See <a href="1.0/hyphenation.html#support">Hyphenation Support</a> for details and instructions on using hyphenation with FOP.</p>
<p>Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):</p>
<pre class="code"><fo:block hyphenate="true"></pre>
-</div>
-<a name="N1032F"></a><a name="indent-inheritance"></a>
-<h4 class="faq">3.14. When I use margins, my content in a nested table or block-containers gets indented twice. Is this a bug?</h4>
-<div align="right">
-<a href="#indent-inheritance-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="indent-inheritance"></a>
+<h3 class="underlined_5">3.14. When I use margins, my content in a nested table or block-containers gets indented twice. Is this a bug?</h3>
<p>
No, although you might easily think so. The problem has to do
with property inheritance of the start-indent and end-indent
@@ -1339,13 +1149,8 @@ Check the following:</p>
For further details, please consult the
<a class="external" href="http://wiki.apache.org/xmlgraphics-fop/IndentInheritance">Wiki page on Indent Inheritance</a>.
</p>
-</div>
-<a name="N10344"></a><a name="pdf-ps-java2d-differences"></a>
-<h4 class="faq">3.15. Why is the output of Java2D/AWT-based renderers different than, for example, PDF or PS?</h4>
-<div align="right">
-<a href="#pdf-ps-java2d-differences-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-ps-java2d-differences"></a>
+<h3 class="underlined_5">3.15. Why is the output of Java2D/AWT-based renderers different than, for example, PDF or PS?</h3>
<p>
If you render the same document once to a PNG or TIFF and once into a PDF, the output
may not be the same, i.e. line breaks are different or lines may have different heights.
@@ -1357,130 +1162,74 @@ Check the following:</p>
<a href="1.0/output.html#general-fonts">notes on fonts in the various output formats</a>.
</p>
</div>
-<a name="N10350"></a><a name="part-embedding"></a>
-<h3 class="underlined_5">4. Embedding FOP. Using FOP in a servlet.</h3>
-<a name="N10354"></a><a name="servlet"></a>
-<h4 class="faq">4.1. How do I use FOP in a servlet?</h4>
-<div align="right">
-<a href="#servlet-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-embedding"></a>
+<h2 class="underlined_10">4. Embedding FOP. Using FOP in a servlet.</h2>
+<div class="section">
+<a name="servlet"></a>
+<h3 class="underlined_5">4.1. How do I use FOP in a servlet?</h3>
<p>
See <a href="1.0/servlets.html">Using FOP in a Servlet</a>.
</p>
-</div>
-<a name="N10360"></a><a name="servlet-with-xslt"></a>
-<h4 class="faq">4.2. How do I use FOP in a servlet with an XSLT
- transformation?</h4>
-<div align="right">
-<a href="#servlet-with-xslt-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="servlet-with-xslt"></a>
+<h3 class="underlined_5">4.2. How do I use FOP in a servlet with an XSLT
+ transformation?</h3>
<p>
See <a href="1.0/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</a>.
</p>
-</div>
-<a name="N1036C"></a><a name="servlet-xslt-params"></a>
-<h4 class="faq">4.3. How do I pass parameters to the XSLT transformation?</h4>
-<div align="right">
-<a href="#servlet-xslt-params-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="servlet-xslt-params"></a>
+<h3 class="underlined_5">4.3. How do I pass parameters to the XSLT transformation?</h3>
<p>
See <a href="1.0/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</a>.
</p>
-</div>
-<a name="N10378"></a><a name="servlet-nonstd-fonts"></a>
-<h4 class="faq">4.4. How do I use my own fonts when running FOP from a servlet?</h4>
-<div align="right">
-<a href="#servlet-nonstd-fonts-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="servlet-nonstd-fonts"></a>
+<h3 class="underlined_5">4.4. How do I use my own fonts when running FOP from a servlet?</h3>
<p>
Declare the fonts in the <span class="codefrag">userconfig.xml</span> file as usual.
See <a href="#usercfg">loading the user configuration file</a>
for further details.
</p>
-</div>
-<a name="N10387"></a><a name="servlet-baseDir"></a>
-<h4 class="faq">4.5. How do I set the baseDir property in a servlet environment?</h4>
-<div align="right">
-<a href="#servlet-baseDir-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="servlet-baseDir"></a>
+<h3 class="underlined_5">4.5. How do I set the baseDir property in a servlet environment?</h3>
<p>
See <a href="1.0/embedding.html#config-internal">Setting the Configuration Programmatically</a>.
</p>
-</div>
-<a name="N10393"></a><a name="usercfg"></a>
-<h4 class="faq">4.6. How do I use a user configuration file from a servlet?</h4>
-<div align="right">
-<a href="#usercfg-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="usercfg"></a>
+<h3 class="underlined_5">4.6. How do I use a user configuration file from a servlet?</h3>
<p>
See <a href="1.0/embedding.html#config-external">Using a Configuration File in an Embedded App</a>.
</p>
-</div>
-<a name="N1039F"></a><a name="servlet-NoClassDefFound"></a>
-<h4 class="faq">4.7. I keep getting NoClassDefFound and other exceptions. How do I
- get FOP working for various servlet engines?</h4>
-<div align="right">
-<a href="#servlet-NoClassDefFound-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="servlet-NoClassDefFound"></a>
+<h3 class="underlined_5">4.7. I keep getting NoClassDefFound and other exceptions. How do I
+ get FOP working for various servlet engines?</h3>
<p>
See <a href="1.0/servlets.html#servlet-engine">Servlet Engines</a>.
</p>
-</div>
-<a name="N103AB"></a><a name="multithreaded"></a>
-<h4 class="faq">4.8. Can FOP be used in multithreaded environments?</h4>
-<div align="right">
-<a href="#multithreaded-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="multithreaded"></a>
+<h3 class="underlined_5">4.8. Can FOP be used in multithreaded environments?</h3>
<p>
See <a href="1.0/embedding.html#multithreading">Multithreading FOP</a>.
</p>
</div>
-<a name="N103B7"></a><a name="part-svg"></a>
-<h3 class="underlined_5">5. SVG specific questions</h3>
-<a name="N103BB"></a><a name="svg-text"></a>
-<h4 class="faq">5.1. The rendering of SVG text in my PDF is of poor quality.
-Can I control this?</h4>
-<div align="right">
-<a href="#svg-text-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-svg"></a>
+<h2 class="underlined_10">5. SVG specific questions</h2>
+<div class="section">
+<a name="svg-text"></a>
+<h3 class="underlined_5">5.1. The rendering of SVG text in my PDF is of poor quality.
+Can I control this?</h3>
<p>See <a href="1.0/graphics.html#svg-pdf-text">Placing SVG Text into PDF</a>.</p>
-</div>
-<a name="N103C7"></a><a name="svg-headless"></a>
-<h4 class="faq">5.2. How do I use FOP with SVG on headless servers?</h4>
-<div align="right">
-<a href="#svg-headless-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="svg-headless"></a>
+<h3 class="underlined_5">5.2. How do I use FOP with SVG on headless servers?</h3>
<p>See <a href="1.0/graphics.html#batik">FOP: Graphics (Batik)</a>.</p>
-</div>
-<a name="N103D3"></a><a name="svghangs"></a>
-<h4 class="faq">5.3. FOP does not exit if a SVG is included.</h4>
-<div align="right">
-<a href="#svghangs-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="svghangs"></a>
+<h3 class="underlined_5">5.3. FOP does not exit if a SVG is included.</h3>
<p>
Applies to older FOP versions and JDK 1.3 and older. That's because
there is an AWT thread hanging around. The solution is to put a
System.exit(0) somewhere.
</p>
-</div>
-<a name="N103DB"></a><a name="svg-url"></a>
-<h4 class="faq">5.4. I have problems with SVG referring to gradients etc. using
- "uri(#stuff)". I get a MalformedURLException.</h4>
-<div align="right">
-<a href="#svg-url-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="svg-url"></a>
+<h3 class="underlined_5">5.4. I have problems with SVG referring to gradients etc. using
+ "uri(#stuff)". I get a MalformedURLException.</h3>
<p>
This is really a "resolving relative URI" problem with some
twists. The problem is that the <span class="codefrag">#stuff</span> URL fragment
@@ -1528,21 +1277,11 @@ Can I control this?</h4>
</p>
<p>See also <a href="#MalformedURL">MalformedURLException</a>
</p>
-</div>
-<a name="N10407"></a><a name="svg-scaling"></a>
-<h4 class="faq">5.5. Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?</h4>
-<div align="right">
-<a href="#svg-scaling-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="svg-scaling"></a>
+<h3 class="underlined_5">5.5. Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?</h3>
<p>See <a href="1.0/graphics.html#svg-scaling">SVG Scaling</a>.</p>
-</div>
-<a name="N10413"></a><a name="svg-attribute-required"></a>
-<h4 class="faq">5.6. FOP fails with something like "The attribute "width" of the element <rect> is required". What's wrong?</h4>
-<div align="right">
-<a href="#svg-attribute-required-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="svg-attribute-required"></a>
+<h3 class="underlined_5">5.6. FOP fails with something like "The attribute "width" of the element <rect> is required". What's wrong?</h3>
<p>
This phenomenon is not a
bug in FOP, but rather in the dependent packages: Apache Batik, Apache Xalan-J and SAXON. The bug in Apache Batik will be
@@ -1562,26 +1301,18 @@ Can I control this?</h4>
you must place Xalan-J in the <span class="codefrag">"lib/endorsed"</span> directory of your JRE.
</p>
</div>
-<a name="N1042E"></a><a name="part-pdf"></a>
-<h3 class="underlined_5">6. PDF specific (includes Acrobat peculiarities)</h3>
-<a name="N10432"></a><a name="pdf-embed-font"></a>
-<h4 class="faq">6.1. How do I embed fonts in PDF?</h4>
-<div align="right">
-<a href="#pdf-embed-font-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-pdf"></a>
+<h2 class="underlined_10">6. PDF specific (includes Acrobat peculiarities)</h2>
+<div class="section">
+<a name="pdf-embed-font"></a>
+<h3 class="underlined_5">6.1. How do I embed fonts in PDF?</h3>
<p>
See the <a href="1.0/fonts.html">Fonts</a> page for information
about embedding fonts.
</p>
-</div>
-<a name="N1043E"></a><a name="pdf-characters"></a>
-<h4 class="faq">6.2. Some characters are not displayed, or displayed incorrectly, or
- displayed as “#”.</h4>
-<div align="right">
-<a href="#pdf-characters-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-characters"></a>
+<h3 class="underlined_5">6.2. Some characters are not displayed, or displayed incorrectly, or
+ displayed as “#”.</h3>
<p>
This usually means the selected font doesn't have a glyph
for the character.
@@ -1611,50 +1342,25 @@ Can I control this?</h4>
required character, for example if you try:
</p>
<pre class="code"><fo:inline font-family="Helvetica">&#x2205;</fo:inline></pre>
-</div>
-<a name="N10462"></a><a name="pdf-postprocess"></a>
-<h4 class="faq">6.3. What tools are available for post-processing my PDF document?</h4>
-<div align="right">
-<a href="#pdf-postprocess-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-postprocess"></a>
+<h3 class="underlined_5">6.3. What tools are available for post-processing my PDF document?</h3>
<p>See <a href="1.0/output.html#pdf-postprocess">PDF Post-processing</a>.</p>
-</div>
-<a name="N1046E"></a><a name="pdf-security"></a>
-<h4 class="faq">6.4. How do I add security features (encryption, disable printing)
- to my PDF document?</h4>
-<div align="right">
-<a href="#pdf-security-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-security"></a>
+<h3 class="underlined_5">6.4. How do I add security features (encryption, disable printing)
+ to my PDF document?</h3>
<p>
See <a href="1.0/pdfencryption.html">PDF Encryption</a>.
See also <a href="1.0/output.html#pdf-postprocess">PDF Post-processing</a>.
</p>
-</div>
-<a name="N1047E"></a><a name="pdf-doc-properties"></a>
-<h4 class="faq">6.5. How do I add document properties (title, author, etc.) to my
- PDF document?</h4>
-<div align="right">
-<a href="#pdf-doc-properties-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-doc-properties"></a>
+<h3 class="underlined_5">6.5. How do I add document properties (title, author, etc.) to my
+ PDF document?</h3>
<p>See <a href="1.0/metadata.html">Metadata</a>.</p>
-</div>
-<a name="N1048A"></a><a name="pdf-watermark"></a>
-<h4 class="faq">6.6. How do I add watermarks to my PDF document?</h4>
-<div align="right">
-<a href="#pdf-watermark-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-watermark"></a>
+<h3 class="underlined_5">6.6. How do I add watermarks to my PDF document?</h3>
<p>See <a href="1.0/output.html#pdf-watermark">PDF Watermarks</a>.</p>
-</div>
-<a name="N10496"></a><a name="pdf-print-contortion"></a>
-<h4 class="faq">6.7. The PDF is printed contorted!</h4>
-<div align="right">
-<a href="#pdf-print-contortion-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-print-contortion"></a>
+<h3 class="underlined_5">6.7. The PDF is printed contorted!</h3>
<p>
Check the paper size in Acrobat settings and the "fit to page" print
setting. Contorted printing is often caused by a mismatched paper
@@ -1662,13 +1368,8 @@ Can I control this?</h4>
made for A4. Sometimes also the printer driver interferes, check its
settings too.
</p>
-</div>
-<a name="N1049E"></a><a name="pdf-bookmark-display"></a>
-<h4 class="faq">6.8. How do I control the Acrobat bookmark display?</h4>
-<div align="right">
-<a href="#pdf-bookmark-display-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="pdf-bookmark-display"></a>
+<h3 class="underlined_5">6.8. How do I control the Acrobat bookmark display?</h3>
<p>
FOP supports the starting-state property of the XSL 1.1
<a class="external" href="http://www.w3.org/TR/xsl11/#fo_bookmark">fo:bookmark</a>
@@ -1677,13 +1378,8 @@ Can I control this?</h4>
<a class="external" href="http://www.w3.org/TR/xsl11/#fo_bookmark-title">fo:bookmark-title</a>
are not yet supported, though.
</p>
-</div>
-<a name="N104AE"></a><a name="acrobat-anti-aliasing"></a>
-<h4 class="faq">6.9. How can I get rid of strange single-pixel lines inside table borders or between table cells in Adobe Acrobat?</h4>
-<div align="right">
-<a href="#acrobat-anti-aliasing-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="acrobat-anti-aliasing"></a>
+<h3 class="underlined_5">6.9. How can I get rid of strange single-pixel lines inside table borders or between table cells in Adobe Acrobat?</h3>
<p>
Since Apache FOP supports the collapsed border model, every border segment consists
of two separate shapes. This is due to the fact that each side of the border
@@ -1710,8 +1406,8 @@ Can I control this?</h4>
<p>
Here an example of how the effect can look like (left: anti-aliasing on, right: anti-aliasing off):
</p>
-<div id="" style="text-align: center;">
-<img id="" class="figure" alt="Left: anti-aliasing on, Right: off" src="images/acrobat-anti-aliasing-artifacts.png"></div>
+<div style="text-align: center;">
+<img class="figure" alt="Left: anti-aliasing on, Right: off" src="images/acrobat-anti-aliasing-artifacts.png"></div>
<p>
Unfortunately, it is not possible to control the above settings from within the PDF file.
The user has to change these settings himself. Improving FOP to avoid this kind of problem
@@ -1721,26 +1417,18 @@ Can I control this?</h4>
of effort required.
</p>
</div>
-<a name="N104C6"></a><a name="part-iex"></a>
-<h3 class="underlined_5">7. IEx specific stuff</h3>
-<a name="N104CA"></a><a name="iex-servlet-multiple"></a>
-<h4 class="faq">7.1. The FOP servlet is called multiple times!</h4>
-<div align="right">
-<a href="#iex-servlet-multiple-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-iex"></a>
+<h2 class="underlined_10">7. IEx specific stuff</h2>
+<div class="section">
+<a name="iex-servlet-multiple"></a>
+<h3 class="underlined_5">7.1. The FOP servlet is called multiple times!</h3>
<p>
This is a problem of Internet Explorer requesting the content several
times. Please see the <a href="1.0/servlets.html#ie">notes on Internet Explorer</a>
for more information.
</p>
-</div>
-<a name="N104D6"></a><a name="iex-pdf-print-from-browser"></a>
-<h4 class="faq">7.2. How do I print PDF directly from the browser?</h4>
-<div align="right">
-<a href="#iex-pdf-print-from-browser-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="iex-pdf-print-from-browser"></a>
+<h3 class="underlined_5">7.2. How do I print PDF directly from the browser?</h3>
<p>
It depends whether you mean "printing to a printer under control of
the server" or "printing on the client's printer".
@@ -1757,197 +1445,109 @@ Can I control this?</h4>
should not be relied on except in tightly controlled environments.
</p>
<p>
- See also <a class="external" href="http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2">http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2</a>
+ See also <a class="external" href="http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2">http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2</a>
</p>
</div>
-<a name="N104EB"></a><a name="part-input"></a>
-<h3 class="underlined_5">8. General questions regarding XSLT, XSLFO, and basic XML</h3>
-<a name="N104EF"></a><a name="fo-center"></a>
-<h4 class="faq">8.1. (FO) How do I vertically center an image or a table (or
- whatever)?</h4>
-<div align="right">
-<a href="#fo-center-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-input"></a>
+<h2 class="underlined_10">8. General questions regarding XSLT, XSLFO, and basic XML</h2>
+<div class="section">
+<a name="fo-center"></a>
+<h3 class="underlined_5">8.1. (FO) How do I vertically center an image or a table (or
+ whatever)?</h3>
<p>
See <a href="fo.html#fo-center-vertical">XSL-FO Vertical Centering</a>.
</p>
-</div>
-<a name="N104FB"></a><a name="fo-center-table-horizon"></a>
-<h4 class="faq">8.2. (FO) How do I center a table horizontally?</h4>
-<div align="right">
-<a href="#fo-center-table-horizon-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-center-table-horizon"></a>
+<h3 class="underlined_5">8.2. (FO) How do I center a table horizontally?</h3>
<p>
See <a href="fo.html#fo-center-table-horizon">XSL-FO Horizontal Centering (Tables)</a>.
</p>
-</div>
-<a name="N10507"></a><a name="fo-page-outer"></a>
-<h4 class="faq">8.3. (FO) How to get page numbers printed on the "outer side" of the
- page (for books, for example)?</h4>
-<div align="right">
-<a href="#fo-page-outer-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-page-outer"></a>
+<h3 class="underlined_5">8.3. (FO) How to get page numbers printed on the "outer side" of the
+ page (for books, for example)?</h3>
<p>
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content Differences</a>.
</p>
-</div>
-<a name="N10513"></a><a name="oddeven"></a>
-<h4 class="faq">8.4. (FO) How do I use different static content for odd and even
- pages?</h4>
-<div align="right">
-<a href="#oddeven-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="oddeven"></a>
+<h3 class="underlined_5">8.4. (FO) How do I use different static content for odd and even
+ pages?</h3>
<p>
See <a href="fo.html#fo-oddeven">Recto/Verso Static Content Differences</a>.
</p>
-</div>
-<a name="N1051F"></a><a name="fo-first-page-header"></a>
-<h4 class="faq">8.5. (FO) How do I get a special header on the first page?</h4>
-<div align="right">
-<a href="#fo-first-page-header-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-first-page-header"></a>
+<h3 class="underlined_5">8.5. (FO) How do I get a special header on the first page?</h3>
<p>
See <a href="fo.html#fo-first-page">Making the First Page Special</a>.
</p>
-</div>
-<a name="N1052B"></a><a name="fo-omit-headers"></a>
-<h4 class="faq">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?</h4>
-<div align="right">
-<a href="#fo-omit-headers-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-omit-headers"></a>
+<h3 class="underlined_5">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?</h3>
<p>
See <a href="fo.html#fo-blank-pages">Blank Pages</a>.
</p>
-</div>
-<a name="N10537"></a><a name="fo-special-symbols"></a>
-<h4 class="faq">8.7. (FO) How do I print an Euro sign, a checkbox or other some other
- special symbols?</h4>
-<div align="right">
-<a href="#fo-special-symbols-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-special-symbols"></a>
+<h3 class="underlined_5">8.7. (FO) How do I print an Euro sign, a checkbox or other some other
+ special symbols?</h3>
<p>
See <a href="fo.html#xml-special-chars">Special Characters</a>.
</p>
-</div>
-<a name="N10543"></a><a name="fo-preformat"></a>
-<h4 class="faq">8.8. (FO) How do I keep linebreaks and hard spaces? How do I get
- preformatted text displayed as expected?</h4>
-<div align="right">
-<a href="#fo-preformat-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-preformat"></a>
+<h3 class="underlined_5">8.8. (FO) How do I keep linebreaks and hard spaces? How do I get
+ preformatted text displayed as expected?</h3>
<p>
See <a href="fo.html#fo-preformat">Preformatting Content</a>.
</p>
-</div>
-<a name="N1054F"></a><a name="fo-total-pages"></a>
-<h4 class="faq">8.9. (FO) How do I print the total number of pages, for example "page 1
- of 12"</h4>
-<div align="right">
-<a href="#fo-total-pages-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-total-pages"></a>
+<h3 class="underlined_5">8.9. (FO) How do I print the total number of pages, for example "page 1
+ of 12"</h3>
<p>
See <a href="fo.html#fo-total-pages">Total Document Pages</a>.
</p>
-</div>
-<a name="N1055B"></a><a name="fo-region-overlap"></a>
-<h4 class="faq">8.10. (FO) The header overlaps body content. The body extends into
- the footer.</h4>
-<div align="right">
-<a href="#fo-region-overlap-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-region-overlap"></a>
+<h3 class="underlined_5">8.10. (FO) The header overlaps body content. The body extends into
+ the footer.</h3>
<p>
See <a href="fo.html#fo-region-align">Aligning Regions</a>.
</p>
-</div>
-<a name="N10567"></a><a name="fo-lines"></a>
-<h4 class="faq">8.11. (FO) How do I get lines in the document, as separators, side
- bars or folding marks?</h4>
-<div align="right">
-<a href="#fo-lines-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-lines"></a>
+<h3 class="underlined_5">8.11. (FO) How do I get lines in the document, as separators, side
+ bars or folding marks?</h3>
<p>
See <a href="fo.html#fo-lines">Drawing Lines</a>.
</p>
-</div>
-<a name="N10573"></a><a name="fo-validate"></a>
-<h4 class="faq">8.12. (FO) How do I validate my FO document?</h4>
-<div align="right">
-<a href="#fo-validate-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="fo-validate"></a>
+<h3 class="underlined_5">8.12. (FO) How do I validate my FO document?</h3>
<p>
See <a href="fo.html#fo-validate">Validating XSL-FO</a>.
</p>
-</div>
-<a name="N1057F"></a><a name="xml-non-breaking-space"></a>
-<h4 class="faq">8.13. (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;.</h4>
-<div align="right">
-<a href="#xml-non-breaking-space-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xml-non-breaking-space"></a>
+<h3 class="underlined_5">8.13. (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;.</h3>
<p>
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
-</div>
-<a name="N1058E"></a><a name="xml-undefined-entities"></a>
-<h4 class="faq">8.14. (XML) How do I enter special characters in XML? There are complaints about undefined entities, such as &uuml;, which work in HTML. </h4>
-<div align="right">
-<a href="#xml-undefined-entities-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xml-undefined-entities"></a>
+<h3 class="underlined_5">8.14. (XML) How do I enter special characters in XML? There are complaints about undefined entities, such as &uuml;, which work in HTML. </h3>
<p>
See <a href="fo.html#xml-special-chars">XML Special Characters</a>.
</p>
-</div>
-<a name="N1059D"></a><a name="xml-illegal-entities"></a>
-<h4 class="faq">8.15. (XML) There are complaints about illegal characters and entities
- in the input.</h4>
-<div align="right">
-<a href="#xml-illegal-entities-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xml-illegal-entities"></a>
+<h3 class="underlined_5">8.15. (XML) There are complaints about illegal characters and entities
+ in the input.</h3>
<p>
See <a href="fo.html#xml-entity-chars">Using HTML Character Names</a>.
</p>
-</div>
-<a name="N105A9"></a><a name="xml-illegal-chars"></a>
-<h4 class="faq">8.16. (XML) There are complaints about illegal bytes or characters in
- the input. There are odd characters in the result.</h4>
-<div align="right">
-<a href="#xml-illegal-chars-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xml-illegal-chars"></a>
+<h3 class="underlined_5">8.16. (XML) There are complaints about illegal bytes or characters in
+ the input. There are odd characters in the result.</h3>
<p>
See <a href="fo.html#xml-encoding">XML Encoding Issues</a>.
</p>
-</div>
-<a name="N105B5"></a><a name="xslt-current-date"></a>
-<h4 class="faq">8.17. (XSLT) How can I use the current date and time in my document?</h4>
-<div align="right">
-<a href="#xslt-current-date-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xslt-current-date"></a>
+<h3 class="underlined_5">8.17. (XSLT) How can I use the current date and time in my document?</h3>
<p>See <a href="fo.html#xslt-date">Current Date and Time</a>.</p>
-</div>
-<a name="N105C1"></a><a name="xhtml-to-pdf"></a>
-<h4 class="faq">8.18. Can I use FOP to convert XHTML or HTML files to PDF?</h4>
-<div align="right">
-<a href="#xhtml-to-pdf-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xhtml-to-pdf"></a>
+<h3 class="underlined_5">8.18. Can I use FOP to convert XHTML or HTML files to PDF?</h3>
<p>
You will get better results if you transform your source
XML directly into XSLFO. It is tempting to use the
@@ -1965,13 +1565,8 @@ Can I control this?</h4>
representations can be handled differently. Setting this
up requires experience and most likely extensive prototyping.
</p>
-</div>
-<a name="N105C9"></a><a name="xhtml-to-pdf2"></a>
-<h4 class="faq">8.19. I know it may be a bad idea to use FOP to convert XHTML or HTML files to PDF, but I want to do it anyway. Are there any tools available to help me?</h4>
-<div align="right">
-<a href="#xhtml-to-pdf2-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="xhtml-to-pdf2"></a>
+<h3 class="underlined_5">8.19. I know it may be a bad idea to use FOP to convert XHTML or HTML files to PDF, but I want to do it anyway. Are there any tools available to help me?</h3>
<p>
The <a href="resources.html">FOP Resources page</a> has links
to a tool called <a class="external" href="http://html2fo.sourceforge.net/">html2fo</a>
@@ -1980,38 +1575,27 @@ Can I control this?</h4>
page.
</p>
</div>
-<a name="N105DD"></a><a name="dev-help"></a>
-<h3 class="underlined_5">9. Development-related Questions.</h3>
-<a name="N105E1"></a><a name="doc-mgt"></a>
-<h4 class="faq">9.1. Where can I learn how the FOP docs and web site are built?</h4>
-<div align="right">
-<a href="#doc-mgt-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="dev-help"></a>
+<h2 class="underlined_10">9. Development-related Questions.</h2>
+<div class="section">
+<a name="doc-mgt"></a>
+<h3 class="underlined_5">9.1. Where can I learn how the FOP docs and web site are built?</h3>
<p>
See FOP <a href="dev/doc.html">Doc Management</a>. ;-)
</p>
</div>
-<a name="N105ED"></a><a name="part-help"></a>
-<h3 class="underlined_5">10. General suggestions. How to solve problems.</h3>
-<a name="N105F1"></a><a name="bugs"></a>
-<h4 class="faq">10.1. I think I have found a bug in FOP. What should I do?</h4>
-<div align="right">
-<a href="#bugs-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="part-help"></a>
+<h2 class="underlined_10">10. General suggestions. How to solve problems.</h2>
+<div class="section">
+<a name="bugs"></a>
+<h3 class="underlined_5">10.1. I think I have found a bug in FOP. What should I do?</h3>
<p>
See <a href="bugs.html">the Bugs page</a> for information about
bugs already reported and how to report new ones.
</p>
-</div>
-<a name="N105FD"></a><a name="postquestions"></a>
-<h4 class="faq">10.2. I have questions that are not addressed in this FAQ. Where
- should I post them?</h4>
-<div align="right">
-<a href="#postquestions-menu">^</a>
-</div>
-<div style="margin-left: 15px">
+<a name="postquestions"></a>
+<h3 class="underlined_5">10.2. I have questions that are not addressed in this FAQ. Where
+ should I post them?</h3>
<p>
<ul>
@@ -2097,7 +1681,6 @@ Can I control this?</h4>
</p>
</div>
</div>
-</div>
<!--+
|end content
+-->
@@ -2115,7 +1698,10 @@ document.write("Last Published: " + docu
<div class="copyright">
Copyright ©
1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
-</div>
+<br>
+ Apache, Apache FOP, the Apache feather logo, and the Apache FOP
+ logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
<!--+
|end bottomstrip
+-->
Modified: xmlgraphics/site/deploy/fop/faq.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/faq.pdf?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/faq.pdf (original) and xmlgraphics/site/deploy/fop/faq.pdf Thu Aug 25 08:04:24 2011 differ
Modified: xmlgraphics/site/deploy/fop/faq.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/faq.xml?rev=1161429&r1=1161428&r2=1161429&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/faq.xml (original)
+++ xmlgraphics/site/deploy/fop/faq.xml Thu Aug 25 08:04:24 2011
@@ -13,7 +13,7 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
---><!-- $Id$ --><document><header><title>FOP FAQ</title></header><body><section id="Questions"><title>Questions</title><section id="part-general"><title>1. General questions</title><section id="fop-general"><title>1.1. What is FOP?</title>
+--><!-- $Id$ --><document><header><title>FOP FAQ</title></header><body><section id="part-general"><title>1. General questions</title><section id="fop-general"><title>1.1. What is FOP?</title>
<p>
FOP is a print formatter for <link href="#XSLFO">XSL formatting
objects</link>.
@@ -974,4 +974,4 @@ Can I control this?</title>
to an appropriate Java specific list.
</li>
</ul>
- </p></section></section></section></body></document>
+ </p></section></section></body></document>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org