From: Pascal Sancho Date: Thu, 5 May 2011 07:18:55 +0000 (+0000) Subject: Site: update DOC for bookmarks X-Git-Tag: fop-1_1rc1old~218 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=fb09043a54b6033b673ed84a2ae22b81aed842e0;p=xmlgraphics-fop.git Site: update DOC for bookmarks git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@1099706 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml index 107f6c5b3..ef9b6f6c2 100644 --- a/src/documentation/content/xdocs/trunk/extensions.xml +++ b/src/documentation/content/xdocs/trunk/extensions.xml @@ -24,14 +24,14 @@

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

- 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 Developers' Extension Page.

All extensions require the correct use of an appropriate namespace in your input document. @@ -47,7 +47,7 @@ Namespace

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 http://xmlgraphics.apache.org/fop/extensions to the root element:

PDF Bookmarks

- In previous versions of Apache FOP there was a fox:outline element + In old versions of Apache FOP there was a fox:outline element which was used to create outlines in PDF files. The redesigned code makes use - of the new bookmark feature defined in the latest XSL 1.1 working draft. + of the bookmark feature defined in the W3C XSL 1.1 standard.

@@ -131,7 +131,7 @@ to following pages. Here is an example of FO code creating such a table-header:< The fox:external-document element is structurally a peer to fo:page-sequence, so wherever you can put an fo:page-sequence you could also place a fox:external-document. - Therefore, the specified contents for fo:root change to: + Therefore, the specified contents for fo:root change to:

@@ -246,7 +246,7 @@ to following pages. Here is an example of FO code creating such a table-header:<

Prepress Support - +

This section defines a number of extensions related to prepress support. @@ -260,15 +260,15 @@ to following pages. Here is an example of FO code creating such a table-header:< Those extensions have been implemented in the PDF and Java2D renderers only. - +

fox:scale

Value: <number>{1,2}

Initial: 1

Applies to: fo:simple-page-master

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

@@ -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 the definition of + (Corresponds to the definition of padding).

@@ -305,12 +305,12 @@ to following pages. Here is an example of FO code creating such a table-header:<

Applies to: fo:simple-page-master

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

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.

@@ -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.

If requested in the future, we could offer to specify the CropBox in absolute coordinates rather