You may list all TEACUP pages under a subdirectory in one go by using the /tcb path.

For example, if you have two TEACUP pages, /toy/bear.htm and /toy/balloon.htm, /tcb/toy will list both TEACUPs on one page.  This is useful in showing a list of TEACUPs (e.g. listing all products under a category).

While individual TEACUP pages may have different layouts, the TCB page needs to show them as a list of repetitive records of uniform layout.  So when you edit the TCB page, you are in fact specifying this uniform layout in similar format of the TEACUP, except that you do not assign it values (e.g. {Price} instead of {Price=9.95}).  The TCB page will plug in the value for each TEACUP on the list.

The TEA name of the list is "/tcb/category/view&TCB".  Since this text is repeated itself when viewed, there are two more TEAs for you to enter a header and footer, /tcb/category/view&Before and /tcb/category/view&After respectively.

If you want to present the list in a table form, you cannot put the header and footer rows in &After and &Before (as each TEA is an independent construct).  You insert the whole table in &TCB to make it self-contained.  In that case, you need to use the <THEAD>, <TBODY> and <TFOOT> tags.  You surround the header row by <THEAD> and </THEAD>, the record row by <TBODY> and </TBODY>, and the footer row <TFOOT> and </TFOOT>.  TCB would "know" to repeat only the TBODY part and keep the rest in place (before and after TBODY).

You don't need to enter all TCB layouts.  Those without a layout will inherit its parent's.  For example, if there is no layout for /tcb/toy/cars, it will inherit the layout from /tcb/toy.  But for top level TCB, no parent layout is available to inherit.  For example, if there is no layout for /tcb/stationery, no listing will be shown.