WEB SITE MAESTRO MANUAL

Web Site Maestro is the top model of a range of four website optimizers offered by
Tonbrand Software. The four applications, in order of increasing features, are HTML-
Optimizer, HTML-Optimizer Plus, HTML-Optimizer Pro, and Web Site Maestro.

Web Site Maestro makes your web files load faster by optimizing both HTML and script
code such as JavaScript, Java, LassoScript, CFscript, VBscript, Jscript, PHP, ASP, JSP, CSP,
TPL and CSS. It also optimizes JPEG images and PNG images.
Web Site Maestro protects your original web files by creating a Duplicate Web Folder for
the optimized files. Thus, it leaves your original files untouched. You should use your
Original Web Folder for editing and use the Duplicate Web Folder for uploading.
To optimize all of your web pages and JPEG/PNG images, select Entire Web Folder and
press the Start Button. Within a minute or less all web pages and images are optimized
and listed in the log. From there you can upload.
When you have optimized your entire web folder the log displays a report showing the
original size of your web folder, the total number of bytes saved and the total
percentage saved, plus the average load and display time speed up percentage of your
site. If your web folder contains files that are never loaded in the customer's browser,
for example download files like myBook.zip, then the report shows two percentages
saved, one for all files and one for web files. Of course, only the last one is relevant.
Note that this report does not appear when Smart Handling - see later - is on.

Web Site Maestro also features Smart Handling, supports XML, and can handle web
pages with any text encoding. Moreover, the program can also check your web pages
for dangling tags, missing attributes and broken links. A built-in FTP/WebDAV Client
enables one-click optimizing and uploading, also in secure mode. Synchronizing your
website with your Duplicate Web Folder is one of the many available options. A
summary of the functions of Web Site Maestro is presented next. After that are detailed
descriptions of the features, menus, commands, and so forth.


SUMMARY OF FUNCTIONS

Web Site Maestro offers 4 functions: optimizing web files, optimizing and uploading of
web files, checking tagged pairs and checking the validity of hyperlinks.

To start the operation you can select on the main window a file, a folder or your entire
web folder. If you select a folder, you can choose to handle the folder recursively, i.e.
handle all of its subfolders in one pass. If you select or drag the entire web folder, the
operation is always recursive.
Instead of selecting a file or a folder you can drag files and/or folders to the Drop Spot
above the View Code Button. Dropped folders can also be handled recursively. Note
that you can only drop folders that belong to any of your web folders loaded in Web
Site Maestro.

1. Optimizing Web Files: The main function offered by Web Site Maestro is optimizing
web pages and JPEG/PNG images. That is, it cuts down image size considerably and it
saves space on your web pages by removing unnecessary characters and tags. Most
HTML Editors add such things for their own purposes and to make the code easier for
the user to read. On your website, such coding is unnecessary. Furthermore, it slows
down load time.

2. Optimizing and Uploading Web Files: The second function offered by Web Site
Maestro is a combination of Optimizing and Uploading in one pass. You can optimize
and upload all web files, a single web file, or the ones you have "dragged and
dropped". More details about this feature are presented in the chapter "Drop Window."

3. Checking Tagged Pairs: The third function is for checking the tagged pair structure
of your original web pages. Dangling tags will be reported. IMG tags are checked for
the presence of the Width, Height and Alt attributes. You can choose to add missing
Width and Height attributes with their pixel values. AREA tags are checked for the
presence of Alt attributes. You can also choose to add missing Alt attributes to IMG
and AREA tags and attach an empty string or, for example, the string "FindMe" to
enable you to easily find and replace a string by a more meaningful caption. You can
perform this job in a separate, resizable text window and save the changes to the
original file.

You may check prior to optimizing if any Alt, Width or Height attributes need to be
added by choosing the "Check (and Complete) Tags" function. You can decide if you
want to have this action performed on the fly while optimizing, by checking the "Add
Missing ..." checkboxes in the Optimization Options section under the Optimizer Tab in
Preferences.
If you choose to add alt strings which are not empty, then you better not choose to do
it on the fly while optimizing, to save you the extra work of manually copying the
changes from the optimized web pages to the original web pages.

