Specifies the base URL based on which relative URL will be resolved.
-
resolution
+
source-resolution
Integer, dpi
-
Resolution in dpi (dots per inch) which is used internally.
+
+ Resolution in dpi (dots per inch) which is used internally to determine the pixel
+ size for SVG images and bitmap images without resolution information.
+
+
+
+
target-resolution
+
Integer, dpi
+
+ Resolution in dpi (dots per inch) used to specify the output resolution for bitmap
+ images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps
+ generated by Apache Batik for filter effects and such.
+
+
+
+
strict-validation
+
Boolean (true, false)
+
+ Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity,
+ for example, you're allowed to specify a border on a region-body which is supported
+ by some FO implementations but is non-standard. Note that such a border would
+ currently have no effect in Apache FOP.
+
+
+
break-indent-inheritance
+
Boolean (true, false)
+
+ Setting this option to 'true' causes FOP to use an alternative rule set to determine
+ text indents specified through margins, start-indent and end-indent. Many commercial
+ FO implementations have chosen to break the XSL specification in this aspect. This
+ option tries to mimic their behaviour. Please note that Apache FOP may still not
+ behave exactly like those implementations either because FOP has not fully matched
+ the desired behaviour and because the behaviour among the commercial implementations
+ varies. The default for this option (i.e. false) is to behave exactly like the
+ specification describes.
default-page-settings
@@ -97,8 +131,12 @@
./
-
- 72
+
+
+ 72
+
+ 72
+
diff --git a/src/documentation/content/xdocs/0.90/embedding.xml b/src/documentation/content/xdocs/0.91/embedding.xml
similarity index 95%
rename from src/documentation/content/xdocs/0.90/embedding.xml
rename to src/documentation/content/xdocs/0.91/embedding.xml
index 2e77c11ab..9833faa0f 100644
--- a/src/documentation/content/xdocs/0.90/embedding.xml
+++ b/src/documentation/content/xdocs/0.91/embedding.xml
@@ -316,9 +316,19 @@ Fop fop = new Fop(MimeConstants.MIME_POSTSCRIPT, userAgent);]]>
- Set the internal resolution for the document. This is used when creating bitmap images, for example. Example:
+ Set the source resolution for the document. This is used internally to determine the pixel
+ size for SVG images and bitmap images without resolution information. Default: 72 dpi. Example:
-
+
+
+
+
+ Set the target resolution for the document. This is used to
+ specify the output resolution for bitmap images generated by bitmap renderers
+ (such as the TIFF renderer) and by bitmaps generated by Apache Batik for filter
+ effects and such. Default: 72 dpi. Example:
+
+
@@ -359,6 +369,15 @@ Fop fop = new Fop(MimeConstants.MIME_POSTSCRIPT, userAgent);]]>
+
+
+ Enable an alternative set of rules for text indents that tries to mimic the behaviour of many commercial
+ FO implementations that chose to break the specification in this aspect. The default of this option is
+ 'false' which causes Apache FOP to behave exactly as describes in the specification. To enable the
+ alternative behaviour, call:
+
+
+
You should not reuse an FOUserAgent instance between FOP rendering runs although you can. Especially
diff --git a/src/documentation/content/xdocs/0.90/extensions.xml b/src/documentation/content/xdocs/0.91/extensions.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/extensions.xml
rename to src/documentation/content/xdocs/0.91/extensions.xml
diff --git a/src/documentation/content/xdocs/0.90/fonts.xml b/src/documentation/content/xdocs/0.91/fonts.xml
similarity index 93%
rename from src/documentation/content/xdocs/0.90/fonts.xml
rename to src/documentation/content/xdocs/0.91/fonts.xml
index ba5be8ed3..993fa047e 100644
--- a/src/documentation/content/xdocs/0.90/fonts.xml
+++ b/src/documentation/content/xdocs/0.91/fonts.xml
@@ -135,13 +135,19 @@ More information about fonts can be found at:
Type 1 Font Metrics
FOP includes PFMReader, which reads the PFM file that normally comes with a Type 1 font, and generates an appropriate font metrics file for it.
To use it, run the class org.apache.fop.fonts.apps.PFMReader:
-
Windows:
- The tool will construct some values (FontBBox, StemV and ItalicAngle) based on assumptions and calculations which are only an approximation to the real values.
FontBBox and Italic Angle can be found in the human-readable part of the PFB file or in the AFM file.
The PFMReader tool does not yet interpret PFB or AFM files, so if you want to be correct, you may have to adjust the values in the XML file manually.
@@ -165,8 +170,7 @@ The constructed values however appear to have no visible influence.
FOP includes TTFReader, which reads the TTF file and generates an appropriate font metrics file for it.
Use it in a similar manner to PFMReader.
For example, to create such a metrics file in Windows from the TrueType font at c:\myfonts\cmr10.ttf:
@@ -222,8 +226,7 @@ To create metrics files for these fonts, you must specify which font in the coll
To get a list of the fonts in a collection, just start the TTFReader as if it were a normal TrueType file (without the -ttcname option).
It will display all of the font names and exit with an Exception.
Here is an example of generating a metrics file for a .ttc file:
- java -cp build\fop.jar;lib\avalon-framework.jar;lib\xml-apis.jar;
- lib\xercesImpl.jar;lib\xalan.jar
+ java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar
org.apache.fop.fonts.apps.TTFReader -ttcname "MS Mincho"
msmincho.ttc msminch.xml
diff --git a/src/documentation/content/xdocs/0.90/graphics.xml b/src/documentation/content/xdocs/0.91/graphics.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/graphics.xml
rename to src/documentation/content/xdocs/0.91/graphics.xml
diff --git a/src/documentation/content/xdocs/0.90/hyphenation.xml b/src/documentation/content/xdocs/0.91/hyphenation.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/hyphenation.xml
rename to src/documentation/content/xdocs/0.91/hyphenation.xml
diff --git a/src/documentation/content/xdocs/0.90/index.xml b/src/documentation/content/xdocs/0.91/index.xml
similarity index 84%
rename from src/documentation/content/xdocs/0.90/index.xml
rename to src/documentation/content/xdocs/0.91/index.xml
index 0fac1c7c2..4d5e12b06 100644
--- a/src/documentation/content/xdocs/0.90/index.xml
+++ b/src/documentation/content/xdocs/0.91/index.xml
@@ -18,7 +18,7 @@
- Apache FOP 0.90 alpha 1
+ Apache FOP 0.91 beta$Revision: 201586 $
@@ -32,6 +32,11 @@
features and stabilizing the code. We welcome any feedback you might have and even more, any
other form of help to get the project forward.
+
+ This second release is mostly a bug fix release but also contains a few new features compared
+ to 0.90alpha1. To see what has changed since the last release, please visit the
+ Changes Page and the Release Notes.
+
Upgrading from an earlier version
diff --git a/src/documentation/content/xdocs/0.90/output.xml b/src/documentation/content/xdocs/0.91/output.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/output.xml
rename to src/documentation/content/xdocs/0.91/output.xml
diff --git a/src/documentation/content/xdocs/0.90/pdfencryption.xml b/src/documentation/content/xdocs/0.91/pdfencryption.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/pdfencryption.xml
rename to src/documentation/content/xdocs/0.91/pdfencryption.xml
diff --git a/src/documentation/content/xdocs/0.90/running.xml b/src/documentation/content/xdocs/0.91/running.xml
similarity index 99%
rename from src/documentation/content/xdocs/0.90/running.xml
rename to src/documentation/content/xdocs/0.91/running.xml
index 3eccf6807..182756359 100644
--- a/src/documentation/content/xdocs/0.90/running.xml
+++ b/src/documentation/content/xdocs/0.91/running.xml
@@ -119,7 +119,7 @@ Fop [options] [-fo|-xml] infile [-xsl file] [-awt|-pdf|-mif|-rtf|-tiff|-png|-pcl
-c cfg.xml use additional configuration file cfg.xml
-l lang the language to use for user information
-r relaxed/less strict validation (where available)
- -dpi xxx resolution in dots per inch (dpi) where xxx is a number
+ -dpi xxx target resolution in dots per inch (dpi) where xxx is a number
-s for area tree XML, down to block areas only
-v to show FOP version being used
diff --git a/src/documentation/content/xdocs/0.90/servlets.xml b/src/documentation/content/xdocs/0.91/servlets.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.90/servlets.xml
rename to src/documentation/content/xdocs/0.91/servlets.xml
diff --git a/src/documentation/content/xdocs/0.90/upgrading.xml b/src/documentation/content/xdocs/0.91/upgrading.xml
similarity index 82%
rename from src/documentation/content/xdocs/0.90/upgrading.xml
rename to src/documentation/content/xdocs/0.91/upgrading.xml
index 60ba5413c..e1a812f83 100644
--- a/src/documentation/content/xdocs/0.90/upgrading.xml
+++ b/src/documentation/content/xdocs/0.91/upgrading.xml
@@ -31,7 +31,7 @@
More than half of the codebase has been rewritten over the last three years. The code is
- new and not as stable as version 0.20.5.
+ relatively new and possibly not as stable as version 0.20.5 in every regard.
The API of FOP has changed considerably and is not backwards-compatible with version 0.20.5.
@@ -39,9 +39,6 @@
The new API is not stable, yet. Please be aware that further changes might still occur!
-
- The configuration file format has changed (see the Configuration page for details).
-
The new code is much more strict about the interpretation of the XSL-FO 1.0 specification.
@@ -51,12 +48,15 @@
While FOP 0.20.5 allowed you to have empty fo:table-cell elements, the new code
will complain about that (unless relaxed validation is enabled) because the specification
- demands at least one block-level element ((%block;)+, see XSL-FO 1.0, 6.7.10)
+ demands at least one block-level element ((%block;)+, see
+ XSL-FO 1.0, 6.7.10)
inside an fo:table-cell element.
- Extensions written for version 0.20.5 will not work with the new code!
+ Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP
+ extension for Barcode4J will be available in
+ January 2006.
The PCL Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional
@@ -91,13 +91,18 @@
As stated above empty table cells <fo:table-cell></fo:table-cell>
- are not allowed.
+ are not allowed by the specification. The same applies to empty static-content
+ and block-container elements, for example.
- 0.20.5 is not XSL-FO compliant with respect to sizing images or instream-foreign-object
+ 0.20.5 is not XSL-FO compliant with respect to sizing images (external-graphic)
+ or instream-foreign-object
objects. If images or SVGs are sized differently in your outputs with the new FOP version
check Bug 37136
- as it contains some hints on what to.
+ as it contains some hints on what to. The file
+
+ "examples/fo/basic/images.fo" has
+ a number of good examples that shows the new, more correct behaviour.
The fox:outline extension not implemented in this version anymore.
diff --git a/src/documentation/content/xdocs/compliance.ihtml b/src/documentation/content/xdocs/compliance.ihtml
index 045082c45..3366914d6 100644
--- a/src/documentation/content/xdocs/compliance.ihtml
+++ b/src/documentation/content/xdocs/compliance.ihtml
@@ -176,7 +176,7 @@
0.20.5 (current stable)
- 0.90alpha1 (unstable)
+ 0.91 beta (unstable)
@@ -614,7 +614,7 @@
[0.20.5] For absolute positioning, use 'position="absolute"' (as 'absolute-position="absolute"' is not implemented), and specify all four of "left", "top", "width" and "height"
- [0.90alpha1] No known restrictions.
+ [0.91 beta] No known restrictions.
@@ -828,7 +828,7 @@
[0.20.5] Only works for table of contents without any problems. The case where the page number doesn't fit on a line isn't handled, and any text on the same line and after the page-number might not appear exactly where you want it to.
- [0.90alpha1] After the page number is known, no relayout is performed. The appearance may be suboptimal depending on the use case.
+ [0.91 beta] After the page number is known, no relayout is performed. The appearance may be suboptimal depending on the use case.
@@ -877,7 +877,7 @@
- [0.90alpha1] Only border-collapse="separate" is supported and there's no support for automatic column widths.
+ [0.91 beta] Only border-collapse="separate" is supported and there's no support for automatic column widths.
@@ -1358,7 +1358,7 @@
-
[0.90alpha1] Restrictions with multi-column documents.
+
[0.91 beta] Restrictions with multi-column documents.
@@ -1475,7 +1475,7 @@
0.20.5 (current stable)
- 0.90alpha1 (unstable)
+ 0.91 beta (unstable)
@@ -1550,7 +1550,7 @@
[0.20.5] Use shorthand position="absolute" as a workaround.
- [0.90alpha1] No restrictions. The 0.20.5 work-around is not supported.
+ [0.91 beta] No restrictions. The 0.20.5 work-around is not supported.
@@ -2044,7 +2044,7 @@
- [0.90alpha1] not yet implemented on table-body, table-header and table-footer.
+ [0.91 beta] not yet implemented on table-body, table-header and table-footer.
@@ -2068,7 +2068,7 @@
- [0.90alpha1] not yet implemented on table-body, table-header and table-footer.
+ [0.91 beta] not yet implemented on table-body, table-header and table-footer.
@@ -3025,7 +3025,7 @@
[0.20.5] "normal", "bolder" and "lighter" are not supported
- [0.90alpha1] TODO <relative> font weights
+ [0.91 beta] TODO <relative> font weights
- [0.90alpha1] Space adjustment may not fully work everywhere, yet.
+ [0.91 beta] Space adjustment may not fully work everywhere, yet.
@@ -3534,7 +3534,7 @@
[0.20.5] For table-cell, the "height" attribute must be set for the parent table-row; setting the height of the table or the table-cell results in vertical centering having no effect.
- [0.90alpha1] TODO Check e-g, i-f-o.
+ [0.91 beta] TODO Check e-g, i-f-o.
@@ -3948,7 +3948,7 @@
- [0.90alpha1] value "line-height" not supported
+ [0.91 beta] value "line-height" not supported
@@ -3972,7 +3972,7 @@
- [0.90alpha1] Value "treat-as-zero-width-space" not supported
+ [0.91 beta] Value "treat-as-zero-width-space" not supported
@@ -3996,7 +3996,7 @@
- [0.90alpha1] Only the values "ignore" and "ignore-if-surrounding-linefeed" work reliably
+ [0.91 beta] Only the values "ignore" and "ignore-if-surrounding-linefeed" work reliably
@@ -4108,7 +4108,7 @@
- [0.90alpha1] Only supported on fo:block.
+ [0.91 beta] Only supported on fo:block.
@@ -4475,10 +4475,10 @@
[0.20.5] works only in table rows
- [0.90alpha1] works on all implemented FOs.
+ [0.91 beta] works on all implemented FOs.
- [0.90alpha1] <integer> values are not supported.
+ [0.91 beta] <integer> values are not supported.
@@ -4505,10 +4505,10 @@
[0.20.5] works only in table rows
- [0.90alpha1] works on all implemented FOs.
+ [0.91 beta] works on all implemented FOs.
- [0.90alpha1] <integer> values are not supported.
+ [0.91 beta] <integer> values are not supported.
@@ -4535,10 +4535,10 @@
[0.20.5] works only in table rows
- [0.90alpha1] works on all implemented FOs, except list- and table-related FOs.
+ [0.91 beta] works on all implemented FOs, except list- and table-related FOs.
- [0.90alpha1] <integer> values are not supported.
+ [0.91 beta] <integer> values are not supported.
@@ -4621,13 +4621,11 @@
no
-
- partial
+
+ yes
-
-
[0.90alpha1] TODO TBD
-
+
@@ -4704,7 +4702,7 @@
[0.20.5] not value "page"
- [0.90alpha1] Not uspported
+ [0.91 beta] Not uspported
@@ -4731,7 +4729,7 @@
[0.20.5] not value "use-content"
- [0.90alpha1] Value "use-content" does not work in all circumstances.
+ [0.91 beta] Value "use-content" does not work in all circumstances.
@@ -6185,7 +6183,7 @@
-
[0.90alpha1] IDs on table-header, table-footer, table-body, table-row, table-and-caption, table-caption, inline-container and bidi-override are not available, yet.
+
[0.91 beta] IDs on table-header, table-footer, table-body, table-row, table-and-caption, table-caption, inline-container and bidi-override are not available, yet.
- The latest unstable version of FOP (0.90 alpha 1) is the first preview release
+ The latest unstable version of FOP (0.91 beta) is the first preview release
after a large redesign effort and implements a larger subset than 0.20.5 of the
XSL-FO Version 1.0 W3C Recommendation
as well as some parts of the XSL-FO Version 1.1 Working Draft.
diff --git a/src/documentation/content/xdocs/site.xml b/src/documentation/content/xdocs/site.xml
index d97bb3310..375f7c85b 100644
--- a/src/documentation/content/xdocs/site.xml
+++ b/src/documentation/content/xdocs/site.xml
@@ -85,9 +85,9 @@
-->
-
+
@@ -111,7 +111,7 @@