|
|
@@ -24,14 +24,14 @@ |
|
|
|
</header> |
|
|
|
<body> |
|
|
|
<p> |
|
|
|
By "extension", we mean any data that can be placed in the input XML document that |
|
|
|
By "extension", we mean any data that can be placed in the input XML document that |
|
|
|
is not addressed by the XSL-FO standard. |
|
|
|
By having a mechanism for supporting extensions, FOP is able to add features that |
|
|
|
By having a mechanism for supporting extensions, FOP is able to add features that |
|
|
|
are not covered in the specification. |
|
|
|
</p> |
|
|
|
<p> |
|
|
|
The extensions documented here are included with FOP, and are automatically available |
|
|
|
to you. If you wish to add an extension of your own to FOP, please see the |
|
|
|
The extensions documented here are included with FOP, and are automatically available |
|
|
|
to you. If you wish to add an extension of your own to FOP, please see the |
|
|
|
<a href="../dev/extensions.html">Developers' Extension Page</a>. |
|
|
|
</p> |
|
|
|
<note>All extensions require the correct use of an appropriate namespace in your input document.</note> |
|
|
@@ -47,7 +47,7 @@ |
|
|
|
<title>Namespace</title> |
|
|
|
<p> |
|
|
|
By convention, FO extensions in FOP use the "fox" namespace prefix. |
|
|
|
To use any of the FO extensions, add a namespace entry for |
|
|
|
To use any of the FO extensions, add a namespace entry for |
|
|
|
<code>http://xmlgraphics.apache.org/fop/extensions</code> to the root element: |
|
|
|
</p> |
|
|
|
<source><![CDATA[<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" |
|
|
@@ -56,9 +56,9 @@ |
|
|
|
<section id="bookmarks"> |
|
|
|
<title>PDF Bookmarks</title> |
|
|
|
<p> |
|
|
|
In previous versions of Apache FOP there was a <code>fox:outline</code> element |
|
|
|
In old versions of Apache FOP there was a <code>fox:outline</code> element |
|
|
|
which was used to create outlines in PDF files. The redesigned code makes use |
|
|
|
of the new <a href="http://www.w3.org/TR/xsl11/#fo_bookmark-tree">bookmark feature defined in the latest XSL 1.1 working draft</a>. |
|
|
|
of the <a href="http://www.w3.org/TR/xsl11/#fo_bookmark-tree">bookmark feature defined in the W3C XSL 1.1 standard</a>. |
|
|
|
</p> |
|
|
|
</section> |
|
|
|
<section id="named-destinations"> |
|
|
@@ -131,7 +131,7 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
The <code>fox:external-document</code> element is structurally a peer to |
|
|
|
<code>fo:page-sequence</code>, so wherever you can put an <code>fo:page-sequence</code> |
|
|
|
you could also place a <code>fox:external-document</code>. |
|
|
|
Therefore, the specified contents for <code>fo:root</code> change to: |
|
|
|
Therefore, the specified contents for <code>fo:root</code> change to: |
|
|
|
</p> |
|
|
|
<p> |
|
|
|
<code> |
|
|
@@ -246,7 +246,7 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
</section> |
|
|
|
<section id="prepress"> |
|
|
|
<title>Prepress Support</title> |
|
|
|
|
|
|
|
|
|
|
|
<p> |
|
|
|
This section defines a number of extensions related to |
|
|
|
<a href="http://en.wikipedia.org/wiki/Prepress">prepress</a> support. |
|
|
@@ -260,15 +260,15 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
<note> |
|
|
|
Those extensions have been implemented in the PDF and Java2D renderers only. |
|
|
|
</note> |
|
|
|
|
|
|
|
|
|
|
|
<section id="scale"> |
|
|
|
<title>fox:scale</title> |
|
|
|
<p>Value: <number>{1,2}</p> |
|
|
|
<p>Initial: 1</p> |
|
|
|
<p>Applies to: fo:simple-page-master</p> |
|
|
|
<p> |
|
|
|
This property specifies a scale factor along resp. the x and y axes. If only one number |
|
|
|
is provided it is used for both the x and y scales. A scale factor smaller than 1 |
|
|
|
This property specifies a scale factor along resp. the x and y axes. If only one number |
|
|
|
is provided it is used for both the x and y scales. A scale factor smaller than 1 |
|
|
|
shrinks the page. A scale factor greater than 1 enlarges the page. |
|
|
|
</p> |
|
|
|
</section> |
|
|
@@ -287,7 +287,7 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
If there are three values, the top is set to the first value, the left and right are set to the second, |
|
|
|
and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and |
|
|
|
left, respectively. |
|
|
|
(Corresponds to <a href="http://www.w3.org/TR/xsl11/#padding">the definition of |
|
|
|
(Corresponds to <a href="http://www.w3.org/TR/xsl11/#padding">the definition of |
|
|
|
padding</a>). |
|
|
|
</p> |
|
|
|
<p> |
|
|
@@ -305,12 +305,12 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
</p> |
|
|
|
<p>Applies to: fo:simple-page-master</p> |
|
|
|
<p> |
|
|
|
Same behaviour as with fox:bleed. The initial value is set to the same values as the |
|
|
|
Same behaviour as with fox:bleed. The initial value is set to the same values as the |
|
|
|
fox:bleed property. |
|
|
|
</p> |
|
|
|
<p> |
|
|
|
This extension indirectly defines the MediaBox and is calculated by expanding |
|
|
|
the TrimBox by the crop offsets. The lengths must be non-negative. |
|
|
|
the TrimBox by the crop offsets. The lengths must be non-negative. |
|
|
|
</p> |
|
|
|
</section> |
|
|
|
<section id="cropBox"> |
|
|
@@ -326,7 +326,7 @@ to following pages. Here is an example of FO code creating such a table-header:< |
|
|
|
The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes |
|
|
|
the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension |
|
|
|
follows that definition. To simplify usage and cover most use cases, the three supported enumeration |
|
|
|
values "trim-box", "bleed-box" and "media-box" set the CropBox to one of those three other boxes. |
|
|
|
values "trim-box", "bleed-box" and "media-box" set the CropBox to one of those three other boxes. |
|
|
|
</p> |
|
|
|
<p> |
|
|
|
If requested in the future, we could offer to specify the CropBox in absolute coordinates rather |