SiteGrinder 2 Basic & SiteGrinder 2 Pro

Reviewer's Guide

February 2006
"When my clients complain that their last web designer took 8 months to build a basic site and then I build a basic one while they wait (and watch) you have to admit that SiteGrinder is a bit of a revolution"
"My business has evolved with SiteGrinder as the main bit of 'proprietary intelligence' that has launched it over the top."
—Alex Morrison , Web Designer,
referring to SiteGrinder 1 Basic

SiteGrinder: The Velvet Revolution in Web Design

Making websites can be a very tricky undertaking. Designing the look of a site is only the beginning. It is no easy task to implement a site that matches a visual design created in a tool like Photoshop. Photoshop is designed to give total freedom to the artist. The web, on the other hand, is built on top of complex technologies and standards that place other concerns ahead of aesthetic ones. This difficulty has understandably intimidated many graphic designers who, though they may be proficient or expert in Photoshop, don't want to spend months or years learning the gory details of the internet such as XHTML, CSS, javascript, and document object models. For years only experts could generate workable sites from arbitrary, graphically intensive designs. Even then compromises often had to be made and the process was never pleasant.

Things change.

The SiteGrinder 2 Basic and SiteGrinder 2 Pro automation plug-ins from Media Lab now turn Adobe Photoshop for Windows and Mac OS X into an easy-to-use and powerful website design and production tool.

While SiteGrinder is not aimed solely at the web neophyte, a SiteGrinder-equipped designer with no previous web experience can use only their Photoshop skills to go from concept to deployment of a professional, standards-compliant site in mere hours with no slicing or programming. The difficulty of this task is invisible to the user as SiteGrinder builds graphics, text, and interactivity using modern web standard technologies and takes into account esoteric and detailed requirements like cross-platform browser compatibility.  While such power and simplicity are unprecedented in the world of web site creation, they call to mind the ability of Adobe Illustrator to enable a designer to create sophisticated 2D vector graphics without giving a thought to the intricate Postscript programming code that under-girds every curve and color of their illustrations.

Given the huge variety of sites on the internet, obviously a significant number are mostly text and/or are heavily database-driven and are not very appropriate for initial design in Photoshop. (This page, with its lengthy text, is an example - although SiteGrinder would be appropriate for creating a "skin" for this page with a graphical header, footer, and navbar and a placeholder for the bulk of the content.)

But for many other designs that feature sophisticated graphics and interactivity, SiteGrinder 2 Provides unprecedented advances in the speed, features and simplicity of WYSIWYG web design.

About This Guide

This guide provides an introduction to the general workflow of SiteGrinder, which is very different from what you are probably used to. After that the guide covers the major feature areas and is interspersed with tutorials that will give you a taste of the details of implementing some of those features.

You will find it most helpful to read the next section, “SiteGrinder Workflow Overview”, before continuing on to browse the feature descriptions. The workflow concepts are applicable to both SiteGrinder 2 Basic and SiteGrinder 2 Pro. You may also wish to view the narrated screen recordings that cover the basic features and workflow found here.

After the workflow section you will find information about features common to SiteGrinder 2 Basic and SiteGrinder 2 Pro, which is a more expensive version of SiteGrinder with concomitantly more, and in some cases more complex, functionality.

Features unique to Pro are described in the final section of the guide and are clearly described as being part of SiteGrinder 2 Pro.

System Requirements

SiteGrinder 2 Basic and Pro work with Photoshop 6 or later for Mac OS X and Windows.

 


SiteGrinder Workflow Overview

The SiteGrinder workflow is decidedly different from the typical workflow for graphically intensive sites.

It’s also a lot more fun.

Traditional vs. SiteGrinder Workflows

Traditional Workflow without SiteGrinder:

  1. Finalize visual design of site
    Time: Hours or Days
  2. Slice and export graphics
    Time: Hours or Days
  3. Laboriously re-create design and add functionality using a code editor or complex visual/code tool such as DreamWeaver or GoLive, importing and positioning sliced graphics as needed
    Time: Hours or Days
  4. Save shell pages based on the re-created design, import page contents, set up button links, rollover effects, etc.
    Time: Hours or Days

This workflow has some major disadvantages:

The SiteGrinder Way:

Because SiteGrinder generates a fully functional site from within Photoshop, most of the aforementioned steps are eliminated or made much simpler. The workflow is rapid and organic, allowing for the kind of quick feedback loop and experimentation that creative designers are accustomed to and prefer.

  1. Create a few design elements, buttons, and/or pages, as you like, adding hints like "-button" and "-menu" to layer names where necessary to indicate interactivity.
    Time: Minutes, Hours, or Days
  2. Open SiteGrinder at any point, examine its report to verify the partially completed site will build as you expect, and set any additional options (such as graphic compression) using controls in the SiteGrinder .
    Time: Seconds or Minutes
  3. Click the “Build” button and wait for SiteGrinder to create the page(s)
    Time: Seconds or Minutes
  4. Try out the page(s) in a browser, decide what you would like to add or change and return to step 1
    Time: Seconds or Minutes
  5. When finished the site can be uploaded or opened in a more generic tool such as Adobe DreamWeaver to add any elements that are outside of SiteGrinder's scope, such as database-generated content.

Advantages of the SiteGrinder workflow:

Key concepts of working with SiteGrinder

There are a few basic aspects and best practices of the SiteGrinder workflow that all users will encounter and need to understand.

SiteGrinder Hints: A Layer Name is Worth 1,000 HTML Tags

Naming layers carefully is both good Photoshop practice and also the simplest way to indicate layer functionality to SiteGrinder. Users who are accustomed to documents chock full of layers named "Layer 1", "Layer 235", etc. will need to change their ways, at least for layers that are meant to be interactive on the web pages they are designing.

To determine certain kinds of functionality SiteGrinder employs "hints", which are key words the user adds to the end of layer names after a dash character. There are many hints, but only a few that are used frequently. These include "-button", "-rollover", and "-popup".

