Added more text.
--- a/FOPRunXSLTExt/examples/balisage2014.xml Mon Jul 28 23:28:14 2014 +0100
+++ b/FOPRunXSLTExt/examples/balisage2014.xml Mon Jul 28 23:28:29 2014 +0100
@@ -1,9 +1,15 @@
<example name="Balisage 2014">
<header>Print and Page Layout <svg href="ppl-logo.svg" id="logo"/> Community Group<lb/>XSLT Extensions</header>
-<box id="box001" width="2240pt" height="620pt">
-<paragraph id="para001">The XSLT extension functions from the Print and Page Layout Community Group @ W3C allow you to run your XSL-FO formatter within your XSLT transform, and do it as often as you like, to get an area tree and make decisions based on formatted areas to do things like: adjust the start-indent of a fo:list-block based on the length of the longest fo:list-item-label; or size this text to be <font-size/> so it fits this box.</paragraph>
+<box id="box001" width="2240pt" height="540pt">
+<paragraph id="para001">The XSLT extension functions from the Print and Page Layout Community Group @ W3C (see <url>https://www.w3.org/community/ppl/wiki/XSLTExtensions</url>) allow you to run your XSL-FO formatter within your XSLT transform, and do it as often as you like, to get an area tree and make decisions based on formatted areas to do things like:</paragraph>
+<list id="list009">
+ <item label="*">Adjust the start-indent of a fo:list-block based on the length of the longest fo:list-item-label; or</item>
+ <item label="*">Size this text to be <font-size/> so it fits this box.</item>
+</list>
</box>
+<box id="box002" width="2240pt" height="560pt" columns="2" border="none">
+<title>XSLT and XSL-FO Processors</title>
<paragraph id="para002">The extension is available for Java and DotNet and uses either the Apache FOP XSL formatter or Antenna House AHF formatter to produce the area trees.</paragraph>
<paragraph>The single Java jar file covers four combinations of XSLT processor and XSL-FO formatter:</paragraph>
<list id="list001">
@@ -18,8 +24,8 @@
<item label="*">DotNet 4.0 and FOP</item>
<item label="*">DotNet 4.0 and Antenna House</item>
</list>
-
-<paragraph>API:</paragraph>
+<title>API</title>
+<paragraph>The PPL CG provides <code>ppl:area-tree()</code> for running the formatter and getting the area tree plus a selection of convenience functions to help hide both the details of the area tree and the differences between the area trees of different XSL-FO formatters.</paragraph>
<api-list id="list003">
<item>
<function>ppl:area-tree($fo-tree as node()) as document-node()</function>
@@ -41,5 +47,22 @@
<function>ppl:block-available-ipd($block as element()) as xs:double</function>
<def>Returns the difference, in points, between the inline-progression-dimension of $block and the inline-progression-dimension of its ancestor reference area.</def>
</item>
+ <item>
+ <function>ppl:is-first($block as element()) as xs:boolean</function>
+ <def>Returns the value of the <code>is-first</code> trait.</def>
+ </item>
+ <item>
+ <function>ppl:is-last($block as element()) as xs:boolean</function>
+ <def>Returns the value of the <code>is-last</code> trait.</def>
+ </item>
+ <item>
+ <function>ppl:sum-lengths-to-inches($lengths as xs:string*) as xs:double</function>
+ <def>Returns the length, in inches, of the sum of a sequence of lengths represented as strings, e.g., “<code>6pt</code>”, etc.</def>
+ </item>
+ <item>
+ <function>ppl:sum-lengths-to-pt($lengths as xs:string*) as xs:double</function>
+ <def>Returns the length, in points (1/72 of an inch), of the sum of a sequence of lengths represented as strings, e.g., “<code>6pt</code>”, etc.</def>
+ </item>
</api-list>
+</box>
</example>