xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From psan...@apache.org
Subject svn commit: r1417890 - /xmlgraphics/site/trunk/content/fop/faq.mdtext
Date Thu, 06 Dec 2012 13:58:23 GMT
Author: psancho
Date: Thu Dec  6 13:58:22 2012
New Revision: 1417890

URL: http://svn.apache.org/viewvc?rev=1417890&view=rev
Log:
replaced <a> with markdown>headerid syntax

Modified:
    xmlgraphics/site/trunk/content/fop/faq.mdtext

Modified: xmlgraphics/site/trunk/content/fop/faq.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/faq.mdtext?rev=1417890&r1=1417889&r2=1417890&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/fop/faq.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/faq.mdtext Thu Dec  6 13:58:22 2012
@@ -2,15 +2,15 @@ Title: FOP FAQ
 
 #FOP FAQ
 
-## 1. Apache&trade; FOP: General questions <a id="part-general"></a>
+## 1. Apache&trade; FOP: General questions  {#part-general}
 
-### 1.1. What is Apache&trade; FOP?<a id="fop-general"></a>
+### 1.1. What is Apache&trade; FOP? {#fop-general}
 
 FOP is a print formatter for [XSL formatting objects](#xslfo).
 
 It can be used to render an XML file containing XSL formatting objects into a page layout.
The main target is PDF but other rendering targets are supported, such as AWT, PCL, text and
direct printing.
 
-### 1.2. What can I do with FOP?<a id="fop-functions"></a>
+### 1.2. What can I do with FOP? {#fop-functions}
 
 FOP provides both an application and a library that converts an XSL FO document into paginated
output.
 
@@ -18,11 +18,11 @@ The FOP command line application can be 
 
 The library can be used in servlets and other Java applications.
 
-### 1.3. What does "FOP" stand for?<a id="fop-acronym"></a>
+### 1.3. What does "FOP" stand for? {#fop-acronym}
 
 FOP is an acronym for **F** ormatting **O** bject **P** rocessor
 
-### 1.4. How does FOP interact with other Apache Projects?<a id="fop-other-apache"></a>
+### 1.4. How does FOP interact with other Apache Projects? {#fop-other-apache}
 
 FOP is distributed with [Cocoon](http://cocoon.apache.org/) as a PDF serializer for XSL (FO)
documents.
 
@@ -37,11 +37,11 @@ FOP also makes use of the following Apac
 - [Commons Logging](http://commons.apache.org/logging/)
 - [Xalan-J](http://xalan.apache.org)
 
-### 1.5. What is XSL?<a id="xsl-def"></a>
+### 1.5. What is XSL? {#xsl-def}
 
 XSL is a W3C standard concerned with publishing XML documents. It consists of two parts:
[XSLT](#XSLT) and [XSL-FO](#xslfo). The acronym expands to e **X** tensible **S** tylesheet
**L** anguage.
 
-### 1.6. What is XSL-FO?<a id="xslfo"></a>
+### 1.6. What is XSL-FO? {#xslfo}
 
 XSLFO (aka XSL-FO) is an XML vocabulary, defined by W3C Recommendation [Extensible Stylesheet
Language (XSL) Version 1.1](http://www.w3.org/TR/xsl/), that is used to specify a pagination
and other styling for page layout output. The acronym “FO” stands for **F** ormatting
**O** bjects. XSLFO can be used in conjunction with [XSLT](#XSLT) to convert from any XML
format into a paginated layout ready for printing or displaying.
 
@@ -49,21 +49,21 @@ XSLFO defines a set of elements in XML t
 
 Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
 
-### 1.7. What is XSLT?<a id="XSLT"></a>
+### 1.7. What is XSLT? {#XSLT}
 
 XSLT describes the transformation of arbitrary XML input into other XML (like XSLFO), HTML
or plain text. The “T” comes from **T** ransformation. For historical reasons, a
transformation is often also called a “style sheet”.
 
 Synonyms: XSL transformation, XSL:T, XSL style sheet.
 
-### 1.8. When will feature X be implemented?<a id="when"></a>
+### 1.8. When will feature X be implemented? {#when}
 
 The short answer is "Don't ask." For more details, see [Understand FOP's Limitations](gethelp.html#limitations).
 
-### 1.9. When is the next released planned?<a id="next-release"></a>
+### 1.9. When is the next released planned? {#next-release}
 
 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
[contributing](dev/index.html#involved) to FOP.
 
-### 1.10. Why did you redesign FOP?<a id="redesign"></a>
+### 1.10. Why did you redesign FOP? {#redesign}
 
 The code redesign of FOP was necessary in order to be able to adress following issues:
 
@@ -78,19 +78,19 @@ The code redesign of FOP was necessary i
 
 - Table Layout
 
-### 1.11. How can I contribute?<a id="contribute"></a>
+### 1.11. How can I contribute? {#contribute}
 
 There are numerous ways that you can help. They are outlined in the [Developer's Introduction](dev/index.html)
page.
 
-## 2. Problems running FOP <a id="part-running"></a>
+## 2. Problems running FOP  {#part-running}
 
-### 2.1. I get the error: [ERROR]: 'master-reference' for 'fo:page-sequence' matches no 'simple-page-master'
or 'page-sequence-master'<a id="no-page-master"></a>
+### 2.1. I get the error: [ERROR]: 'master-reference' for 'fo:page-sequence' matches no 'simple-page-master'
or 'page-sequence-master' {#no-page-master}
 
 FOP was changed to be in accordance with the latest standard (see [XSL standard](resources.html#specs-xslfo)).The
page master for a fo:page-sequence is now referenced by the master-reference attribute. Replace
the master-name attributes of your fo:page-sequence elements by master-reference attributes.
You have to do this also for fo:single-page-master-reference, fo:repeatable-page-master-reference
and fo:conditional-page-master-reference elements in you page master definitions.
 
 Update your FO documents and style sheets.
 
-### 2.2. I get a NoClassDefFound exception.<a id="NoClassDefFound"></a>
+### 2.2. I get a NoClassDefFound exception. {#NoClassDefFound}
 
 This is typically a problem with your classpath.
 
@@ -105,18 +105,17 @@ If you run FOP embedded in your servlet,
 
 If you downloaded the source distribution, or a snapshop from the repository, remember you
have to build the FOP jars first.
 
-### 2.3. I get a NoSuchMethodException or a NoSuchFieldException exception.<a id="NoSuchMethodException"></a>
+### 2.3. I get a NoSuchMethodException or a NoSuchFieldException exception. {#NoSuchMethodException}
 
 This is usually caused by an older version of one of the FOP jars or old XML tools in the
classpath.
 
 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.
 
-### 2.4. I get an OutOfMemoryException.<a id="OutOfMemoryException"></a>
+### 2.4. I get an OutOfMemoryException. {#OutOfMemoryException}
 
 See [FOP Memory](1.0/running.html#memory).
 
-### 2.5. I get a MalformedURLException.<a id="MalformedURLException"></a>
-<a id="MalformedURL"></a>
+### 2.5. I get a MalformedURLException. {#MalformedURLException} {#MalformedURL}
 What you probably think of as "file names" are usually URLs, in particular the `src` attribute
of fo:external-graphic.
 
 Because usage of URLs is growing, you should make yourself familiar with it. The relevant
specification is [RFC 2396](http://www.rfc-editor.org/rfc/rfc2396.txt).
@@ -125,15 +124,15 @@ In a nutshell, the correct syntax for an
 
 A relative file URL starts with anything but a slash, and doesn't have the `file:` prefix,
for example `file.ext`, `path/file.ext` or `../file.ext`. The string `file:path/file.ext`
is *not* a relative URL, in fact, it isn't a valid URL at all. A relative URL is subject to
a resolving process, which transforms it into an absolute URL.
 
-### 2.6. I get an "[ERROR]: null", or a NullPointerException.<a id="NullPointerException"></a>
+### 2.6. I get an "[ERROR]: null", or a NullPointerException. {#NullPointerException}
 
 This is very likely a bug in FOP. If you encounter this error, please [Open a New Bug](bugs.html#issues_new).
 
-### 2.7. FOP returns the message "[ERROR] object|property - 'x' is not implemented yet."
When will it be implemented?<a id="not-implemented"></a>
+### 2.7. FOP returns the message "[ERROR] object|property - 'x' is not implemented yet."
When will it be implemented? {#not-implemented}
 
 See FOP's Standards [Compliance](compliance.html) page.
 
-### 2.8. FOP hangs. FOP does not exit.<a id="fop-hangs"></a>
+### 2.8. FOP hangs. FOP does not exit. {#fop-hangs}
 
 The most likely reason is a known problem with the Java run time environment which is triggered
by rendering SVGs. Sun's JDK 1.4 and later do not have this problem. See also [FOP does not
exit if a SVG is included](#svghangs).
 
@@ -144,15 +143,15 @@ If you called the FOP command line appli
 If you can reproduce this problem given a specific input and configuration,
 then please [Open a New Bug](bugs.html#issues_new).
 
-### 2.9. FOP runs forever, writing lots of ">" to the log.<a id="boxoverflow"></a>
+### 2.9. FOP runs forever, writing lots of ">" to the log. {#boxoverflow}
 
 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 space-before or space-after larger than the
page size. Catch the first page showing this phenomenon and check it. If it is not obvious
which element causes the trouble, remove stuff until the problem goes away. Decrease the dimensions
of the offending element or property, or increase the dimension of the enclosing element or
container, or remove keep-with-* properties.
 
-### 2.10. FOP cannot find a file for fo:external-graphics.<a id="cannot-find-external-graphics"></a>
+### 2.10. FOP cannot find a file for fo:external-graphics. {#cannot-find-external-graphics}
 
 The src attribute of the `fo:external-graphics` element requires a URI, not a file name.
See [External Resources](fo.html#external-resources) for more information about specifying
URIs.
 
-### 2.11. FOP does not find my fonts.<a id="fonts-not-found"></a>
+### 2.11. FOP does not find my fonts. {#fonts-not-found}
 
 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.
 
@@ -160,7 +159,7 @@ If you used a relative URL, make sure yo
 
 Try also setting the [font-base configuration](1.0/configuration.html#general-elements).
 
-### 2.12. I get a SAXException: Mismatch: page-sequence vs. root (or similar).<a id="saxexception-mismatch"></a>
+### 2.12. I get a SAXException: Mismatch: page-sequence vs. root (or similar). {#saxexception-mismatch}
 
 The full exception usually looks similar to this:
 Mismatch: page-sequence (http://www.w3.org/1999/XSL/Format) vs. root
@@ -191,15 +190,15 @@ The work-around is to set an explicit `E
 
     }
 
-### 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."<a id="faq-N1026C"></a>
+### 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." {#faq-N1026C}
 
 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.
 
 To avoid the warning you can simply delete the old Font Cache file, which lives in ${base}\conf\font.cache
(see [font-base configuration](1.0/configuration.html#general-elements)).
 
-## 3. Problems with FOP output <a id="part-output"></a>
+## 3. Problems with FOP output  {#part-output}
 
-### 3.1. Leaders don't work in current FOP. Instead of filling the line, only three dots
or a short ruler is output.<a id="leader-expansion"></a>
+### 3.1. Leaders don't work in current FOP. Instead of filling the line, only three dots
or a short ruler is output. {#leader-expansion}
 
 Leaders still work, in fact they work better than ever before. You'll just have to add `text-align="justify"`
and/or `text-align-last="justify"` to the block with the leader. Be sure you haven't accidentally
overridden the `leader-length.maximum="100%"` default value.
 
@@ -211,7 +210,7 @@ Actually due to the fuzzyness of the spe
 
 If you want to have a longer ruler or space in a non-justified line, you have to increase
the leader-length.optimum property.
 
-### 3.2. Why does FOP insert a blank page between my page sequences?<a id="blank-page-between-page-sequences"></a>
+### 3.2. Why does FOP insert a blank page between my page sequences? {#blank-page-between-page-sequences}
 
 This is because spec conformance has been improved.
 
@@ -219,7 +218,7 @@ The [force-page-count property](http://w
 
 If you don't want to have this blank page, use `force-page-count="no-force"`.
 
-### 3.3. Why is my graphic not rendered?<a id="graphic-not-displayed"></a>
+### 3.3. Why is my graphic not rendered? {#graphic-not-displayed}
 
 Most commonly, the external file is not being found by FOP. Check the following:
 
@@ -239,15 +238,15 @@ Other possibilities:
 
 - There may be something (static content) that is obscuring the graphic. (This is very rare).
 
-### 3.4. My graphical images do not work properly.<a id="png-fails"></a>
+### 3.4. My graphical images do not work properly. {#png-fails}
 
 See [FOP Graphics Formats](1.0/graphics.html) for a list of supported graphics formats and
related issues.
 
-### 3.5. Why is my graphic rendered at a different resolution than it was created?<a id="graphic-resolution"></a>
+### 3.5. Why is my graphic rendered at a different resolution than it was created? {#graphic-resolution}
 
 See [Graphics Resolution](1.0/graphics.html#resolution).
 
-### 3.6. Keep-with-next, keep-with-previous, keep-together don't work.<a id="keep-with"></a>
+### 3.6. Keep-with-next, keep-with-previous, keep-together don't work. {#keep-with}
 
 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.
 
@@ -273,13 +272,13 @@ An example of an image and the image cap
 </fo:table>
 Consider upgrading to the latest version which supports keeps.
 
-### 3.7. My tables are missing, or missing their content.<a id="table-missing"></a>
+### 3.7. My tables are missing, or missing their content. {#table-missing}
 
 Check for `fo:table-body` around the rows. Usually FOP will catch this problem.
 
 Also, the `fo:table-with-caption` element is not implemented, tables within such an element
are dropped too. FOP generates an error message for this problem. Older DocBook style sheets
generate `fo:table-with-caption` elements, so watch out.
 
-### 3.8. Text overflowing table cells and the like is not clipped. Long text flows into adjacent
cells/block, obscuring stuff there.<a id="cells-overflow"></a>
+### 3.8. Text overflowing table cells and the like is not clipped. Long text flows into adjacent
cells/block, obscuring stuff there. {#cells-overflow}
 
 Since the `overflow` property doesn't apply to table-cell, you can wrap the cell content
in a block-container and specify `overflow="hidden"` there. Alternatively, if you have long
words overflowing table cells, try to get them hyphenated. Artificial names like product identifications
or long numbers usually aren't hyphenated. You can try special processing at XSLT level, like
 
@@ -292,27 +291,27 @@ Since the `overflow` property doesn't ap
 
 Check the [XSL FAQ](http://dpawson.co.uk/xsl) and the [XSL list archive](http://www.mulberrytech.com/xsl/xsl-list/)
for how to perform these tasks.
 
-### 3.9. The contents of table cells don’t wrap<a id="table-cell-wrap"></a>
+### 3.9. The contents of table cells don’t wrap {#table-cell-wrap}
 
 You probably have `keep-together="always"` set on the table cell. See [next question](#keep-together).
 
-### 3.10. FOP behaves differently from earlier versions when keep-together="always" is set
on table cells<a id="keep-together"></a>
+### 3.10. FOP behaves differently from earlier versions when keep-together="always" is set
on table cells {#keep-together}
 
 Support for inline-level keeps has been added in FOP 0.95, and setting `keep-together="always"`
also implicitly sets `keep-together.within-line="always"`, which forbids FOP to break the
text into multiple lines. Set `keep-together.within-column="always"` on table-cell instead.
It’s a good idea not to use the shorthand `keep-together="always"` at all!
 
-### 3.11. FOP tells me: "The contents of row 1 are taller than they should be". What does
that mean?<a id="row-height-constraint"></a>
+### 3.11. FOP tells me: "The contents of row 1 are taller than they should be". What does
that mean? {#row-height-constraint}
 
 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 corresponding property)
you [implicitely set](http://www.w3.org/TR/xsl11/#d0e4413) block-progression-dimension.minimum,
block-progression-dimension.optimum and block-progression-dimension.maximum to the same value.
You'll get some information about that in the warning message. Look for something like: "MinOptMax[min=opt=max=14000]".
 
 Assuming you set the height on the table-row to 14pt and your content is 75pt high, a constraint
(maximum=14pt) is violated. Normally, you just want to make sure with the "height" property
that the row has a minimum height. If that is so, the right solution is to specify block-progression-dimension.minimum="14pt"
instead of height="14pt".
 
-### 3.12. Page numbers are not properly right aligned.<a id="page-number-align"></a>
+### 3.12. Page numbers are not properly right aligned. {#page-number-align}
 
 This happens for `fo:page-number-citation` elements if the citation occurs before FOP formatted
the requested page, usually in TOC or index pages. It is caused by the problem that FOP has
to guess how much space the yet unknown page number will occupy, and usually the guesses are
somewhat off.
 
 The most recent FOP releases should have this problem fixed. Check whether you can upgrade.
 
-### 3.13. Hyphenation does not work.<a id="hyphenation-fails"></a>
+### 3.13. Hyphenation does not work. {#hyphenation-fails}
 
 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">
@@ -320,63 +319,63 @@ See [Hyphenation Support](1.0/hyphenatio
 
 Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):
 <fo:block hyphenate="true">
-### 3.14. When I use margins, my content in a nested table or block-containers gets indented
twice. Is this a bug?<a id="indent-inheritance"></a>
+### 3.14. When I use margins, my content in a nested table or block-containers gets indented
twice. Is this a bug? {#indent-inheritance}
 
 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
`setBreakIndentInheritanceOnReferenceAreaBoundary(true)` on the FOUserAgent. The better way
is to reset `start-indent` and `end-indent` to "0pt" on table-body or block-container. For
further details, please consult the [Wiki page on Indent Inheritance](http://wiki.apache.org/xmlgraphics-fop/IndentInheritance).
 
-### 3.15. Why is the output of Java2D/AWT-based renderers different than, for example, PDF
or PS?<a id="pdf-ps-java2d-differences"></a>
+### 3.15. Why is the output of Java2D/AWT-based renderers different than, for example, PDF
or PS? {#pdf-ps-java2d-differences}
 
 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 [notes on fonts in the various output formats](1.0/output.html#general-fonts).
 
-## 4. Embedding FOP. Using FOP in a servlet. <a id="part-embedding"></a>
+## 4. Embedding FOP. Using FOP in a servlet.  {#part-embedding}
 
-### 4.1. How do I use FOP in a servlet?<a id="servlet"></a>
+### 4.1. How do I use FOP in a servlet? {#servlet}
 
 See [Using FOP in a Servlet](1.0/servlets.html).
 
-### 4.2. How do I use FOP in a servlet with an XSLT transformation?<a id="servlet-with-xslt"></a>
+### 4.2. How do I use FOP in a servlet with an XSLT transformation? {#servlet-with-xslt}
 
 See [Using FOP in a Servlet with XSLT Transformation](1.0/servlets.html#xslt).
 
-### 4.3. How do I pass parameters to the XSLT transformation?<a id="servlet-xslt-params"></a>
+### 4.3. How do I pass parameters to the XSLT transformation? {#servlet-xslt-params}
 
 See [Using FOP in a Servlet with XSLT Transformation](1.0/servlets.html#xslt).
 
-### 4.4. How do I use my own fonts when running FOP from a servlet?<a id="servlet-nonstd-fonts"></a>
+### 4.4. How do I use my own fonts when running FOP from a servlet? {#servlet-nonstd-fonts}
 
 Declare the fonts in the `userconfig.xml` file as usual. See [loading the user configuration
file](#usercfg) for further details.
 
-### 4.5. How do I set the baseDir property in a servlet environment?<a id="servlet-baseDir"></a>
+### 4.5. How do I set the baseDir property in a servlet environment? {#servlet-baseDir}
 
 See [Setting the Configuration Programmatically](1.0/embedding.html#config-internal).
 
-### 4.6. How do I use a user configuration file from a servlet?<a id="usercfg"></a>
+### 4.6. How do I use a user configuration file from a servlet? {#usercfg}
 
 See [Using a Configuration File in an Embedded App](1.0/embedding.html#config-external).
 
-### 4.7. I keep getting NoClassDefFound and other exceptions. How do I get FOP working for
various servlet engines?<a id="servlet-NoClassDefFound"></a>
+### 4.7. I keep getting NoClassDefFound and other exceptions. How do I get FOP working for
various servlet engines? {#servlet-NoClassDefFound}
 
 See [Servlet Engines](1.0/servlets.html#servlet-engine).
 
-### 4.8. Can FOP be used in multithreaded environments?<a id="multithreaded"></a>
+### 4.8. Can FOP be used in multithreaded environments? {#multithreaded}
 
 See [Multithreading FOP](1.0/embedding.html#multithreading).
 
-## 5. SVG specific questions <a id="part-svg"></a>
+## 5. SVG specific questions  {#part-svg}
 
-### 5.1. The rendering of SVG text in my PDF is of poor quality. Can I control this?<a
id="svg-text"></a>
+### 5.1. The rendering of SVG text in my PDF is of poor quality. Can I control this? {#svg-text}
 
 See [Placing SVG Text into PDF](1.0/graphics.html#svg-pdf-text).
 
-### 5.2. How do I use FOP with SVG on headless servers?<a id="svg-headless"></a>
+### 5.2. How do I use FOP with SVG on headless servers? {#svg-headless}
 
 See [FOP: Graphics (Batik)](1.0/graphics.html#batik).
 
-### 5.3. FOP does not exit if a SVG is included.<a id="svghangs"></a>
+### 5.3. FOP does not exit if a SVG is included. {#svghangs}
 
 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.
 
-### 5.4. I have problems with SVG referring to gradients etc. using "uri(#stuff)". I get
a MalformedURLException.<a id="svg-url"></a>
+### 5.4. I have problems with SVG referring to gradients etc. using "uri(#stuff)". I get
a MalformedURLException. {#svg-url}
 
 This is really a "resolving relative URI" problem with some twists. The problem is that the
`#stuff` URL fragment identifier is resolved within the current SVG document. So the reference
must be valid within the XML subset and it cannot reference other SVG documents in the same
XML file. Some options to try:
 
@@ -395,11 +394,11 @@ Ultimately, both FOP and especially Bati
 
 See also [MalformedURLException](#MalformedURL)
 
-### 5.5. Why is my SVG rendered at a size different from that specified in my fo:external-graphic
element?<a id="svg-scaling"></a>
+### 5.5. Why is my SVG rendered at a size different from that specified in my fo:external-graphic
element? {#svg-scaling}
 
 See [SVG Scaling](1.0/graphics.html#svg-scaling).
 
-### 5.6. FOP fails with something like "The attribute "width" of the element <rect>
is required". What's wrong?<a id="svg-attribute-required"></a>
+### 5.6. FOP fails with something like "The attribute "width" of the element <rect>
is required". What's wrong? {#svg-attribute-required}
 
 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.
 
@@ -407,13 +406,13 @@ Bug description: In a namespace-enabled 
 
 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 [Endorsed Standards Override Mechanism](http://java.sun.com/j2se/1.4.2/docs/guide/standards/),
i.e. you must place Xalan-J in the `"lib/endorsed"` directory of your JRE.
 
-## 6. PDF specific (includes Acrobat peculiarities) <a id="part-pdf"></a>
+## 6. PDF specific (includes Acrobat peculiarities)  {#part-pdf}
 
-### 6.1. How do I embed fonts in PDF?<a id="pdf-embed-font"></a>
+### 6.1. How do I embed fonts in PDF? {#pdf-embed-font}
 
 See the [Fonts](1.0/fonts.html) page for information about embedding fonts.
 
-### 6.2. Some characters are not displayed, or displayed incorrectly, or displayed as “#”.<a
id="pdf-characters"></a>
+### 6.2. Some characters are not displayed, or displayed incorrectly, or displayed as “#”.
{#pdf-characters}
 
 This usually means the selected font doesn't have a glyph for the character.
 
@@ -425,31 +424,31 @@ For most symbols, it is better to select
 <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>
-### 6.3. What tools are available for post-processing my PDF document?<a id="pdf-postprocess"></a>
+### 6.3. What tools are available for post-processing my PDF document? {#pdf-postprocess}
 
 See [PDF Post-processing](1.0/output.html#pdf-postprocess).
 
-### 6.4. How do I add security features (encryption, disable printing) to my PDF document?<a
id="pdf-security"></a>
+### 6.4. How do I add security features (encryption, disable printing) to my PDF document?
{#pdf-security}
 
 See [PDF Encryption](1.0/pdfencryption.html). See also [PDF Post-processing](1.0/output.html#pdf-postprocess).
 
-### 6.5. How do I add document properties (title, author, etc.) to my PDF document?<a
id="pdf-doc-properties"></a>
+### 6.5. How do I add document properties (title, author, etc.) to my PDF document? {#pdf-doc-properties}
 
 See [Metadata](1.0/metadata.html).
 
-### 6.6. How do I add watermarks to my PDF document?<a id="pdf-watermark"></a>
+### 6.6. How do I add watermarks to my PDF document? {#pdf-watermark}
 
 See [PDF Watermarks](1.0/output.html#pdf-watermark).
 
-### 6.7. The PDF is printed contorted!<a id="pdf-print-contortion"></a>
+### 6.7. The PDF is printed contorted! {#pdf-print-contortion}
 
 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.
 
-### 6.8. How do I control the Acrobat bookmark display?<a id="pdf-bookmark-display"></a>
+### 6.8. How do I control the Acrobat bookmark display? {#pdf-bookmark-display}
 
 FOP supports the starting-state property of the XSL 1.1 [fo:bookmark](http://www.w3.org/TR/xsl11/#fo_bookmark)
element which can be used for this. The color, font-style and font-weight properties on [fo:bookmark-title](http://www.w3.org/TR/xsl11/#fo_bookmark-title)
are not yet supported, though.
 
-### 6.9. How can I get rid of strange single-pixel lines inside table borders or between
table cells in Adobe Acrobat?<a id="acrobat-anti-aliasing"></a>
+### 6.9. How can I get rid of strange single-pixel lines inside table borders or between
table cells in Adobe Acrobat? {#acrobat-anti-aliasing}
 
 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 segment can have a different
color. Now, Adobe Acrobat may display thin (1 pixel wide) lines inside the border segment
or sometimes even between to adjacent colored rectangles making up the background of a block
or table cell. This effect is due to the way Adobe Acrobat does anti-aliasing. Adobe's algorithm
seems to cause these artifacts. Other PDF viewers don't have that problem. Or at least we
haven't had any reports in that direction.
 
@@ -463,13 +462,13 @@ Here an example of how the effect can lo
 
 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.
 
-## 7. IEx specific stuff <a id="part-iex"></a>
+## 7. IEx specific stuff  {#part-iex}
 
-### 7.1. The FOP servlet is called multiple times!<a id="iex-servlet-multiple"></a>
+### 7.1. The FOP servlet is called multiple times! {#iex-servlet-multiple}
 
 This is a problem of Internet Explorer requesting the content several times. Please see the
[notes on Internet Explorer](1.0/servlets.html#ie) for more information.
 
-### 7.2. How do I print PDF directly from the browser?<a id="iex-pdf-print-from-browser"></a>
+### 7.2. How do I print PDF directly from the browser? {#iex-pdf-print-from-browser}
 
 It depends whether you mean "printing to a printer under control of the server" or "printing
on the client's printer".
 
@@ -479,97 +478,97 @@ For the second task, you can use some cl
 
 See also [http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2](http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2)
 
-## 8. General questions regarding XSLT, XSLFO, and basic XML <a id="part-input"></a>
+## 8. General questions regarding XSLT, XSLFO, and basic XML  {#part-input}
 
-### 8.1. (FO) How do I vertically center an image or a table (or whatever)?<a id="fo-center"></a>
+### 8.1. (FO) How do I vertically center an image or a table (or whatever)? {#fo-center}
 
 See [XSL-FO Vertical Centering](fo.html#fo-center-vertical).
 
-### 8.2. (FO) How do I center a table horizontally?<a id="fo-center-table-horizon"></a>
+### 8.2. (FO) How do I center a table horizontally? {#fo-center-table-horizon}
 
 See [XSL-FO Horizontal Centering (Tables)](fo.html#fo-center-table-horizon).
 
-### 8.3. (FO) How to get page numbers printed on the "outer side" of the page (for books,
for example)?<a id="fo-page-outer"></a>
+### 8.3. (FO) How to get page numbers printed on the "outer side" of the page (for books,
for example)? {#fo-page-outer}
 
 See [Recto/Verso Static Content Differences](fo.html#fo-oddeven).
 
-### 8.4. (FO) How do I use different static content for odd and even pages?<a id="oddeven"></a>
+### 8.4. (FO) How do I use different static content for odd and even pages? {#oddeven}
 
 See [Recto/Verso Static Content Differences](fo.html#fo-oddeven).
 
-### 8.5. (FO) How do I get a special header on the first page?<a id="fo-first-page-header"></a>
+### 8.5. (FO) How do I get a special header on the first page? {#fo-first-page-header}
 
 See [Making the First Page Special](fo.html#fo-first-page).
 
-### 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?<a id="fo-omit-headers"></a>
+### 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? {#fo-omit-headers}
 
 See [Blank Pages](fo.html#fo-blank-pages).
 
-### 8.7. (FO) How do I print an Euro sign, a checkbox or other some other special symbols?<a
id="fo-special-symbols"></a>
+### 8.7. (FO) How do I print an Euro sign, a checkbox or other some other special symbols?
{#fo-special-symbols}
 
 See [Special Characters](fo.html#xml-special-chars).
 
-### 8.8. (FO) How do I keep linebreaks and hard spaces? How do I get preformatted text displayed
as expected?<a id="fo-preformat"></a>
+### 8.8. (FO) How do I keep linebreaks and hard spaces? How do I get preformatted text displayed
as expected? {#fo-preformat}
 
 See [Preformatting Content](fo.html#fo-preformat).
 
-### 8.9. (FO) How do I print the total number of pages, for example "page 1 of 12"<a id="fo-total-pages"></a>
+### 8.9. (FO) How do I print the total number of pages, for example "page 1 of 12" {#fo-total-pages}
 
 See [Total Document Pages](fo.html#fo-total-pages).
 
-### 8.10. (FO) The header overlaps body content. The body extends into the footer.<a id="fo-region-overlap"></a>
+### 8.10. (FO) The header overlaps body content. The body extends into the footer. {#fo-region-overlap}
 
 See [Aligning Regions](fo.html#fo-region-align).
 
-### 8.11. (FO) How do I get lines in the document, as separators, side bars or folding marks?<a
id="fo-lines"></a>
+### 8.11. (FO) How do I get lines in the document, as separators, side bars or folding marks?
{#fo-lines}
 
 See [Drawing Lines](fo.html#fo-lines).
 
-### 8.12. (FO) How do I validate my FO document?<a id="fo-validate"></a>
+### 8.12. (FO) How do I validate my FO document? {#fo-validate}
 
 See [Validating XSL-FO](fo.html#fo-validate).
 
-### 8.13. (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;.<a
id="xml-non-breaking-space"></a>
+### 8.13. (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;.
{#xml-non-breaking-space}
 
 See [XML Special Characters](fo.html#xml-special-chars).
 
-### 8.14. (XML) How do I enter special characters in XML? There are complaints about undefined
entities, such as &uuml;, which work in HTML.<a id="xml-undefined-entities"></a>
+### 8.14. (XML) How do I enter special characters in XML? There are complaints about undefined
entities, such as &uuml;, which work in HTML. {#xml-undefined-entities}
 
 See [XML Special Characters](fo.html#xml-special-chars).
 
-### 8.15. (XML) There are complaints about illegal characters and entities in the input.<a
id="xml-illegal-entities"></a>
+### 8.15. (XML) There are complaints about illegal characters and entities in the input.
{#xml-illegal-entities}
 
 See [Using HTML Character Names](fo.html#xml-entity-chars).
 
-### 8.16. (XML) There are complaints about illegal bytes or characters in the input. There
are odd characters in the result.<a id="xml-illegal-chars"></a>
+### 8.16. (XML) There are complaints about illegal bytes or characters in the input. There
are odd characters in the result. {#xml-illegal-chars}
 
 See [XML Encoding Issues](fo.html#xml-encoding).
 
-### 8.17. (XSLT) How can I use the current date and time in my document?<a id="xslt-current-date"></a>
+### 8.17. (XSLT) How can I use the current date and time in my document? {#xslt-current-date}
 
 See [Current Date and Time](fo.html#xslt-date).
 
-### 8.18. Can I use FOP to convert XHTML or HTML files to PDF?<a id="xhtml-to-pdf"></a>
+### 8.18. Can I use FOP to convert XHTML or HTML files to PDF? {#xhtml-to-pdf}
 
 You will get better results if you transform your source XML directly into XSLFO. It is tempting
to use the XML->XHTML->XSLFO approach, because this apparently means there's only one
transformation to maintain, but XHTML and publishing grade PDF are dissimilar enough that
an "generic" XHTML->XSLFO(PDF) usually wont cut it, because the XHTML already lacks information
from the original XML. It may be worthwhile to go from the source XML to an intermediate custom
XML which on one hand is close enough to representation to allow simple transformation to
either XHTML or XSLFO for most of the structure, but on the other hand retains enough semantic
from the original XML that elements which must be handled differently in the two representations
can be handled differently. Setting this up requires experience and most likely extensive
prototyping.
 
-### 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?<a id="xhtml-to-pdf2"></a>
+### 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? {#xhtml-to-pdf2}
 
 The [FOP Resources page](resources.html) has links to a tool called [html2fo](http://html2fo.sourceforge.net/)
which can be used to make such a transformation. In addition, there are tools on the Antenna
House [XSL-FO Tutorial and Sample](http://www.antennahouse.com/XSLsample/XSLsample.htm) page.
 
-## 9. Development-related Questions. <a id="dev-help"></a>
+## 9. Development-related Questions.  {#dev-help}
 
-### 9.1. Where can I learn how the FOP docs and web site are built?<a id="doc-mgt"></a>
+### 9.1. Where can I learn how the FOP docs and web site are built? {#doc-mgt}
 
 See FOP [Doc Management](dev/doc.html). ;-)
 
-## 10. General suggestions. How to solve problems. <a id="part-help"></a>
+## 10. General suggestions. How to solve problems.  {#part-help}
 
-### 10.1. I think I have found a bug in FOP. What should I do?<a id="bugs"></a>
+### 10.1. I think I have found a bug in FOP. What should I do? {#bugs}
 
 See [the Bugs page](bugs.html) for information about bugs already reported and how to report
new ones.
 
-### 10.2. I have questions that are not addressed in this FAQ. Where should I post them?<a
id="postquestions"></a>
+### 10.2. I have questions that are not addressed in this FAQ. Where should I post them?
{#postquestions}
 
 - If your question is a development-related question, please see the [Developer FAQs](dev/faq.html).
 



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


Mime
View raw message