Table of Contents
itemtable Plugin
Compatible with DokuWiki
>= 2009-12-25, Anteater
Renders tables by using itemlists instead of the DokuWiki syntax (very helpful for big tables with a lot of text).
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This plugin is based on the plugin dbtables originally written by Stephen C. Many thanks.
Download and Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Syntax and Usage
<itemtable c=name,[name, ...];[options]> . . . </itemtable>
<itemtable c=Column1,Column2,Column3;fdelim=:;header=Titel-Header>
Options
Option | Description | Format | Default |
---|---|---|---|
c=name,[name,…] | Names fields of the table which are separated by a comma; The order of the colums follows the orders how the columns are listed here | For legacy reasons, the c{…}=colum could be listed for each individual column individually. | |
fdelim | Field Delimeter - representing how each DW-DB field is seperated | Character | : |
header | Table Heading - representing the line in which a table name is defined | Character | |
twidth | Width of the HTML table | integer | Undefined - Dokuwiki decides |
norender | Outputs the DW-tables in Dokuwiki text format | Charactier | Undefined |
Cellinput over several lines could be enclosed by the pair <tablecell> and </tablecell>.
Note that with twidth, and norender, you must assign some sort of value, for example, norender=1
.
Examples
Standard table
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:> _line_a column_a:text_a1 column_b:<tablecell>text_a2 \\ This is an example how to fill a cell over several lines</tablecell> _line_b column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences can be added to force a linebreak in the cell. Other formatting elements could be used as well. </tablecell> column_c:text_b2 </itemtable>
Result
Standard table not rendered
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:;norender=1> _line_a column_a:text_a1 column_b:<tablecell>text_a2 \\ This is an example how to fill a cell over several lines</tablecell> _line_b column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences can be added to force a linebreak in the cell. Other formatting elements could be used as well. </tablecell> column_c:text_b2 </itemtable>
Result
test | ||||
---|---|---|---|---|
column_a | column_b | column_c | column_d | |
line_a | text_a1 | text_a2 This is an example how to fill a cell over several lines | ||
line_b | text_b1 As you can see, local DokuWiki CRLF sequences can be added to force a linebreak in the cell. Other formatting elements could be used as well. | text_b2 |
Suggestions / Bugs
- Is there a way to put spaces in the column headings?
- Eliminate the need for the first column as a description (i.e. no “_thing”) just start with the first named column.
- Is there a way to put one entry over multiple cells (like HTML:rowspan or colspan) ?
DW plugin in table
I would like to use the "do plugin" in a cell of the table:
ToDo:<do USER DATE>TEXT</do>
Unfortunately it will not work. The do-plugin will not write any entry in his sqlite-database.
Any idea how to get it to work? 24.08.2011 Joachim
Table sortable and searchtable
It would be fine to have the table sortable and searchable.
I tried the following with searchtablejs plugin and sortablejs plugin, but is not working Sorry, it is working, GREAT!:
<sortable> <searchtable> <itemtable .......> ...... ...... </itemtable> </searchtable> </sortable>
24.08.2011 Joachim
- Eliminate first column: Yes, this is really what I need.
- Rowspan is already possible. Just put
:::
into the cell which you want to be “rowspaned”.
Colspan: I don't know how to do it. I think an extension of the plugin is necessary to enable it.
The most severe problem I have is that the table the itemtable plugin generates is always nested in another table (with only one cell). Is this a problem with compatibility? I'm using Release 2012-09-10 “Adora Belle RC1”.
— Moni 2012-10-22
I too have the problem that the table is nested in another table with only one cell.
— DerYo 2013-10-25