mirror of
https://github.com/apache/xmlgraphics-fop.git
synced 2024-09-14 00:01:49 +02:00
Minor changes to the FAQ
Change 0.94 to 0.95 in links Adapt Opinion about 1.0 release data Mentioned support for keep-* in recent FOP releases Fixed FIXME in last Q regarding alternative XML/XSLT stuff Some minor changes related to 0,94 vs. 0,95 release in some places Additional minor formatting changes to the XML source git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@833607 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
96db64d94e
commit
fe38248279
@ -138,8 +138,10 @@
|
||||
<p>
|
||||
When it's ready and the committers have enough time to go through
|
||||
the time-consuming process of creating a release. We
|
||||
released version 0.94 on 24th August 2007, and intend to
|
||||
release version 1.0 later in late 2007 or early 2008. If you
|
||||
released version 0.95 on August 6th, 2008, and intend to
|
||||
release version 1.0 once we consider it "feature complete", major
|
||||
work is still in progress regarding page flows with changing page width
|
||||
(changing IPD, to be precise). If you
|
||||
want to speed up the process, consider
|
||||
<link href="dev/index.html#involved">contributing</link> to FOP.</p>
|
||||
</answer>
|
||||
@ -211,7 +213,7 @@
|
||||
If you run FOP embedded in your servlet, web application or
|
||||
other Java application, check the classpath of the
|
||||
application. Check the also the information pertaining to <link
|
||||
href="0.94/servlets.html#servlet-engine">servlet engines</link>
|
||||
href="0.95/servlets.html#servlet-engine">servlet engines</link>
|
||||
for further hints.
|
||||
</p>
|
||||
<p>
|
||||
@ -241,7 +243,7 @@
|
||||
<question>I get an OutOfMemoryException.</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/running.html#memory">FOP Memory</link>.
|
||||
See <link href="0.95/running.html#memory">FOP Memory</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -302,7 +304,7 @@
|
||||
<p>
|
||||
If you use XSLT, problems in your style sheet and in your
|
||||
source XML also can produce a NullPointerException. <link
|
||||
href="0.94/running.html#check-input">Run the transformation
|
||||
href="0.95/running.html#check-input">Run the transformation
|
||||
separately</link> to check for this, usually you'll get a
|
||||
detailed error message from the XSLT processor.
|
||||
</p>
|
||||
@ -380,7 +382,7 @@
|
||||
</p>
|
||||
<p>
|
||||
Try also setting the <link
|
||||
href="0.94/configuration.html#general-elements">font-base
|
||||
href="0.95/configuration.html#general-elements">font-base
|
||||
configuration</link>.
|
||||
</p>
|
||||
</answer>
|
||||
@ -439,12 +441,11 @@ public class DefaultErrorListener implements ErrorListener {
|
||||
So this failure doesn't break anything.
|
||||
</p>
|
||||
<p>
|
||||
To avoid the warning you can simply delete the
|
||||
old Font Cache file, which according to [1] lives in ${base}\conf\font.cache.
|
||||
Or you can disable Font Caching altogether using the option "use-cache"
|
||||
</p>
|
||||
<p>
|
||||
[1] http://xmlgraphics.apache.org/fop/0.94/configuration.html#general-elements
|
||||
To avoid the warning you can simply delete the
|
||||
old Font Cache file, which lives in ${base}\conf\font.cache (see <link
|
||||
href="0.95/configuration.html#general-elements">font-base
|
||||
configuration</link>). Or you can disable Font Caching altogether using
|
||||
the option "use-cache."
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -452,7 +453,7 @@ public class DefaultErrorListener implements ErrorListener {
|
||||
<part id="part-output">
|
||||
<title>Problems with FOP output</title>
|
||||
<faq id="leader-expansion">
|
||||
<question>Leaders don't work anymore in 0.94. Instead of
|
||||
<question>Leaders don't work anymore in 0.94 or later. Instead of
|
||||
filling the line, only three dots or a short ruler is
|
||||
output.</question>
|
||||
<answer>
|
||||
@ -533,7 +534,7 @@ Check the following:</p>
|
||||
<p>Other possibilities:</p>
|
||||
<ul>
|
||||
<li>The image format is not supported or not supported completely.
|
||||
See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
|
||||
See <link href="0.95/graphics.html">FOP Graphics Formats</link> for a
|
||||
list of supported formats and related issues.</li>
|
||||
<li>The graphic may be too large to fit into the intended space.</li>
|
||||
<li>There may be something (static content) that is obscuring the
|
||||
@ -545,14 +546,14 @@ Check the following:</p>
|
||||
<faq id="png-fails">
|
||||
<question>My graphical images do not work properly.</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
|
||||
<p>See <link href="0.95/graphics.html">FOP Graphics Formats</link> for a
|
||||
list of supported graphics formats and related issues.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="graphic-resolution">
|
||||
<question>Why is my graphic rendered at a different resolution than it was created?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/graphics.html#resolution">Graphics Resolution</link>.</p>
|
||||
<p>See <link href="0.95/graphics.html#resolution">Graphics Resolution</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="keep-with">
|
||||
@ -560,8 +561,14 @@ Check the following:</p>
|
||||
don't work.</question>
|
||||
<answer>
|
||||
<p>
|
||||
These properties are not implemented on version 0.20.5 and earlier, except on table rows. In
|
||||
order to take advantage of them, you have to nest stuff to be
|
||||
These properties are not implemented on version 0.20.5 and earlier,
|
||||
except on table rows. More recent FOP releases have extensive support for
|
||||
these properties. The current release, FOP 0.95, still supports the
|
||||
values "always" and "never" only, no numerical values. There may be
|
||||
a few places where keep-* still don't work, this should be very rare.
|
||||
</p>
|
||||
<p>
|
||||
If you still have to use FOP 0.20.5, you have to nest stuff to be
|
||||
kept together in a table.
|
||||
</p>
|
||||
<p>
|
||||
@ -705,7 +712,7 @@ Check the following:</p>
|
||||
<answer>
|
||||
<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>
|
||||
<source><![CDATA[<fo:page-sequence language="fi">]]></source>
|
||||
<p>See <link href="0.94/hyphenation.html#support">Hyphenation Support</link> for details and instructions on using hyphenation with FOP.</p>
|
||||
<p>See <link href="0.95/hyphenation.html#support">Hyphenation Support</link> 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>
|
||||
<source><![CDATA[<fo:block hyphenate="true">]]></source>
|
||||
</answer>
|
||||
@ -751,7 +758,7 @@ Check the following:</p>
|
||||
<question>How do I use FOP in a servlet?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/servlets.html">Using FOP in a Servlet</link>.
|
||||
See <link href="0.95/servlets.html">Using FOP in a Servlet</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -760,7 +767,7 @@ Check the following:</p>
|
||||
transformation?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
|
||||
See <link href="0.95/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -768,7 +775,7 @@ Check the following:</p>
|
||||
<question>How do I pass parameters to the XSLT transformation?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
|
||||
See <link href="0.95/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -786,7 +793,7 @@ Check the following:</p>
|
||||
<question>How do I set the baseDir property in a servlet environment?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
|
||||
See <link href="0.95/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -794,7 +801,7 @@ Check the following:</p>
|
||||
<question>How do I use a user configuration file from a servlet?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
|
||||
See <link href="0.95/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -803,7 +810,7 @@ Check the following:</p>
|
||||
get FOP working for various servlet engines?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/servlets.html#servlet-engine">Servlet Engines</link>.
|
||||
See <link href="0.95/servlets.html#servlet-engine">Servlet Engines</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -811,7 +818,7 @@ Check the following:</p>
|
||||
<question>Can FOP be used in multithreaded environments?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/embedding.html#multithreading">Multithreading FOP</link>.
|
||||
See <link href="0.95/embedding.html#multithreading">Multithreading FOP</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -822,13 +829,13 @@ Check the following:</p>
|
||||
<question>The rendering of SVG text in my PDF is of poor quality.
|
||||
Can I control this?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
|
||||
<p>See <link href="0.95/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="svg-headless">
|
||||
<question>How do I use FOP with SVG on headless servers?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
|
||||
<p>See <link href="0.95/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="svghangs">
|
||||
@ -891,7 +898,7 @@ Can I control this?</question>
|
||||
<faq id="svg-scaling">
|
||||
<question>Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/graphics.html#svg-scaling">SVG Scaling</link>.</p>
|
||||
<p>See <link href="0.95/graphics.html#svg-scaling">SVG Scaling</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="svg-attribute-required">
|
||||
@ -924,7 +931,7 @@ Can I control this?</question>
|
||||
<question>How do I embed fonts in PDF?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See the <link href="0.94/fonts.html">Fonts</link> page for information
|
||||
See the <link href="0.95/fonts.html">Fonts</link> page for information
|
||||
about embedding fonts.
|
||||
</p>
|
||||
</answer>
|
||||
@ -943,7 +950,7 @@ Can I control this?</question>
|
||||
set. For a variety of reasons, even those are not completely
|
||||
guaranteed to work, for example you can't use the fi
|
||||
ligature from the standard serif font. Check the <link
|
||||
href="0.94/output.html#pdf-fonts">overview</link> for the default
|
||||
href="0.95/output.html#pdf-fonts">overview</link> for the default
|
||||
PDF fonts.
|
||||
</p>
|
||||
<p>
|
||||
@ -951,7 +958,7 @@ Can I control this?</question>
|
||||
the desired character. Furthermore the font must be
|
||||
available on the machine where the PDF is viewed or it must
|
||||
have been embedded in the PDF file. See <link
|
||||
href="0.94/fonts.html">embedding fonts</link>.
|
||||
href="0.95/fonts.html">embedding fonts</link>.
|
||||
</p>
|
||||
<p>
|
||||
For most symbols, it is better to select the symbol font
|
||||
@ -969,7 +976,7 @@ Can I control this?</question>
|
||||
<faq id="pdf-postprocess">
|
||||
<question>What tools are available for post-processing my PDF document?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
|
||||
<p>See <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="pdf-security">
|
||||
@ -977,8 +984,8 @@ Can I control this?</question>
|
||||
to my PDF document?</question>
|
||||
<answer>
|
||||
<p>
|
||||
See <link href="0.94/pdfencryption.html">PDF Encryption</link>.
|
||||
See also <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.
|
||||
See <link href="0.95/pdfencryption.html">PDF Encryption</link>.
|
||||
See also <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.
|
||||
</p>
|
||||
</answer>
|
||||
</faq>
|
||||
@ -986,13 +993,13 @@ Can I control this?</question>
|
||||
<question>How do I add document properties (title, author, etc.) to my
|
||||
PDF document?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
|
||||
<p>See <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="pdf-watermark">
|
||||
<question>How do I add watermarks to my PDF document?</question>
|
||||
<answer>
|
||||
<p>See <link href="0.94/output.html#pdf-watermark">PDF Watermarks</link>.</p>
|
||||
<p>See <link href="0.95/output.html#pdf-watermark">PDF Watermarks</link>.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
<faq id="pdf-print-contortion">
|
||||
@ -1028,7 +1035,7 @@ Can I control this?</question>
|
||||
<answer>
|
||||
<p>
|
||||
This is a problem of Internet Explorer requesting the content several
|
||||
times. Please see the <link href="0.94/servlets.html#ie">notes on Internet Explorer</link>
|
||||
times. Please see the <link href="0.95/servlets.html#ie">notes on Internet Explorer</link>
|
||||
for more information.
|
||||
</p>
|
||||
</answer>
|
||||
@ -1315,8 +1322,10 @@ Can I control this?</question>
|
||||
bugs and processor specific APIs. Note that JDK 1.4 comes with an
|
||||
XML parser and an XSLT processor which are older versions of
|
||||
Xerces and Xalan, respectively, and both have a number of annoying
|
||||
bugs. See $$$FIXME on how to use more recent versions or other
|
||||
packages instead.
|
||||
bugs. See http://java.sun.com/developer/EJTechTips/2003/tt0311.html
|
||||
and http://java.sun.com/j2se/1.4.2/docs/guide/standards/ (or similar
|
||||
pages for later Java releases) for some hints on how to use more
|
||||
recent versions or other packages instead.
|
||||
</li>
|
||||
<li>
|
||||
Problems with servlet containers should be asked on the vendor
|
||||
@ -1325,7 +1334,7 @@ Can I control this?</question>
|
||||
<li>
|
||||
More general questions regarding Java, including deployment, Java
|
||||
APIs, classpath issues and property definitions should be redirected
|
||||
to some Java specific list.
|
||||
to an appropriate Java specific list.
|
||||
</li>
|
||||
</ul>
|
||||
</answer>
|
||||
|
Loading…
Reference in New Issue
Block a user