12.5.4 The first page of the generated web

The entry page of a generated web is treated as a special case for the following reasons:

• Whether the first paragraph in the FrameMaker document triggers a node or not, a first page must always be created.
• It may not always be possible to determine the HTML TITLE for the entry page because:

The topmost heading of the FrameMaker document (that is, the title of the printed document) may not be the first paragraph of the document.

The FrameMaker document may not necessarily contain a topmost heading.

To guarantee the generation of the entry page, including a user-specified HTML TITLE, WebMaker requires the following:

• The node name of FirstPage is reserved for the node that describes the entry page. If no NODE FirstPage is defined, a default one is created by WebMaker.
• The topmost heading of a document (the title of the printed document) must not trigger a new node and must be declared of TYPE Normal, as shown in the following example.
• The HTML TITLE of the entry page is specified in the Make a Web dialog, and on the batch-mode command line with the -t switch:

webmaker ... -t "The Title of the first page" ...

This string may be accessed in the configuration by calling the predefined function:

maintitle()

The following excerpt from a WML configuration file describes an entry page for a generated web and the conversion rules for the paragraph of the topmost heading.

NODE FirstPage
{
  TITLE maintitle()
  HEADER
    {
      @NavigationPanel=concatenate(button("[Next] ",filename(next)));
      write(*,paragraph(@NavigationPanel));
    }
  FOOTER
    {
      write(*,heading(2,"Table of contents"));
      write(*,toc(1));
      write(*,hrule());
      write(*,address(concatenate("MR - ",date())));
      write(*,paragraph(@NavigationPanel));
    }
} 
PARAGRAPH "Title" TYPE Normal
{
  ACTIONS  {
              write(*,heading(1,text()));
              write(*,hrule());
            }
}