The terminology for MMSS is a bit messed up, and needs work.

-"MMSS" refers to this framework, the set of different scripts
and templates used to create and manage the web pages of a
site.

-"Site" refers to a collection of web pages that are served
from a webserver, and not necessarily a dedicated web host
(EG- I use the term "site" to describe my set of web pages
hosted at angelfire.com even though they host *many* other
people's pages). This is not necessarily the sense of the
word used by other people, hence the clarification here.

-"Page" refers to a single HTML file, and/or its rendering
as carried out by a browser.

-"Document Tree" refers to the set of directories containing
the various documents for your website that you want MMSS to
deal with; it is generally used to refer to that document tree
on your computer, this computer you are using now, especially
when referring to files that are part of MMSS or are for its
control; but it can also be used to refer to the copy of the
document tree that ends up on your web server, in other words,
your site, even though your site wouldn't end up with copies
of most of those files MMSS uses (only the HTML that it creates
and uploads)

-The part on the left of the page with links to other parts of
the site and other parts of the page is the navigation bar

-The top of the navigation bar is the site map. This has links
into different *sections*.

-Each section has a directory, and one or more pages in that
directory that are the pages of the section. There should be
a page named "index", although the function of that page
doesn't have to be that of an index (due to the navigation bar).

-The next box down in the navigation bar is the "navigate section"
box, that has links to each of the different pages of the section.

-Now, the next box down from that is the "navigate this page" box;
the confusion arises because the different parts of the page... I've
ended up frequently referring to as "sections". Doh. These parts
of the page each have their own box (like those in the navigation
bar, but much wider, for the larger amounts of text), with a
title, and a link in the "navigate this page" box to jump to them.
The title for the link isn't always the same as the title on the
box.
These parts make up the body of the page, and the contents of
them is taken from a file "pagename.partname.input", and copied
verbatim into the HTML to go into the box.

-The "navigate section" box gets its contents from a file named
(section).nav in the section's directory.

-The "navigate this page" box gets its contents from a file named
(page).pnav in the same directory.

-The overall details of the page, including the title, what section
it's in (so far certain parts of the system don't know unless you tell
them), and the parts that comprise the page, are controlled by
the file (page).layout. Currently, this is done by making calls to
MMSS's m4 macros there, passing the details as arguments. This is
probably the least user-friendly part of the system - especially as
I had to redefine m4's quotes from ` and '  to [q[ and ]q] to avoid
the various bits of HTML and ordinary everyday text having unwanted
results (I would have chosen better quote symbols if I could think
of any that wouldn't have the same problems).

-The "site map" box gets its contents from a file named site.nav in
the root directory of the document tree.