4. Checking the Validity of Hyperlinks: The fourth function is checking the validity of
your hyperlinks. Your original pages are checked for broken "href" and "src" links.
These are checked for the file to which they point. Links that start with "../" up to
"../../../../../" are checked for their real path. Broken hyperlinks of the type <a
href="#item1> and <a href="page1.htm#item1"> are also found, even if only "item1"
has changed.
By default only internal links are checked. In Preferences, under the Miscellaneous Tab,
you can choose to check external links as well. However, that will take more time and
#anchors are not tested then. External links are qualified as broken when a "404 - Not
Found" error occurs or when a timeout occurs before the headers are retrieved. Broken
external links will be displayed in bold text. If you double-click such a line in the Log,
the URL will be copied to the clipboard. That will enable you to paste the URL in your
browser in order to check the link again. Sometimes a link flagged as broken is only
temporarily broken.
If you discover that valid links are wrongly flagged, then you may consider if case could
be the cause. In Preferences you can choose to ignore case (which is not
recommended).

If you have used the Check Tags function or the Check Links function then you have
the option of editing the code in a separate, resizable text window and saving the
changes to the original file. Without leaving the program you could, for example,
correct a broken link, save the changes, and perform the Check Links function again to
determine if the broken link has been fixed.


FEATURES OF WEB SITE MAESTRO

Smart Handling

Web Site Maestro features an option called Smart Handling. If you have a large web
folder, then you can choose to optimize only the pages that have been changed. For
example, if you have a website consisting of 500 pages and you have worked on 25
pages, then you would not like to optimize all 500. Instead, you can turn on Smart
Handling, choose Entire Web Folder, and start. Only those 25 pages out of 500 pages
will be processed. This can be a significant time saving.

There are several ways that you can use the Smart Handling feature. In Preferences, you
can choose between "Date + Time", "Today", "Since <date>" and "File Size".
In "Date+Time" mode the modification date and time are compared between the
original files and the duplicate files.
If you choose "Date+Time", then a file is handled only if the original file was modified
at a later date, or at a later time on the same date, as the duplicate file. Once a file has
been handled, it will not be handled again, until you change it.
If you choose "Today" or "Since <date>", then a file can be handled more than once if it
has been created or changed either today or since the date specified by you. The
default date for the "Since <date>" mode is one day before the current date. This
means that only files are handled that have been created and/or changed yesterday
and/or today.
If you choose "File Size", the size of a web page or a JPEG/PNG image is compared
between the original file currently being processed and the same file processed in a
previous session. This means that only those web pages and JPEG/PNG images are
handled which actually got smaller or larger. The "File Size" mode does nothing with
files that cannot be optimized, for example PDF files. The "File Size" mode does also
nothing with files that are new. In that case you should first choose the "Refresh
Duplicate Web Folder" command from the Manage menu.
The "File Size" mode is the only feasible option if your web folder has been created in
an HTML Editor that exports your web folder with the modification date of all files
updated, even if only one file was changed. An example of such an HTML Editor is iWeb
'08 or earlier. iWeb '09 should be used with "Date + Time" mode.
The "File Size" mode does not work for listing and uploading non-optimized files.

If you have added new files - other than web pages and JPEG/PNG images - to your
Original Web Folder, then you can upload those new files by choosing "List Non-
Optimized Files for Uploading" from the Transfer menu while Smart Handling is on (but
not in "File Size" mode). Moreover, all new files will be copied on the fly to the duplicate
web folder.

On the Main Window the current Smart Handling mode is displayed as a link under the
checkbox. When you click on this link you can toggle between the four modes.
Customized "Since <date>" mode settings are not remembered when you quit Web Site
Maestro.

If you have refreshed your duplicate web folder, you cannot use the 'Date+Time' mode
for smart-optimizing web files. The reason is that the modification dates of the
original and the duplicate files have become equal.

If you have optimized your entire web folder without Smart Handling and you wish to
select web pages and images that have been changed since a certain date, you can
click in the Optimizer Log on the header of the "Y-M-D" column to sort that column.
Then you can drag-select the lines in the Log, starting from the date you want.


About Optimizing

Web Site Maestro analyzes the code of your web pages prior to optimizing and
separates the different code blocks from each other. Thus, pure HTML code is treated
differently from script codes. Script codes are also treated differently from one
another. For example, JavaScript gets a different optimizing approach than Java,
LassoScript, CFscript, VBscript, Jscript, PHP, ASP, JSP, CSP, TPL or CSS. Each of these
script codes gets its own special treatment in order to get the best result without
corrupting the code. When optimizing is finished, the codes are synthesized again to
form a complete, optimized web page.

During the optimizing process, your original pages remain untouched for later editing.
This is quite useful since optimized pages are difficult to read for humans, unless you
have turned off "Remove Returns" or chosen to remove only waste returns.

Optimized web files are by default written to your Duplicate Web Folder. The Duplicate
Web Folder is located in the WSM Output Folder. The WSM Output Folder is, by default,
located in the same folder where your Original Web Folder resides. You can relocate the
WSM Output folder if you want to do so. However, you should not move it manually and
you should never rename it. See the explanation of the Configure Menu.

