[[PageOutline(2-5,Contents,pullout)]]
= Foldable tables =

== Description ==

A macro for creating foldable tree-like tables in trac.

== Bugs/Feature Requests == 

Existing bugs and feature requests for FoldMacro are 
[report:9?COMPONENT=FoldMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=FoldMacro&owner=p__m new ticket].

== Download ==

Download the zipped source from [download:foldmacro here].

== Source ==

You can check out FoldMacro from [http://trac-hacks.org/svn/foldmacro here] using Subversion, or [source:foldmacro browse the source] with Trac.

== Example ==

A macro to create a foldable tree-like table.

One creates a foldable table by creating a normal trac-like table inside a processor block:

{{{
{{{
#!fold
|| Normal || Trac || Table || Syntax ||
|| Normal || Trac || Table || Syntax ||
}}}
}}}

To make parts of the table foldable, insert diff like statements into it:

{{{
{{{
#!fold
|| Normal row ||
<<<
|| This part is shown ||
---
|| If the above row is expanded, it will be replaced by this row ||
>>>
|| Normal row ||
}}}
}}}

Foldable blocks can be nested in other foldable blocks to create tree-like tables. To keep the table readable we recommend to use indentation, which is legal in foldable tables.

The following is an example table:

{{{
{{{
#!fold
|| Grandparent A ||
  <<<
  || Grandparent B ||
  ---
  || '''Parent B.1''' ||
    <<<
    || Parent B.2 ||
    ---
    || Child B.2.1 ||
    || [http://www.google.com Child B.2.2] ||
    || Child B.2.3 ||
    >>>
  || Parent B.3 ||
  >>>
|| Grandparent C ||
}}}
}}}

== Recent Changes ==

[[ChangeLog(foldmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:p__m], Shivoc [[BR]]
'''Maintainer:''' [wiki:p__m], Shivoc [[BR]]
'''Contributors:''' FoldingMacro