SiteGrinder matches similarly named layers that have hints which work together. For example, an image layer named "Home-rollover" becomes the rollover version of an image layer named "Home-button". Any layers (any number of them) named "Home-popup" will become visible on the web page whenever the user rolls over "Home-button."

Luckily Photoshop makes it very convenient to rename a layer by double-clicking directly on the layer name in the layers palette, allowing in-place editing without bringing up a dialog box. SiteGrinder also has tools to automatically alter layer names.

There are many hints, but most users will only employ a few of them. A complete list is located at the end of this guide.

A number of hints can be used in combination in a single layer name, as in "Home-text-button" to tell SiteGrinder that a type layer should output as a text button.

Layer Management: Layer Groups Make This Easy

SiteGrinder acts upon layers and does not use the Photoshop image slice tools in any way. Layer management therefore becomes important, especially for larger site designs. Photoshop's layer groups, the folders previously known as “layer sets” into which the layers palette can be divided, make this very straightforward. Many users, for example, place elements that will appear on every page of their site in one layer group. Other layers reside most comfortably in groups corresponding to the pages on which they appear. This organization is merely a recommendation, not a requirement.

Many SiteGrinder hints can be added to the names of layer groups in addition to individual layers, allowing maximum power and flexibility.

Layer Comps: The Best Photoshop Feature You've Never Used

Photoshop CS introduced a useful new feature that many users have not yet discovered, the "layer comps" palette. Layer comps allow you to set up the layers of a document a certain way and take a snapshot (called a "layer comp") of the layer positions, visibility, and styles. You can then name this layer comp and call it back or update it to the current document state at any time. You can make as many comps as you need.

One of the biggest advantages of layer comps is that they allow layers to be arbitrarily associated together even if they are far apart in the layers palette and don't share the same group.

The combination of layer comps and layer groups make for efficient management of many different web page layouts inside a single Photoshop document.

SiteGrinder uses layer comps whose names end with the "-page" hint to define web pages and also to determine which buttons link to those pages.

Just as SiteGrinder matches a layer named "Home-button" to one named “Home-rollover”, it will also match them to a layer comp named "Home-page". When the site is built the button named "Home-button" will automatically hyperlink from any page it appears on to the page defined by the "Home-page" layer comp. This is set up by the user completely through this simple layer and layer comp naming convention. The user never enters a URL for this process to function, which both saves time and eliminates the possibility of errors commonly caused by typos in finicky URL spellings.

Layer comps are so crucial to defining pages that SiteGrinder includes a functionally equivalent tool for users of earlier versions of Photoshop that don't have the layer comps feature.

Click below for:

The SiteGrinder Window

SiteGrinder can glean most of the designer’s intentions from the kinds and positions of layers in the document and the hints added by the user. Some things, however, are better expressed using the controls in the various tabbed panels of the SiteGrinder window.

These include:

The first thing SiteGrinder shows to the user when it is opened from Photoshop's File->Automate menu is the Report panel. The report presents a detailed analysis of the pages, buttons, menus, and graphics SiteGrinder will construct when the user clicks the "Build" button. Most importantly it warns of any potential problems it detects, such as a "rollover" layer with no corresponding "button" layer.

After a quick look at the report the user can choose to build their site or can go to some of the other panes to add or change settings. (Only panes which are relevant to the contents of the current document appear in the SiteGrinder window.)

SiteGrinder saves these settings into the Photoshop file, so they need only be entered once per design.

Once the settings are finalized the user can build an instant text-only preview to evaluate text styles and navigation, a slower full preview built to a temp folder, or a final build to a specific folder ready to upload to the internet or open in another tool.

When the build is complete the new site will open in the user's browser. A post build report gives information about sizes of graphic files created, etc.

Click below for more information about:

SiteGrinder 2 Basic Feature Guide

Media Lab has, over the years, created several popular products for quickly and painlessly converting Photoshop designs into useful starting points for work in other products such as Macromedia Flash and Macromedia Director.

Converting a Photoshop design to a working website is a much grander task due to the variety of sites designable with Photoshop, and the complexity of the technologies and standards required for even trivial websites.

As a result SiteGrinder has a large feature set. Luckily most users will never need all of the features and will only have to learn about those they do need. Since most of the features work very similarly to each other using layers, layer comps, and hinting, learning new parts of the software can be quite rapid once the basics are mastered.

Here are the key features of SiteGrinder 2 Basic, linked to their descriptions:
Here are the key features added by SiteGrinder 2 Pro, linked to their descriptions:

SiteGrinder 2 Basic Feature: Styled Web Text from Photoshop Type Layers

SiteGrinder, unlike ImageReady, can convert Photoshop Type layers directly into styled CSS text on web pages. All of the Photoshop character and paragraph styles that are supported by CSS (which is almost all of them) are preserved. These include color, bold, italic, underline, space before paragraph, space after paragraph, paragraph alignment, etc.

This is obviously an incredibly useful feature for almost any web page design. Users need only turn off anti-aliasing or add the "-text" hint to a type layer to take advantage of it.

Type layers can be made to scroll if there is more text than can fit in the area of the layer simply by adding the "-scroll" hint.

Phrases inside the text can have hyperlinks added in several ways. Any URLs (HTTP, email, and otherwise) appearing in the text are automatically set up as hyperlinks by SiteGrinder. In addition, a separate layer with the "-links" hint can be used to apply links to particular phrases within the corresponding type layer.

To give this feature a try, follow these steps:
  1. Create a new 500X500 document in Photoshop and fill it with white
  2. Make sure a dark foreground color is selected
  3. Add a "paragraph" type layer by clicking and dragging with the type tool
  4. Type in some text and apply character and paragraph settings using Photoshop's text styles palettes
  5. Either set anti-aliasing for the layer to "none" or add "-text" to the end of the layer name
  6. Save the document and open SiteGrinder from the File->Automate menu
  7. Click the "Build" button