If you check or optimize a file or folder not belonging to any web folder, then it will be
saved directly in the WSM Output Folder.

WARNING: If you open an optimized web page in the HTML Editor that originally
created it and save any changes, most of the optimizing will be undone because the
Editor adds its own formatting again!

Web Site Maestro removes the following tags by default:

Optional end tags such as </OPTION> However, these tags are no longer optional in
XHTML or XML files. They are not removed from those files.

Forbidden end tags such as </IMG>.

Redundant Editor Tags introduced by GoLive, Dreamweaver and other HTML Editors.

The following characters are removed by default:

All returns - not really "all" because some returns should not be removed - or only
waste returns from Mac, Windows or Unix files (CRs, CRLFs and LFs).

Tabs.

Unneeded quotation marks.

Waste white space.

Code surrounded by the following tags is dealt with separate from the main code:

<SCRIPT> and </SCRIPT>
<CFSCRIPT> and </CFSCRIPT>
<SERVER> and </SERVER>
<APPLET> and </APPLET>
<STYLE> and </STYLE>
<OBJECT> and </OBJECT>
<PRE> and </PRE>
<NOOP> and </NOOP>
<? and ?>
<% and %>

The <? and ?> tags can enclose PHP, LassoScript or any other code that follows the
same basic syntax.

The <% and %> tags are used to enclose ASP code.

"NOOP" means No Optimizing. The <NOOP> and </NOOP> custom tags can be
applied by you to enclose a certain HTML code block that you don't want to be
touched. You should not nest the NOOP tags within any of the tags listed above.
Neither should this code block contain any of the tags listed above. The NOOP tags will
not appear in the optimized file. This feature works only in web pages with the htm or
html extension.

In Preferences you can indicate which files and/or folders in your web folder should not
be handled by Web Site Maestro. Some HTML Editors, for example Dreamweaver, save
data in specific folders that should not be optimized. You can choose to support
nested folders up to 5 levels deep. If you want to exclude subfolders deeper than 5
levels, you can enter subfolders that are at level 5 and ultimately exclude subfolders up
to 10 levels deep.
You can enter a set of files and/or folders for each web folder separately. Folders are
displayed in bold text to distinguish them from files. If you don't need that difference,
you can indicate that under the Extra Tab of Preferences.

Comments in HTML code, CF code and script code can be removed. Comments that
start with "<!--#" will be removed if the special option is selected, but never from web
pages with the ".spm" or ".spml" extension. MS Conditional tags that start with "<!--["
are not removed.
It's possible that not all comments are removed. This may happen when the comment
lines contain not just words but strings that resemble code.
Single-line comments that include the word "Copyright" - case-insensitive - are not
removed.

"\n" and "\t" or "\t\t" or "\t\t\t\" etc. can be removed from FluxBB code.

Directory URLs like "http://www.xyz.com" can be qualified, i.e. they will get their
missing trailing slash, which makes it twice as fast for a browser to access that URL.
Also any occurrence of "&amp;" in a URL is replaced with "&". This option works for
HTML and script code.

Embedded email links can be encoded against spam harvesters. This option works only
for HTML code.


Optimizing Images

Web Site Maestro optimizes JPEG images and PNG images. You can choose to convert
PNG images without a mask to JPEG and then optimize them while retaining their .png
extension, so that hyperlinks in your code pointing to these images are not broken.
Every browser will display the converted image with .png extension correctly, despite
the fact that its file format has been changed from PNG to JPEG/JFIF. In most cases
converting PNGs without masks to JPEGs results in higher savings in bytes.
The default image quality value for optimizing JPEG images and converted PNG images
is 69%. The default compression level for optimizing PNG images with a mask is "High".
You can specify another value in Preferences, under the Extra Tab. If you have
optimized your JPEG images and PNG images without a mask and you are not satisfied
with the image quality, then you can choose a higher value, for example 75%, and
optimize again.
If you have optimized your images and you want to revert them to the original state,
then uncheck the "Optimize JPEG Images" and/or "Optimize PNG Images" checkboxes.
Then the original images will be copied to the duplicate web folder when you optimize
your files.


Web Folder Drop Down Menu

If you have more than one Original Web Folder, then the Web Folder Drop Down Menu
enables you to easily switch between Original Web Folders. The currently selected
Original Web Folder is called the Current Web Folder. When you open the Web Folder
Drop Down Menu, then you will see the names and paths of the various Original Web
Folders that have been added to the menu. Related settings, such as the Transfer
Settings, are automatically retrieved for the Current Web Folder.

