Documentation  »  Features  »  Wiki  »  Wiki Plugin  »  PluginSplit

Plugin Split

This Wiki Plugin can be used to generate an html table without all the tags. Ideal for creating two or more columns in a wiki page, this plugin allows for wiki syntax and line breaks within the cells of a table, unlike the simple table? syntax. It also supports the inclusion of (multiple) other pages within a table framework and Edit by Section in the wiki.

Syntax

Plugin command: {SPLIT(fixedsize=__, colsize=__, joincols=__, first=__ )}

additional syntax:

--- separates columns @@@ separates rows

Parameters: Split uses the following parameters:

joincols=y|n|0|1 : if it is true 'colspan' attribute will be generated if there are cells mising in a row. - default 'y' fixedsize=y|n|0|1 : 'width' attribute will be generated for TDs - default 'y' colsize=>size1|size2|...: are the size in pixels by default or colsize=>percent%|percent| : using % tiki will take the values as the relative percentage size of each table cell. Numbers that add up to more than 100 will be proportional.

In 1.10: first=> col|line : col is the editorial way: the column is filled first, line is the html way, the row is filled e.g. first {SPLIT(first=col)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT} {SPLIT(first=>line)}r1c1---r1c2@@@r2c1---r2c2{SPLIT}

padding? - the split plugin doe not use a cellpadding parameter, but colsize can be used to create narrow "spacer" columns.

In 3.0: customclass => className : for customizing the design

Examples

To split a page in two or more columns, use --- as the separator: Example: {SPLIT()} -=hey=- one two three --- -=hoy=- foo bar test {SPLIT}

Produces:

If you want to do another row, use @@@: Example: {SPLIT()} -=hey=- one two three --- -=hoy=- foo bar test @@@ next line1--- next line2{SPLIT}

Produces:

note: If you want to use the horizontal rule in a split cell --- , you have to use more than 3 dashes ----

In tikiwiki1.10 : There are 2 additional parameters - first=col|line. The default is line , the behaviour of 1.9 or the html table behavior. First=col enables you to describe first the first column, second the second column.. It is more appropriate for an editorial behavior. Ex: {SPLIT(first=col)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT} - edit=y to be able to edit the split section (if you have the perms of course). The parameter works only if first=col has been choosen and on a wiki page. It will create a little edit icon in the corner of the split section and will allow you to edit the section without the rest.

FAQ

• How do i make the border disappear?

The table created with a split has a class wikiplugin-split and a class normal if the table with be 100% width

Bugs

Bugs: Content within the table doesn't seem to be parsed for all tiki markup, it doesn't work for italics, in any case.

More Examples

{SPLIT(colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=y, colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=n, colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=n, colsize=20|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=y, colsize=20|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=y, colsize=20%|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=y, colsize=20|60%|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}

{SPLIT(fixedsize=n, colsize=20|60|10|10, joincols=n)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}

• What you can see, fixedsize has no importance if colsize is specified.
• If one colsize has a % , the table gets the class normal ->100% width

Related

• PluginFancyTable

Alias

• Split
• Split plugin