Other macros
In contrast to the macros listed in Commonly-used macros, the macros documented in this article are used infrequently or only in specific contexts, or are deprecated.
Special contexts
Landing page components
We have an assortment of macros that can be used to automatically generate the contents of landing pages. Here they are.
Lists of subpages
ListSubpages
generates an unordered list of links to all the immediate children of the current page; useful for automatically generating tables of contents for sets of documentation.LandingPageListSubpages
outputs a two-column definition list of all immediate subpages of the current page, with their titles as the<dt>
and their SEO summary as the<dd>
. This makes it easy to automatically generate reasonably attractive landing pages.APIListAlpha
builds a list of the current page's subpages, formatted as a list of API terms, divided up by first letter. There are three parameters. The first is 0 if you want to include all top-level subpages or 1 to leave out subpages with "." in their names. The second and third let you add text to display as part of the name in each link. This can be used to add "<" and ">" for element links, or to add "()" at the end of lists of method names.SubpagesWithSummaries
constructs a definition list of all the immediate children of the current page. There is no other formatting done. You can get a two-column list ready for use as a multi-column landing page usingLandingPageListSubpages
.
Lists of links
We have one macro specifically designed to create lists of links within content:
QuickLinksWithSubpages
creates a list of links comprised of the pages below the current page (or specified page, if one is given). Up to two total levels of depth are generated.