The Web Folder Drop Down Menu has a contextual menu that you can open by control-
clicking the menu. This contextual menu duplicates some commands from the
Configure Menu. For example, the "Sort Web Folders" command in the Web Folder Drop
Down Menu enables you to sort the items in the Web Folder Drop Down Menu. Items
are sorted alphabetically. Also, the Current Web Folder name can be changed by
choosing "Apply Custom Label to Current Web Folder" from the Configure Menu.

If you work with Web Folder A and you choose, maybe by accident, a file or folder from
Web Folder B, then Web Folder B is automatically selected in the Web Folder Drop Down
Menu. This also works when you drop files or a folder on either the program's special
drop spot or on the Drop Window.

If you switch between Original Web Folders and/or switch between functions, then the
caption of the "Hide/Show" Button will change to "Show Current Log" if a listing for the
Current Web Folder and the selected function is available.


The Log

You can select a file shown in the Log by clicking on its line in the Log. You can also
control-click (right-click) on a line to evoke a contextual menu. Multiple selection is
supported but is available only for uploading. You can press the Command (Apple) key
to make multiple selections or choose "Select All" from the Edit Menu.
If you have optimized your entire web folder, the last line in the Log shows "Original
Total Size", "Total Bytes Saved" and "Percentage Saved". If your web folder contains files
which will not be loaded in the browser, for example downloads with the .zip
extension, two different lines are shown: the first for all files, including the downloads,
and the second for web files, i.e. web pages and images. If you use a trial copy of Web
Site Maestro, the number of files will be 70% of the total number.

You can save the Log by choosing "Save Current Log" from the File Menu.
If you double-click a line in the Log, you copy that line to the clipboard.

Optimized or checked files appear in the Log display. If a file belongs to the Duplicate
Web Folder or to the Original Web Folder, this is indicated in the Log's heading when
you select the file. If a file does not belong to any of your web folders, it gets an
asterisk after its name. You cannot drag and drop files that do not belong to any of
your web folders. Optimized pages are put in the Duplicate Web Folder. Checked pages
without changes remain in the Original Web Folder. Changed pages appear in the
Duplicate Web Folder.

The View Code Button, the View Page Button, and the Upload Button are enabled when
a file is selected in the Log. If a button is still disabled after you make a selection, this
could mean that its action is not permitted for the selected file. For example, it's
possible to use the Upload Button when you are selecting an optimized file but not with
a checked (non-optimized) file. Neither can you view the page when you have made a
multiple selection, because the program can't tell which file you want.

The "Y-M-D" column, showing modification dates, is available only when either using
the Optimize function or using the Optimize and Upload function. You can sort the
Current Log, but not the History Log, by clicking on the column heading. That makes it
easy for you to select the most recent web files for uploading. You can do it that way
instead of using Smart Handling.

You can drag selected lines to the Desktop from the Current Log but not the History
Log. You can also drag them to a text editor's window. In Text Edit the columns are
lined up if the font type is non-proportional, e.g. Courier or Monaco. Also, you can
save the Current Log by choosing "Save Current Log" from the File Menu.

You can adjust the column widths by placing the cursor on the dividers in the heading.
If the Log is not wide enough to properly display the results, then you can widen it by
widening the main window.

The Log Display can show a practically unlimited number of lines but you will be
prompted when the History Log gets so full that performance would slow down. You
can empty the History Log by choosing "Purge History Log" from the File Menu. The
logs are located in the Web Site Maestro Logs folder which is in the Preferences folder.

The History Log Button enables you to see what you have done in the past. The dates
are included. Note that you cannot upload files when they're called from the History
Log. From the File Menu, you can choose to open the History Log with Text Edit. The
type of log depends on the selected function, i.e. Optimizing, Checking Tags or
Checking Links.

When you optimize or check a web folder, each individual listing of the result for each
individual Original Web Folder, i.e. the "current" Log, will be remembered until you
overwrite the listing or until you quit the program.


The Configure Menu

From the Configure Menu you can add additional Original Web Folders to the Web
Folder Drop Down Menu. You can also remove Original Web Folders from the Web
Folder Drop Down Menu. However, the Web Folder Drop Down Menu must always have
at least one remaining Original Web Folder. Note that when you add an Original Web
Folder, you should select the folder that contains in its root the index file (the home
page).

The "Apply Custom Label to Current Web Folder" command allows you to enter a
different display name for the Current Web Folder. This name will appear in the Web
Folder Drop Down Menu.

The "Relocate WSM Output Folder" command allows you to move the entire WSM
Output folder to another location on the same volume. If you want to move the WSM
Output folder to another volume or partition, then you should choose "Reset
Configuration".

