1.1 Installing WhiteJazz

You should place all themes in the sites/all/themes folder of your Drupal installation. If you have not installed additional themes yet, this folder may not exist. If this is the case, simply create a subfolder in the sites/all folder called themes.

Download the WhiteJazz theme distribution and extract the files. The WhiteJazz theme is distributed in a pkzip or a compressed tar file. Download the appropriate distribution for your platform and extract the contents using a tool such as pkZip, 7-Zip, or Stuffit. Linux users can extract the file using the tar command.

Locate the themes folder of the WhiteJazz distribution. Within this folder is a subfolder named whitejazz. This is the folder that you will copy to your Drupal themes folder.

FTP/Copy/SCP the whitejazz folder to the sites/all/themes folder of your Drupal installation.

Enable the theme by logging into the administrator account of your Drupal installation, pointing your browser to /yoursite/admin/build/themes, and checking the 'Enabled' checkbox next to the WhiteJazz theme. If you want to use WhiteJazz as the default theme for your site, select the Default button next to the WhiteJazz theme. Click the Save Configuration button to save the changes.

For detailed instructions on installing and configuring Drupal themes, check out the Drupal.org handbook page on theme installation.

1.2. Installing the Theme Settings API Module

The ThemeSettingsAPI module is only required for Drupal version 5. The features of this module are built into Drupal version 6. If you're using Drupal version 6, you can skip forward to the next section.

You should place all modules in the sites/all/modules folder of your Drupal installation. If you have not installed additional modules yet, this folder may not exist. If this is the case, simply create a subfolder in the sites/all folder called modules.

Download the WhiteJazz theme distribution and extract the files. The WhiteJazz theme is distributed in a pkzip or a compressed tar file. Download the appropriate distribution for your platform and extract the contents using a tool such as pkZip, 7-Zip, or Stuffit. Linux users can extract the file using the tar command.

Locate the modules folder of the WhiteJazz distribution. Within this folder is a subfolder named themesettingsapi. This is the folder that you will copy to your Drupal modules folder.

FTP/Copy/SCP the themesettingsapi folder to the sites/all/modules folder of your Drupal installation.

Enable the module by logging into the administrator account of your Drupal installation, pointing your browser to /yoursite/admin/build/modules, and checking the 'Enabled' checkbox next to the Theme Settings API module. Click the Save Configuration button to save the changes.

For detailed instructions on installing and configuring Drupal modules, check out the Drupal.org handbook page on module installation.

1.3. Configuring WhiteJazz

If you have successfully installed and enabled the Theme Settings API module (or if you're running Drupal version 6), you can easily configure many aspects of the WhiteJazz theme from the Drupal administration menus.

Drupal 5 Users: You can use the WhiteJazz theme without installing the Theme Settings API module. However, you will not be able to control the theme features as described below without this module installed and enabled.

Point your browser to /yoursite/admin/build/themes/settings/whitejazz. At the bottom of this form is a series of options specific to the WhiteJazz theme. Each of the available options is described below. Modify the options to your liking and click the Save Configuration button at the bottom of the page. Your changes will take effect immediately.

Use Fixed Width: If this option is enabled, the WhiteJazz content window will have a fixed width. The width is specified in the Fixed Width Size input. If this option is disabled, the WhiteJazz content window will be fluid, meaning it will grow to fill the width of the browser window.

Fixed Width Size: This option allows you to specify the width of the WhiteJazz content window when using the fixed-width option. The default value is 850, which represents a page that is 850 pixels wide.

Show Breadcrumbs: If this option is enabled, Drupal will display breadcrumbs in the upper-left corner of each page.

Use IE PNG Fix: When this feature is enabled, WhiteJazz will load a javascript program that allows IE6 to display transparent PNG images.

Font Family: This option allows you to select the default font family for your site. You can select one of the provided options, or you can select Custom and specify your own font selector below.

Custom Font-Family Setting: If you selected Custom from the Font Family drop-down menu, you can specify a custom font-family string here. The string should be valid in the context of a CSS definition. Font family names that includes spaces should be enclosed in quotes, and multiple font names should be separated by commas.

Include Local Content File: If this option is enabled, Drupal will load a CSS file with the name specified beolow during the page-load sequence. This allows you to create a custom CSS file with site-specific CSS customizations. Isolating theme modifications and site-specific CSS in this manner prevents future theme updates from overwriting your changes.

Local Content File Name: If the Include Local Content File option is enabled, this option is used to specify the file name of the local content file. Note that the path is relative to the tapestry theme root folder.

Left Sidebar Width: This option is used to specify the width, in pixels, of the left sidebar.

Right Sidebar Width: This option is used to specify the width, in pixels, of the right sidebar.

Use Suckerfish Menus: Internet Explorer 6 has a bug related to the CSS hover attribute that prevents pure CSS suckerfish menus from working correctly. WhiteJazz provides a javascript file that will work around this problem and allow suckerfish menus to work correctly in IE. If you want to use this feature, you must enable this checkbox. If you do not enable this option, suckerfish menus will not work in IE6.

Specify Custom Logo Size: This option allows you to specify the dimensions of the logo image. This will not be necessary in all circumstances. However, if you are using a PNG image and you have enabled the IE PNG fix, you might need to enable this option and specify the logo image size.

Logo Width: The width, specified in pixels, of the logo image.

Logo Height: The height, specified in pixels, of the logo image.