Use !contents to list all or some of the child pages of the current page along with additional information such as help text, suite filters, some property settings, and graceful names.

Example:  !contents -R2 -g -p -f -h
  Options
    -R   ...include all of the descendent pages;
    -Rn  ...include n levels of descendent pages;
    -f   ...show suite filters--define FILTER_TOC {true} for global;
    -g   ...show graceful names in the list--define REGRACE_TOC {true} for global;
    -h   ...show help property text--define HELP_TOC {true} for global;
    -p   ...show property suffixes--define PROPERTY_TOC {true} for global;
              defaults:  Suite(*), Test(+), Imported(@), Symbolic(>), Pruned(-)
              define PROPERTY_CHARACTERS {*+@>-} to change.

The !contents widget is replaced with a list of all the immediate child pages. If there are no child pages, then it is replaced with an empty list.

Markup:

!contents -R

will replace itself with a list of child pages in which case the widget will recurse down the hierarchy from the page you're on. So you get the immediate child pages, all of their immediate child pages, all of theirs, etc, until all of the leaves have been reached.

Usage

The table that follows describes variables that modify the display of !contents from the point where that variable is defined.

Limited Recursion
The depth of the recursion of the -R option may be limited by specifying the number of levels to descend as part of the -R option; e.g., -R2 shows only two levels of child pages regardless of the full depth of the tree. If more levels of the hierarchy exist at any node past the specified depth, an ellipsis (...) is shown to denote more levels exist. Similarly, the -R1 option shows only the immediate children (like !contents with no -R option,) but the ellipsis will be displayed when more levels exist. The ellipsis may be changed to a different string via the MORE_SUFFIX_TOC variable.

Help Text
To define a particular page's help text, navigate to that page, click Properties, and enter the help text in the input box labeled "Help Text". When the -h option is specified, or the HELP_TOC variable is "true", the help text is appended to the corresponding line in the TOC. If neither the -h option, nor the HELP_TOC is true, the help text displays as a mouse-over balloon. The delimiter that starts the appended help text defaults to ": " and may be changed via the HELP_PREFIX_TOC variable.

Page Properties
To facilitate the verification of test, suite, and symbolic links, the -p option will append a series of characters to denote a particular property that is set for that page. The default characters are:

Character	Property	Description
*	Suite	The Suite property box is checked
+	Test	The Test property box is checked
@	Imported	The page is imported from an external source
>	Symbolic Link	The page is a symbolic link of the current page
-	Pruned	The Prune property box is checked; this page and all its chidlren are excluded from suite tests

The character set for properties may be changed via the PROPERTY_CHARACTERS variable; this variable is positional in the order specified above.

Global Variables that Modify TOC

NAME	Default	Values	Notes
FILTER_TOC	false	true|false	Append suite fiters to TOC (-f flag)
HELP_PREFIX_TOC	:<space>	any string	Define prefix for help text suffix
HELP_TOC	false	true|false	Append help text to TOC (-h flag)
MORE_SUFFIX_TOC	<space>...	any string	Define sequence to show more TOC levels
PROPERTY_CHARACTERS	*+@>-	any characters	Define property icons for TOC
PROPERTY_TOC	false	true|false	Append property icons to TOC (-p flag)
REGRACE_TOC	false	true|false	Makes !contents list graceful (-g flag)

(See the root page for overrides)

AcceptanceTests for the !contents widget

• SuiteAcceptanceTests.SuiteWidgetTests.TestContents[?]
• SuiteAcceptanceTests.SuiteWidgetTests.TestContentsWithRecursion[?]
• SuiteAcceptanceTests.SuiteWidgetTests.TestContentsRegraced[?]
• SuiteAcceptanceTests.SuiteWidgetTests.TestContentsProperties[?]
• SuiteAcceptanceTests.SuiteWidgetTests.TestContentsFilters[?]
• SuiteAcceptanceTests.SuiteWidgetTests.TestContentsHelp[?]