WARNING: Never move the WSM Output folder manually. Do not rename it.

Should things ever go wrong and corrupt the program's configuration, an easy way out
is to choose the "Reset Configuration" command. After this action you must configure
Web Site Maestro again but your registration data, transfer login data, and preferences
are remembered.

If using the "Reset Configuration" command does not solve the problem, then choose
the "Reset Configuration" command again while holding down the Alt key. The Web Site
Maestro Preferences File will be cleared.


The Manage Menu

The Duplicate Web Folder is the folder from which you upload optimized files to the
server, so it must stay up to date after you have changed your original web folder. To
accomplish this, the Manage menu has two commands: "Synchronize Duplicate Web
Folder with the Original" and "Refresh Duplicate Web Folder.

The "Synchronize Duplicate Web Folder with the Original" command adds files that are
missing from your Duplicate Web Folder. Moreover, it will remove orphaned files and
folders from your Duplicate Web Folder. The time it takes to remove orphaned items
depends on the number of levels of your web folder. If your web folder has only one
level, i.e. no subfolders, the minimum number of passes is 3. One pass is added for
each subsequent level.
You should use this command after you have made large changes to your web folder,
i.e. added a lot of stuff, renamed items and/or removed items.
You do not need to use this command after you have added only a few new folders and
files to your web folder. In that case the changes will be dealt with automatically while
optimizing.

The "Refresh Duplicate Web Folder" command should be used when the previous
command fails to restore the integrity of the Duplicate Web Folder. This command will
delete the corrupted Duplicate Web Folder and create a new one. Then you will need to
optimize your entire web folder.

The "Show Refresh/Sync Log" command enables you to view the Log again after you
have clicked the Hide Button or performed other tasks that made the Refresh/Sync Log
disappear.


The Transfer Menu

The "List Non-Optimized Files for Uploading" command enables you to upload your
non-optimized files such as GIFs, PDFs, MOVs, SWFs and MP3s, or a selection of them.
You can select Smart Handling before you choose this command. The "File Size" mode
does not work with non-optimized files.

The "Get Remote Directory Listing/Download Files" command enables you to check
which files you have uploaded and when. The total file size is displayed at the end of
the listing. If you select in the listing one or more lines referring to a file, the Download
File Button is enabled for downloading the selected file(s) to a destination preset by
you. For downloading you may choose to restore returns in HTML code to make the
code more readable to humans. You cannot download directories. They can be
recognized by their names in bold text.
If you are connected with a WebDAV server, getting all remote directories may take
several minutes because most WebDAV servers do not support recursive listings.

