1 Date: Fri, 29 Dec 2006 18:57:39 +0000
2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.8a)
3 X-Rcs-Id: $Id: Help%2FRichTablePlugin,v 1.2 2007-01-02 13:25:07 rurban Exp $
4 Content-Type: application/x-phpwiki;
5 pagename=Help%2FRichTablePlugin;
6 pgsrc_version="2 $Revision: 1.2 $";
10 Content-Transfer-Encoding: binary
15 The Help:RichTablePlugin is a plugin that takes off from the Help:OldStyleTablePlugin. It allows a user to specify arbitrary properties of <tt><table></tt>, <tt><tr></tt> and <tt><td></tt> with a very simple markup.
17 NEW: The plugin is now fixed so that the contents of each cell are individually processed by the ~BlockParser. This means that if everything works correctly, you can do interesting things like put *invoke plugins*, use *enumerated lists* etc within each cell!
19 *A <tt>"-"</tt> (dash) at the start of a new line represents a new row in the table.
20 *A <tt>"|"</tt> (vertical bar or pipe) at the start of a new line represents a cell.
21 *Attributes for the tags
22 *A line that starts with a <tt>"*"</tt> (star or asterisk) after a <tt>"|"</tt> is parsed for attributes for the corresponding cell.
23 *Attributes for the table are given on line that starts with a <tt>"*"</tt>, only if the line appears before any other line except whitespace.
24 *A line that starts with a <tt>-</tt> is always parsed for attributes since it can't have any content, unlike a cell.
26 *Cell contents are processed by the ~BlockParser.
27 *Any line that starts with a <tt>"*"</tt> anywhere other than the table attribute line is treated as normal content.
28 *Any line that starts with whitespace is also treated as content.
29 *Any cell line that does not have a <tt>"*"</tt> after the <tt>"|"</tt> is treated as normal content.
30 *All content lines that follow a cell line are added to that cell. They can contain arbitrary text except the above cases.
31 *If there is no cell in the current row, content lines are dropped silently.
32 *The two special characters <tt>"~~"</tt> and <tt>"?>"</tt> should be escaped as <tt>"\~~"</tt> and <tt>"?\>"</tt>. I havn't discovered any other characters yet that might need to be escaped. This is required for the block parser to work.
35 * The source code sucks
36 * The plugin can't nest itself yet. Thus nested tables are currently not possible.
42 *border=1, cellpadding=5, bgcolor=#f0f8f8, width=75%, align=center
44 |* colspan=3, align=center
48 [http://phpwiki.sourceforge.net/demo/themes/default/images/png.png]
50 This cell actually has a plugin invocation inside it!
62 This line gets dropped ... no cell to contain it!
63 |* bgcolor=#f0f0ff, align=center
68 This cell uses the row color
69 | I wish this cell had a nested table inside it! :(
72 The above table is rendered from:
77 *border=1, cellpadding=5, bgcolor=#f0f8f8, width=75%, align=center
79 |* colspan=3, align=center
83 [http://phpwiki.sourceforge.net/demo/themes/default/images/png.png]
85 This cell actually has a plugin invocation inside it!
97 This line gets dropped ... no cell to contain it!
98 |* bgcolor=#f0f0ff, align=center
103 This cell uses the row color
104 | I wish this cell had a nested table inside it! :(
108 ;<strong>Author</strong>: Sameer D. Sahasrabuddhe
109 ;<strong>Url</strong>: http://www.it.iitb.ac.in/~sameerds/phpwiki/index.php/RichTablePlugin
114 PhpWikiDocumentation Help:WikiPlugin