SiteGrinder will construct and open a web page with styled css text. Compare the text on the page to the text you created in Photoshop. Any styles supported by CSS will have been preserved.

SiteGrinder 2 Basic Feature: Web Graphics from Photoshop Image Layers

SiteGrinder converts image layers (including shape layers, etc.) to web graphics and positions them perfectly on the resulting web pages. SiteGrinder matches the "z-order" of layers in Photoshop on the resulting pages also.

SiteGrinder can use any compression setting from Photoshop's "Save For Web" dialog, including user-created settings, on any layer. The user can select a default that will be applied to most layers and exceptions for layers with different compression requirements.

To give this feature a try, follow these steps:
  1. Create a new 500X500 document in Photoshop and fill it with white
  2. Add a new image layer and paint in it
  3. Add a second image layer somewhere else and paint in it
  4. Save the document and open SiteGrinder from the File->Automate menu
  5. Select the "Compression" panel
  6. Choose a Save For Web Preset from the menu
  7. Click the "Build" button

SiteGrinder will output graphics using the compression setting you chose and the HTML required to display them where they appear in the Photoshop document.

SiteGrinder 2 Basic Feature: Buttons, Popups, and Basic Linking

For SiteGrinder, a button is just a layer or layer group that responds to the mouse in some way. It can change appearance and/or trigger a popup in response to a rollover, and it can link to other pages or resources on the web in response to a click.

SiteGrinder can create buttons from image layers, from styled type layers, or a combination. Both kinds of buttons, text and graphic, can trigger popups and rollover effects. Image button rollover effects are accomplished by replacing the image layer button with a corresponding image layer for the rollover.

Text button rollover effects are generated by CSS, not images, and include all of the standard options such as bold, italic, underline, overline, background and text color changes, and borders. In contrast to image buttons, text rollover options are set within the "Text Buttons" panel of the SiteGrinder window.

A popup is a layer (or layer group) that appears when a user rolls over a particular button and disappears when they roll off the button. A button can trigger any number of popups and those popups can be type layers, image layers, and even layer groups.

Both text and image buttons can also trigger popup menus. (See next section)

The various parts of buttons (the -button, its -rollover, and -popups) can be layer groups instead of layers, and individual layers in these layer groups can be made to react to rollovers instead of the entire button allowing for subtle control over button behavior.

Buttons that are constructed from a combination of graphics and text using layer groups are called "hybrid buttons".

To give graphical buttons a try, follow these steps:
  1. Create a new 500X500 document in Photoshop and fill it with white
  2. Add a new image layer and name it "Sample-button"
  3. Create a button-sized rectangle in this layer
  4. Select this layer in the layers palette
  5. Choose "Duplicate layer..." from the layers palette menu
  6. Give the duplicated layer the name "Sample-rollover" (this layer will contain the rollover state image)
  7. Select a new foreground color
  8. Select the Paintbucket fill tool
  9. Make sure "Sample-rollover" is selected and click inside the button rectangle to change its color
  10. Save the document and open SiteGrinder from the File->Automate menu
  11. Click the "Build" button

SiteGrinder will create a page with the "Sample-button" graphic visible. Roll over it with the mouse to see it change to the rollover version. Roll off to see it revert.

Follow these steps to create a text button with a hyperlink:
  1. Create a new 500X500 document in Photoshop and fill it with white
  2. Select the type tool (make sure a dark foreground color is selected)
  3. Click somewhere in the document to create a type layer
  4. Type "Testing" in plain 12 point Courier in the empty type layer
  5. Change the layer's name to "Testing-text-button"
  6. Save the document and open SiteGrinder from the File->Automate menu
  7. Choose the "Text Buttons" panel where settings unique to text buttons are altered
  8. In the "Rollover" area note what is selected. The default is Italic. If you prefer, add or change effects, including color, bold, etc.
  9. Choose the "Buttons" panel where settings common to all buttons are altered
  10. Click in the left-hand "Link" column next to the entry for "Testing-text-button"
  11. In the "Link" dialog select "URL" as the type
  12. Type "www.medialab.com" into the text entry area
  13. Click "Okay"
  14. Click the "Build" button

SiteGrinder will create a web page with your text button on it. Roll over it to see the effect. Click on the button to go to medialab.com.

For extra credit, add another layer (text or image) on a different part of the page and name it "Testing-popup", then open SiteGrinder and build again. When you roll over the button your new popup layer should appear.

Click below to find out how to:

SiteGrinder 2 Basic Feature: Menus

SiteGrinder can create menus from type layers containing multiple entries or from layer groups containing multiple buttons.

Text menus can have horizontal or vertical orientations. Each menu item is considered a button and has similar highlight options.

Layer group menus contain text or graphic buttons that can be in any configuration the user chooses for a huge number of possible effects.

As with simple buttons, SiteGrinder automatically links menu items to matching layer comp page names.

Menus on the built pages can be set to retain the highlight state of the button representing the current page the user is viewing, a common website feature.

Each menu button can, in turn, trigger its own popup menu (or non-interactive popup) via layer name matching. Any number of popup menus can be nested in this way.

For a tutorial demonstrating menus, see the next section on Pages.

Click below to find out how to:

SiteGrinder 2 Basic Feature: Pages and More Links

Pages are defined using layer comps whose names end with the "-page" hint. (SiteGrinder also provides a functionally equivalent tool for users of pre-CS versions of Photoshop.)

What goes on individual pages is determined by what layers are visible in these layer comps. This allows a site with an arbitrary number of pages to be defined in a single Photoshop document. Multiple pages can share layers, and shared layers can appear in different positions on different pages. The next section contains a tutorial that includes defining pages with layer comps.

Pages can be left, right, or center-aligned horizontally. They may be top-aligned or centered vertically.

