Configuration

Configuration is controlled through the Options Panel, reached by selecting the Tools>Option menu item. The Options panel is divided into several tabs. Each of these tabs is described in turn.

Generator Configuration

The Options panel with the Generator tab selected.

Fields

This information identifies where to find the files for your website.

Site Directory

Synthesis assumes that you have a copy of your web site on your local disk. This copy is modified, and the changes are uploaded to your web server when you're finished. The Site Directory identifies the root directory of your site's files. (Another way of saying this is that the Site Directory is where your home page is located.)

Template Directory

The root directory for the Template files to use. This should be configured automatically, unless you want to change it to something else.

Library Directory

The root directory for the Library's files. It is important that all of the files in the Library are stored under this directory, otherwise Synthesis may not be able to maintain links with those files correctly.

Construction Page

When Synthesis is unable to resolve a link (typically because the target page has not been published yet) it will replace the link with one to your specified construction page. The construction link will be replaced as soon as the missing content is published.

Upload Options

The Options panel with the Upload tab selected.

Fields

This information will be provided by your web host. Here is what you'll need:

Server Name

The name of the FTP server you're connecting to. A typical value would be: ftp.your-domain.com.

User Name

The user name to log into on the FTP server.

Server Directory

If you need to load your site files somewhere other than where you log on to the server, that directory path goes here.

Password

Your password. This won't be shown on the screen other than as ***. You'll need to type this in the first time you do an upload during a session. The value will not be stored between sessions for security reasons.

Server Port
The FTP port to use. The typical setting is 21, and it's unlikely to be anything else.

Applications Options

The Options panel with the Applications tab selected.

Fields

This information is used to launch the support applications from Synthesis.

Web Browser

The command line for the Internet Browser you wish to use when web pages are displayed. For Windows platforms this would look something like:

"C:\Program Files\Internet Explorer\iexplore.exe" -nohome

HTML Editor

The command line for the HTML Editor you wish to use when you need to edit your web pages by hand. We're big emacs fans here, so ours is set to:

C:\Program Files\Gnu\emacs-21.2\bin\runemacs.exe

Text Editor

The command line for the HTML Editor you wish to use when you need to edit a text file. We use the same editor as for the HTML Editor (above). If you wanted to use Notepad, your setting would be:

notepad

Graphics Editor

The command line for the Graphics Editor you wish to use when modifying image files. For Adobe Photoshop on Windows platforms this would look something like:

"C:\Program Files\Adobe\Photoshop 6.0\Photoshp.exe"

Buttons

Template Toggle Button

Detect the HTML Browser to use. On Windows platforms this tries to obtain this information from the Registry, and may not succeed.

Template Toggle Button

Detect the HTML Editor to use. On Windows platforms this tries to obtain this information from the Registry, and may not succeed.

Template Toggle Button

Detect the Text Editor to use. On Windows platforms this tries to obtain this information from the Registry, and may not succeed.

Template Toggle Button

Detect the Graphics Editor to use. On Windows platforms this tries to obtain this information from the Registry, and may not succeed.