## Purpose

The toolset is a series of what might ambitiously be called authoring tools designed explicitly for the production of programming tutoring or training pages. They are designed to be as easy to use as possible so that authors can concentrate upon content.

The toolset is implemented in JavaScript (sometimes with a Java applet in the background). Tools are accessed as JavaScript function calls.

## Usage

HTML embeds JavaScript within `<script> </script>` tags. Although in the last edition of this manual, the actual code was escaped in HTML comments, it no longer is, on the grounds that browsers that don't support javaScript will be of little use on WebWriter authored sites.

For example, shown below is a request to start a note (a section that will usually be turned off in lecture mode but on in study mode), here without escaping—

    <script language="JavaScript" type="text/javascript">
     startNote();
    </script>

and here with—

    <script language="JavaScript" type="text/javascript"><!--
     startNote();
    // -->
    </script>

## Snippets

Many HTML editors (e.g. DreamWeaver or 1st Page 2000) support snippets, which let standard boilerplate, including JavaScript, be inserted automaticaly into a document. Generally, there are two modes:

Wrap Selection
  A piece of one's html document is selected and then is wrapped, that is separate snippets are inserted before and after the selection.
Block
  The snippet is inserted at the insertion point as a single block.

Most of WebWriter's tools have been designed with snippets in mind. For example, to make a section of your document into a note, you would select the desired section and then insert a wrap snippet. Before the selection would go the above piece of code

    <script language="JavaScript" type="text/javascript">
     startNote();
    </script>

while the selection would be followed by

    <script language="JavaScript" type="text/javascript">
     endNote();
    </script>

## Specific Tools

1. Inserting Code
2. Hidden Notes
3. Pop-ups
4. Definitions
5. Rollover Blocks
6. Answer containers
7. Buttons
8. Utilities