xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r841430 - in /websites/staging/xmlgraphics/trunk/content: ./ fop/faq.html
Date Mon, 10 Dec 2012 15:39:29 GMT
Author: buildbot
Date: Mon Dec 10 15:39:28 2012
New Revision: 841430

Log:
Staging update by buildbot for xmlgraphics

Modified:
    websites/staging/xmlgraphics/trunk/content/   (props changed)
    websites/staging/xmlgraphics/trunk/content/fop/faq.html

Propchange: websites/staging/xmlgraphics/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Dec 10 15:39:28 2012
@@ -1 +1 @@
-1419459
+1419528

Modified: websites/staging/xmlgraphics/trunk/content/fop/faq.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/faq.html (original)
+++ websites/staging/xmlgraphics/trunk/content/fop/faq.html Mon Dec 10 15:39:28 2012
@@ -375,7 +375,8 @@ $(document).ready(function () {
 <h3 id="when">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>
 <h3 id="next-release">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 released version 1.0 on 21 July 2010, and will release version
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>
+<p>Generally speaking, definite dates for future release of FOP are not published (or
known for that matter).
+It's planned when it's ready and the committers have enough time to go through the time-consuming
process of creating a release. We released version 1.1 on 20 October 2012. If you want to
speed up the process, consider <a href="dev/index.html#involved">contributing</a>
to FOP.</p>
 <h3 id="redesign">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>
@@ -412,13 +413,13 @@ $(document).ready(function () {
 <p>If this doesn't help, check whether still all the jar files mentioned in the classpath
in the <code>fop.bat</code> file are in their respective places.</p>
 </li>
 </ul>
-<p>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 <a
href="1.0/servlets.html#servlet-engine">servlet engines</a> for further hints.</p>
+<p>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 <a
href="1.1/servlets.html#servlet-engine">servlet engines</a> for further hints.</p>
 <p>If you downloaded the source distribution, or a snapshop from the repository, remember
you have to build the FOP jars first.</p>
 <h3 id="NoSuchMethodException">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.</p>
 <p>Incompatible versions of Batik may also cause this problem. Use the version of Batik
that comes with FOP. It is not always possible to use a more recent version of Batik.</p>
 <h3 id="OutOfMemoryException">2.4. I get an OutOfMemoryException.</h3>
-<p>See <a href="1.0/running.html#memory">FOP Memory</a>.</p>
+<p>See <a href="1.1/running.html#memory">FOP Memory</a>.</p>
 <h3 id="MalformedURL">2.5. I get a MalformedURLException.</h3>
 <p>What you probably think of as "file names" are usually URLs, in particular the <code>src</code>
attribute of fo:external-graphic.</p>
 <p>Because usage of URLs is growing, you should make yourself familiar with it. The
relevant specification is <a href="http://www.rfc-editor.org/rfc/rfc2396.txt">RFC 2396</a>.</p>
@@ -441,7 +442,7 @@ then please <a href="bugs.html#issues_ne
 <h3 id="fonts-not-found">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 metrics-file attribute in the user config file is actually
an URL, not a file name. Use "file:///C:/foo/arial.xml" instead.</p>
 <p>If you used a relative URL, make sure your application has the working directory
you expect. Currently FOP does not use the baseDir for resolving relative URLs pointing to
font metric files.</p>
-<p>Try also setting the <a href="1.0/configuration.html#general-elements">font-base
configuration</a>.</p>
+<p>Try also setting the <a href="1.1/configuration.html#general-elements">font-base
configuration</a>.</p>
 <h3 id="saxexception-mismatch">2.12. I get a SAXException: Mismatch: page-sequence
vs. root (or similar).</h3>
 <p>The full exception usually looks similar to this:
 Mismatch: page-sequence (http://www.w3.org/1999/XSL/Format) vs. root
@@ -473,7 +474,7 @@ This exception is usually a follow-up er
 
 <h3 id="faq-N1026C">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."</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. So this failure doesn't break
anything.</p>
-<p>To avoid the warning you can simply delete the old Font Cache file, which lives
in ${base}\conf\font.cache (see <a href="1.0/configuration.html#general-elements">font-base
configuration</a>).</p>
+<p>To avoid the warning you can simply delete the old Font Cache file, which lives
in ${base}\conf\font.cache (see <a href="1.1/configuration.html#general-elements">font-base
configuration</a>).</p>
 <h2 id="part-output">3. Problems with FOP output</h2>
 <h3 id="leader-expansion">3.1. Leaders don't work in current FOP. Instead of filling
the line, only three dots or a short ruler is output.</h3>
 <p>Leaders still work, in fact they work better than ever before. You'll just have
to add <code>text-align="justify"</code> and/or <code>text-align-last="justify"</code>
to the block with the leader. Be sure you haven't accidentally overridden the <code>leader-length.maximum="100%"</code>
default value.</p>
@@ -501,7 +502,7 @@ This exception is usually a follow-up er
 <p>Other possibilities:</p>
 <ul>
 <li>
-<p>The image format is not supported or not supported completely. See <a href="1.0/graphics.html">FOP
Graphics Formats</a> for a list of supported formats and related issues.</p>
+<p>The image format is not supported or not supported completely. See <a href="1.1/graphics.html">FOP
Graphics Formats</a> for a list of supported formats and related issues.</p>
 </li>
 <li>
 <p>The graphic may be too large to fit into the intended space.</p>
@@ -511,9 +512,9 @@ This exception is usually a follow-up er
 </li>
 </ul>
 <h3 id="png-fails">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>
+<p>See <a href="1.1/graphics.html">FOP Graphics Formats</a> for a list
of supported graphics formats and related issues.</p>
 <h3 id="graphic-resolution">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>
+<p>See <a href="1.1/graphics.html#resolution">Graphics Resolution</a>.</p>
 <h3 id="keep-with">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 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>The concept is called “blind table”. The table is used for pure layout
reasons and is not obvious in the output.</p>
@@ -566,35 +567,35 @@ Consider upgrading to the latest version
 <h3 id="hyphenation-fails">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):
 <fo:page-sequence language="fi">
-See <a href="1.0/hyphenation.html#support">Hyphenation Support</a> for details
and instructions on using hyphenation with FOP.</p>
+See <a href="1.1/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):
 <fo:block hyphenate="true"></p>
 <h3 id="indent-inheritance">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 properties to which the margin properties are mapped. Apache
FOP strictly adheres to the XSL-FO specification here which many other commercial FO implementations
don't do to better meet end-user expectations. You can make FOP behave like these if you set
<code>setBreakIndentInheritanceOnReferenceAreaBoundary(true)</code> on the FOUserAgent.
The better way is to reset <code>start-indent</code> and <code>end-indent</code>
to "0pt" on table-body or block-container. For further details, please consult the <a href="http://wiki.apache.org/xmlgraphics-fop/IndentInheritance">Wiki
page on Indent Inheritance</a>.</p>
 <h3 id="pdf-ps-java2d-differences">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. The
reason for this: The Java2D-based renderers use the font subsystem of Java2D/AWT. The PDF
and PS renderers use FOP's own font subsystem which provides much better font metrics than
Java2D. These can lead to different layout decisions when the same document is rendered with
different renderers. An alternative approach to fix this problem might be available but it
hasn't been tested, yet. See also the <a href="1.0/output.html#general-fonts">notes
on fonts in the various output formats</a>.</p>
+<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. The
reason for this: The Java2D-based renderers use the font subsystem of Java2D/AWT. The PDF
and PS renderers use FOP's own font subsystem which provides much better font metrics than
Java2D. These can lead to different layout decisions when the same document is rendered with
different renderers. An alternative approach to fix this problem might be available but it
hasn't been tested, yet. See also the <a href="1.1/output.html#general-fonts">notes
on fonts in the various output formats</a>.</p>
 <h2 id="part-embedding">4. Embedding FOP. Using FOP in a servlet.</h2>
 <h3 id="servlet">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>
+<p>See [Using FOP in a Servlet][currentFop_servlets].</p>
 <h3 id="servlet-with-xslt">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>
+<p>See <a href="1.1/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</a>.</p>
 <h3 id="servlet-xslt-params">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>
+<p>See <a href="1.1/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</a>.</p>
 <h3 id="servlet-nonstd-fonts">4.4. How do I use my own fonts when running FOP from
a servlet?</h3>
 <p>Declare the fonts in the <code>userconfig.xml</code> file as usual.
See <a href="#usercfg">loading the user configuration file</a> for further details.</p>
 <h3 id="servlet-baseDir">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>
+<p>See <a href="1.1/embedding.html#config-internal">Setting the Configuration
Programmatically</a>.</p>
 <h3 id="usercfg">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>
+<p>See <a href="1.1/embedding.html#config-external">Using a Configuration File
in an Embedded App</a>.</p>
 <h3 id="servlet-NoClassDefFound">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>
+<p>See <a href="1.1/servlets.html#servlet-engine">Servlet Engines</a>.</p>
 <h3 id="multithreaded">4.8. Can FOP be used in multithreaded environments?</h3>
-<p>See <a href="1.0/embedding.html#multithreading">Multithreading FOP</a>.</p>
+<p>See <a href="1.1/embedding.html#multithreading">Multithreading FOP</a>.</p>
 <h2 id="part-svg">5. SVG specific questions</h2>
 <h3 id="svg-text">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>
+<p>See <a href="1.1/graphics.html#svg-pdf-text">Placing SVG Text into PDF</a>.</p>
 <h3 id="svg-headless">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>
+<p>See <a href="1.1/graphics.html#batik">FOP: Graphics (Batik)</a>.</p>
 <h3 id="svghangs">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>
 <h3 id="svg-url">5.4. I have problems with SVG referring to gradients etc. using "uri(#stuff)".
I get a MalformedURLException.</h3>
@@ -617,30 +618,30 @@ See <a href="1.0/hyphenation.html#suppor
 <p>Ultimately, both FOP and especially Batik should be fixed to make your code work
as expected, but this will not only take some time but also some effort by a standard committee
in order to make the semantics of this kind of references in embedded SVG clearer.</p>
 <p>See also <a href="#MalformedURL">MalformedURLException</a></p>
 <h3 id="svg-scaling">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>
+<p>See <a href="1.1/graphics.html#svg-scaling">SVG Scaling</a>.</p>
 <h3 id="svg-attribute-required">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 fixed in the next release.
In the latest release of Apache Xalan-J, the bug is already fixed. It only occurs in the Xalan
version bundled with Sun's JVM, because Sun uses a rather old version.</p>
 <p>Bug description: In a namespace-enabled Level 3 DOM, an attribute in the default
namespace must be set with <code>"null"</code> as the value for the namespace
URI. SAX, on the other side, uses an empty string ("") to designate the default namespace.
Many packages appear to not properly handle this difference in which case they still use the
empty string as the namespace URI parameter for <code>org.w3c.dom.Element.setAttributeNS()</code>.</p>
 <p>Work-around: Use the latest version of Apache Xalan-J. Note that starting with JDK
1.4 it's not enough to replace Xalan-J on the normal application classpath and you need to
override the Xalan-J version bundled with the Sun JVM using the <a href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/">Endorsed
Standards Override Mechanism</a>, i.e. you must place Xalan-J in the <code>"lib/endorsed"</code>
directory of your JRE.</p>
 <h2 id="part-pdf">6. PDF specific (includes Acrobat peculiarities)</h2>
 <h3 id="pdf-embed-font">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>
+<p>See the <a href="1.1/fonts.html">Fonts</a> page for information about
embedding fonts.</p>
 <h3 id="pdf-characters">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.</p>
-<p>The standard text fonts supplied with Acrobat Reader have mostly glyphs for characters
from the ISO Latin 1 character 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 <a href="1.0/output.html#pdf-fonts">overview</a> for the default PDF
fonts.</p>
-<p>If you use your own fonts, the font must have a glyph for 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 <a href="1.0/fonts.html">embedding fonts</a>.</p>
+<p>The standard text fonts supplied with Acrobat Reader have mostly glyphs for characters
from the ISO Latin 1 character 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 <a href="1.1/output.html#pdf-fonts">overview</a> for the default PDF
fonts.</p>
+<p>If you use your own fonts, the font must have a glyph for 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 <a href="1.1/fonts.html">embedding fonts</a>.</p>
 <p>For most symbols, it is better to select the symbol font explicitely, for example
in order to get the symbol for the mathematical empty set, write:
 <fo:inline font-family="Symbol">&#x2205;</fo:inline>
 The "#" shows up if the selected font does not define a glyph for the required character,
for example if you try:
 <fo:inline font-family="Helvetica">&#x2205;</fo:inline></p>
 <h3 id="pdf-postprocess">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>
+<p>See <a href="1.1/output.html#pdf-postprocess">PDF Post-processing</a>.</p>
 <h3 id="pdf-security">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>
+<p>See <a href="1.1/pdfencryption.html">PDF Encryption</a>. See also <a
href="1.1/output.html#pdf-postprocess">PDF Post-processing</a>.</p>
 <h3 id="pdf-doc-properties">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>
+<p>See <a href="1.1/metadata.html">Metadata</a>.</p>
 <h3 id="pdf-watermark">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>
+<p>See <a href="1.1/output.html#pdf-watermark">PDF Watermarks</a>.</p>
 <h3 id="pdf-print-contortion">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 format, for example if the setting is "US Letter"
but the PDF was made for A4. Sometimes also the printer driver interferes, check its settings
too.</p>
 <h3 id="pdf-bookmark-display">6.8. How do I control the Acrobat bookmark display?</h3>
@@ -654,7 +655,7 @@ The "#" shows up if the selected font do
 <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 would be possible although rather hard to achieve because we'd need to add a considerable
amount of code to combine the various line segments. Something like that has been tried already
years ago showing that this is a tricky task. Also, the improvement may not justify the amount
of effort required.</p>
 <h2 id="part-iex">7. IEx specific stuff</h2>
 <h3 id="iex-servlet-multiple">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>
+<p>This is a problem of Internet Explorer requesting the content several times. Please
see the <a href="1.1/servlets.html#ie">notes on Internet Explorer</a> for more
information.</p>
 <h3 id="iex-pdf-print-from-browser">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".</p>
 <p>For the first problem, look at the print servlet in the FOP examples. You'll have
to gather any printer settings in a HTML form and send it to the server.</p>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org


Mime
View raw message