Next Previous Up Top Contents Index

WebMaker User Guide

4.4 Complete options for making a web

First, if you want to see detailed information about what WebMaker is doing as it makes the web, choose WebMaker > Log. That command opens a window containing a log of status information.

To make a web, either click Make a Web or choose WebMaker > Make a Web. A dialog appears, enabling you to specify options about the web. The dialog is shown in Figure 4.3.

Figure 4.3 Make a Web dialog

Notice now that WebMaker may have filled in the MIF File field for you, if you have used RapidRules or Make a Web in this session. If the default that it chose is incorrect, you can change it.

Now notice that the Destination Directory and File Name Prefix fields are also filled in. The contents of these fields are based on either the name and location of the MIF file in the MIF File field, or, if there is no MIF file, on the name and location of the WML file.

If no fields are filled in, or if you wish to specify other files and prefix, follow these steps:

1. Specify the FrameMaker document (in MIF format) that you want to convert to a web.
2. Specify the destination directory. This is the directory where the HTML files should be created. If you type in a directory that does not exist, WebMaker will create it for you.
3. Specify the filename prefix for the HTML files.
If you enter a prefix such as sim (which is appropriate for the Simple Example document), the HTML files are named as follows: sim-1.html, sim-2.html, and so on. Note that on platforms where filenames have a length limitation, if that limit is reached (by means of a file such as sim-10000.htm), WebMaker continues to number the files but it removes a character from the prefix in order to adhere to the filename length limitation (for instance, si-10000.htm).

Now you should fill in the other options:

1. Enter a Main Web Title. This is a title that should describe the entire web document; it is often the same as the title of your FrameMaker document. There is no default.
2. If you are using UNIX or Macintosh, choose a Filename Format option. The default value is Long File Names.

Table 4.2 Filename Format Options

Filename Format Option

Behavior

Long File Names

Uses long, descriptive names for the generated HTML and image files (for example, simple-1-image-1.gif for the first image file on the first page of the web).

8.3 Lowercase File Names

Uses filenames that conform to the DOS 8.3 file naming conventions, and generates files that have lowercase names (for example, sim1ima1.gif for the first image on the first page of the web).

8.3 Uppercase File Names

This option also uses filenames that conform to the DOS 8.3 file naming conventions, but it uses uppercase file names (for example, SIM1IMA1.GIF for the first image on the first page of the web).

3. Choose the Convert Graphics option. If checked, all graphics in the document are converted to GIF. If unchecked, the graphics are not converted, but the links to them are created in the HTML files; this option can save you time if you are reconverting a document, the graphics have already been converted, and you are sure that the resulting HTML files will not have different filenames than they did in the previous conversion.
4. Choose an Equations option. You can choose to have WebMaker convert FrameMaker equations into GIF files or HTML markup. Note that more browsers support the display of GIF files than the display of the HTML equation markup.
5. Choose a Footnote option. The Bottom of Page option puts footnotes at the bottom of the web page. The All on One Page options puts all the footnotes in a single web page. The New Page per Note options puts each footnote in its own web page.
6. Choose a Style Sheet option. If checked, WebMaker creates a .css file and inserts CSS-related markup into the HTML files. If unchecked, WebMaker does not create a .css file and does not insert CSS-related markup into the HTML files. For more information, see Chapter 5, "Cascading Style Sheets". Additional CSS-related options are available as command-line options; see Section 6.2.3, "Options for style sheets".
7. Choose a Debugging Markers option. The None option is for normal processing and is what you should normally choose. For information, see Section 8.2, "Debugging markers".
8. Click on Make a Web. WebMaker provides a progress bar that gives you an idea of where it is in the process of making a web.