Added more text.
authorTony Graham
Mon, 28 Jul 2014 23:28:29 +0100
changeset 51 53a9f2fe79d0
parent 50 8f316759e0bc
child 52 2ca58ce19d72
Added more text.
FOPRunXSLTExt/examples/balisage2014.xml
--- 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., &#x201C;<code>6pt</code>&#x201D;, 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., &#x201C;<code>6pt</code>&#x201D;, etc.</def>
+  </item>
 </api-list>
+</box>
 </example>