aboutsummaryrefslogtreecommitdiffstats
path: root/src/documentation/content
diff options
context:
space:
mode:
authorJeremias Maerki <jeremias@apache.org>2006-09-11 18:24:35 +0000
committerJeremias Maerki <jeremias@apache.org>2006-09-11 18:24:35 +0000
commit2466f253400d1ec0f7c4bc6f68a8dab87a3ab87e (patch)
tree75eb326342f941d01902022ebb4a5ed989dec12c /src/documentation/content
parent3fe8aa56c053a08463fa90966677d840d7af612d (diff)
downloadxmlgraphics-fop-2466f253400d1ec0f7c4bc6f68a8dab87a3ab87e.tar.gz
xmlgraphics-fop-2466f253400d1ec0f7c4bc6f68a8dab87a3ab87e.zip
Implemented limited support for extension properties through new methods on ElementMapping (backwards-compatible).
Moved block-progression-unit into the fox: namespace. Implemented new extension properties: fox:orphan-content-limit and fox:widow-content-limit for fo:table and fo:list-block. See documentation for details. Bugfix in ElementListUtils.removeLegalBreaks (concerning box/glue combinations). Added a unit test to cover the problem. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@442282 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src/documentation/content')
-rw-r--r--src/documentation/content/xdocs/trunk/extensions.xml22
1 files changed, 20 insertions, 2 deletions
diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml
index e2d19eca8..0c22ca123 100644
--- a/src/documentation/content/xdocs/trunk/extensions.xml
+++ b/src/documentation/content/xdocs/trunk/extensions.xml
@@ -51,8 +51,11 @@
<code>http://xml.apache.org/fop/extensions</code> to the root element:
</p>
<source><![CDATA[<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
- xmlns:fox="http://xml.apache.org/fop/extensions">]]></source>
- <note>Currently, no extensions are implemented in FOP Trunk which use the FOP extension namespace.</note>
+ xmlns:fox="http://xmlgraphics.apache.org/fop/extensions">]]></source>
+ <note>
+ Currently, no extension elements are implemented in FOP Trunk which use the
+ FOP extension namespace.
+ </note>
</section>
<section id="bookmarks">
<title>PDF Bookmarks</title>
@@ -101,6 +104,21 @@ to following pages. Here is an example of FO code creating such a table-header:<
</fo:table-row>
</fo:table-header>]]></source-->
</section>
+ <section id="widow-orphan-content-limit">
+ <title>fox:orphan-content-limit and fox:widow-content-limit</title>
+ <p>
+ The two proprietary extension properties, fox:orphan-content-limit and
+ fox:widow-content-limit, are used to improve the layout of list-blocks and tables.
+ If you have a table with many entries, you don't want a single row to be left over
+ on a page. You will want to make sure that at least two or three lines are kept
+ together. The properties take an absolute length which specifies the area at the
+ beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a
+ table or list-block. The properties are inherited and only have an effect on fo:table
+ and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure
+ the you'll have at least three lines (assuming line-height="1.2") together on a table
+ or list-block.
+ </p>
+ </section>
</section>
</body>
</document>