This is example 7 as described in the Wsmake User Manual.

Have you read example 6 yet? We assume that you have, so if you haven't read
it yet, please do so now.

We cover menuing in this example. We are going to use the same configuration
from example 6, and we have made all of the changes for you.

This example can be found in the doc/examples/ex7/ directory of the source
distribution.

In our last example we found that once we moved our menu out of the page,
it lost its uniqueness. Specifically, every menu item on the list was a
link. Before, the section we were in was bold and not a link. Now we
are going to solve this problem by using more SubTags and SubTagGroups.

Instead of putting links in our templates/menu.html, we have put some new,
yet to be defined, subtags:

<home> | <about> | <help>

Now we need to define the SubTags for these. Since every Page that uses
this menu also uses the "default" SubTagGroup, we put in some defaults
for the tags:

      SubTag "<home>" "<a href=\"home.html\">Home</a>"
      SubTag "<about>" "<a href=\"about.html\">About</a>"
      SubTag "<help>" "<a href=\"help.html\">Help</a>"

Now if we were to remake, the same output would come out as the last example.
But now we have more flexibility. There are two ways to tailor these links
for each page, one through the use of SubTagGroups, and the other by simply
specifying the SubTag in the Pages. Both produce the same output. I made two
configuration files for this reason. "ex7.ws" is the one that uses
SubTagGroups, and "ex7-2.ws" is the one that puts the SubTags in the
Pages. I'll describe both ways next.

Using SubTagGroups:

The idea here is to use a different SubTagGroup for each Page before the
"default" SubTagGroup is used. So we could have 3 SubTagGroups as follows:

    SubTagGroup {
      name "home"
      SubTag "<home>" "<b>Home</b>"
    }

    SubTagGroup {
      name "about"
      SubTag "<about>" "<b>About</b>"
    }

    SubTagGroup {
      name "help"
      SubTag "<help>" "<b>Help</b>"
    }

Then, in each Page, we reference these SubTagGroups before we reference
the "default" SubTagGroup. Notice that in the case of the "help"
SubTagGroup, we could also include the "<sitename>" SubTag, which is
defined in the help DefaultPage. I leave that as an exercise for the
reader. :)

Using SubTags:

The idea here is to use a SubTag in each Page that overrides any
SubTagGroup settings. So basically we define the following three lines
in each of their corresponding Page sections:

    SubTag "<home>" "<b>Home</b>"

    SubTag "<about>" "<b>About</b>"

    SubTag "<help>" "<b>Help</b>"

Ok, this is the end of example 7.