Pages have user-settable background colors. (SiteGrinder 2 Pro provides powerful background tile options in addition.)

Any page can be set to be the "home" or "index" page of the site. This page will be saved as "index.html" and links to it will be properly adjusted.

Graphics that are used on more than one page are only saved once, which can increase loading and memory efficiency a great deal.

Tutorial: Tying Together Menus, Pages, and Links:

Creating the text menu layer:

  1. Create a new 500X500 document in Photoshop and fill it with white
  2. Select the type tool (make sure a dark foreground color is selected)
  3. Click in the upper left of the document to create a type layer
  4. Type "Home", press enter or return to go to the next line, and type "Contact"
  5. Change that layer's name to "Example-menu"

Creating the page content:

  1. Create another type layer and type "Welcome to the home page!" in it
  2. Open the layer comps palette from Photoshop's Window menu if it is not already open
  3. Click the "New layer comp" button at the bottom of the palette
  4. Double-click the layer comp's name and change it to "Home-page"
  5. Hide the "Welcome to the home page" layer
  6. Create a new type layer and type "This is the contact page" into it
  7. In the layer comps palette create a new comp and name it "Contact-page"

Checking and Building in SiteGrinder:

  1. Save the document and open SiteGrinder from the File->Automate menu
  2. Choose the "Buttons" panel where settings common to all buttons are altered
  3. Notice that the two menu items appear here, already set to link to the matching pages
  4. Choose the "Pages" panel
  5. Click the radio button next to "home-page" in the "Home page" column
  6. Click the "Build" button

SiteGrinder has now built two pages. The menu appears on both and links between them via SiteGrinder's name matching. There is a custom message on each page.

From this small example it should be easy to imagine expanding the menu to as many items as you have pages and filing the pages with content using layer comps.

Adding a popup menu to the original menu:

  1. Continuing from the previous ex maple, close SiteGrinder
  2. Add another type layer and type "Phone", enter, "Email", enter, "Fax"
  3. Name this new, 3-line type layer "Contact-menu" to match the "Contact" item of the menu you made in the previous example
  4. Select the move tool and move your new menu layer just to the right of the "Example-menu", with the first line approximately lined up with the "Contact" menu item.

Add a link to the popup menu in SiteGrinder:

  1. Save the document and open SiteGrinder from the File->Automate menu
  2. Choose the "Buttons" panel where settings common to all buttons are altered
  3. Notice all five items from the two menus are listed in the Button column
  4. Click in the link column to the right of the "Email" button
  5. In the link dialog, click "Email" for the type of link
  6. In the "To" field enter sales@medialab.com
  7. In the "Subject" field enter "I'm giving SiteGrinder 5/5!"
  8. Click "Okay"
  9. Click the "Build" button

Because "Contact-menu" matched the "Contact" item in the "Example-menu" SiteGrinder has made it a popup menu for that item. Roll over "Contact" and see the menu appear. Click "Email" in the submenu. If your email software is properly configured it will open and a new message will be created.

SiteGrinder 2 Basic Feature: Cloning Pages

One of SiteGrinder's most subtle and powerful features is called "Page Cloning". SiteGrinder 2 Basic can create many identical pages based on just one or two original page designs. This can be very useful for creating "site skeletons". Site skeletons are sets of pages which, while incomplete, already have all of their common elements built and in place, such as working navbars and positioned background and header graphics. These pages can then be finished off in another package with content that would be awkward to deal with in Photoshop, such as long sections of flowing HTML.

Each button (and menu item) defined by hints in the document can link in one of three ways:

  1. A link to a SiteGrinder page with contents defined by a layer comp, usually one matching the button name
  2. An arbitrary link set by the user using the SiteGrinder button panel
  3. A page not defined by a layer comp, but cloned from a layer comp (or the current document state)

It is this third option that we are leveraging here.

Create the world's fastest skeleton site:
  1. Create a new 500 X 500 pixel Photoshop document and fill it with white
  2. Create a new type layer and type "Home","Gallery", and "Contact" each on their own line into it
  3. Open SiteGrinder from Photoshop's Automate menu
  4. Click build

SiteGrinder will create three pages with nothing on them but the menu. Click the menu items to go between them and look at the page names in the browser's title bar.

Where did these pages come from? How did SiteGrinder know what to put on them?

SiteGrinder knew only that you might be making three pages corresponding to the three menu items. Since you didn't tell it otherwise by setting up layer comps or setting other links on the buttons, SiteGrinder generated the three pages by "cloning" the current document state. Since the current document state contains the menu, all the pages contain the menu.

And, importantly, the menu actually works on each page. SiteGrinder named the cloned pages after the menu items and auto-linked them all to the menu.

That's a lot of output from one layer!

In the previous example we cloned the current state of the document. What is even more useful is to set up one or more layer comps and clone them. In this way you can set up a complex template page with a navigation menu, background color and graphics, header graphics/text, and generate as many pages as you need.

Then you can open these pages in another tool and add the content HTML. This is how SiteGrinder can jump start a site by creating a skeleton containing the things Photoshop with SiteGrinder is good at, and add content Photoshop isn't so good at, like lengthy sections of flowing HTML content, in another tool.

SiteGrinder 2 Pro adds features that make page cloning even more useful.

SiteGrinder 2Basic Summary

As you can see, SiteGrinder 2 Basic is able to create a wide array of sites with all of the most common elements of web pages including buttons, rollovers, menus, popups, graphics, and styled web text.

Read on to learn about what SiteGrinder 2 Pro brings to the table.

SiteGrinder 2 Pro Features Guide

SiteGrinder 2 Pro both adds fundamentally new features and improves on old features.

SiteGrinder 2 Pro Feature: Improvements to Building

SiteGrinder 2 Pro allows user to make text-only changes and then rebuild final pages without re-exporting graphics, greatly speeding up the process of making small alterations.

