vmote 2003/03/15 10:49:56 Modified: src/documentation/content/xdocs faq.xml Log: 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. Revision Changes Path 1.11 +57 -54 xml-fop/src/documentation/content/xdocs/faq.xml Index: faq.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/faq.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- faq.xml 12 Mar 2003 01:41:22 -0000 1.10 +++ faq.xml 15 Mar 2003 18:49:56 -0000 1.11 @@ -3,7 +3,7 @@ "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/faq-v11.dtd"> <faqs title="FOP FAQ"> - <part> + <part id="part_general"> <title>General questions</title> <faq id="fop_general"> <question>What is FOP?</question> @@ -120,33 +120,8 @@ </answer> </faq> </part> - <part> - <title>Common stumbling blocks</title> - <faq id="blank_page_between_page_sequences"> - <question>Why does FOP insert a blank page between my page sequences?</question> - <answer> - <p> - This is because spec conformance has been improved. - </p> - <p> - The <link - href="http://www.w3.org/TR/xsl/slice7.html#force-page-count">force-page-count - property</link> controls how a FO processor pads page sequences in - order to get certain page counts or last page numbers. The default is - "<code>auto</code>". 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. - </p> - <p> - If you don't want to have this blank page, use - <code>force-page-count="no-force"</code>. - </p> - </answer> - </faq> + <part id="part_running"> + <title>Problems running FOP</title> <faq id="no_page_master"> <question>I get the error: [ERROR]: 'master-reference' for 'fo:page-sequence'matches no 'simple-page-master' or @@ -168,25 +143,6 @@ </p> </answer> </faq> - <faq id="png_fails"> - <question>My PNG images don't work.</question> - <answer> - <p> - 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 <fork - href="http://java.sun.com/products/jimi">download</fork> - and install it by yourself. - </p> - <p> - 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. - </p> - <p> - An alternative to Jimi is to use Sun's JAI. It is much faster, but - not available for all platforms. - </p> - </answer> - </faq> <faq id="NoClassDefFound"> <question>I get a NoClassDefFound exception.</question> <answer> @@ -443,6 +399,53 @@ </p> </answer> </faq> + </part> + <part id="part_output"> + <title>Problems with FOP output</title> + <faq id="blank_page_between_page_sequences"> + <question>Why does FOP insert a blank page between my page sequences?</question> + <answer> + <p> + This is because spec conformance has been improved. + </p> + <p> + The <link + href="http://www.w3.org/TR/xsl/slice7.html#force-page-count">force-page-count + property</link> controls how a FO processor pads page sequences in + order to get certain page counts or last page numbers. The default is + "<code>auto</code>". 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. + </p> + <p> + If you don't want to have this blank page, use + <code>force-page-count="no-force"</code>. + </p> + </answer> + </faq> + <faq id="png_fails"> + <question>My PNG images don't work.</question> + <answer> + <p> + 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 <fork + href="http://java.sun.com/products/jimi">download</fork> + and install it by yourself. + </p> + <p> + 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. + </p> + <p> + An alternative to Jimi is to use Sun's JAI. It is much faster, but + not available for all platforms. + </p> + </answer> + </faq> <faq id="keep-with"> <question>Keep-with-next, keep-with-previous, keep-together don't work.</question> @@ -588,7 +591,7 @@ </answer> </faq> </part> - <part> + <part id="part_embedding"> <title>Embedding FOP. Using FOP in a servlet.</title> <faq id="servlet"> <question>How do I use FOP in a servlet?</question> @@ -785,7 +788,7 @@ </answer> </faq> </part> - <part> + <part id="part_svg"> <title>Batik/SVG specific questions</title> <faq id="svg_text"> <question>SVG text rendered in bad quality. How do I put SVG text as text @@ -907,7 +910,7 @@ </answer> </faq> </part> - <part> + <part id="part_pdf"> <title>PDF specific (includes Acrobat peculiarities)</title> <faq id="pdf_embed_font"> <question>How do I embed fonts in PDF?</question> @@ -1083,7 +1086,7 @@ </answer> </faq> </part> - <part> + <part id="part_iex"> <title>IEx specific stuff</title> <faq id="iex_servlet_multiple"> <question>The FOP servlet is called multiple times!</question> @@ -1141,7 +1144,7 @@ </answer> </faq> </part> - <part> + <part id="part_input"> <title>More general questions regarding XSLT and XSLFO and basic XML</title> <faq id="fo_center"> <question>(FO) How do I vertically center an image or a table (or @@ -1644,7 +1647,7 @@ </answer> </faq> </part> - <part> + <part id="part_developer"> <title>General Developer Questions</title> <faq id="javadoc_location"> <question>How do I get the javadocs for FOP?</question> @@ -1655,7 +1658,7 @@ </answer> </faq> </part> - <part> + <part id="part_help"> <title>General suggestions. How to solve problems.</title> <faq id="bugs"> <question>Where to post bugs.</question>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]