4W WebMerge Settings

Generation Tab

The Generation tab provides additional options for governing how WebMerge generates your pages, and any post-processing you'd like it to do, such as uploading the files to your server or running additional settings files.



Auto-Run Option

One of the most powerful features of WebMerge is its ability to let you save your settings to a file and have them run automatically when that file is double-clicked. To activate this feature, first save your settings by choosing File->Save, and then set this checkbox:

If you want to modify a settings file after it's been saved with this option, first open WebMerge and then choose File->Open to select the file. The auto-run feature is only activated when a settings file is opened by double-clicking it in the OS.

Write URLs as Links

WebMerge can automatically generate URLs in your data as active HTML links. Just click the checkbox labeled "Write URLs as links", and any field which contains a valid URL (e.g., "http://www.fourthworld.com") will be written using an href tag.

The following services are recognized anywhere in the field data when this option is set: mailto, ftp, news, and of course http. When using the mailto service, the service name ("mailto:") is not included in the link's display text; all other services are displayed as complete URLs. Email addresses do not require the "mailto:" service specifier; WebMerge should be able to identify any properly-formatted email address when this option is active.

For example, if your source data contained this:

   Go to our Web site:  http://www.fourthworld.com

It would be generated like this:

   Go to our Web site: <a href="http://www.fourthworld.com">http://www.fourthworld.com</a>

Prepend Image Paths

This option allows special handling of image paths. Sometimes you may not know the path to your images folder at the time you enter the data in your database. If you had included the path (e.g., "project/images/") and it changed to, say, "project/myproject/images/", you would have to modify every record in your database to match the new directory structure. We think that's too much work.

WebMerge makes handling cases like this a snap. In your database, simply enter the short name of the image file only, without any of the path information (e.g., "mypicture.jpg"). After you export your data and open WebMerge, you can turn on the option labeled "Prepend Image Path to....", and select the field with the file name you want the path added to.

For example, suppose we had a folder named "images" containing our JPEGs, and in our database we store only the short names of each image (e.g., "Cake.jpg"). In WebMerge, we turn on the prepend option for image paths, select the field named "Food_Image" from the popup menu provided, and in the field below it we type the path:

images/

When WebMerge generates the pages, it will replace the source URL portion of your IMG tag with not only the short file name you had in your data, but will also include the path you specified:

<IMG SRC="images/Cake.jpg">

You probably won't need to use this option often, but when you do you'll find it invaluable.

FTP Files to Server

Once WebMerge has finished generating your pages, you can have it upload those pages to your server by setting this checkbox:

The popup list to the right lets you select from the FTP servers you've entered. You can enter new server info or modify an existing set of info by choose "Edit list..." from this control. This opens the FTP Server Settings window which lets you create or delete FTP settings. Each FTP setting consists of a label (which appears in the popup list in the Generation tab), the host address or name (e.g., "ftp.fourthworld.com), your user name and password for that host, and you can optionally specify the directory on that server that is the root of your Web site.

On the right of this section is a button labeled "Root Folder", which lets you select a folder on your hard drive which acts as the root of your site. This lets WebMerge determine the relative location of files as they should be uploaded to your server. For example, if you generated a file at "/HardDrive/site/pages/index.htm", and your root folder is "/HardDrive/site/", WebMerge will log into your server and copy the file to the directory "/pages/". If no such directory exists on your server, WebMerge will create it for you.

For expediency, WebMerge will only upload the files it generates. If you need to upload other files related to your site, consider using a dedicated FTP program.

Don't Show Results Dialog

By default, when WebMerge has finished generating pages it presents a summary of results in a dialog window. You can turn this option off by setting this checkbox:

Note that this option is set automatically when you set the Auto-Quit option (see below). If it is unchecked with Auto-Quit set, WebMerge will not be able to quit while it waits for you to dismiss the results dialog manually.

Logging Results

WebMerge can optionally log results and errors to a log file for your reference by setting this checkbox:

If you have not already specified a log file, setting this option will trigger the "File..." button to let you specify where the results log will be written. You can also choose whether you want WebMerge to retain previous logs by appending the log file by choosing the "Append" option, or overwrite older logs by choosing "Overwrite".

Run Other WebMerge Files

WebMerge lets you run batches of settings files by adding those files to this list and setting this checkbox:

You can select other WebMerge settings files to add to this list by clicking the "Add Settings File.." button. To remove a file from this list, first select it and click "Remove File from Queue".

You can change the order in which these files are processed by using the "Move Up" and "Move Down" buttons on the right.

Note that any settings files included in this list must have their Auto-Run and Don't Show Results options set in order to avoid interrupting your batch run.


Auto-Quit

You can have WebMerge automatically quit after it finishes generating your pages by setting this option:

This is especially useful when used in conjunction with the Auto-Run option, so you can have WebMerge launch, process your files, and quit in one move.


Include "Made with WebMerge"

You can have WebMerge insert a notice stating "Thispage was made with 4W WebMerge" at the bottom of every generated page by setting this option. The notice contains a link to the WebMerge product page at fourthworld.com. When this option is set, WebMerge will also insert a "generator" meta tag into the head of each page.