The "Get Server Root Directory Listing" command (or "Get MobileMe iDisk Directory
Listing" command if your host is MobileMe iDisk) could help you determine the initial
path that you should enter in Transfer Settings. In the listing you may see a number of
files and folders of any kind. Just look for a name such as "www", "web", "public_html",
"htdocs" and try it as initial path. For MobileMe iDisk the initial path is "Web/Sites/"
followed by the name of your web folder in iWeb.
If you click on a disclosure triangle, a sub-directory list is received from the server, up
to a maximum of two levels deep.
If you use MobileMe iDisk you can open any of the sub-directories for downloading
Apple-related or private stuff.
Downloads from these directories always arrive on your desktop.

The "Synchronize Web Site" command enables you to synchronize your website with
your Duplicate Web Folder. You can choose to either update older files with newer files
or to update files and also delete orphaned files.
It is recommended to perform a test run first. During this test procedure, the Sync Log
will display what actions would have taken place, for example creating folders,
uploading files, deleting files or deleting folders. If you don't see any unexpected
actions, you can safely perform a live synchronization, otherwise you may have entered
a wrong initial path in Transfer Settings.
By default your Duplicate Web Folder will be used as reference, so it is important that
this folder is up to date. In case of doubt you should synchronize it with your Original
Web Folder before you start synchronizing your website. If you have chosen to
optimize the web files in your Original Web Folder (see the Miscellaneous Tab in
Preferences) then your Original Web Folder will be used as reference and you don't
have to consider the state of your Duplicate Web Folder. The result of the synchronize
process will be displayed in the Sync Log.

Under the Sync Tab of Preferences you find several options to customize the
synchronization process. When you select to skip a folder in the synchronization
process, the setting applies to two different conditions. The first condition is when you
have a folder, "local test" for example, in your web folder that does not exist in your
website on the server. If you select to skip this folder then, when synchronizing, this
folder will not be created in your website on the server. The other condition is if your
website on the server has a folder, "remote test" for example, that does not exist in
your web folder. If you select to skip this folder then, when synchronizing, this folder
will not be removed from your website on the server. Note that remote files and folders
that are not accessible by the public - often residing before the initial path - are not of
interest here.

If you are connected with a WebDAV server, synchronizing your website can take
several minutes because most WebDAV servers do not support recursive listings.

The "Synchronize Remote Folder" command enables you to synchronize a remote
subdirectory on the web server with a local subfolder in your Duplicate Web Folder.
This comes in handy when you are sure that you do not need to synchronize your
entire website. See the previous paragraph for further details on the synchronize
process.

IMPORTANT: If you notice, after having optimized your web folder and synchronized
your website, that the images on your site have not been replaced by their optimized
versions, then you should do the following for each of your web folders (or just your
web folder if you have only one site):
Go to the Optimizer Tab of Preferences and check if the options to optimize JPEG
images and PNG images have been selected. Then go to the Extra Tab and change the
Image Quality setting a little bit, for example from 69 to 70, and save. Then optimize
your entire web folder.
Repeat this for every other web folder, change the Image Quality setting each time a
little bit, this time for example from 70 to 69, and optimize your entire web folder.
When this job is done, your optimized images will be uploaded during the
synchronization process.

The three following commands are automatically executed if required by the
synchronize process. They are available anyway for occasional use.
The "Rename/Move Remote File or Folder" command and the "Delete Remote File or
Folder" command allow items to be handled that belong to your currently selected
Duplicate Web Folder. You may press one of the Select Buttons in the dialog to indicate
what file or folder in your Duplicate Web Folder must be deleted, renamed or moved at
the server. The path/name will be displayed so that you can be sure that the right item
is going to be handled. If you want to remove a remote folder, the name of the folder
must end with a slash. Note that paths and names are case sensitive.

The "Restore Original Web Folder" command comes to the rescue when your Original
Web Folder has been lost or corrupted, for example after a hard disk failure. Start with
an empty folder with the name of the lost web folder. You can choose to only restore
the local directory structure or to restore and download everything. You can choose to
restore most returns in HTML code to make the code more readable to humans. Those
returns were deleted in the optimizing process before you uploaded your files. You
could also use the restore method to update your Original Web Folder with your
website (reverse synchronizing but not mirroring). In that case it's recommended to get
the server time offset again first.
The restore method applied here is 100% reliable, as opposed to programs that claim
to download entire websites but mostly leave certain files untouched.
If you are connected with a WebDAV server, restoring your web folder can take several
minutes because most WebDAV servers do not support recursive listings.

The "Reset Transfer Settings" command comes in handy when for some reason your
login data and/or other settings have become corrupted.


The Select Button

The Select Button does the obvious. It shows an Open Dialog, with the Current Web
Folder as the default directory. If you select "Entire Web Folder", the Select Button
changes its name to Start. Your entire web folder will then be processed. There is no
limit to the number of levels. Note that when you select "Folder" instead of "Entire Web
Folder", you can choose to handle the folder recursively, i.e. handle all of its subfolders
in one pass.

If your web folder includes a WebObjects application bundle, then you can only
optimize the web pages in this bundle if you selected "Entire Web Folder".


The Stop Button

Of course, you can always safely abort a process by pressing the Stop Button.


The Same Again Button

If you press this button, then you start any selected action on the same file or folder
that was recently selected or dropped, so you don't need to navigate through an Open
dialog again. You can repeat this action for as long as you wish, until you select
another file or folder. This button will prove to be very useful when you want to
perform consecutive actions on the same file or folder, e.g. checking tags, checking
links, and finally optimizing, in that order.


The View Code or Edit Code Button

Depending upon which function has been most recently finished, the button will be
named either View Code or Edit Code.

View Code Button
When you have optimized a web page, the button is named View Code. Use this button
to view the code, also called the source or the source code, of a web page. The button
will allow you to view the optimized source code but not to edit it. If you want to edit
the original source code, then you should do that in your HTML Editor and optimize it
again.

To view the source code, choose a page by selecting its line in the Log. When you click
the View Code Button, the source code for the selected page appears in place of the log
in the main window. The Hide/Show Button becomes a Hide Code Button. When you
click the Hide Code Button, then the source code is replaced by the log. When the
source code is present in the window, there is a small disclosure triangle to the left of
the code. The disclosure triangle enables you to toggle between the default size of the
window and the large size of the window.

Edit Code Button
When you have optimized web pages with the optimization options set to add missing
alt attributes, or when you have checked tags or links, then the View Code Button is
renamed Edit Code. To edit the code of a page that appears on the log, select the page
in the log and click the Edit Code Button. A separate, resizable text window opens,
displaying the source code for the selected page. The title of the window shows the
name of the file and indicates whether it is the original file or the duplicate file. The
window also shows the path of the file.

The text window includes a Find Button. If you click the Find Button, then a Find &
Replace Dialog appears. The dialog automatically includes a character string, for
example, a broken link that was detected if you checked for broken links. Note that
when you press the Find Button on the Edit Code Window, the string to be found is
already present in the Find Field of the Find Dialog. However, if you choose "Find" from
the Edit Menu, then the Find Field is empty. If the Log indicates that there are more
occurrences of the same broken link then you can press the Find Next Button (or type
Command - G) to locate the next occurrence. When you have finished correcting the
broken links, then you can press the Save Button. This will save the changes that you
have made and also close the window. Then you can select another line in the Log and
press the Edit Code Button again. It could be another file or the same file with a
different broken link. Then you simply repeat the foregoing actions.

In Preferences, under the Miscellaneous Tab, there is a check box that allows you to
enable or disable the feature to automatically activate the Edit Code Window when you
pass the pointer over it. If this feature is enabled, then it saves you extra clicks on the
Edit Code Window and the Main Window while you are interacting between them. The
feature is disabled by default and can be enabled with the check box.

The View Page Button on the Edit Code Window works the same as the View Page
Button on the Main Window. See the next section.


The View Page Button

Use this button to view an optimized or checked page in the program's own HTML
Viewer. Choose a page by selecting its line in the Log.
Under the Miscellaneous Tab in Preferences you can select the option to view a web
page in your default browser after you have pressed the View Page Button. This may
not work if you use FileVault.
When you have optimized a JPEG or a PNG image and you select its line in the Log, the
button is named View Image. Then the optimized image will be displayed in the
program's own Image Viewer.
In rare cases pressing the View Page Button or View Image Button does not have any
effect. If that happens you should restart Web Site Maestro.

When you get a remote directory listing and you select a file in that listing, the View
Page Button will change itself into a Delete File Button. When you return to optimizing
or checking web files, the button will revert to View Page Button.


The Upload File Button

This button enables you to upload one or more web files to the server. Simply select
their line(s) in the Log. You can press the Command (Apple) key to make multiple
selections. Then, press the Upload File Button. If you choose "Select All" from the Edit
Menu, then all lines in the log will be selected. Note that you may also sort the "Y-M-D"
column in the Log in order to easily select and upload web files that have recently been
changed.
If you want to upload your iWeb based web folder to MobileMe iDisk, then choose
"About iWeb and MobileMe iDisk" from the Help menu for essential information.
The Upload File Button will change itself into a Download File Button when a list is
displayed in the Log after using the "Get Remote Directory Listing/Download Files"
command or the "Get Server Root Directory Listing" command. If a file is selected in the
list, then the button becomes enabled.


Preferences

This is a very important part of Web Site Maestro, giving you maximum flexibility. You
can choose to show or hide advanced settings.
Note that Help Tags pop up when you move the pointer to a checkbox or to a radio
button and hold it there for a moment. You can turn this feature off.

Pressing the Save Button will save your changes and close the Preferences Window.
Pressing the Cancel Button will close the Preferences Window and discard any settings
you may have made.
The Default Settings Button is effective only for the current tab panel.
All controls on the Preferences Window have help tags, so their properties are not
explained here.

The Preferences Window has seven functional tab panels: the Filters Tab, the Optimizer
Tab, the Smart Handling Tab, the Miscellaneous Tab, the Transfer Tab, the Sync Tab,
and the Extra Tab.

1. The Filters Tab enables you to specify which files are to be handled and which
subfolders to be excluded from handling.

2. The Optimizer Tab includes all optimization options. All settings can be made for
each website separately.

3. The Smart Handling Tab shows the various modes of the Smart Handling feature.

4. The Miscellaneous Tab has settings for checking tags, starting up and finishing. The
checkbox for remembering the currently selected function is enabled only in a
registered copy of Web Site Maestro.

5. The Transfer Tab holds all settings and options for uploading your web files.
Settings can be made for each website separately, of course.
Before you can upload, you have to complete the Transfer Settings. Start with entering
the name of the remote server. In the next box you enter the initial path. Look what
has been written about this in the Transfer Menu chapter. After you have entered your
login data, you can set the server time offset (only required for the FTP protocol). Press
the "Get FTP Server Time Offset" Button. If this button is disabled you may have
selected the WebDAV protocol. Within a few seconds after you have pressed the button,
the difference between your time and the remote server time will be displayed. The
correct server time offset is required when you synchronize your website with your
local web folder.
It is recommended to get the server time offset again when Daylight Saving Time - if
applicable for your country - has started or ended.
For WebDAV servers like MobileMe iDisk the server time offset is not relevant.
The option for choosing an alternative FTP upload method should only be used if the
default FTP method does not work, which could happen with an FTP server with an
unusual configuration.

6. The Sync Tab holds all settings and options for synchronizing your website. For
example, you can choose to always verify the server time offset before synchronizing
your website. The server time offset is the difference between your (local) time and the
time shown by the (remote) server clock. This option is useful if the server clock
appears to be inaccurate. If the server clock is inaccurate by two or more minutes, then
Web Site Maestro can detect it and set the Offset Tolerance to a value that matches the
inaccuracy. You can also adjust the Offset Tolerance by using the Drop Down menu.
The advantage of a properly set Offset Tolerance is that, during synchronization,
unnecessary uploads are avoided. A (small) disadvantage is that a new version of a file
will not be uploaded for the second time if its modification time is only X minutes apart
from the previous modification time, where X is the Offset Tolerance. In such a case
you should upload the file manually.

The option to skip folders whose name starts with an underscore will allow you to
exclude certain local folders, with their contents, from uploading or to prevent
unwanted deleting of server owned folders which (by error) reside in the root directory
of your website but not in the root directory of your Duplicate Web Folder.

All settings can be made for each website separately.

7. The Extra Tab is a collection of supplementary items that you may find handy. For
example, you can choose to have your Duplicate Web Folder name spelled in CAPITALS
to distinguish it from your Original Web Folder. Another example is the option to partly
restore returns in HTML code of an optimized web page, to make the code easier to
read. The output will be written to the same file.

If Web Site Maestro gives an error when accessing the Internet, you should check your
firewall settings. It may be required that you have to enter a rule to allow Web Site
Maestro to make a connection via port 80 (http).


Local and Remote Setup of your Web Folder

To avoid possible errors when uploading your files or synchronizing your website with
your local web folder, the local and remote setup of your web folder must match. In the
first place this means that the initial path in Transfer Settings must be correct. For
MobileMe iDisk this is "Web/Sites/" followed by the name of your web folder in iWeb.
Then you should check if your web folder that has been loaded in Web Site Maestro
contains in its main directory the main index file. If you do not feel sure about this, you
should perform a test run when synchronizing your website with your local web folder.
If you do not see any unexpected actions in the Sync Log, everything should be OK.
The golden rule is that your main index file should be located in the main directory of
your local web folder and in the main directory of your website.


Dropping Files or Folders

The Drop Window is a little window that you can select from the File Menu. It can
receive dropped files and/or folders.
The program's main window has a drop spot just above the View Code Button to which
you can drag files and/or folders. Dropped folders can always be handled recursively,
overriding the unchecked Recursive checkbox setting on the main window, by checking
the "Always handle a dropped folder recursively" under the Extra Tab of Preferences.
Note that you can only drop files and folders that belong to any of your web folders
present in the Web Folder Drop Down Menu.
You can also drop files - not folders - on the program's icon or its alias. If you do that
while the program is not running, it will be launched and the dropped file(s) will be
handled.
In Preferences you can choose to get the Drop Window immediately on your desktop
when you launch Web Site Maestro. Its last position on the screen is remembered for
subsequent launches. By clicking on the Drop Window, you can display either the Web
Site Maestro icon or the text "Drag your file(s) and/or folder(s) here".


From Trial to Full Copy

When you start using Web Site Maestro as a demo, your trial period is limited to 30
days and the number of web files to be optimized in one pass is limited to 70% of your
total number of files. You will get a warning when you have only 10 days remaining
until the expiration date, and again for each day thereafter. Please register in time so
that you can continue working with Web Site Maestro without delay. To purchase a
license, choose "Register..." from the Web Site Maestro menu and follow the directions.
In a registered copy your user name and serial number are displayed in the 'About Web
Site Maestro' window. If you click on 'Organization' you may enter or edit your
organization name at any time.


License Policy

We offer 'Single User' licenses only. Your serial number will be based on the name of
your user account of this computer, in short the 'user name'. Other user accounts on
your computer are supported. You may install Web Site Maestro on a maximum of two
computers of your own. For example, you may install the application on your desktop
computer and on your laptop computer. However, the two computers must share the
same user name. If the user names of the two computers are not identical, then your
serial number will not work automatically on both computers. In that case, you will
need a second serial number for the other computer. You can contact
sales@tonbrand.nl to request a second serial number. If the two computers have user
names that believably identify the same individual, then we will supply a second serial
number. Otherwise you will need a second license.