</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>
<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"
<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">
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>
</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.
<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>
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>
</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">
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