SiteGrinder 2 Basic usually required users to rebuild an entire site to finalize changes before uploading. SiteGrinder 2 Pro allows final building of individual or just a few pages, which can be uploaded individually.

SiteGrinder 2 Pro CSS generation is more efficient than SiteGrinder 2 Basic. CSS common to multiple elements is better combined to avoid redundant entries, for example, and CSS unique to a single page is kept in the HEAD section of that page rather than in a common CSS file.

SiteGrinder 2 Pro Feature: Image Galleries

Image galleries are a major new feature of SiteGrinder with a large number of options. This feature is aimed at Photographers and anyone else with a number of images they wish to display in a flexible and easily navigable gallery format.

It is possible to create a gallery of images with SiteGrinder 2 Basic, but it involves the creation of many pages and buttons. SiteGrinder 2 Pro supports robust automatic gallery creation from folders of images and based on a very small number of buttons and pages in the Photoshop document.

Galleries: General Gallery Workflow

Galleries are created in the following way:

  1. Create a single page design using the -gallery layer comp hint and the -picturebox layer hint. The -picturebox layer indicates where a full size image should be displayed. The -gallery hint allows SiteGrinder to connect this gallery page to others when necessary.
  2. Add next, previous, and, optionally, up buttons to this single design for navigation from one image to another or back to the thumbnails page.
  3. Optionally create another page design indicating size and position of thumbnails images for navigation directly to corresponding images. You can choose instead to use no thumbs or to have thumbs and images on the same page.
  4. Open SiteGrinder and identify the folder of images on your hard disk from which to generate the gallery.

Thus a folder of image files and two page designs are enough to generate a complex gallery with both thumbnail-based and next/previous-based navigation.

Galleries: Full Size Image Pages

A gallery can have a single page design on which to display full sized images, or it can have a number of designs corresponding to different height/width proportions of the images. Thus a landscape-oriented image could have a special frame in the background, and a portrait-oriented image a different one, in a different place. Matching of proportion to image is automatic.

Images can be optionally scaled or cropped to fit in a particular rectangular area.

Image metadata is thoroughly supported. Image pages can include any jpeg metadata. Multiple pieces of metadata can appear anywhere on the page, and can be given Photoshop text and paragraph styles.

Thus a full size image page can contain the image in the upper right, the filename in large green type centered under the image and the date the image was taken to the left of the image in small white text. SiteGrinder uses hints inside type layers to represent metadata. SiteGrinder fills in and applies styles to the actual values when it builds the pages.

Galleries: Thumbnails

SiteGrinder has unprecedented flexibility and power when it comes to thumbnails via the -thumb hint. Thumbnails are buttons, usually small versions of the images they represent, that SiteGrinder automatically links to the appropriate full-sized image page.

Users can supply their own thumbnails.

Users can create buttons with rollovers and popups to be their thumbnails.

SiteGrinder can automatically generate "sheets" of thumbnails from the original full-sized images. The user need only provide a rectangular area for the sheet and another indicating the size of the thumbs. These sheets can optionally be scrolling and have customizable spacing between thumbs.

Users can create multiple small rectangles and place them anywhere they like to indicate where SiteGrinder should size and position automatically generated thumbnails.

Thumbnails can appear on pages with full sized images to combine navigation and viewing on the same page

Generic thumbnails can be made from layer sets and contain image metadata. Thus thumbs can easily be labeled with metadata in the same way that full sized images can.

SiteGrinder can also supply automatic rollover effects for thumbnails.

Galleries: Step-By-Step Tutorials

Follow these tutorials to see the basic process.

First we will indicate where and how large the full sized images should be:
  1. Create a new 500X500 pixel document in Photoshop and fill it with white
  2. Create a new image layer and name this layer "Example-picturebox"
  3. With this layer active, select a large rectangle in the upper right corner and fill it with a color

This layer will not appear on the built gallery pages...it is a size and location guide and will be replaced by the actual jpeg images from your selected image folder)

