Keeper Garrett Table Styles

Modified on 2016/06/08 08:38 by CategoryListFormatter — Categorized as: Uncategorized

Table Styles¶

This page describes the usage of tables and their syntax when working with the Keeper Garrett Formatters.

Table of Contents [Hide/Show]

Table Styles
    Support By
    Markup Usage
       Add A Heading
       Add A Footer
       Change Column Order and Display
       Change Column Names
       Table Styling

Support By ¶

Currently 4 of the formatters uses the table styles, they are:

Markup Usage ¶

What can you do?

Add a heading to your table
Add a footer to your table
Show only specified columns
Change column order
Override column headers
Use one of the 11 predefined styles
Define your own style
Use the default wiki theme style
Use the default generic wiki theme style

Usage:

{SomeFormatter( ...Formatter_Specific_Args=XX... head=XXX foot=YYY cols=ZZZ colnames=XYZ style=ZXY}

Where:

head - Heading of the table
foot - Footer of the table
cols - Name and order of the columns to show, must be seperated by ,. Ex. 'col1,col2,col3'
colnames - Custom column names, must be seperated by ,. Ex. 'col1,col2,col3'
style - Name of one of the predefined styles, if not specified the default wiki style is used.

All args which have a value that contains whitespaces, must be encapsulated in ' ', ex. 'My Heading'.

Add A Heading ¶

Markup:

{SomeFormatter( ... head='My Heading'}

Result:

My Heading
Col1	Col2
DataCell1	DataCell2

Add A Footer ¶

Markup:

{SomeFormatter( ... foot='My Footer'}

Result:

Col1	Col2
DataCell1	DataCell2

Change Column Order and Display ¶

Markup:

{SomeFormatter( ... cols='Col1,Col3,Col2'}

Result:


Col1	Col3	Col2
DataCell1	DataCell3	DataCell2

Here a 4 column called Col4 is omitted since it is not mentioned.

Change Column Names ¶

Markup:

{SomeFormatter( ... colnames='X,Y,Z'}

Result:


X	Y	Z
DataCell1	DataCell2	DataCell3

Markup:

{SomeFormatter( ... cols='Col1,Col3,Col2' colnames='X,Y,Z'}

Result:


X	Y	Z
DataCell1	DataCell3	DataCell2

Table Styling ¶

Markup:

{SomeFormatter( ... style='hor-minimalist-a'}

Result:

Head1	Head2	Head3
hor-minimalist-a
My Footer
Col1	Col2	Col3
Col1	Col2	Col3
Col1	Col2	Col3

If the style argument is not supplied the default wiki table style is used.
There are 2 theme based styles and 11 predefined styles which are bundled with all the formatters (which uses tables).

Wiki Theme styles:

No style specified - will use the current theme's default style
generic - will use the current theme's generic style
1. There's a small section in the TableStyle.css which removes the generic padding so that the generic style mathces the one used in the wiki. Uncomment the generic section if you do not like this and save the TableStyle.css.

Predefined table styles:

hor-minimalist-a
hor-minimalist-b
ver-minimalist
box-table-a
box-table-b
hor-zebra
hor-zebra-a
hor-zebra-b
rounded-corner
background-image
gradient-style

All these styles are defined in the TableStyle.css file located in default file storage provider on the following path:
/Keeper.Garrett.Formatters/Tables/TableStyle.css
So to create your own custom style simply add your CSS to this file.

For a visual preview go here, or look further below (requires the FileContentFormatter):
/Keeper.Garrett.Formatters/Tables/table-examples.html
Examples:
{FileCont file='/Keeper.Garrett.Formatters/Tables/table-examples.html'}