From 5fbedcde6cbfab4c94e9c4227864a6b14fd04abc Mon Sep 17 00:00:00 2001 From: William Victor Mote Date: Sat, 15 Mar 2003 18:49:56 +0000 Subject: [PATCH] 1. Break "stumbling blocks" section into two pieces: (a) runtime problems (b) output problems 2. Add ids for each part, hopefully to get consistent cross-references for them as well. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196106 13f79535-47bb-0310-9956-ffa450edef68 --- src/documentation/content/xdocs/faq.xml | 111 ++++++++++++------------ 1 file changed, 57 insertions(+), 54 deletions(-) diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index 7a996fa83..6d8962c88 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -3,7 +3,7 @@ "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/faq-v11.dtd"> - + General questions What is FOP? @@ -120,33 +120,8 @@ - - Common stumbling blocks - - Why does FOP insert a blank page between my page sequences? - -

- This is because spec conformance has been improved. -

-

- The force-page-count - property controls how a FO processor pads page sequences in - order to get certain page counts or last page numbers. The default is - "auto". With this setting, if the next page sequence - begins with an odd page number because you set the - initial-page-number, and the current page sequence also ends with an - odd page number, the processor inserts a blank page to keep odd and - even page numbers alternating (similar for the case the current page - sequence ends with an even page number and the next page sequence - starts with an even page number. -

-

- If you don't want to have this blank page, use - force-page-count="no-force". -

-
-
+ + Problems running FOP I get the error: [ERROR]: 'master-reference' for 'fo:page-sequence'matches no 'simple-page-master' or @@ -168,25 +143,6 @@

- - My PNG images don't work. - -

- The Jimi image library, which is by default used for processing - images in PNG and other formats, was removed from the distribution - for licensing reasons. You have to download - and install it by yourself. -

-

- Extract the file "JimiProClasses.zip" from the archive you've downloaded, rename it to "jimi-1.0.jar" and move it to FOP's lib directory. -

-

- An alternative to Jimi is to use Sun's JAI. It is much faster, but - not available for all platforms. -

-
-
I get a NoClassDefFound exception. @@ -443,6 +399,53 @@

+
+ + Problems with FOP output + + Why does FOP insert a blank page between my page sequences? + +

+ This is because spec conformance has been improved. +

+

+ The force-page-count + property controls how a FO processor pads page sequences in + order to get certain page counts or last page numbers. The default is + "auto". With this setting, if the next page sequence + begins with an odd page number because you set the + initial-page-number, and the current page sequence also ends with an + odd page number, the processor inserts a blank page to keep odd and + even page numbers alternating (similar for the case the current page + sequence ends with an even page number and the next page sequence + starts with an even page number. +

+

+ If you don't want to have this blank page, use + force-page-count="no-force". +

+
+
+ + My PNG images don't work. + +

+ The Jimi image library, which is by default used for processing + images in PNG and other formats, was removed from the distribution + for licensing reasons. You have to download + and install it by yourself. +

+

+ Extract the file "JimiProClasses.zip" from the archive you've downloaded, rename it to "jimi-1.0.jar" and move it to FOP's lib directory. +

+

+ An alternative to Jimi is to use Sun's JAI. It is much faster, but + not available for all platforms. +

+
+
Keep-with-next, keep-with-previous, keep-together don't work. @@ -588,7 +591,7 @@
- + Embedding FOP. Using FOP in a servlet. How do I use FOP in a servlet? @@ -785,7 +788,7 @@ transformer.transform(xmlsource, new SAXResult(driver.getContentHandler())); - + Batik/SVG specific questions SVG text rendered in bad quality. How do I put SVG text as text @@ -907,7 +910,7 @@ transformer.transform(xmlsource, new SAXResult(driver.getContentHandler())); - + PDF specific (includes Acrobat peculiarities) How do I embed fonts in PDF? @@ -1083,7 +1086,7 @@ transformer.transform(xmlsource, new SAXResult(driver.getContentHandler())); - + IEx specific stuff The FOP servlet is called multiple times! @@ -1141,7 +1144,7 @@ transformer.transform(xmlsource, new SAXResult(driver.getContentHandler())); - + More general questions regarding XSLT and XSLFO and basic XML (FO) How do I vertically center an image or a table (or @@ -1644,7 +1647,7 @@ class rendtest { - + General Developer Questions How do I get the javadocs for FOP? @@ -1655,7 +1658,7 @@ class rendtest { - + General suggestions. How to solve problems. Where to post bugs. -- 2.39.5