h1. Tables
Confluence offers very flexible, but non-semantic table support. I.e. users may use table headers and normal table cells anywhere in a table. Because of this Scroll has to limit the supported constructs and make assumptions about the desired output.
Scroll supports Confluence's tables of [type 1|http://confluence.atlassian.com/display/DOC/Working+with+Tables]. Tables which are based on the \{section} and \{column} macros (type 2) are not supported.
h2. Table with Header
Allows you to create a simple table with an optional header row. You cannot set the width of the columns in this table.
Use double bars for a table heading row.
*What you type:*
{code}||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|{code}
*What you get:*
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
Please note that Scroll does not support vertical headers.
h2. Table without Header
If you don't need a header, leave it out like this:
*What you type:*
{code}|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|{code}
*What you get:*
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
h2. Table Captions
In order to create a table captions you will need to wrap a standard table with the \{scroll-title} macro. It will add a caption to the table.
*What you type:*
{code}{scroll-title:title=Caption}
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
{scroll-title}{code}
*What you get:*
{scroll-title:title=Caption}
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
{scroll-title}
h2. Limitations
* Scroll does not support vertical headers.
* Scroll's PDF exporter currently does not dynamically detect column widths. This means, all columns of a table have the same width.
h2. DocBook Reference
Scroll creates uses CALS tables:
* http://www.docbook.org/tdg5/en/html/cals.table.html
* http://www.docbook.org/tdg5/en/html/cals.informaltable.html
* http://www.oasis-open.org/specs/a502.htm
Confluence offers very flexible, but non-semantic table support. I.e. users may use table headers and normal table cells anywhere in a table. Because of this Scroll has to limit the supported constructs and make assumptions about the desired output.
Scroll supports Confluence's tables of [type 1|http://confluence.atlassian.com/display/DOC/Working+with+Tables]. Tables which are based on the \{section} and \{column} macros (type 2) are not supported.
h2. Table with Header
Allows you to create a simple table with an optional header row. You cannot set the width of the columns in this table.
Use double bars for a table heading row.
*What you type:*
{code}||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|{code}
*What you get:*
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
Please note that Scroll does not support vertical headers.
h2. Table without Header
If you don't need a header, leave it out like this:
*What you type:*
{code}|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|{code}
*What you get:*
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
h2. Table Captions
In order to create a table captions you will need to wrap a standard table with the \{scroll-title} macro. It will add a caption to the table.
*What you type:*
{code}{scroll-title:title=Caption}
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
{scroll-title}{code}
*What you get:*
{scroll-title:title=Caption}
||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|
{scroll-title}
h2. Limitations
* Scroll does not support vertical headers.
* Scroll's PDF exporter currently does not dynamically detect column widths. This means, all columns of a table have the same width.
h2. DocBook Reference
Scroll creates uses CALS tables:
* http://www.docbook.org/tdg5/en/html/cals.table.html
* http://www.docbook.org/tdg5/en/html/cals.informaltable.html
* http://www.oasis-open.org/specs/a502.htm