Object Info:

pageTable

Introduction

pageTable is a macro that builds a table of links to web pages that lie at a particular level of your site. It can be very useful for building dynamic navigation links to other pages on your site. In its simplest form, pageTable returns a table of links to pages on the same level as the current page. The current page is listed, but not linked. The table items are center justified.

Example 1
pageTable():

You can control the type face and size shown in the link table.

Example 2
pageTable(fontface:"geneva\,arial"):

Example 3
pageTable(fontSize:"-2"):

This version of pageTable supercedes previous versions of fileList released here.

Details

pageTable v1.5b1. See script comments for version history.

The pageTable macro uses five parameters to build an vertical table of links. The syntax is:

pageTable(adr, fontFace, fontSize, glossTitles, showMe)

adr is the address of the page that you wish to build the list around. It defaults to the address of the current page being rendered.

fontFace is a string value, that controls the type face of the items in the table. Strings should list the name of the font or fonts to use. The default value is "", using this value will cause the browser to use its default font.

fontSize is a string value, that controls the type size of the items in the table. Strings should list the font size relative to the browsers default font size. The default value is "", using this value will cause the browser to use its default font size.

glossTitles is a boolean that controls whether the navigation bar is build from glossary entries as titles or as object names. Since the nextPrevs outline lists object names, you need to resolve these to page titles to work with glossary entries generated by the stock Frontier pageFilter. useTitles allows for this resolution. The default is true.

showMe is a boolean value, that controls whether the current page is shown in a page list or not. The default is true.

The pageTable macro builds a list of links to other siblings based on a structured nextPrevs outline. The order which the siblings appear in the nextPrevs outline determines the order that links are shown. Your links do not have to be in alphabetic order.

You may take a nextPrevs outline generated by Frontier's "Build nextPrev List..." and add structure to it, or you may use the webExtras v 1.5 suite's "Build Structured NP..." command (which will do most of the work for you). You can also use the structuredNP script, to generate a structured outline of your site. The outline structure does not have to mimic the site structure (though it is a little hard to imagine a why you would build an outline structure that wasn't at least a little similar to the site structure).