pgsrc/Help%2FRichTablePlugin

   1 Date: Thu, 16 Dec 2010 12:56:02 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FRichTablePlugin;
   6   flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
   7   markup=2;
   8   charset=UTF-8
   9 Content-Transfer-Encoding: binary
  10
  11 The **~RichTable** [[Help:WikiPlugin|plugin]] is a plugin that takes off from the [[Help:OldStyleTablePlugin|OldStyleTable]] plugin. It allows a user to specify arbitrary properties of ##<table>##, ##<tr>## and ##<td>## with a very simple markup.
  12
  13 This plugin is included for legacy only. We recommand to
  14 use [[Help:MediawikiTablePlugin|Mediawiki tables]] instead.
  15
  16 == Syntax ==
  17
  18 The contents of each cell are individually processed by the ~BlockParser. This means that you can do interesting things like put **invoke plugins**, use **enumerated lists** etc within each cell!
  19
  20 * A ##"-"## (dash) at the start of a new line represents a new row in the table.
  21 * A ##"|"## (vertical bar or pipe) at the start of a new line represents a cell.
  22 * Attributes for the tags
  23 ** A line that starts with a ##"*"## (star or asterisk) after a ##"|"## is parsed for attributes for the corresponding cell.
  24 ** Attributes for the table are given on line that starts with a ##"*"##, only if the line appears before any other line except whitespace.
  25 ** A line that starts with a ##-## is always parsed for attributes since it can't have any content, unlike a cell.
  26 * Cell contents
  27 ** Cell contents are processed by the ~BlockParser.
  28 ** Any line that starts with a ##"*"## anywhere other than the table attribute line is treated as normal content.
  29 ** Any line that starts with whitespace is also treated as content.
  30 ** Any cell line that does not have a ##"*"## after the ##"|"## is treated as normal content.
  31 ** All content lines that follow a cell line are added to that cell. They can contain arbitrary text except the above cases.
  32 ** If there is no cell in the current row, content lines are dropped silently.
  33 * The two special characters ##"~~"## and ##"?>"## should be escaped as ##"\~~"## and ##"?\>"##. I havn't discovered any other characters yet that might need to be escaped. This is required for the block parser to work.
  34
  35 We allow attributes with or without quotes (")
  36 {{{
  37 border=1, cellpadding="5"
  38 style="font-family: sans-serif; border-top:1px solid #dddddd;"
  39 style="font-family: Verdana, Arial, Helvetica, sans-serif"
  40 }}}
  41
  42 == Example ==
  43
  44 <<RichTable
  45
  46 *border=1, cellpadding=5, bgcolor=#f0f8f8, width=75%, align=center
  47 -
  48 |* colspan=3, align=center
  49 HomePage
  50 -
  51 |* colspan=2
  52 [http://phpwiki.sourceforge.net/demo/themes/default/images/png.png]
  53 |* rowspan=2
  54 This cell actually has a plugin invocation inside it!
  55 <?plugin
  56 BackLinks
  57 ?\>
  58 - bgcolor=white
  59 |
  60 # One
  61 # Two
  62 |
  63 * Foo
  64 * Bar
  65 - bgcolor=cyan
  66 This line gets dropped ... no cell to contain it!
  67 |* bgcolor=#f0f0ff, align=center
  68 One paragraph
  69
  70 Another paragraph?
  71 |* align=left
  72 This cell uses the row color
  73 | I wish this cell had a nested table inside it! :(
  74 >>
  75
  76 The above table is rendered from:
  77
  78 {{{
  79 <<RichTable
  80
  81 *border=1, cellpadding=5, bgcolor=#f0f8f8, width=75%, align=center
  82 -
  83 |* colspan=3, align=center
  84 HomePage
  85 -
  86 |* colspan=2
  87 [http://phpwiki.sourceforge.net/demo/themes/default/images/png.png]
  88 |* rowspan=2
  89 This cell actually has a plugin invocation inside it!
  90 <?plugin
  91 BackLinks
  92 ?\>
  93 - bgcolor=white
  94 |
  95 # One
  96 # Two
  97 |
  98 * Foo
  99 * Bar
 100 - bgcolor=cyan
 101 This line gets dropped ... no cell to contain it!
 102 |* bgcolor=#f0f0ff, align=center
 103 One paragraph.
 104
 105 Another paragraph?
 106 |* align=left
 107 This cell uses the row color
 108 | I wish this cell had a nested table inside it! :(
 109 >>
 110 }}}
 111
 112 == Known Bugs ==
 113 * The plugin can't nest itself yet. Thus nested tables are currently not possible.
 114
 115 == Author ==
 116 * [Sameer D. Sahasrabuddhe|http://www.it.iitb.ac.in/~sameerds/phpwiki/index.php/RichTablePlugin]
 117
 118 <noinclude>
 119 ----
 120 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
 121 </noinclude>