Second we will add navigation buttons:
  1. Create a text layer below the left part of the picturebox and type "Previous" into it
  2. Name that layer "Prev-button"
  3. Create another text layer below the right of the picturebox and type "Next" into it
  4. Name that layer "Next-button". ("prev-button" and "next-button" are hints for SiteGrinder.

The exact contents and placement of these button layers don't matter for their functionality, only the name.

These can be text or graphical buttons. In this case if the layers you made have anti-aliasing set to "None" they will become text buttons. Otherwise they will be graphic buttons. The only limit is that their layer names must be "next-button" and "prev-button". (Note that in the case of graphic buttons the user may also provide "next-rollover" and "prev-rollover" as well, just as with standard buttons.)

Third we create the gallery page layer comp:
  1. Open the layer comps palette from the window menu if necessary
  2. Click the "new layer comp" icon button at the bottom of the palette
  3. Double click the name of the comp and change the name to "Example-gallery"
Fourth we tell SiteGrinder where our folder of images resides:
  1. Save the document and open SiteGrinder from the File->Automate menu
  2. Chose the "Galleries" panel
  3. Notice our "Example" gallery is listed
  4. Click in the "Source" column to the right of the "Example-gallery" entry
  5. Click "Browse" in the dialog that appears
  6. If you happen to have a folder of jpegs, browse to it, otherwise browse to the "Media Lab SiteGrinder" folder in your Photoshop plug-ins folder. Inside, find SiteGrinderDemoFiles. Inside that find "Nasa Earth Images". Select it and click "Ok"
  7. Click the "Build" button

SiteGrinder will now generate a page for every image in the folder you selected and auto-program the next/prev buttons to navigate between them. When finished it will open one of the gallery pages in your default browser and you can test them out.

Now we will add automatic thumbnail navigation to the gallery we just made.
  1. Create a tall, narrow image layer on the left side of the document and fill it with a color. Name this layer "example-thumbsheet-scroll". SiteGrinder will fill this layer with thumbnails once we indicate how big we want each thumbnail to be in the next step. If there are more thumbnails than can fit, the thumbs area will scroll thanks to the -scroll hint.
  2. Create another image layer more narrow than the -thumbsheet layer and about the proportions of a photo and fill it with a color. Name this layer "Example-thumb". This layer can be placed anywhere on the page. It is merely an indicator of size to SiteGrinder.

Finally we will update the gallery layer comp to include the thumbsheet layers and then build:
  1. If the layer comps palette is not open, select "layer comps" from Photoshop's Window menu
  2. Right click (or control-click for Mac OS) on the "Example-gallery"comp and select "Update Layer Comp" from the menu that appears.
  3. Open up SiteGrinder 2 Pro and click "Build"

SiteGrinder will now create a new gallery from the folder you picked in the previous example, but this time it will have a scrolling area of thumbnails (if there are too many thumbs to fit). After the site opens, click on the thumbnails to navigate to a particular photo. Thumbsheets can be on the same pages as the full sized images or be on their own pages without the full sized versions.

These gallery pages can, of course, have any number of background elements, other buttons etc.

Click here for an overview of the Gallery features with links to more resources

SiteGrinder 2 Pro Feature: Animated Flash Slideshows

SiteGrinder 2 Pro can generate animated Flash slideshows from folders of images. These can be any size and can appear anywhere on a page.

Click here for a gallery of the different slideshow types

Users control where slideshows appear and how big they are using placeholder layers with the "-slideshow" hint.

Slideshows are similar to galleries in that they are generated from folders of images. The images are automatically scaled to the size of the slideshow layer.

Slideshow backgrounds seamlessly match page backgrounds.

Slideshows have a variety of timing, effects, and transition settings, including pan, zoom, and crossfade.

Optional slideshow controls allow next/previous/pause/play while Slideshows are running.

Background MP3 music playback is supported.

Unique hyperlinks for each image can set on slideshows using metadata.

These features mean that slideshows can do a lot more than simply show a series of photos. They can be used to create small, animated banners that draw the eye on one or more pages, perhaps to promote a sales special or a new addition to a site.

Create a slideshow page with these steps:
  1. Create a new 500 X 500 pixel Photoshop document
  2. Press "M" to choose the marquee tool
  3. Create a rectangular selection covering about 2/3 of the document and fill it with a color
  4. Name the layer "Example-slideshow"
  5. Save the document and open SiteGrinder
  6. Select the "Slideshows" pane.
  7. Click in the column to the right of the "Example-slideshow" entry.
  8. In the dialog that appears click the browse button
  9. Use the folder selection dialog to find and select a folder of jpeg files. (If you don't have one handy, navigate to your Photoshop plug-ins folder and then into Media Lab SiteGrinder 2 Pro/SiteGrinderDemoFiles and select one of the image folders there.)
  10. Click Ok
  11. Click Build

SiteGrinder 2 Pro Feature: Using External Media with SiteGrinder Pages

SiteGrinder 2 Pro makes it easy to place multimedia elements on pages. This is done via placeholder layers which indicate where on a page media should go. These layers use the "xmedia" hint, short for "eXternal Media", and are replaced with the actual media when the pages they appear on are built.

Supported media types include Flash and animated GIF files, digital video and audio, and external images.

Media files local to your hard disk are and copied into your build folder. Media elsewhere on the internet is linked as is, through URLs, to appear on your pages from their original locations when your pages load.

To make media management more efficient, SiteGrinder allows users to optionally specify a media folder. SiteGrinder 2 Pro will automatically find and place files in this folder whose names match xmedia layer names. A Flash movie that is located in the media folder and is named "southpark.fla", for example, will match a layer in the Photoshop document named "southpark-xmedia".

Creating the placeholder :
  1. Create a new 400 X 400 pixel document and fill it with white
  2. Create a new image layer and name it "Example Flash-xmedia"
  3. Press "m" to select the marquee tool
  4. Set the marquee style to "Fixed Size" and set the size to 300 pixel width, 50 pixel height. These are the original dimensions of the size of the Flash file we'll be adding.
  5. Click near the left side of the document
  6. Making sure the selection fits inside the document and that the xmedia layer is active, fill your selection with a color
Setting a media folder and building:
  1. Save the document from the previous steps and open SiteGrinder 2 Pro
  2. Select the "External Media" tab
  3. Click the folder button in the "External media Folder" area
  4. Navigate to your Photoshop Plug-ins folder
  5. Navigate inside the Media Lab SiteGrinder 2 Pro folder
  6. Navigate inside the SiteGrinderDemoFiles folder, select the folder named "External Media", and click Ok
  7. The "Type" column next to the Example Flash entry should now say "Flash". If it does not you have either chosen the wrong folder or used the wrong layer name.
  8. Click Ok
  9. Click Build

Once you selected the media folder, SiteGrinder found the media matching your -xmedia layer name. The media folder is an optional convenience. Clicking in the "Type" column of this panel to the right of an xmedia layer allows you to choose media from any location you like.

SiteGrinder 2 Pro Feature: Using External HTML with SiteGrinder Pages

SiteGrinder 2 Pro provides advanced support for incorporating external HTML files into your pages.

Just as xmedia layers define a size and location for external media files, they can also provide the same for external HTML.

HTML can be incorporated into your pages when SiteGrinder builds them or they can be dynamically included at the moment visitors to your pages load them from the server.

For pages included locally when building, SiteGrinder:

Because imported HTML is often of an unknown or changing length, it works especially well with expandable pages. (See below.)

Using external HTML files users can incorporate web content on their pages that is not appropriate for creation in Photoshop. These include lengthy stretches of text, advanced PHP controls such as calendars or blogs, paypal stores, etc.

SiteGrinder 2 Pro Feature: Background Images and Tiles

SiteGrinder 2 Basic supports customizable page background colors only. SiteGrinder 2 Pro adds robust support for background graphics and tiles.

A tile is just a repeating pattern. They are very common on websites, including very narrow tiles repeated either horizontally or vertically. SiteGrinder 2 Pro supports both. Tiles can create a variety of dramatic effects, including a border around content and strong visual column separations. There are a number of demo files accessible from the SiteGrinder report that demonstrate various tile techniques.

SiteGrinder 2 Pro supports fixed background graphics. In this case the contents of pages will scroll in the browser window while the background image stays underneath and doesn't move. This is a popular and dramatic effect.

SiteGrinder 2 Pro supports setting an "interior" tile to fill the background of the content area as represented by the dimensions of the Photoshop file. This tile can grow vertically as much as is needed in growing documents. (See Expandable Pages)

SiteGrinder 2 Pro also supports an "exterior" tile to fill the area between the edge of the content and the edge of the browser window when the window is open larger than the content area. Many sites use this sort of effect to place drop shadows and other visual separators between the content and browser window edge.

Because SiteGrinder 2 Pro uses the "Pattern Overlay" layer style to identify the tile, user-definable patterns are fully supported.

SiteGrinder considers the "interior" to be the dimensions of the Photoshop document. The "exterior" is the area between the edges of the document and the edges of the browser window when the browser window is wider than the size of the "interior".

To see the exterior tile in action:
  1. Create a new 500X500 pixel Photoshop document
  2. Select the rectangular marquee tool
  3. Select all and fill the empty layer with a color
  4. Select Layer Style->Pattern Overlay from the Photoshop Layer menu
  5. Select a pattern to fill the layer with
  6. Close the Layer Style dialog
  7. Name the layer "Exterior-tile"
  8. Create a new image layer on top of the tile layer
  9. Select all and fill it with some color (you won't see the tile layer anymore)
  10. Save the document and open SiteGrinder
  11. Click the build button

When the page opens, expand the browser window so you can see that the pattern filling the exterior tile layer is now filing the area between the "content" and the edges of the browser window.

SiteGrinder 2 Pro Feature: Expandable Pages

Pages created by SiteGrinder may be called upon to contain larger or smaller amounts content than were originally present in the Photoshop design when the page was built. This may be because the document is edited in another tool after SiteGrinder builds it or even because users view the page in a browser that allows them to force changes to the size of css text.

SiteGrinder 2 Pro supports vertically expandable areas to handle this situation via the "-grow" hint. Footer-style elements that appear below these growable areas will shift down or up, as necessary to accommodate the changes in height.

Text layers, and layers with the -xmedia hint are able to use the -grow hint, since they are the two layer types that might grow after a build.

Follow these steps to see the -grow hint in action:
  1. Create a new 500X500 Photoshop document and fill it with white
  2. Create a new image layer to represent the footer ("Layer 2" in the screenshot below)
  3. Select the rectangular marquee tool
  4. Make a short rectangular selection along the bottom of the document
  5. Fill it with a dark color
  6. Select the type tool
  7. Click and hold down the mouse button near the top left of the document
  8. Drag down and to the right until you have a rectangular text layer that doesn't extend below the top of the footer layer you previously made.
  9. Type a few words of 12 point text into the type layer
  10. Change the type layer's name to "Example-text-grow"

Your document should now look similar to this:

Save the document, open SiteGrinder 2 Pro from Photoshop's File->Automate menu, and Click the build button

When the page open in the browser notice that the footer layer has moved up into the empty space the -grow layer wasn't using. Any number of layers that sit below the bottom of a -grow layer will do this. Thus the footer can be quite elaborate, containing menus, text, graphics, etc.

To see the grow layer when more text is added you can open the html file in an editor (if you are viewing in IE Windows just "View Source" to open it in Notepad, add more text to the tag containing your original text, save, and reload in your browser.

SiteGrinder 2 Pro Feature: Advanced Page Cloning

SiteGrinder 2 Basic and Pro will create pages for all buttons and menu items that don't have links explicitly assigned to them and base the contents of those pages on a specified layer comp or the current state of the document.

SiteGrinder 2 Basic can leverage this feature to create site skeletons of identical pages with navigation and background graphics in place. Content not ideal for handling in Photoshop, like long flowing HTML documents, can be added to these pages in other tools.

SiteGrinder 2 Pro extends this idea much farther. The following features combine to make SiteGrinder 2 Pro a powerful tool for mixing pre-existing HTML content and Photoshop designs to build finished sites rapidly:

These features allow the user to specify a folder which contains HTML files that match button names in the document. These files will be imported and placed in a region that will adjust to fit. Tiling can be added to fill both the area behind the imported content, and the rest of the document.

To see this feature in action, open SiteGrinder and click on the "Grow-with xmedia and tile" demo file. This file builds from HTML files containing scenes from Shakespeare's "A Midsummer Night's Dream." Each file contains one scene and the file names match menu items in the document.

Build the file and explore the resulting pages. Note the paper texture tile beneath the styled HTML scene text. Note also the tile filling the rest of the area such as the drop shadow on the left and right edges and the gradient between the document edges and the edges of the browser window. Note also how the footer has adjusted on each page to the different scene lengths.

Now return to Photoshop, close SiteGrinder, and examine the layers of the file.

SiteGrinder 2 Pro is the best of both worlds for this kind of site. Graphic design and interactive elements are easy to make in Photoshop, and long flowing content is easy to import to create many pages from only a few designs and layers in the Photoshop document itself.

This kind of site could have been built with SiteGrinder 2 Basic but it would have taken many more layer and layer comps to accomplish.

No other tool can perform a similar function with the simplicity and efficiency of SiteGrinder 2 Pro.

SiteGrinder 2 Pro Feature: HTML Forms

HTML forms are the standard way to solicit information from visitors to web sites.  This might be for sending the site owner an email, typing in an address to get driving directions to a store location, etc.  HTML forms can contain text entry fields, menus, and other input controls.

While there is no direct analog to the various form elements in Photoshop’s bag of layer types, SiteGrinder 2 Pro employs a straightforward way to encode multiple form elements in a single text layer. Text entry fields are denoted by underscores, buttons are surrounded by parentheses, labels are followed by colons, etc. (See example below)

SiteGrinder 2 Pro supports the most commonly used form elements, including text fields, menus, multi-choice boxes, and checkboxes.

SiteGrinder supports CGI and PHP email forms out of the box. This means the only requirement for the user is to name the email field labels correctly, such as "subject", and SiteGrinder handles the rest.

Generic forms for myriad other purposes, such as looking up directions on Google's map page, require the addition of appropriate URLs and sometimes custom variable names and differ with each application. 

The names of the variables whose values are given by the web page visitor, such as their email address, can appear right in the form layer next to the individual field labels.

Names and values of variables that need to be set by the web page designer, such as the location of their store, are added using the Forms pane of the SiteGrinder user interface. This is also where the URL to submit the form to is entered.

To set up a form to look up a zip code in Google maps:
  1. Create a new 500X500 pixel Photoshop document and fill it with white
  2. Select the text tool
  3. Click and drag from the upper left to the lower right of the document to create a type layer
  4. Into this layer type "Enter your zip code:________" (Make the underlined area by typing underscore characters) then hit return to add a second line and type "(Show Me The Map)". The underscores represent a text entry field. The more of them there are the wider it will be. The second line will become the button to submit the form because it is in parentheses.
  5. Name this type layer "Example-form"

To finish the form in SiteGrinder 2 Pro:
  1. Save the document and open SiteGrinder 2 Pro from Photoshop's File->Automate menu
  2. Select the Forms pane
  3. Click in the column to the left of the entry for "Example-form"
  4. In the form settings dialog that appear, set the type of form to "generic-form"
  5. In the type "http://maps.google.com/maps"
  6. Set the action to "get"

Click Ok and then click the Build button

When the page opens, type in a zip code and try it out!

The SiteGrinder demo files contain a slightly more advanced version of this that gets driving directions from the entered zip code to a predefined location.

Click below to see:

SiteGrinder 2 Basic & Pro Summary:

There are many more small features and feature details than appear in this guide.  Please explore the documentation, the examples, the user showcase, and especially the hint summaries and UI description pages for more complete feature details.

Please address any questions to help@medialab.com. We have famously responsive and knowledgeable technical support.

Appendix A: SiteGrinder 2 Basic & Pro Hints

Long Short Type Set? Function
-button -b Any Y Defines a button.
-rollover -r Any Y Defines a rollover for a button with the same name.
-popup -p Any Y Creates a popup for the button with the same name.
-popdown   Any Y The "button" with the matching name causes this to hide
-hide   Any Y This layer or set will be hidden when any popups appear from any button
  -g Text   Forces a type layer to be rendered as a graphic
-text   Text   Forces a type layer to generate live styled text instead of a graphic. Same as turning off anti-aliasing for the layer
-haslinks   Text   Use this hint & a matching "links" layer to put links on words inside type layers
-links   Text   A list of links matching words or phrases in the corresponding "haslinks" type layer
-link   Text   Applies the contents of a text field as a hyperlink for the button of the same name.
-@link   Text   Applies the contents of a type layer as an email link for the button of the same name.
-scroll   Text   Gives the type layer a vertical scrollbar on the final web page.
-menu   Text Y Causes a type layer or a layer set to be a menu
-rrect   rect   Causes a Rounded Rectangle shape layer to become a re-sizable rounded rect web element
-nomerge   Image Y Tells SiteGrinder 2 Pro not to merge this layer with any other when it builds
-fav   Any   Causes a layer to become a 16X16 favorites icon for the site
-page   Comp   Specifies that a layer comp represents a page; optional for comps with matching buttons

Appendix B: SiteGrinder 2 Pro Hints

Long Type Set? Function
-form Text   The text layer contains information SiteGrinder 2 Pro will use to build HTML form entry fields
-grow Text,xmedia   The layer height and position indicates the vertical section of the page that may grow vertically
interior-tile Image   The pattern used in this layer's Pattern Overlay style will be used as the page's background tile
exterior-tile Image   The pattern used in this layer's Pattern Overlay style will fill the browser window area outside the document area
interiorgrow-tile Image   The pattern used in this layer's Pattern Overlay style will fill the area of the page's -grow layer
-xmedia Any   Layer is a placeholder telling SiteGrinder 2 Pro to include some external media, such as a Flash movie or an HTML file, at layer's location when building
next-button Any Y Creates automatic forward navigation between pages, especially gallery pages. See note below.
prev-button Any Y Creates automatic backward navigation between pages, especially gallery pages. See note below.
up-button Any Y Creates automatic navigation from a gallery image page to its corresponding page of thumbnails. See note below.
-img Image   Uses the HTML <img> tag when placing the image.
-slideshow Any   Layer is a placeholder for an animated slideshow to be generated by SiteGrinder 2 Pro
-thumb Image Y Layer will be a thumbnail for a gallery image
-thumbsheet Image   Layer defines an area which SiteGrinder will fill with thumbnails
-picturebox Image   Layer is a placeholder for the full size versions of images in a gallery to be generated by SiteGrinder 2 Pro
-metadata Text   Layer contains metadata hints so SiteGrinder 2 Pro will display image metadata along with a gallery image
-gallery Comp   Page contains thumbnails, thumbsheet or pictureboxes for a gallery to be created by SiteGrinder 2 Pro
-ignore Any Y Layer (or layer set/group) will not be included in the build of any page, even if it is visible.
-literal Text   USE WITH CAUTION. Text layer contents will be included without modification, allowing arbitrary HTML or other code to be directly added to a sized and positioned DIV.