[jboss-cvs] JBossAS SVN: r103735 - projects/docs/enterprise/5.0/Seam_Reference_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Fri Apr 9 03:06:28 EDT 2010
Author: misty at redhat.com
Date: 2010-04-09 03:06:28 -0400 (Fri, 09 Apr 2010)
New Revision: 103735
Modified:
projects/docs/enterprise/5.0/Seam_Reference_Guide/en-US/Itext.xml
Log:
Rewriting tables....
Modified: projects/docs/enterprise/5.0/Seam_Reference_Guide/en-US/Itext.xml
===================================================================
--- projects/docs/enterprise/5.0/Seam_Reference_Guide/en-US/Itext.xml 2010-04-09 07:02:43 UTC (rev 103734)
+++ projects/docs/enterprise/5.0/Seam_Reference_Guide/en-US/Itext.xml 2010-04-09 07:06:28 UTC (rev 103735)
@@ -1,296 +1,366 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
+ ]>
<chapter id="itext" >
- <title>iText PDF generation</title>
- <para>
- Seam now includes a component set for generating documents with iText. The primary focus of Seam's iText document support is for the generation of PDF documents, but Seam also offers basic support for RTF document generation.
- </para>
- <section id="itext.intro">
- <title>Using PDF Support</title>
- <para>
- iText support is provided by <filename>jboss-seam-pdf.jar</filename>. This <filename>JAR</filename> contains the iText JSF controls (which construct views that can render to PDF) and the DocumentStore component (which serves the rendered documents to the user). To include PDF support in your application, place <filename>jboss-seam-pdf.jar</filename> in your <literal>WEB-INF/lib</literal> directory along with the iText <filename>JAR</filename> file. No further configuration is required to use Seam's iText support.
- </para>
- <para>
- The Seam iText module requires that Facelets be used as the view technology. Future versions of the library may also support the use of JSP. It also requires the use of the <literal>seam-ui</literal> package.
- </para>
- <para>
- The <literal>examples/itext</literal> project contains an example of the PDF support in action. It demonstrates proper deployment packaging, and contains several examples demonstrating the key PDF-generation features currently supported.
- </para>
- <section id="itext.document">
- <title>Creating a document</title>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:document>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Documents are generated by Facelet XHTML files using tags in the <literal>http://jboss.com/products/seam/pdf</literal> namespace. Documents should always have the <literal>document</literal> tag at the root of the document. The <literal>document</literal> tag prepares Seam to generate a document into the DocumentStore and renders an HTML redirect to that stored content.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <variablelist>
- <varlistentry>
- <term><literal>type</literal></term>
- <listitem>
- <para>
- The type of the document to be produced. Valid values are <literal>PDF</literal>, <literal>RTF</literal> and <literal>HTML</literal>. Seam defaults to PDF generation, and many features only work correctly when generating PDF documents.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>pageSize</literal></term>
- <listitem>
- <para>
- The size of the page to be generated. The most commonly used values are <literal>LETTER</literal> and <literal>A4</literal>. A full list of supported pages sizes can be found in the <literal>com.lowagie.text.PageSize</literal> class. Alternatively, pageSize can provide the width and height of the page directly. The value "612 792", for example, is equivalent to the LETTER page size.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>orientation</literal></term>
- <listitem>
- <para>
- The orientation of the page. Valid values are <literal>portrait</literal> and <literal>landscape</literal>. Landscape mode swaps the height and width page values.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>margins</literal></term>
- <listitem>
- <para>
- The left, right, top and bottom margin values.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>marginMirroring</literal></term>
- <listitem>
- <para>
- Indicates that margin settings should be reversed on alternating pages.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>disposition</literal></term>
- <listitem>
- <para>
- When generating PDFs in a web browser, this determines the HTTP <literal>Content-Disposition</literal> of the document. Valid values are <literal>inline</literal>, which indicates the document should be displayed in the browser window if possible, and <literal>attachment</literal>, which indicates that the document should be treated as a download. The default value is <literal>inline</literal>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><literal>fileName</literal></term>
- <listitem>
- <para>
- For attachments, this value overrides the downloaded file name.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- <emphasis>Metadata Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>title</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>subject</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>keywords</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>author</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>creator</literal>
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
+ <title>iText PDF generation</title>
+ <para>
+ Seam now includes a component set for generating documents with iText. The primary focus of Seam's iText document support is for the generation of PDF documents, but Seam also offers basic support for RTF document generation.
+ </para>
+ <section id="itext.intro">
+ <title>Using PDF Support</title>
+ <para>
+ iText support is provided by <filename>jboss-seam-pdf.jar</filename>. This <filename>JAR</filename> contains the iText JSF controls (which construct views that can render to PDF) and the DocumentStore component (which serves the rendered documents to the user). To include PDF support in your application, place <filename>jboss-seam-pdf.jar</filename> in your <literal>WEB-INF/lib</literal> directory along with the iText <filename>JAR</filename> file. No further configuration is required to use Seam's iText support.
+ </para>
+ <para>
+ The Seam iText module requires that Facelets be used as the view technology. Future versions of the library may also support the use of JSP. It also requires the use of the <literal>seam-ui</literal> package.
+ </para>
+ <para>
+ The <literal>examples/itext</literal> project contains an example of the PDF support in action. It demonstrates proper deployment packaging, and contains several examples demonstrating the key PDF-generation features currently supported.
+ </para>
+ <section id="itext.document">
+ <!--
+ <title>Creating a document</title>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:document>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Documents are generated by Facelet XHTML files using tags in the <literal>http://jboss.com/products/seam/pdf</literal> namespace. Documents should always have the <literal>document</literal> tag at the root of the document. The <literal>document</literal> tag prepares Seam to generate a document into the DocumentStore and renders an HTML redirect to that stored content.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><literal>type</literal></term>
+ <listitem>
+ <para>
+ The type of the document to be produced. Valid values are <literal>PDF</literal>, <literal>RTF</literal> and <literal>HTML</literal>. Seam defaults to PDF generation, and many features only work correctly when generating PDF documents.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>pageSize</literal></term>
+ <listitem>
+ <para>
+ The size of the page to be generated. The most commonly used values are <literal>LETTER</literal> and <literal>A4</literal>. A full list of supported pages sizes can be found in the <literal>com.lowagie.text.PageSize</literal> class. Alternatively, pageSize can provide the width and height of the page directly. The value "612 792", for example, is equivalent to the LETTER page size.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>orientation</literal></term>
+ <listitem>
+ <para>
+ The orientation of the page. Valid values are <literal>portrait</literal> and <literal>landscape</literal>. Landscape mode swaps the height and width page values.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>margins</literal></term>
+ <listitem>
+ <para>
+ The left, right, top and bottom margin values.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>marginMirroring</literal></term>
+ <listitem>
+ <para>
+ Indicates that margin settings should be reversed on alternating pages.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>disposition</literal></term>
+ <listitem>
+ <para>
+ When generating PDFs in a web browser, this determines the HTTP <literal>Content-Disposition</literal> of the document. Valid values are <literal>inline</literal>, which indicates the document should be displayed in the browser window if possible, and <literal>attachment</literal>, which indicates that the document should be treated as a download. The default value is <literal>inline</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>fileName</literal></term>
+ <listitem>
+ <para>
+ For attachments, this value overrides the downloaded file name.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ <emphasis>Metadata Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>title</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>subject</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>keywords</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>author</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>creator</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
-<programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf">
- The document goes here.
+ <programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf">
+The document goes here.
</p:document>]]>
-</programlisting>
-</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
-
- <section id="itext.text">
- <title>Basic Text Elements</title>
- <para>
- Seam provides special UI components for generating content suitable to PDF. <literal><![CDATA[<p:image>]]></literal> and <literal><![CDATA[<p:paragraph>]]></literal> tags form the foundations of simple documents. Tags like <literal><![CDATA[<p:font>]]></literal> provide style information.
- </para>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:paragraph>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- For most purposes, text should be sectioned into paragraphs so that text fragments can be assigned a logical flow, format and style.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>firstLineIndent</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>extraParagraphSpace</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>leading</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>multipliedLeading</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingBefore</literal> — The blank space to be inserted before the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingAfter</literal> — The blank space to be inserted after the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationLeft</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationRight</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>keepTogether</literal>
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:paragraph alignment="justify">
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ -->
+
+ <remark>Rewriting the above table for new Publican compliance</remark>
+
+ <variablelist>
+ <varlistentry>
+ <term><p:document></term>
+ <listitem>
+ <varlistentry>
+ <term>Description</term>
+ <listitem><para>Documents are generated by Facelet XHTML files using tags in the http://jboss.com/products/seam/pdf namespace. Documents should always have the document tag at the root of the document. The document tag prepares Seam to generate a document into the DocumentStore and renders an HTML redirect to that stored content.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term> type</term>
+ <listitem><para>The type of the document to be produced. Valid values are PDF, RTF and HTML. Seam defaults to PDF generation, and many features only work correctly when generating PDF documents. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>pageSize</term>
+ <listitem><para>The size of the page to be generated. The most commonly used values are LETTER and A4. A full list of supported pages sizes can be found in the com.lowagie.text.PageSize class. Alternatively, pageSize can provide the width and height of the page directly. The value "612 792", for example, is equivalent to the LETTER page size. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>orientation</term>
+ <listitem><para>The orientation of the page. Valid values are portrait and landscape. Landscape mode swaps the height and width page values. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>margins</term>
+ <listitem><para>The left, right, top and bottom margin values. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>marginMirroring</term>
+ <listitem><para>Indicates that margin settings should be reversed on alternating pages. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>disposition</term>
+ <listitem><para>When generating PDFs in a web browser, this determines the HTTP Content-Disposition of the document. Valid values are inline, which indicates the document should be displayed in the browser window if possible, and attachment, which indicates that the document should be treated as a download. The default value is inline. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>fileName</term>
+ <listitem><para>For attachments, this value overrides the downloaded file name. </para></listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Metadata Attributes</term>
+ <listitem>
+ <itemizedlist>
+ <listitem><para>title</para></listitem>
+ <listitem><para>subject</para></listitem>
+ <listitem><para>keywords</para></listitem>
+ <listitem><para>author</para></listitem>
+ <listitem><para>creator</para></listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <para><code><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf"> The document goes here. </p:document>]]></code></para>
+ </listitem>
+ </varlistentry>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+
+ <section id="itext.text">
+ <title>Basic Text Elements</title>
+ <para>
+ Seam provides special UI components for generating content suitable to PDF. <literal><![CDATA[<p:image>]]></literal> and <literal><![CDATA[<p:paragraph>]]></literal> tags form the foundations of simple documents. Tags like <literal><![CDATA[<p:font>]]></literal> provide style information.
+ </para>
+ <!--
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:paragraph>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ For most purposes, text should be sectioned into paragraphs so that text fragments can be assigned a logical flow, format and style.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>firstLineIndent</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>extraParagraphSpace</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>leading</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>multipliedLeading</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingBefore</literal> — The blank space to be inserted before the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingAfter</literal> — The blank space to be inserted after the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationLeft</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationRight</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>keepTogether</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:paragraph alignment="justify">
This is a simple document. It isn't very fancy.
</p:paragraph>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:text>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The <literal>text</literal> tag lets application data produce text fragments using normal JSF converter mechanisms. It is very similar to the <literal>outputText</literal> tag used when rendering HTML documents.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>value</literal> — The value to be displayed. This is typically a value binding expression.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:paragraph>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:text>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The <literal>text</literal> tag lets application data produce text fragments using normal JSF converter mechanisms. It is very similar to the <literal>outputText</literal> tag used when rendering HTML documents.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>value</literal> — The value to be displayed. This is typically a value binding expression.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:paragraph>
The item costs <p:text value="#{product.price}">
<f:convertNumber type="currency"
currencySymbol="$"/>
</p:text>
-</p:paragraph>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:html>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The <literal>html</literal> tag renders HTML content into the PDF.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>value</literal> — The text to be displayed.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:html value="This is HTML with <b>some markup</b>" />
+ </p:paragraph>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:html>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The <literal>html</literal> tag renders HTML content into the PDF.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>value</literal> — The text to be displayed.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:html value="This is HTML with <b>some markup</b>" />
<p:html>
<h1>This is more complex HTML</h1>
<ul>
@@ -301,384 +371,729 @@
</p:html>
<p:html>
- <s:formattedText value="*This* is |Seam Text| as
- HTML.
- It's very^cool^." />
+ <s:formattedText value="*This* is |Seam Text| as
+ HTML.
+ It's very^cool^." />
</p:html>
]]></programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:font>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The <literal>font</literal> tag defines the default font to be used for all text inside of it.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>name</literal> — The font name, for example: <literal>COURIER</literal>, <literal>HELVETICA</literal>, <literal>TIMES-ROMAN</literal>, <literal>SYMBOL</literal> or <literal>ZAPFDINGBATS</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>size</literal> — The point size of the font.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>style</literal> — The font styles. Any combination of : <literal>NORMAL</literal>, <literal>BOLD</literal>, <literal>ITALIC</literal>, <literal>OBLIQUE</literal>, <literal>UNDERLINE</literal>, <literal>LINE-THROUGH</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>encoding</literal> — The character set encoding.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:font name="courier" style="bold" size="24">
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:font>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The <literal>font</literal> tag defines the default font to be used for all text inside of it.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>name</literal> — The font name, for example: <literal>COURIER</literal>, <literal>HELVETICA</literal>, <literal>TIMES-ROMAN</literal>, <literal>SYMBOL</literal> or <literal>ZAPFDINGBATS</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>size</literal> — The point size of the font.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>style</literal> — The font styles. Any combination of : <literal>NORMAL</literal>, <literal>BOLD</literal>, <literal>ITALIC</literal>, <literal>OBLIQUE</literal>, <literal>UNDERLINE</literal>, <literal>LINE-THROUGH</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>encoding</literal> — The character set encoding.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:font name="courier" style="bold" size="24">
<p:paragraph>My Title</p:paragraph>
-</p:font>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:newPage>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:newPage</literal> inserts a page break.
- </para>
- <para>
- <emphasis>Usage</emphasis>
- </para>
+ </p:font>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:newPage>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:newPage</literal> inserts a page break.
+ </para>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:newPage />]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:image>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:image</literal> inserts an image into the document. Images can be loaded from the classpath or from the web application context using the <literal>value</literal> attribute.--> <!-- #clarify: from classpath w/ value AND webapp w/ value, or from classpath OR webapp w/ value? --><!--
+ </para>
+ <para>
+ Resources can also be dynamically generated by application code. The <literal>imageData</literal> attribute can specify a value binding expression whose value is a <literal>java.awt.Image</literal> object.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>value</literal> — A resource name or a method expression that binds to an application-generated image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rotation</literal> — The rotation of the image in degrees.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>height</literal> — The height of the image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>alignment</literal>— The alignment of the image. (See <xref linkend="itext.alignment" /> for possible values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>alt</literal> — Alternative text representation for the image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationLeft</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationRight</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingBefore</literal> — The blank space to be inserted before the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingAfter</literal> — The blank space to be inserted after the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>widthPercentage</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>initialRotation</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>dpi</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>scalePercent</literal> — The scaling factor (as a percentage) to use for the image. This can be expressed as a single percentage value or as two percentage values representing separate x and y scaling percentages.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>wrap</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>underlying</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:image value="/jboss.jpg" />]]>
+ </programlisting>
+
+ <programlisting role="XHTML"><![CDATA[<p:image value="#{images.chart}" />]]>
+ </programlisting>
+ </entry>
+</row>
+<row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:anchor>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:anchor</literal> defines clickable links from a document. It supports the following attributes:
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>name</literal> — The name of an in-document anchor destination.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>reference</literal> — The destination the link refers to. Links to other points in the document should begin with a "#". For example, "#link1" to refer to an anchor position with a <literal>name</literal> of <literal>link1</literal>. To point to a resource outside the document, links must be a complete URL.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:listItem>
+ <p:anchor reference="#reason1">Reason 1</p:anchor>
+ </p:listItem>
+ ...
+ <p:paragraph>
+ <p:anchor name="reason1">
+ It's the quickest way to get "rich"
+ </p:anchor>
+ ...
+ </p:paragraph>]]>
+ </programlisting>
+ </entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+-->
+ <remark>Rewriting the table above to be compliant with Publican</remark>
+
+ <variablelist>
+ <varlistentry>
+ <term><p:paragraph></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ For most purposes, text should be sectioned into paragraphs so that text fragments can be assigned a logical flow, format and style.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <itemizedlist>
+ <listitem><para>firstLineIndent</para></listitem>
+ <listitem><para>extraParagraphSpace</para></listitem>
+ <listitem><para>leading</para></listitem>
+ <listitem><para>multipliedLeading</para></listitem>
+ <listitem><para>spacingBefore — The blank space to be inserted before the element.</para></listitem>
+ <listitem><para>spacingAfter — The blank space to be inserted after the element.</para></listitem>
+ <listitem><para>indentationLeft</para></listitem>
+ <listitem><para>indentationRight</para></listitem>
+ <listitem><para>keepTogether</para></listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <para>
+ <code><![CDATA[<p:paragraph alignment="justify"> This is a simple document. It isn't very fancy. </p:paragraph>]]></code>
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+
+ </variablelist>
+
+
+
+ </listitem>
+ </varlistentry>
-<programlisting role="XHTML"><![CDATA[<p:newPage />]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:image>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:image</literal> inserts an image into the document. Images can be loaded from the classpath or from the web application context using the <literal>value</literal> attribute. <!-- #clarify: from classpath w/ value AND webapp w/ value, or from classpath OR webapp w/ value? -->
- </para>
- <para>
- Resources can also be dynamically generated by application code. The <literal>imageData</literal> attribute can specify a value binding expression whose value is a <literal>java.awt.Image</literal> object.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>value</literal> — A resource name or a method expression that binds to an application-generated image.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rotation</literal> — The rotation of the image in degrees.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>height</literal> — The height of the image.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>width</literal> — The width of the image.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>alignment</literal>— The alignment of the image. (See <xref linkend="itext.alignment" /> for possible values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>alt</literal> — Alternative text representation for the image.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationLeft</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationRight</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingBefore</literal> — The blank space to be inserted before the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingAfter</literal> — The blank space to be inserted after the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>widthPercentage</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>initialRotation</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>dpi</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>scalePercent</literal> — The scaling factor (as a percentage) to use for the image. This can be expressed as a single percentage value or as two percentage values representing separate x and y scaling percentages.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>wrap</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>underlying</literal>
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:image value="/jboss.jpg" />]]>
-</programlisting>
-
-<programlisting role="XHTML"><![CDATA[<p:image value="#{images.chart}" />]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:anchor>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:anchor</literal> defines clickable links from a document. It supports the following attributes:
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>name</literal> — The name of an in-document anchor destination.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>reference</literal> — The destination the link refers to. Links to other points in the document should begin with a "#". For example, "#link1" to refer to an anchor position with a <literal>name</literal> of <literal>link1</literal>. To point to a resource outside the document, links must be a complete URL.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:listItem>
- <p:anchor reference="#reason1">Reason 1</p:anchor>
-</p:listItem>
-...
-<p:paragraph>
- <p:anchor name="reason1">
- It's the quickest way to get "rich"
- </p:anchor>
- ...
-</p:paragraph>]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
+ <varlistentry>
+ <term><code><p:text></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ The <tagname>text</tagname> tag lets application data produce text fragments using normal JSF converter mechanisms. It is very similar to the <tagname>outputText</tagname> tag used when rendering HTML documents.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <itemizedlist>
+ <listitem><para>value — The value to be displayed. This is typically a value binding expression.</para></listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[<p:paragraph> The item costs <p:text value="#{product.price}"> <f:convertNumber type="currency" currencySymbol="$"/> </p:text> </p:paragraph>]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><code><p:html></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ The <tagname>html</tagname> tag renders HTML content into the PDF.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[
+ <p:html value="This is HTML with <b>some markup</b>." />
+ <p:html>
+ <h1>This is more complex HTML</h1>
+ <ul>
+ <li>one</li>
+ <li>two</li>
+ <li>three</li>
+ </ul>
+ </p:html>
+
+ <p:html>
+ <s:formattedText value="*This* is |Seam Text| as HTML. It's very^cool^." />
+ </p:html>
+ ]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><code><p:font></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ The <tagname>font</tagname> tag defines the default font to be used for all text inside of it.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>name</term>
+ <listitem><para>The font name, for example: <code>COURIER</code>, <code>HELVETICA</code>, <code>TIMES-ROMAN</code>, <code>SYMBOL</code>, or <code>ZAPFDINGBATS</code>.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>size</term>
+ <listitem><para>The point size of the font.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>style</term>
+ <listitem><para>The font styles. Any combination of : <code>NORMAL</code>, <code>BOLD</code>, <code>ITALIC</code>, <code>OBLIQUE</code>, <code>UNDERLINE</code>, <code>LINE-THROUGH</code></para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>encoding</term>
+ <listitem><para>The character set encoding.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[<p:font name="courier" style="bold" size="24"> <p:paragraph>My Title</p:paragraph> </p:font>]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><code><p:newPage></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ <tagname>p:newPage</tagname> inserts a page break.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <para>
+ None
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[<p:newPage />]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><code><p:image></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para>
+ <tagname>p:image</tagname> inserts an image into the document. Images can be loaded from the classpath or from the web application context using the <varname>value</varname> attribute.
+ </para>
+ <para>
+ Resources can also be dynamically generated by application code. The <varname>imageData</varname> attribute can specify a value binding expression whose value is a <systemitem>java.awt.Image</systemitem> object.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <variablelist>
+ <varlistitem>
+ <term>value</term>
+ <listitem><para>A resource name or a method expression that binds to an application.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>rotation</term>
+ <listitem><para>The rotation of the image in degrees. </para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>height</term>
+ <listitem><para>The height of the image.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>width</term>
+ <listitem><para>The width of the image. </para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>alignment</term>
+ <listitem><para>The alignment of the image. (See <xref linkend="itext.alignment" /> for possible values.)</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>alt</term>
+ <listitem><para>Alternative text representation for the image.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>indentationLeft</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>indentationRight</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>spacingBefore</term>
+ <listitem><para>The blank space to be inserted before the element.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>spacingAfter</term>
+ <listitem><para>The blank space to be inserted after the element.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>widthPercentage</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>initialRotation</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>dpi</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>scalePercent</term>
+ <listitem><para>The scaling factor (as a percentage) to use for the image. This can be expressed as a single percentage value or as two percentage values representing separate x and y scaling percentages.</para></listitem>
+ </varlistitem>
+ <varlistitem>
+ <term>wrap</term>
+ <listitem />
+ </varlistitem>
+ <varlistitem>
+ <term>underlying</term>
+ <listitem />
+ </varlistitem>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[<p:image value="/jboss.jpg" />]]>
+ </programlisting>
+ <programlisting>
+ <![CDATA[<p:image value="#{images.chart}" />]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><code><p:anchor></code></term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Description</term>
+ <listitem>
+ <para><tagname>p:anchor</tagname> defines clickable links from a document. </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Attributes</term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>name</term>
+ <listitem><para>The name of an in-document anchor destination. </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>reference</term>
+ <listitem><para>The destination the link refers to. Links to other points in the document should begin with a "#". For example, "#link1" to refer to an anchor position with a name of <systemitem>link1</systemitem>. To point to a resource outside the document, a link must be a complete URL. </para></listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Usage</term>
+ <listitem>
+ <programlisting>
+ <![CDATA[<p:listItem><p:anchor reference="#reason1">Reason 1</p:anchor></p:listItem> ... <p:paragraph> <p:anchor name="reason1">It's the quickest way to get "rich"</p:anchor> ... </p:paragraph>]]>
+ </programlisting>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+
+ </section>
+
+ <section id="itext.header">
+ <title>Headers and Footers</title>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:header>]]></literal>
+ </para>
+ <para>
+ <literal><![CDATA[<p:footer>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The <literal>p:header</literal> and <literal>p:footer</literal> components let you place header and footer text on each page of a generated document. Header and footer declarations should appear at the beginning of a document.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>backgroundColor</literal> — The background color of the header/footer box. (See <xref linkend="itext.colors" /> for color values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderColor</literal> — The border color of the header/footer box. Individual border sides can be set using <literal>borderColorLeft</literal>, <literal>borderColorRight</literal>, <literal>borderColorTop</literal> and <literal>borderColorBottom</literal>. (See <xref linkend="itext.colors" /> for color values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderWidth</literal> — The width of the border. Individual border sides can be specified using <literal>borderWidthLeft</literal>, <literal>borderWidthRight</literal>, <literal>borderWidthTop</literal> and <literal>borderWidthBottom</literal>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
- <section id="itext.header">
- <title>Headers and Footers</title>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:header>]]></literal>
- </para>
- <para>
- <literal><![CDATA[<p:footer>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The <literal>p:header</literal> and <literal>p:footer</literal> components let you place header and footer text on each page of a generated document. Header and footer declarations should appear at the beginning of a document.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>backgroundColor</literal> — The background color of the header/footer box. (See <xref linkend="itext.colors" /> for color values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderColor</literal> — The border color of the header/footer box. Individual border sides can be set using <literal>borderColorLeft</literal>, <literal>borderColorRight</literal>, <literal>borderColorTop</literal> and <literal>borderColorBottom</literal>. (See <xref linkend="itext.colors" /> for color values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderWidth</literal> — The width of the border. Individual border sides can be specified using <literal>borderWidthLeft</literal>, <literal>borderWidthRight</literal>, <literal>borderWidthTop</literal> and <literal>borderWidthBottom</literal>.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:facet name="header">
+ <programlisting role="XHTML"><![CDATA[<p:facet name="header">
<p:font size="12">
<p:footer borderWidthTop="1" borderColorTop="blue"
- borderWidthBottom="0" alignment="center">
- Why Seam? [<p:pageNumber />]
+ borderWidthBottom="0" alignment="center">
+ Why Seam? [<p:pageNumber />]
</p:footer>
</p:font>
-</f:facet>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:pageNumber>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The current page number can be placed inside a header or footer with the <literal>p:pageNumber</literal> tag. The page number tag can only be used in the context of a header or footer and can only be used once.
- </para>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:footer borderWidthTop="1" borderColorTop="blue"
+ </f:facet>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:pageNumber>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The current page number can be placed inside a header or footer with the <literal>p:pageNumber</literal> tag. The page number tag can only be used in the context of a header or footer and can only be used once.
+ </para>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:footer borderWidthTop="1" borderColorTop="blue"
borderWidthBottom="0" alignment="center">
Why Seam? [<p:pageNumber />]
</p:footer>]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.chapters">
+ <title>Chapters and Sections</title>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:chapter>]]></literal>
+ </para>
+ <para>
+ <literal><![CDATA[<p:section>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ If the generated document follows a book/article structure, the <literal>p:chapter</literal> and <literal>p:section</literal> tags can be used to provide structure. Sections can only be used inside chapters, but they may be nested to any depth required. Most PDF viewers provide easy navigation between chapters and sections in a document.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>number</literal> — The chapter number. Every chapter should be assigned a chapter number.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>numberDepth</literal> — The depth of numbering for section. All sections are numbered relative to their surrounding chapters/sections. The fourth section of the first section of chapter three would be section 3.1.4, if displayed at the default number depth of <literal>3</literal>. To omit the chapter number, a number depth of <literal>2</literal> should be used — this would display the section number as 1.4.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
- <section id="itext.chapters">
- <title>Chapters and Sections</title>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:chapter>]]></literal>
- </para>
- <para>
- <literal><![CDATA[<p:section>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- If the generated document follows a book/article structure, the <literal>p:chapter</literal> and <literal>p:section</literal> tags can be used to provide structure. Sections can only be used inside chapters, but they may be nested to any depth required. Most PDF viewers provide easy navigation between chapters and sections in a document.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>number</literal> — The chapter number. Every chapter should be assigned a chapter number.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>numberDepth</literal> — The depth of numbering for section. All sections are numbered relative to their surrounding chapters/sections. The fourth section of the first section of chapter three would be section 3.1.4, if displayed at the default number depth of <literal>3</literal>. To omit the chapter number, a number depth of <literal>2</literal> should be used — this would display the section number as 1.4.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf" title="Hello">
+ <programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf" title="Hello">
<p:chapter number="1">
<p:title><p:paragraph>Hello</p:paragraph></p:title>
<p:paragraph>Hello #{user.name}!</p:paragraph>
@@ -693,37 +1108,37 @@
<p:paragraph>Goodbye #{user.name}.</p:paragraph>
</p:chapter>
-</p:document> ]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:header>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Any chapter or section can contain a <literal>p:title</literal>. The title will be displayed next to the chapter or section number. The body of the title may contain raw text or may be a <literal>p:paragraph</literal>.
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
-
- <section id="itext.list">
- <title>Lists</title>
- <para>
- List structures can be displayed with the <literal>p:list</literal> and <literal>p:listItem</literal> tags. Lists may contain arbitrarily-nested sublists. List items may not be used outside of a list. The following document uses the <literal>ui:repeat</literal> tag to to display a list of values retrieved from a Seam component.
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf"
+ </p:document> ]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:header>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Any chapter or section can contain a <literal>p:title</literal>. The title will be displayed next to the chapter or section number. The body of the title may contain raw text or may be a <literal>p:paragraph</literal>.
+ </para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.list">
+ <title>Lists</title>
+ <para>
+ List structures can be displayed with the <literal>p:list</literal> and <literal>p:listItem</literal> tags. Lists may contain arbitrarily-nested sublists. List items may not be used outside of a list. The following document uses the <literal>ui:repeat</literal> tag to to display a list of values retrieved from a Seam component.
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:document xmlns:p="http://jboss.com/products/seam/pdf"
xmlns:ui="http://java.sun.com/jsf/facelets" title="Hello">
<p:list style="numbered">
@@ -731,237 +1146,237 @@
<p:listItem>#{doc.name}</p:listItem>
</ui:repeat>
</p:list>
-
-</p:document>]]>
-</programlisting>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:list>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <!-- #modify: ??? description required? <para> <emphasis>Description</emphasis> </para> <para>...</para> --> <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>style</literal> — The ordering/bulleting style of the list. One of: <literal>NUMBERED</literal>, <literal>LETTERED</literal>, <literal>GREEK</literal>, <literal>ROMAN</literal>, <literal>ZAPFDINGBATS</literal>, <literal>ZAPFDINGBATS_NUMBER</literal>. If no style is given, the list items are bulleted by default.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>listSymbol</literal> — For bulleted lists, specifies the bullet symbol.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indent</literal> — The indentation level of the list.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>lowerCase</literal> — For list styles using letters, indicates whether the letters should be lower case.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>charNumber</literal> — For <literal>ZAPFDINGBATS</literal>, indicates the character code of the bullet character.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>numberType</literal> — For <literal>ZAPFDINGBATS_NUMBER</literal>, indicates the numbering style.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:list style="numbered">
+
+ </p:document>]]>
+ </programlisting>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:list>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <!-- #modify: ??? description required? <para> <emphasis>Description</emphasis> </para> <para>...</para> --> <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>style</literal> — The ordering/bulleting style of the list. One of: <literal>NUMBERED</literal>, <literal>LETTERED</literal>, <literal>GREEK</literal>, <literal>ROMAN</literal>, <literal>ZAPFDINGBATS</literal>, <literal>ZAPFDINGBATS_NUMBER</literal>. If no style is given, the list items are bulleted by default.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>listSymbol</literal> — For bulleted lists, specifies the bullet symbol.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indent</literal> — The indentation level of the list.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>lowerCase</literal> — For list styles using letters, indicates whether the letters should be lower case.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>charNumber</literal> — For <literal>ZAPFDINGBATS</literal>, indicates the character code of the bullet character.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>numberType</literal> — For <literal>ZAPFDINGBATS_NUMBER</literal>, indicates the numbering style.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:list style="numbered">
<ui:repeat value="#{documents}" var="doc">
<p:listItem>#{doc.name}</p:listItem>
</ui:repeat>
-</p:list>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:listItem>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:listItem</literal> supports the following attributes:
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>alignment</literal> — The alignment of the list item. (See <xref linkend="itext.alignment" /> for possible values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationLeft</literal> — The left indentation amount.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indentationRight</literal> — The right indentation amount.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>listSymbol</literal> — Overrides the default list symbol for this list item.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML">...
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
+ </p:list>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:listItem>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:listItem</literal> supports the following attributes:
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>alignment</literal> — The alignment of the header/footer box section. (See <xref linkend="itext.alignment" /> for alignment values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>alignment</literal> — The alignment of the list item. (See <xref linkend="itext.alignment" /> for possible values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationLeft</literal> — The left indentation amount.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indentationRight</literal> — The right indentation amount.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>listSymbol</literal> — Overrides the default list symbol for this list item.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
- <section id="itext.tables">
- <title>Tables</title>
- <para>
- Table structures can be created using the <literal>p:table</literal> and <literal>p:cell</literal> tags. Unlike many table structures, there is no explicit row declaration. If a table has three columns, then every three cells will automatically form a row. Header and footer rows can be declared, and the headers and footers will be repeated in the event a table structure spans multiple pages.
- </para>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:table>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:table</literal> supports the following attributes.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>columns</literal> — The number of columns (cells) that make up a table row.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>widths</literal> — The relative widths of each column. There should be one value for each column. For example: <literal>widths="2 1 1"</literal> would indicate that there are three columns and the first column should be twice the size of the second and third column.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>headerRows</literal> — The initial number of rows considered to be header and footer rows, which should be repeated if the table spans multiple pages.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>footerRows</literal> — The number of rows considered to be footer rows. This value is subtracted from the <literal>headerRows</literal> value. If document has two rows which make up the header and one row that makes up the footer, <literal>headerRows</literal> should be set to <literal>3</literal> and <literal>footerRows</literal> should be set to <literal>1</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>widthPercentage</literal> — The percentage of the page width spanned by the table.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>horizontalAlignment</literal> — The horizontal alignment of the table. (See <xref linkend="itext.alignment" /> for possible values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>skipFirstHeader</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>runDirection</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>lockedWidth</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>splitRows</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingBefore</literal> — The blank space to be inserted before the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spacingAfter</literal> — The blank space to be inserted after the element.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>extendLastRow</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>headersInEvent</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>splitLate</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>keepTogether</literal>
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:table columns="3" headerRows="1">
+ <programlisting role="XHTML">...
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.tables">
+ <title>Tables</title>
+ <para>
+ Table structures can be created using the <literal>p:table</literal> and <literal>p:cell</literal> tags. Unlike many table structures, there is no explicit row declaration. If a table has three columns, then every three cells will automatically form a row. Header and footer rows can be declared, and the headers and footers will be repeated in the event a table structure spans multiple pages.
+ </para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:table>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:table</literal> supports the following attributes.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>columns</literal> — The number of columns (cells) that make up a table row.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>widths</literal> — The relative widths of each column. There should be one value for each column. For example: <literal>widths="2 1 1"</literal> would indicate that there are three columns and the first column should be twice the size of the second and third column.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>headerRows</literal> — The initial number of rows considered to be header and footer rows, which should be repeated if the table spans multiple pages.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>footerRows</literal> — The number of rows considered to be footer rows. This value is subtracted from the <literal>headerRows</literal> value. If document has two rows which make up the header and one row that makes up the footer, <literal>headerRows</literal> should be set to <literal>3</literal> and <literal>footerRows</literal> should be set to <literal>1</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>widthPercentage</literal> — The percentage of the page width spanned by the table.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>horizontalAlignment</literal> — The horizontal alignment of the table. (See <xref linkend="itext.alignment" /> for possible values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>skipFirstHeader</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>runDirection</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>lockedWidth</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>splitRows</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingBefore</literal> — The blank space to be inserted before the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spacingAfter</literal> — The blank space to be inserted after the element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>extendLastRow</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>headersInEvent</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>splitLate</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>keepTogether</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:table columns="3" headerRows="1">
<p:cell>name</p:cell>
<p:cell>owner</p:cell>
<p:cell>size</p:cell>
@@ -970,362 +1385,362 @@
<p:cell>#{doc.user.name}</p:cell>
<p:cell>#{doc.size}</p:cell>
</ui:repeat>
-</p:table>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:cell>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- <literal>p:cell</literal> supports the following attributes:
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>colspan</literal> — Cells can span more than one column by declaring a <literal>colspan</literal> greater than one. Cells cannot span multiple rows.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>horizontalAlignment</literal> — The horizontal alignment of the cell. (See <xref linkend="itext.alignment" /> for possible values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>verticalAlignment</literal> — The vertical alignment of the cell. (See <xref linkend="itext.alignment" /> for possible values.)
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>padding</literal> — Specify padding on a particular side using <literal>paddingLeft</literal>, <literal>paddingRight</literal>, <literal>paddingTop</literal> and <literal>paddingBottom</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>useBorderPadding</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>leading</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>multipliedLeading</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>indent</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>verticalAlignment</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>extraParagraphSpace</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>fixedHeight</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>noWrap</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>minimumHeight</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>followingIndent</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rightIndent</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>spaceCharRatio</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>runDirection</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>arabicOptions</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>useAscender</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>grayFill</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rotation</literal>
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:cell>...</p:cell>]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
+ </p:table>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:cell>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ <literal>p:cell</literal> supports the following attributes:
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>colspan</literal> — Cells can span more than one column by declaring a <literal>colspan</literal> greater than one. Cells cannot span multiple rows.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>horizontalAlignment</literal> — The horizontal alignment of the cell. (See <xref linkend="itext.alignment" /> for possible values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>verticalAlignment</literal> — The vertical alignment of the cell. (See <xref linkend="itext.alignment" /> for possible values.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>padding</literal> — Specify padding on a particular side using <literal>paddingLeft</literal>, <literal>paddingRight</literal>, <literal>paddingTop</literal> and <literal>paddingBottom</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>useBorderPadding</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>leading</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>multipliedLeading</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>indent</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>verticalAlignment</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>extraParagraphSpace</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>fixedHeight</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>noWrap</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>minimumHeight</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>followingIndent</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rightIndent</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>spaceCharRatio</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>runDirection</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>arabicOptions</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>useAscender</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>grayFill</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rotation</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
- <section id="itext.constant">
- <title>Document Constants</title>
- <para>
- This section documents some of the constants shared by attributes on multiple tags.
- </para>
- <section id="itext.colors">
- <title>Color Values</title>
- <para>
- Seam documents do not yet support a full color specification. Currently, only named colors are supported. They are: <literal>white</literal>, <literal>gray</literal>, <literal>lightgray</literal>, <literal>darkgray</literal>, <literal>black</literal>, <literal>red</literal>, <literal>pink</literal>, <literal>yellow</literal>, <literal>green</literal>, <literal>magenta</literal>, <literal>cyan</literal> and <literal>blue</literal>.
- </para>
- </section>
-
- <section id="itext.alignment">
- <title>Alignment Values</title>
- <para>
- Seam PDF supports the following horizontal alignment values: <literal>left</literal>, <literal>right</literal>, <literal>center</literal>, <literal>justify</literal> and <literal>justifyall</literal>. The vertical alignment values are <literal>top</literal>, <literal>middle</literal>, <literal>bottom</literal>, and <literal>baseline</literal>.
- </para>
- </section>
-
- </section>
-
- </section>
-
- <section id="itext.charting">
- <title>Charting</title>
- <para>
- Charting support is also provided with <filename>jboss-seam-pdf.jar</filename>. Charts can be used in PDF documents, or as images in an HTML page. To use charting, you will need to add the JFreeChart library (<filename>jfreechart.jar</filename> and <filename>jcommon.jar</filename>) to the <literal>WEB-INF/lib</literal> directory. Three types of charts are currently supported: pie charts, bar charts and line charts.
- </para>
- <informaltable id="itext.barchart">
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3.5*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:barchart>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Displays a bar chart.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>borderVisible</literal> — Controls whether or not a border is displayed around the entire chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderPaint</literal> — The color of the border, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderBackgroundPaint</literal> — The default background color of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderStroke</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainAxisLabel</literal> — The text label for the domain axis.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainLabelPosition</literal> — The angle of the domain axis category labels. Valid values are <literal>STANDARD</literal>, <literal>UP_45</literal>, <literal>UP_90</literal>, <literal>DOWN_45</literal> and <literal>DOWN_90</literal>. The value can also be a positive or negative angle in radians.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainAxisPaint</literal> — The color of the domain axis label.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlinesVisible</literal>— Controls whether or not gridlines for the domain axis are shown on the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlinePaint</literal>— The color of the domain gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlineStroke</literal> — The stroke style of the domain gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>height</literal> — The height of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>width</literal> — The width of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendItemPaint</literal>— The default color of the text labels in the legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendItemBackgoundPaint</literal>— The background color for the legend, if different from the chart background color.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendOutlinePaint</literal>— The color of the border around the legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>orientation</literal> — The orientation of the plot, either <literal>vertical</literal> (the default) or <literal>horizontal</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotBackgroundPaint</literal> — The color of the plot background.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotBackgroundAlpha</literal> — The alpha (transparency) level of the plot background. This should be a number between 0 (completely transparent) and 1 (completely opaque).
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotForegroundAlpha</literal> — The alpha (transparency) level of the plot. This should be a number between 0 (completely transparent) and 1 (completely opaque).
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotOutlinePaint</literal> — The color of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotOutlineStroke</literal> — The stroke style of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeAxisLabel</literal> — The text label for the range axis.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeAxisPaint</literal> — The color of the range axis label.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlinesVisible</literal> — Controls whether or not gridlines for the range axis are shown on the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlinePaint</literal> — The color of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlineStroke</literal> — The stroke style of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>title</literal> — The chart title text.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>titlePaint</literal> — The color of the chart title text.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>titleBackgroundPaint</literal> — The background color around the chart title.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>width</literal> — The width of the chart.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:barchart title="Bar Chart" legend="true" width="500" height="500">
+ <programlisting role="XHTML"><![CDATA[<p:cell>...</p:cell>]]>
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.constant">
+ <title>Document Constants</title>
+ <para>
+ This section documents some of the constants shared by attributes on multiple tags.
+ </para>
+ <section id="itext.colors">
+ <title>Color Values</title>
+ <para>
+ Seam documents do not yet support a full color specification. Currently, only named colors are supported. They are: <literal>white</literal>, <literal>gray</literal>, <literal>lightgray</literal>, <literal>darkgray</literal>, <literal>black</literal>, <literal>red</literal>, <literal>pink</literal>, <literal>yellow</literal>, <literal>green</literal>, <literal>magenta</literal>, <literal>cyan</literal> and <literal>blue</literal>.
+ </para>
+ </section>
+
+ <section id="itext.alignment">
+ <title>Alignment Values</title>
+ <para>
+ Seam PDF supports the following horizontal alignment values: <literal>left</literal>, <literal>right</literal>, <literal>center</literal>, <literal>justify</literal> and <literal>justifyall</literal>. The vertical alignment values are <literal>top</literal>, <literal>middle</literal>, <literal>bottom</literal>, and <literal>baseline</literal>.
+ </para>
+ </section>
+
+ </section>
+
+ </section>
+
+ <section id="itext.charting">
+ <title>Charting</title>
+ <para>
+ Charting support is also provided with <filename>jboss-seam-pdf.jar</filename>. Charts can be used in PDF documents, or as images in an HTML page. To use charting, you will need to add the JFreeChart library (<filename>jfreechart.jar</filename> and <filename>jcommon.jar</filename>) to the <literal>WEB-INF/lib</literal> directory. Three types of charts are currently supported: pie charts, bar charts and line charts.
+ </para>
+ <informaltable id="itext.barchart">
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3.5*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:barchart>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Displays a bar chart.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>borderVisible</literal> — Controls whether or not a border is displayed around the entire chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderPaint</literal> — The color of the border, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderBackgroundPaint</literal> — The default background color of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderStroke</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainAxisLabel</literal> — The text label for the domain axis.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainLabelPosition</literal> — The angle of the domain axis category labels. Valid values are <literal>STANDARD</literal>, <literal>UP_45</literal>, <literal>UP_90</literal>, <literal>DOWN_45</literal> and <literal>DOWN_90</literal>. The value can also be a positive or negative angle in radians.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainAxisPaint</literal> — The color of the domain axis label.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlinesVisible</literal>— Controls whether or not gridlines for the domain axis are shown on the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlinePaint</literal>— The color of the domain gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlineStroke</literal> — The stroke style of the domain gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>height</literal> — The height of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendItemPaint</literal>— The default color of the text labels in the legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendItemBackgoundPaint</literal>— The background color for the legend, if different from the chart background color.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendOutlinePaint</literal>— The color of the border around the legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>orientation</literal> — The orientation of the plot, either <literal>vertical</literal> (the default) or <literal>horizontal</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotBackgroundPaint</literal> — The color of the plot background.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotBackgroundAlpha</literal> — The alpha (transparency) level of the plot background. This should be a number between 0 (completely transparent) and 1 (completely opaque).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotForegroundAlpha</literal> — The alpha (transparency) level of the plot. This should be a number between 0 (completely transparent) and 1 (completely opaque).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotOutlinePaint</literal> — The color of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotOutlineStroke</literal> — The stroke style of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeAxisLabel</literal> — The text label for the range axis.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeAxisPaint</literal> — The color of the range axis label.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlinesVisible</literal> — Controls whether or not gridlines for the range axis are shown on the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlinePaint</literal> — The color of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlineStroke</literal> — The stroke style of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>title</literal> — The chart title text.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>titlePaint</literal> — The color of the chart title text.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>titleBackgroundPaint</literal> — The background color around the chart title.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the chart.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:barchart title="Bar Chart" legend="true" width="500" height="500">
<p:series key="Last Year">
<p:data columnKey="Joe" value="100" />
<p:data columnKey="Bob" value="120" />
@@ -1334,193 +1749,193 @@
<p:data columnKey="Joe" value="125" />
<p:data columnKey="Bob" value="115" />
</p:series>
-</p:barchart>]]>
-</programlisting>
-</entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:linechart>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Displays a line chart.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>borderVisible</literal> — Controls whether or not a border is displayed around the entire chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderPaint</literal> — The color of the border, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderBackgroundPaint</literal> — The default background color of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>borderStroke</literal> —
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainAxisLabel</literal> — The text label for the domain axis.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainLabelPosition</literal> — The angle of the domain axis category labels. Valid values are <literal>STANDARD</literal>, <literal>UP_45</literal>, <literal>UP_90</literal>, <literal>DOWN_45</literal> and <literal>DOWN_90</literal>. The value can also be a positive or negative angle in radians.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainAxisPaint</literal> — The color of the domain axis label.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlinesVisible</literal>— Controls whether or not gridlines for the domain axis are shown on the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlinePaint</literal>— The color of the domain gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>domainGridlineStroke</literal> — The stroke style of the domain gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>height</literal> — The height of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>width</literal> — The width of the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendItemPaint</literal> — The default color of the text labels in the legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendItemBackgoundPaint</literal> — The background color for the legend, if different from the chart background color.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legendOutlinePaint</literal> — The color of the border around the legend.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>orientation</literal> — The orientation of the plot, either <literal>vertical</literal> (the default) or <literal>horizontal</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotBackgroundPaint</literal> — The color of the plot background.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotBackgroundAlpha</literal> — The alpha (transparency) level of the plot background. It should be a number between 0 (completely transparent) and 1 (completely opaque).
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotForegroundAlpha</literal> — The alpha (transparency) level of the plot. It should be a number between 0 (completely transparent) and 1 (completely opaque).
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotOutlinePaint</literal> — The color of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>plotOutlineStroke</literal> — The stroke style of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeAxisLabel</literal> — The text label for the range axis.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeAxisPaint</literal> — The color of the range axis label.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlinesVisible</literal> — Controls whether or not gridlines for the range axis are shown on the chart.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlinePaint</literal> — The color of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rangeGridlineStroke</literal> — The stroke style of the range gridlines, if visible.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>title</literal> — The chart title text.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>titlePaint</literal> — The color of the chart title text.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>titleBackgroundPaint</literal> — The background color around the chart title.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>width</literal> — The width of the chart.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:linechart title="Line Chart" width="500" height="500">
+ </p:barchart>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:linechart>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Displays a line chart.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>borderVisible</literal> — Controls whether or not a border is displayed around the entire chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderPaint</literal> — The color of the border, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderBackgroundPaint</literal> — The default background color of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>borderStroke</literal> —
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainAxisLabel</literal> — The text label for the domain axis.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainLabelPosition</literal> — The angle of the domain axis category labels. Valid values are <literal>STANDARD</literal>, <literal>UP_45</literal>, <literal>UP_90</literal>, <literal>DOWN_45</literal> and <literal>DOWN_90</literal>. The value can also be a positive or negative angle in radians.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainAxisPaint</literal> — The color of the domain axis label.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlinesVisible</literal>— Controls whether or not gridlines for the domain axis are shown on the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlinePaint</literal>— The color of the domain gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>domainGridlineStroke</literal> — The stroke style of the domain gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>height</literal> — The height of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendItemPaint</literal> — The default color of the text labels in the legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendItemBackgoundPaint</literal> — The background color for the legend, if different from the chart background color.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legendOutlinePaint</literal> — The color of the border around the legend.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>orientation</literal> — The orientation of the plot, either <literal>vertical</literal> (the default) or <literal>horizontal</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotBackgroundPaint</literal> — The color of the plot background.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotBackgroundAlpha</literal> — The alpha (transparency) level of the plot background. It should be a number between 0 (completely transparent) and 1 (completely opaque).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotForegroundAlpha</literal> — The alpha (transparency) level of the plot. It should be a number between 0 (completely transparent) and 1 (completely opaque).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotOutlinePaint</literal> — The color of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>plotOutlineStroke</literal> — The stroke style of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeAxisLabel</literal> — The text label for the range axis.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeAxisPaint</literal> — The color of the range axis label.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlinesVisible</literal> — Controls whether or not gridlines for the range axis are shown on the chart.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlinePaint</literal> — The color of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rangeGridlineStroke</literal> — The stroke style of the range gridlines, if visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>title</literal> — The chart title text.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>titlePaint</literal> — The color of the chart title text.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>titleBackgroundPaint</literal> — The background color around the chart title.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the chart.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:linechart title="Line Chart" width="500" height="500">
<p:series key="Prices">
<p:data columnKey="2003" value="7.36" />
<p:data columnKey="2004" value="11.50" />
@@ -1528,148 +1943,148 @@
<p:data columnKey="2006" value="76.30" />
<p:data columnKey="2007" value="85.05" />
</p:series>
-</p:linechart>]]>
-</programlisting>
-</entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:piechart>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Displays a pie chart.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>title</literal> — The chart title text.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>label</literal> — The default label text for pie sections.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend. Default value is <literal>true</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelLinkMargin</literal> — The link margin for labels.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelLinkPaint</literal> — The paint used for the label linking lines.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelLinkStroke</literal> — The stroke used for the label linking lines.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelLinksVisible</literal> — A flag that controls whether or not the label links are drawn.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelOutlinePaint</literal> — The paint used to draw the outline of the section labels.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelOutlineStroke</literal> — The stroke used to draw the outline of the section labels.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelShadowPaint</literal> — The paint used to draw the shadow for the section labels.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelPaint</literal> — The color used to draw the section labels.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelGap</literal> — The gap between the labels and the plot, as a percentage of the plot width.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>labelBackgroundPaint</literal> — The color used to draw the background of the section labels. If this is null, the background is not filled.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>startAngle</literal> — The starting angle of the first section.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>circular</literal> — A Boolean value indicating that the chart should be drawn as a circle. If <literal>false</literal>, the chart is drawn as an ellipse. The default is <literal>true</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>direction</literal> — The direction in which the pie sections are drawn. One of: <literal>clockwise</literal> or <literal>anticlockwise</literal>. The default is <literal>clockwise</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionOutlinePaint</literal> — The outline paint for all sections.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionOutlineStroke</literal> — The outline stroke for all sections.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionOutlinesVisible</literal> — Indicates whether an outline is drawn for each section in the plot.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>baseSectionOutlinePaint</literal> — The base section outline paint.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>baseSectionPaint</literal> — The base section paint.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>baseSectionOutlineStroke</literal> — The base section outline stroke.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[
+ </p:linechart>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:piechart>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Displays a pie chart.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>title</literal> — The chart title text.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>label</literal> — The default label text for pie sections.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>legend</literal> — A Boolean value indicating whether or not the chart should include a legend. Default value is <literal>true</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>is3D</literal> — A Boolean value indicating that the chart should be rendered in 3D instead of 2D.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelLinkMargin</literal> — The link margin for labels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelLinkPaint</literal> — The paint used for the label linking lines.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelLinkStroke</literal> — The stroke used for the label linking lines.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelLinksVisible</literal> — A flag that controls whether or not the label links are drawn.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelOutlinePaint</literal> — The paint used to draw the outline of the section labels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelOutlineStroke</literal> — The stroke used to draw the outline of the section labels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelShadowPaint</literal> — The paint used to draw the shadow for the section labels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelPaint</literal> — The color used to draw the section labels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelGap</literal> — The gap between the labels and the plot, as a percentage of the plot width.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>labelBackgroundPaint</literal> — The color used to draw the background of the section labels. If this is null, the background is not filled.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>startAngle</literal> — The starting angle of the first section.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>circular</literal> — A Boolean value indicating that the chart should be drawn as a circle. If <literal>false</literal>, the chart is drawn as an ellipse. The default is <literal>true</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>direction</literal> — The direction in which the pie sections are drawn. One of: <literal>clockwise</literal> or <literal>anticlockwise</literal>. The default is <literal>clockwise</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionOutlinePaint</literal> — The outline paint for all sections.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionOutlineStroke</literal> — The outline stroke for all sections.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionOutlinesVisible</literal> — Indicates whether an outline is drawn for each section in the plot.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>baseSectionOutlinePaint</literal> — The base section outline paint.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>baseSectionPaint</literal> — The base section paint.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>baseSectionOutlineStroke</literal> — The base section outline stroke.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[
<p:piechart title="Pie Chart" circular="false"
direction="anticlockwise" startAngle="30"
labelGap="0.1" labelLinkPaint="red">
@@ -1681,528 +2096,528 @@
<p:data key="2007" columnKey="2007" value="85.05" />
</p:series>
</p:piechart>]]>
-</programlisting>
-</entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:series>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Category data can be broken down into series. The series tag is used to categorize a data set with a series and apply styling to the entire series.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>key</literal> — The series name.
- </para>
- </listitem>
- <!-- <listitem> <para> <literal>seriesFillPaint</literal> — </para> </listitem> --> <listitem>
- <para>
- <literal>seriesPaint</literal> — The color of each item in the series.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>seriesOutlinePaint</literal> — The outline color for each item in the series.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>seriesOutlineStroke</literal> — The stroke used to draw each item in the series.
- </para>
- </listitem>
- <!-- <listitem> <para> <literal>seriesStroke</literal> </para> </listitem> --> <listitem>
- <para>
- <literal>seriesVisible</literal> — A Boolean indicating if the series should be displayed.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>seriesVisibleInLegend</literal> — A Boolean indicating whether the series should be listed in the legend.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:series key="data1">
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:series>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Category data can be broken down into series. The series tag is used to categorize a data set with a series and apply styling to the entire series.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>key</literal> — The series name.
+ </para>
+ </listitem>
+ <!-- <listitem> <para> <literal>seriesFillPaint</literal> — </para> </listitem> --> <listitem>
+ <para>
+ <literal>seriesPaint</literal> — The color of each item in the series.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>seriesOutlinePaint</literal> — The outline color for each item in the series.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>seriesOutlineStroke</literal> — The stroke used to draw each item in the series.
+ </para>
+ </listitem>
+ <!-- <listitem> <para> <literal>seriesStroke</literal> </para> </listitem> --> <listitem>
+ <para>
+ <literal>seriesVisible</literal> — A Boolean indicating if the series should be displayed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>seriesVisibleInLegend</literal> — A Boolean indicating whether the series should be listed in the legend.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:series key="data1">
<ui:repeat value="#{data.pieData1}" var="item">
<p:data columnKey="#{item.name}"
value="#{item.value}" />
</ui:repeat>
-</p:series>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:data>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The data tag describes each data point to be displayed in the graph.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>key</literal> — The name of the data item.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>series</literal> — The series name, when not embedded inside a <code><![CDATA[<p:series>]]></code>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>value</literal> — The numeric data value.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>explodedPercent</literal> — For pie charts, indicates how exploded from the pie a piece is.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionOutlinePaint</literal> — For bar charts, the color of the section outline.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionOutlineStroke</literal> — For bar charts, the stroke type for the section outline.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>sectionPaint</literal> — For bar charts, the color of the section.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:data key="foo" value="20" sectionPaint="#111111" explodedPercent=".2" />
+ </p:series>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:data>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The data tag describes each data point to be displayed in the graph.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>key</literal> — The name of the data item.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>series</literal> — The series name, when not embedded inside a <code><![CDATA[<p:series>]]></code>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>value</literal> — The numeric data value.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>explodedPercent</literal> — For pie charts, indicates how exploded from the pie a piece is.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionOutlinePaint</literal> — For bar charts, the color of the section outline.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionOutlineStroke</literal> — For bar charts, the stroke type for the section outline.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>sectionPaint</literal> — For bar charts, the color of the section.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:data key="foo" value="20" sectionPaint="#111111" explodedPercent=".2" />
<p:data key="bar" value="30" sectionPaint="#333333" />
<p:data key="baz" value="40" sectionPaint="#555555"
- sectionOutlineStroke="my-dot-style" />]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:color>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- The color component declares a color or gradient for filled shapes.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>color</literal> — The color value. For gradient colors, this indicates the starting color. See <xref linkend="itext.colors" /> for color values.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>color2</literal> — For gradient colors, this is the color that ends the gradient.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>point</literal> — The coordinates that mark the beginning of the gradient color.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>point2</literal> — The coordinates that mark the end of the gradient color.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:color id="foo" color="#0ff00f"/>
+ sectionOutlineStroke="my-dot-style" />]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:color>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ The color component declares a color or gradient for filled shapes.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>color</literal> — The color value. For gradient colors, this indicates the starting color. See <xref linkend="itext.colors" /> for color values.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>color2</literal> — For gradient colors, this is the color that ends the gradient.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>point</literal> — The coordinates that mark the beginning of the gradient color.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>point2</literal> — The coordinates that mark the end of the gradient color.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:color id="foo" color="#0ff00f"/>
<p:color id="bar" color="#ff00ff" color2="#00ff00"
- point="50 50" point2="300 300"/>]]>
-</programlisting>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:stroke>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Describes a stroke used to draw lines in a chart.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>width</literal> — The width of the stroke.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>cap</literal> — The line cap type. Valid values are <literal>butt</literal>, <literal>round</literal> and <literal>square</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>join</literal> — The line join type. Valid values are <literal>miter</literal>, <literal>round</literal> and <literal>bevel</literal>
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>miterLimit</literal> — For miter joins, this value is the limit of the size of the join.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>dash</literal> — The dash value sets the dash pattern used to draw the line. Use space-separated integers to indicate the length of each alternating drawn and undrawn segment.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>dashPhase</literal> — The dash phase indicates the point in the dash pattern that corresponds to the beginning of the stroke.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:stroke id="dot2" width="2" cap="round" join="bevel" dash="2 3" />]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
-
- <section id="itext.barcodes">
- <title>Bar codes</title>
- <para>
- Seam can use iText to generate barcodes in a wide variety of formats. These barcodes can be embedded in a PDF document or displayed as an image on a web page. However, barcodes cannot currently display barcode text when used with HTML images.
- </para>
- <informaltable id="itext.barcode">
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:barCode>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Displays a barcode image.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>type</literal> — A barcode type supported by iText. Valid values include: <literal>EAN13</literal>, <literal>EAN8</literal>, <literal>UPCA</literal>, <literal>UPCE</literal>, <literal>SUPP2</literal>, <literal>SUPP5</literal>, <literal>POSTNET</literal>, <literal>PLANET</literal>, <literal>CODE128</literal>, <literal>CODE128_UCC</literal>, <literal>CODE128_RAW</literal> and <literal>CODABAR</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>code</literal> — The value to be encoded by the barcode.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>xpos</literal> — For PDFs, the absolute <literal>x</literal> position of the barcode on the page.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>ypos</literal> — For PDFs, the absolute <literal>y</literal> position of the barcode on the page.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>rotDegrees</literal> — For PDFs, the rotation factor of the barcode in degrees.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>barHeight</literal> — The height of the bars in the barcode.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>minBarWidth</literal> — The minimum bar width.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>barMultiplier</literal> — The bar multiplier for wide bars or the distance between bars for <literal>POSTNET</literal> and <literal>PLANET</literal> code.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>barColor</literal> — The color the bars should be drawn in.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>textColor</literal> — The color of any text on the barcode.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>textSize</literal> — The size of any text on the barcode.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>altText</literal> — The <literal>alt</literal> text for HTML image links.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
-
-<programlisting role="XHTML"><![CDATA[<p:barCode type="code128" barHeight="80" textSize="20"
+ point="50 50" point2="300 300"/>]]>
+ </programlisting>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:stroke>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Describes a stroke used to draw lines in a chart.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the stroke.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>cap</literal> — The line cap type. Valid values are <literal>butt</literal>, <literal>round</literal> and <literal>square</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>join</literal> — The line join type. Valid values are <literal>miter</literal>, <literal>round</literal> and <literal>bevel</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>miterLimit</literal> — For miter joins, this value is the limit of the size of the join.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>dash</literal> — The dash value sets the dash pattern used to draw the line. Use space-separated integers to indicate the length of each alternating drawn and undrawn segment.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>dashPhase</literal> — The dash phase indicates the point in the dash pattern that corresponds to the beginning of the stroke.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:stroke id="dot2" width="2" cap="round" join="bevel" dash="2 3" />]]>
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.barcodes">
+ <title>Bar codes</title>
+ <para>
+ Seam can use iText to generate barcodes in a wide variety of formats. These barcodes can be embedded in a PDF document or displayed as an image on a web page. However, barcodes cannot currently display barcode text when used with HTML images.
+ </para>
+ <informaltable id="itext.barcode">
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:barCode>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Displays a barcode image.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>type</literal> — A barcode type supported by iText. Valid values include: <literal>EAN13</literal>, <literal>EAN8</literal>, <literal>UPCA</literal>, <literal>UPCE</literal>, <literal>SUPP2</literal>, <literal>SUPP5</literal>, <literal>POSTNET</literal>, <literal>PLANET</literal>, <literal>CODE128</literal>, <literal>CODE128_UCC</literal>, <literal>CODE128_RAW</literal> and <literal>CODABAR</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>code</literal> — The value to be encoded by the barcode.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>xpos</literal> — For PDFs, the absolute <literal>x</literal> position of the barcode on the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>ypos</literal> — For PDFs, the absolute <literal>y</literal> position of the barcode on the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>rotDegrees</literal> — For PDFs, the rotation factor of the barcode in degrees.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>barHeight</literal> — The height of the bars in the barcode.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>minBarWidth</literal> — The minimum bar width.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>barMultiplier</literal> — The bar multiplier for wide bars or the distance between bars for <literal>POSTNET</literal> and <literal>PLANET</literal> code.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>barColor</literal> — The color the bars should be drawn in.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>textColor</literal> — The color of any text on the barcode.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>textSize</literal> — The size of any text on the barcode.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>altText</literal> — The <literal>alt</literal> text for HTML image links.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
+
+ <programlisting role="XHTML"><![CDATA[<p:barCode type="code128" barHeight="80" textSize="20"
code="(10)45566(17)040301" codeType="code128_ucc"
altText="My BarCode" />]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
-
- <section id="itext.fillinforms">
- <title>Fill-in-forms</title>
- <para>
- If you have a complex, pre-generated PDF with named fields, you can easily populate it with values from your application and present it to the user.
- </para>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:form>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Defines a form template to populate.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>URL</literal> — A URL that points to the PDF file to use as a template. If the value contains no protocol (<literal>://</literal>), the file is read locally.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>filename</literal> — The filename to use for the generated PDF file.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>exportKey</literal> — If set, no redirect will occur when the generated PDF file is placed in a DocumentData object under the specified key in the event context.
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <informaltable>
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:field>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Connects a field name to its value.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>name</literal> — The name of the field.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>value</literal> — The value of the field.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>readOnly</literal> — Whether the field is read-only. The default is <literal>true</literal>.
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
-
-<programlisting role="XML"> <![CDATA[
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.fillinforms">
+ <title>Fill-in-forms</title>
+ <para>
+ If you have a complex, pre-generated PDF with named fields, you can easily populate it with values from your application and present it to the user.
+ </para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:form>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Defines a form template to populate.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>URL</literal> — A URL that points to the PDF file to use as a template. If the value contains no protocol (<literal>://</literal>), the file is read locally.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>filename</literal> — The filename to use for the generated PDF file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>exportKey</literal> — If set, no redirect will occur when the generated PDF file is placed in a DocumentData object under the specified key in the event context.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:field>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Connects a field name to its value.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>name</literal> — The name of the field.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>value</literal> — The value of the field.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>readOnly</literal> — Whether the field is read-only. The default is <literal>true</literal>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ <programlisting role="XML"> <![CDATA[
<p:form
xmlns:p="http://jboss.com/products/seam/pdf"
URL="http://localhost/Concept/form.pdf">
<p:field name="person.name" value="Me, myself and I"/>
</p:form>]]>
-</programlisting>
- </section>
-
- <section id="itext.swingcomponents">
- <title>Rendering Swing/AWT components</title>
- <para>
- Seam now provides experimental support to render Swing components into PDF images. Some Swing look and feel supports, specifically those that use native widgets, will not render correctly.
- </para>
- <informaltable id="itext.swing">
- <tgroup cols="2">
- <colspec colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="3*"></colspec>
- <tbody>
- <row>
- <entry valign="top">
- <para>
- <literal><![CDATA[<p:swing>]]></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
- <emphasis>Description</emphasis>
- </para>
- <para>
- Renders a Swing component into a PDF document.
- </para>
- <para>
- <emphasis>Attributes</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>width</literal> — The width of the component to be rendered.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>height</literal> — The height of the component to be rendered.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>component</literal> — An expression whose value is a Swing or AWT component.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis>Usage</emphasis>
- </para>
+ </programlisting>
+ </section>
+
+ <section id="itext.swingcomponents">
+ <title>Rendering Swing/AWT components</title>
+ <para>
+ Seam now provides experimental support to render Swing components into PDF images. Some Swing look and feel supports, specifically those that use native widgets, will not render correctly.
+ </para>
+ <informaltable id="itext.swing">
+ <tgroup cols="2">
+ <colspec colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="3*"></colspec>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <literal><![CDATA[<p:swing>]]></literal>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>
+ <emphasis>Description</emphasis>
+ </para>
+ <para>
+ Renders a Swing component into a PDF document.
+ </para>
+ <para>
+ <emphasis>Attributes</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>width</literal> — The width of the component to be rendered.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>height</literal> — The height of the component to be rendered.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>component</literal> — An expression whose value is a Swing or AWT component.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <emphasis>Usage</emphasis>
+ </para>
- <programlisting role="XHTML"><![CDATA[<p:swing width="310" height="120" component="#{aButton}" />]]>
-</programlisting>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </section>
-
- <section id="itext.configuration">
- <title>Configuring iText</title>
- <para>
- Document generation itself requires no additional configuration, but some minor configuration can make your application more user-friendly.
- </para>
- <para>
- The default implementation serves PDF documents from a generic URL, <literal>/seam-doc.seam</literal>. Many users would prefer to see a URL that contains the actual PDF name — <filename>/myDocument.pdf</filename>, for example — which requires some configuration. To serve PDF files, all <filename>*.pdf</filename> resources must be mapped to the <literal>DocumentStoreServlet</literal>:
- </para>
-
-<programlisting role="XML"><![CDATA[<servlet>
+ <programlisting role="XHTML"><![CDATA[<p:swing width="310" height="120" component="#{aButton}" />]]>
+ </programlisting>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
+ <section id="itext.configuration">
+ <title>Configuring iText</title>
+ <para>
+ Document generation itself requires no additional configuration, but some minor configuration can make your application more user-friendly.
+ </para>
+ <para>
+ The default implementation serves PDF documents from a generic URL, <literal>/seam-doc.seam</literal>. Many users would prefer to see a URL that contains the actual PDF name — <filename>/myDocument.pdf</filename>, for example — which requires some configuration. To serve PDF files, all <filename>*.pdf</filename> resources must be mapped to the <literal>DocumentStoreServlet</literal>:
+ </para>
+
+ <programlisting role="XML"><![CDATA[<servlet>
<servlet-name>Document Store Servlet</servlet-name>
<servlet-class>
org.jboss.seam.document.DocumentStoreServlet
</servlet-class>
-</servlet>
-<servlet-mapping>
- <servlet-name>Document Store Servlet</servlet-name>
- <url-pattern>*.pdf</url-pattern>
-</servlet-mapping>]]>
-</programlisting>
- <para>
- The <literal>use-extensions</literal> option instructs the DocumentStore component to generate URLs with the correct filename extension for the generated document type.
- </para>
-
-<programlisting role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
+ </servlet>
+ <servlet-mapping>
+ <servlet-name>Document Store Servlet</servlet-name>
+ <url-pattern>*.pdf</url-pattern>
+ </servlet-mapping>]]>
+ </programlisting>
+ <para>
+ The <literal>use-extensions</literal> option instructs the DocumentStore component to generate URLs with the correct filename extension for the generated document type.
+ </para>
+
+ <programlisting role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
xmlns:document="http://jboss.com/products/seam/document"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
@@ -2211,37 +2626,37 @@
http://jboss.com/products/seam/components
http://jboss.com/products/seam/components-2.1.xsd">
<document:document-store use-extensions="true"/>
-</components>]]>
-</programlisting>
- <para>
- The DocumentStore holds documents in conversation scope, so documents will expire when the conversation ends. At that point, references to the document will be invalid. Specify a default view to show when a document does not exist by editing the <literal>error-page</literal> property of <literal>documentStore</literal>.
- </para>
-
-<programlisting role="XML"><![CDATA[<document:document-store use-extensions="true"
+ </components>]]>
+ </programlisting>
+ <para>
+ The DocumentStore holds documents in conversation scope, so documents will expire when the conversation ends. At that point, references to the document will be invalid. Specify a default view to show when a document does not exist by editing the <literal>error-page</literal> property of <literal>documentStore</literal>.
+ </para>
+
+ <programlisting role="XML"><![CDATA[<document:document-store use-extensions="true"
error-page="/documentMissing.seam" />]]>
-</programlisting>
- </section>
-
- <section id="itext.links">
- <title>Further documentation</title>
- <para>
- For further information on iText, see:
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <para>
- <ulink url="http://www.lowagie.com/iText/">iText Home Page</ulink>
- </para>
- </listitem>
- <listitem>
- <para>
- <ulink url="http://www.manning.com/lowagie/">iText in Action</ulink>
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </section>
-
+ </programlisting>
+ </section>
+
+ <section id="itext.links">
+ <title>Further documentation</title>
+ <para>
+ For further information on iText, see:
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://www.lowagie.com/iText/">iText Home Page</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.manning.com/lowagie/">iText in Action</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
</chapter>
More information about the jboss-cvs-commits
mailing list