Macromedia USING HOMESITE+ FOR DREAMWEAVER MX User Manual

Using HomeSite+ for

Dreamweaver MX

HomeSite+ for Dreamweaver MX for Windows 98, Windows ME, Windows NT 4.0, Windows 2000, and Windows XP

Macromedia® Incorporated

Macromedia, the Macromedia logo, ColdFusion, Dreamweaver, Flash, HomeSite, JRun, Quick Tag Editor, Roundtrip, and what the web can be are trademarks or registered trademarks of Macromedia, Inc. which may be registered in the United States and internationally. Java and Solaris are trademarks of Sun Microsystems, Inc. Microsoft, Windows, Windows NT, Windows 98, Windows ME, Windows XP, and Windows 2000 are registered trademarks of Microsoft Corporation. UNIX is a trademark of The Open Group. Other brand names may be trademarks or registered trademarks of others.

This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Macromedia Inc. Macromedia Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this book.

Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Macromedia Inc.

Part number: ZCS50M100

Contents

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Developer resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

About the documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Getting answers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Contacting Macromedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Copyright information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

Macromedia website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

ColdFusion web resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Documentation conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Viewing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Printing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Chapter 1 Setting Up the Product . . . . . . . . . . . . . . . . . 1

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Installing or upgrading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Completing the setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

About the Initial Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Using the Initial Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Monitoring system resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Releasing system resources taken at startup . . . . . . . . . . . . . . . . . . . . . . . . . . 6

About the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Using the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 2 Configuring Browsers and Servers . . . . . . . 9

Configuring the internal browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Configuring an external browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Working with files on remote servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Using the SNE node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Connecting to a server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

iv Contents

Managing servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

About server mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Adding a server mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 3 Exploring the Workspace . . . . . . . . . . . . . . 25

The workspace areas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Setting options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Working in the Resources window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Creating and browsing files in the Document window. . . . . . . . . . . . . . . . . . . . . . 29

About the Edit tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

About the Browse tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

About the Help tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Tracking your work in the Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Customizing the workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Managing application toolbars and the QuickBar . . . . . . . . . . . . . . . . . . . . 31

Customizing toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Getting the most from the online Help system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Opening Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . 35

Editing Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . 35

Accessing online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Printing Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Bookmarking Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Searching the online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Extending the Help system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Adding media content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Chapter 4 Managing Files . . . . . . . . . . . . . . . . . . . . . . . 41

About the Files tabs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

About file encoding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Working with files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Setting startup options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Opening a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Adding a link to an open file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Saving a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Backing up files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Changing the file list display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Dragging a file from Windows Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Building a Favorite Folders list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Downloading a web page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Chapter 5 Writing Code and Web Content . . . . . . . . . 51

Inserting code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Inserting a tag from the QuickBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Contents v

Selecting a tag from Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Completing a tag with a tag editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Using inline tools to enter code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Using Tag Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Using Function Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Using Tag Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Using Auto Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Using Code Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Using the Extended and Special Characters palette . . . . . . . . . . . . . . . . . . . 58

Using code generating tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Adding document content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Using keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Saving a code block as a snippet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Sharing snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Sharing snippets between Dreamweaver MX and HomeSite+ . . . . . . . . . . 63

Using dynamic variables in snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Assigning a shortcut key to a snippet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Resources for website accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Tips for visually impaired users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Assigning keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Working with user interface elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 6 Editing Pages . . . . . . . . . . . . . . . . . . . . . . . . 69

Setting editor options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Using the Editor toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Settings editor options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Selecting a code or text block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Saving text to the multiple-entry Clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Using the Clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Setting the Clipboard entry limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Collapsing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Editing a referenced file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Editing an image file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Editing an included file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Using tag editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

About VTML tag editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Editing a tag with a tag editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Navigating the structure of a document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

About outline profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Setting the Tag Tree display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Editing code in the Tag Inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Setting the Tag Inspector display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

vi Contents

Creating and editing an event handler script block . . . . . . . . . . . . . . . . . . . 79

Formatting pages with Cascading Style Sheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

About Cascading Style Sheets (CSS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

About the integrated style editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Macro Recorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Using the Macro Recorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

VTOM methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Command IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Chapter 7 Using Web Development Languages . . . . . 97

About language support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Supported languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

How a language is detected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Setting options for markup languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Coding in XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

What is XHTML? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Setting options for XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Using coding tools that support XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Setting color coding for XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Using CodeSweepers to convert your code to XHTML . . . . . . . . . . . . . . . 105

Validating XHTML code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Using regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

About regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Writing regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Using a special character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Creating a single-character regular expression . . . . . . . . . . . . . . . . . . . . . . 108

Using a character class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Creating a multi-character regular expression . . . . . . . . . . . . . . . . . . . . . . 110

Using a back reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Anchoring a regular expression to a string . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Regular expression examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Using color coding schemes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Setting the supported file types for a scheme . . . . . . . . . . . . . . . . . . . . . . . . 112

Setting the display of tags in the Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Formatting code with CodeSweepers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Running a CodeSweeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Managing CodeSweepers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Setting Macromedia CodeSweeper options . . . . . . . . . . . . . . . . . . . . . . . . . 118

Validating code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Using the default Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Using the CSE HTML Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Working with tag definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

About namespace precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Setting namespace precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Contents vii

Editing tag definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Chapter 8 Accessing Data Sources . . . . . . . . . . . . . . 129

Introduction to database tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Working with data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Configuring a ColdFusion data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Connecting to a data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Viewing a data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Using SQL Builder for database queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

The SQL Builder user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Writing an SQL statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Building a SELECT statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Inserting SQL into a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Testing and editing a query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Chapter 9 Managing Projects . . . . . . . . . . . . . . . . . . . 137

Understanding projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

What is a project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Why use a project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

About project folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

About the project file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Creating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Setting project options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Creating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Populating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Working with a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Using the Projects tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Managing project files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Managing project resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

Performing other project-level tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Adding a project to source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Why use source control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Supported source control systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Setting up a project in source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Using source control in HomeSite+ for Dreamweaver MX . . . . . . . . . . . . 150

Displaying the Source Control toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Sharing project files in Visual SourceSafe . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Chapter 10 Debugging Application Code . . . . . . . . . 151

Overview of the Interactive Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Setting up a debugging session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Using the Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

About the Debugger toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

viii Contents

Running the Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

About the Debug window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Debugging across multiple pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Stepping through code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Evaluating an expression and setting a watch . . . . . . . . . . . . . . . . . . . . . . . 158

Chapter 11 Deploying Files . . . . . . . . . . . . . . . . . . . . . 159

Setting default deployment options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Deploying a single file or folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Performing a custom deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Selecting folders and files to deploy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Adding a deployment server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Running the Deployment Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Saving deployment results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Chapter 12 Testing and Maintaining

Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Working in the Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Opening the Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Saving results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Searching documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Selecting search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Saving search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Using basic search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Using extended search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Searching with regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Checking spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Configuring the spelling checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Using the spelling checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Verifying links. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185

Using Site View to check page links. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Testing page download times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Chapter 13 Extending the Help System . . . . . . . . . . . 191

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Adding content to the Help tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Changing the order of items in the Help tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Displaying text files in the Help tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Chapter 14 Customizing the Development Environment . .

Contents ix

197

About Visual Tools Markup Language (VTML) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Using Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Exploring the new VTML structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

About dialog definition files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Category tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Element tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Creating a tag definition file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Tag definition file structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Defining attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Defining attribute categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Building a tag editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Defining controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Populating dialog boxes with tag data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Generating a tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Adding tag Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Container and Control examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

TabDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

TabPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

DropDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

ListBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

FontPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

ColorPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

RadioGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

TextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

SQLTextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

FileBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

StyleTextBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

ActiveX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Building a custom wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Creating a wizard definition page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Dynamic expressions in tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Bound controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Wizard definition page example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Creating a wizard output template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Expressions and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

WIZ Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Special considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

x Contents

Wizard definition page library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

SelectDataSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Chapter 15 Scripting the Visual Tools Object Model 223

Writing and executing scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

The VTOM hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Writing a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Executing a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Creating a custom toolbutton or toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Application object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Toolbar and toolbutton methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

ActiveDocument object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

DocumentCache object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Project object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

ProjectManager object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Folder methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Deployment methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

DeploymentManager object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

Project folder names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

HTTPProvider object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

ZIPProvider object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

ActiveScripting examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

JScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Third-party add-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Running a script at startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Sample startup script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Contents xi

Table of CommandID values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

Table of SettingID values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

xii Contents

About This Book

Using HomeSite+ for Dreamweaver MX is designed to familiarize you with the product’s user interface and the productivity tools that you can use to quickly develop high-quality applications and web content.

Contents

• Intended audience................................................................................................... xiv

• Developer resources................................................................................................. xiv

• About the documentation ....................................................................................... xvi

• Getting answers......................................................................................................xviii

• Contacting Macromedia........................................................................................ xviii

• Copyright information............................................................................................. xix

xiv About This Book

Intended audience

This book is intended for professional web developers who have a working knowledge of HTML and web server environments. It introduces you to the user interface and development tools, and provides instructions for installing, configuring, and using the product.

Developer resources

Macromedia Corporation is committed to setting the standard for customer support in developer education, technical support, and professional services. Therefore, the Macromedia web site provides a wealth of online resources.

This section also describes other resources available for HomeSite+ for Dreamweaver MX developers.

Macromedia website

The Macromedia website is designed to give you quick access to the entire range of online resources, as described in the following table:

Resource Description URL

Macromedia website General information about Macromedia

products and services

Product information Detailed product information on Macromedia

products and related topics

Technical support Macromedia HomeSite Support Center with

links to many support services

Search the repository of technical articles on Macromedia products

Installation support Support for installation-related issues for all

Macromedia products

Support forums Online access to experienced developers

and Macromedia support staff, where you can post messages and read replies on subjects relating to HomeSite+ for Dreamweaver MX features

Developer Center All the resources that you need to stay

current in your skills, including online discussion groups, Knowledge Base, technical papers and more

Browser testing sites Links to websites that provide online testing

services, as browser compatibility is still an important issue for website developers.

www.macromedia.com/

www.macromedia.com/software/

www.macromedia.com/support/ homesite

www.macromedia.com/support/ homesite/installation.html

http:// webforums.macromedia.com/ homesite/

www.macromedia.com/desdev/ developer/

http://builder.cnet.com/ webbuilding/ 0-7255-8-5801921-1.html

Developer resources xv

Resource Description URL

Professional education Information about developer certification

and the classes, on-site training, and online courses offered by Macromedia

Macromedia alliances Connection with the growing network of

solution providers, application developers, resellers, and hosting services that create solutions with Macromedia products

www.macromedia.com/support/ training/

www.macromedia.com/partners/

ColdFusion web resources

Following are just a few of the many sites dedicated to ColdFusion Markup Language (CFML) development:

• CF Advisor Online at http://www.cfadvisor.com/api-shl/ engine.cfmwww.cfadvisor.com/api-shl/engine.cfm/a.

• Haznet’s Fallout shelter, a CF portal, at http://www.hudziak.com/haznet/ cfml.htmlwww.hudziak.com/haznet/cfml.html/a.

• ColdFusion Developer’s Journal, an online version of the popular print journal, at http://www.sys-con.com/coldfusion/index2.cfmwww.sys-con.com/coldfusion/

index2.cfm/a.

Tutorials

The World Wide Web Consortium (W3C) at www.W3Schools.com offers free web tutorials.

xvi About This Book

About the documentation

The documentation is designed to provide support for the complete spectrum of participants. The print and online versions are organized to allow you to quickly locate the information that you need. The online documentation is provided in HTML and Adobe Acrobat formats.

You can also access release notes, product support information, and several developer resources from the Help menu.

The rest of this section describes the conventions used in the documentation and the contents of the HomeSite+ for Dreamweaver MX documentation set.

Documentation conventions

When reading the documentation, note formatting cues, as described in the following table:

Typ e o f information Convention

Code sample Set in a

Levels to access a dialog box or pane

Book titles and emphasized text

New terms Set in boldface

Separated by the greater than sign (>), and the path is set in bold. Following are two examples:

• “Select File > New” means “Select New from the File menu.”

• “Select Options > Settings > Editor > Auto Completion”

Set in italics

monospaced font

means “Select Settings from the Options menu. In the Settings dialog box, expand the Editor node and select Auto Completion.”

Viewing online documentation

You can view Help for a specific tag, Help topics in HTML format, or online documentation in Adobe Acrobat (PDF) format.

To view Help for a tag:

• Position the cursor in a tag and press F1 or right-click and select Edit Tag. Help for the selected tag appears, including syntax and usage information.

F1 Help is available for all supported languages. To view a list of the supported languages, open Tag Chooser (Ctrl+E).

About the documentation xvii

To view the online HTML Help:

1 Select Help > Open Help References Window.

The Help tab of the Resources window appears, displaying a tree of online books that includes several language references, as well as the documentation.

2 Find the Help topic you need, using the tree, search engine, index, or bookmarks.

For details, see “Getting the most from the online Help system” on page 35.

3 Double-click a topic to display it in the Document window.

To view the PDF documentation:

Open the PDF documentation from the product CD-ROM or download it from the HomeSite+ for Dreamweaver MX section of the Macromedia website.

Printing online documentation

You can print one Help topic at a time in the HTML Help, or print as many pages of the Help as you need from the Adobe Acrobat (PDF) format of the Help.

To print a single Help topic in the HTML Help:

1 Display the Help topic that you want to print.

For instructions, see “Viewing online documentation” on page xvi.

2 Right-click the topic in the Document window and select your browser’s

command to print.

To print several pages from the PDF documentation:

1 Open the PDF documentation from the product CD-ROM or download it from

the HomeSite+ for Dreamweaver MX section of the Macromedia website.

2 Print as many pages of the documentation as you need.

For more information, see the Adobe Acrobat Reader online Help.

xviii About This Book

Getting answers

One of the best ways to solve particular programming problems is to tap into the vast expertise of the HomeSite+ for Dreamweaver MX developer communities which you can by following the Community links on http://www.macromedia.com/software/ homesite/.

Other developers on the forum can help you figure out how to do just about anything with http://www.macromedia.com/software/homesite/. The search facility can also help you search messages from the previous 12 months, allowing you to learn how others have solved a problem that you might be facing. The forum is a great resource for learning HomeSite+ for Dreamweaver MX, and it is also a great place to see the HomeSite+ for Dreamweaver MX developer community in action.

Contacting Macromedia

Corporate headquarters

Technical support

Sales

Macromedia, Inc. 600 Townsend Street San Francisco, CA 94103

Tel: 415.252.2000 Fax: 415.626.0554

Web: http://www.macromedia.commacromedia.com/a

Macromedia offers a range of telephone and web-based support options. Go to http://www.macromedia.com/

support/www.macromedia.com/support//a for a complete

description of technical support services. All user forums are listed on the Macromedia Forums home

page at http://www.macromedia.com/support/forums/ http://www.macromedia.com/support/forums//a. You can post an entry anytime.

To ll - fr e e: 888.939.2545 Tel: 617.219.2100

Fax: 617.219.2101 E-mail:

mailto:sales@macromedia.comsales@macromedia.com/ a

Online store: http://dynamic.macromedia.com/bin/MM/

store/US/home.jsphttp://dynamic.macromedia.com/bin/

MM/store/US/home.jsp/a.

Copyright information

Portions of the software are copyrighted as follows:

Quality freeware from Sight&Sound, Slovenia: http://www.sight-sound.si Version 1.0: release date 15.11.1996.

xx About This Book

Chapter 1

Setting Up the Product

This chapter describes how to install or upgrade HomeSite+ for Dreamweaver MX and how to initially configure it.

Contents

• System requirements .................................................................................................. 2

• Installing or upgrading ............................................................................................... 2

• Completing the setup ................................................................................................. 3

• Monitoring system resources ..................................................................................... 6

2 Chapter 1 Setting Up the Product

System requirements

The minimum installation requirements are as follows:

• Pentium-compatible processor (Pentium II or higher recommended)

• Microsoft Windows Windows XP

• Internet Explorer 4.5 or later

• 128 MB available RAM

• 800 x 600 pixel screen resolution with 256-color display

• 200 MB of hard disk space

• ColdFusion

• CD-ROM drive for packaged (not trial) version

Server for debugging, database access, and deployment

98, Windows ME, Windows NT® 4.0, Windows 2000, or

Installing or upgrading

This section contains instructions for installing and upgrading HomeSite+ for Dreamweaver MX. The installation also installs TopStyle 2.1 Lite, its integrated style sheet editor, unless your computer already has TopStyle version 2.1 or 2.5 installed.

Do not install an earlier version of HomeSite+ for Dreamweaver MX over a later version; however, later versions are backward-compatible with earlier versions. If both this version and a previous version are installed on your computer, you can run either version, but the earlier version will reflect changes made in the current version to searching, source control and projects, debugging, FTP, RDS, and validation.

HomeSite+ for Dreamweaver MX records any errors that are encountered during the installation to install.log in the root directory. Please be ready to send this file to Technical Support if you need help with the installation.

Completing the setup 3

To install or upgrade:

1 If you are upgrading, you can uninstall the previous version before installing the

new version, but do not delete the UserData and AutoBackup folders from the previous installation. If you delete them, you cannot import your customizations, or the files that were created by Auto Backup, into the new version.

2 Close all open applications and insert the HomeSite+ for Dreamweaver MX

CD-ROM.

3 When the initial window displays, click Install.

4 Follow the instructions in the Installation Wizard.

5 After the program files are copied to your computer, select the option to restart

your computer and click Finish.

Note

If you would like to configure Microsoft Internet Explorer so that it opens this product as the default HTML editor (instead of Microsoft Frontpage, for example), see Knowledge Base article http://www.allaire.com/handlers/

index.cfm?ID=10425&Method=Full10425/a on the Macromedia website.

Completing the setup

This section explains how to initially set up HomeSite+ for Dreamweaver MX if you have installed it for the first time, and how to set up HomeSite+ for Dreamweaver MX based on the options that were set in a previous version. The Initial Configuration Wizard (ICW) guides you through both of these processes.

Note

The English language version of HomeSite+ for Dreamweaver MX is installed with support for Chinese (traditional and simplified), Korean, and Japanese character sets on localized Windows systems. To enter characters from these sets, use the Microsoft input method. This support depends on your system language, and does not work if the Western language option is set. In Windows, you can reset your system language from the Control Panel, in Regional Settings or Regional Options.

About the Initial Configuration Wizard

The Initial Configuration Wizard (ICW) lets you carry over options from a previous version and also set new options.

The first time you run the current version of HomeSite+ for Dreamweaver MX, the ICW automatically starts, and it checks for a previous version:

• If one is found, you can selectively import options from the previous version.

• If one is not found, the Wizard prompts you to set a few initial options.

When you are finished, HomeSite+ for Dreamweaver MX starts.

4 Chapter 1 Setting Up the Product

You can run the ICW again at any time by selecting File > New and then selecting Initial Configuration Wizard from the Custom tab.

Using the Initial Configuration Wizard

This section explains how to complete the ICW after a first-time installation on a computer, and after an upgrade.

The ICW automatically starts when you run HomeSite+ for Dreamweaver MX for the first time.

To complete the ICW after a first-time installation:

1 In the initial Welcome dialog box of the Wizard, click Next.

2 In the Debug Settings dialog box, add, modify, or delete RDS server

configurations. Click Next.

3 In the Debug Mappings dialog box, add, modify, or delete mappings to RDS

servers. Click Next.

You can view or modify this information later using the Debug menu commands.

4 In the Development Style dialog box, select the language toolbars to include in

the QuickBar, and select or browse to the template that you want to use as your default for all HomeSite+ for Dreamweaver MX documents.

5 In the Perform Upgrade dialog box, confirm your selections (you can click Back

and make changes if necessary), and then click Finish.

The initial configuration is complete and you can start using HomeSite+ for Dreamweaver MX.

To complete the ICW after an upgrade:

1 In the initial Welcome dialog box of the Wizard, click Next.

2 In the Upgrade Product Settings dialog box, note the items that you can upgrade,

based on the changes made in the previous version. Click Next.

What appears next depends on the changes made in the previous version:

• If remote servers were defined in the previous version, the Upgrade Remote

Servers dialog box appears. Select every server that you need for the current version or any previous

version. (If you do not select a server in this list, it will no longer work in the previous version either.) Click Next.

• If toolbars were added or modified, the Upgrade Toolbars dialog box appears.

Select every toolbar change that you want to carry over to the current version. Click Next.

• If the previous version contained customizations such as shortcuts, snippets,

code templates, and modifications to Tag Completion and Tag Insight, then the Upgrade Feature Customizations dialog box appears. Select every customization that you want to carry over to the current version. Click Next.

Completing the setup 5

3 In the Preserve Editor Settings dialog box, select the options to carry over to the

current version. Click Next.

You can change these options later by selecting Options > Settings and making changes in the Editor pane, Validation pane, and the panes underneath Editor.

4 In the Preserve General Settings dialog box, select the customizations to carry

over to the current version. (Only nondefault options appear.) Click Next.

You can change these options later by selecting Options > Settings and making changes in the following panes: General, Markup Languages, Startup, Locations, File Settings, Browse, Spelling, Dreamweaver/UltraDev, Projects, and Tag Definitions Library.

5 In the Miscellaneous Settings dialog box, select the items whose options you

want to carry over to the current version. For example, to carry over color coding customizations, select Color Settings. Or if Auto Completion was enabled in the previous version, and you want to keep it turned on in the current version, select Auto Completion. Click Next.

6 In the Debug Settings dialog box, add, modify, or delete RDS server

configurations. Click Next.

7 In the Debug Mappings dialog box, add, modify, or delete mapping to RDS

servers. Click Next.

You can view or modify this information later using the Debug menu commands.

Note

To import a localhost RDS development mapping from a previous version, complete the Wizard, open HomeSite+ for Dreamweaver MX, expand the Macromedia FTP & RDS node on one of the Files tabs, right-click the localhost server and select Delete server. Run the Wizard again and import the previous version of the localhost RDS development mapping.

8 In the Development Style dialog box, select the language toolbars to include in

the QuickBar, and select or browse to the template that you want to use as your default for all HomeSite+ for Dreamweaver MX documents.

9 In the Perform Upgrade dialog box, confirm your selections (you can click Back

and make changes if necessary), and then click Finish.

The initial configuration is complete and you can start using HomeSite+ for Dreamweaver MX.

6 Chapter 1 Setting Up the Product

Monitoring system resources

On Windows 98 and Windows ME platforms, HomeSite+ for Dreamweaver MX uses a great amount of Windows Graphics Device Interface (GDI) and user resources. This section describes the resource problem and how to mitigate it.

For more information, also see http://www.allaire.com/Handlers/

index.cfm?ID=21011&Method=FullKnowledge Base article 21011/a on the

Macromedia website.

Releasing system resources taken at startup

You can free up Windows 98/ME resources by preventing unnecessary programs and processes from running at startup.

To release resources that Windows 98/ME takes at startup:

1 In Windows, select Start > Run.

2 In the Run dialog box, enter msconfig and click OK.

3 Clear the options that you are absolutely certain that you do not need, use, or

have. Record your changes as you proceed, in case you need to change back.

4 Click Apply.

For a useful description of memory usage on Windows 98/ME systems, see the Windows 9.x System Resources article on http://www.windows-help.net/techfiles/

win-resources.htmlInfiniSource/a.

After reclaiming these resources, if you still encounter difficulties with system resources, you might benefit from configuring the Resource Level Monitor.

About the Resource Level Monitor

The Resource Level Monitor runs in the background when you start HomeSite+ for Dreamweaver MX and warns you when resources reach a critical level, enabling them to save documents and close the application before a crash occurs. However, the warning dialog box was not labeled with the application name, and users had to edit the Windows registry to configure the monitor.

As a result, the Resource Level Monitor has been enhanced for this release so that the warning dialog box includes the application name in the window title and in the message text, to indicate that it is generated by HomeSite+ for Dreamweaver MX. Also, users can now configure the monitor in a graphical user interface.

Note

You must have rsrc32.dll installed on your computer to use the Resource Monitor. This DLL file comes from the Windows System Resource Monitor.

Monitoring system resources 7

Using the Resource Level Monitor

This section explains how to respond to warnings and how to configure the monitor.

Responding to warnings

A warning dialog box appears if your available Windows Graphics Device (GDI) or user resources drop below your default warning thresholds. For example, it appears if your default warning threshold for GDI resources is 15% and your available GDI resources drop to 14%.

For best results, save your work, even if you choose to continue. If you continue, the warning dialog box closes and does not appear again unless your system resources drop another 5%; for example, when your GDI resources drop to 9%.

Configuring the monitor

You should configure the Resource Level Monitor if your system crashes without having been warned, or if you are being warned frequently or unnecessarily. You can adjust monitor options until you find a stable level for your computer.

To configure the Resource Level Monitor:

1In the Options > Settings > Resource Monitoring pane, specify any of the

following options:

• Enable resource monitoring Clear this to disable resource monitoring.

GDI level threshold (%) Select the minimum percentage of remaining

Windows Graphics Device Interface (GDI) resources before the system issues a warning. The default is 15%.

• User level threshold (%) Select the minimum percentage of remaining user

level resources before the system issues a warning. The default is 15%.

• Monitoring interval (minutes) Select a time interval in minutes for the

system to monitor your available resources.

2 Click Apply.

8 Chapter 1 Setting Up the Product

Chapter 2

Configuring Browsers and Servers

This chapter contains instructions for setting up browsers and servers.

Contents

• Configuring the internal browser............................................................................. 10

• Configuring an external browser ............................................................................. 12

• Working with files on remote servers ...................................................................... 14

10 Chapter 2 Configuring Browsers and Servers

Configuring the internal browser

You can use the internal browser to browse documents and application pages from within HomeSite+ for Dreamweaver MX.

With a server mapping, you can also preview server-side processes in your page; for example, server-side includes, results from submitting a form to a CGI program, and the results of server-side code. For more information, see “About server mappings” on page 20.

You can also use the Browse toolbar to view pages in external browsers, test the page in different screen resolutions, and more. For more information, see “A b ou t t he

Browse tab” on page 29.

To set internal browser options:

1In the Options > Settings > Browse pane, select one of these browser options:

• Use Microsoft Internet Explorer Uses Microsoft Internet Explorer (version

3.01 or later) as the internal browser. To download the latest version, see

http://www.microsoft.com/downloads/http://www.microsoft.com/

downloads//a.

• Use Netscape Uses Netscape (version 6 or later) as the internal browser.

For this option you must correctly install and configure the Mozilla browser NGLayout/Gecko control. (Please note that the Mozilla control is under continual development, and could lack stability.)

For setup instructions, “To install and configure Mozilla:” on page 10.

• Use the built-in browser Uses the built-in browser as the internal browser.

Please note that this browser has only limited support of HTML and browser extensions.

You can only use one internal browser at a time, but you can change this setting as needed. Restart the product for the change to take effect.

2 To have the same file saving behavior when viewing pages in the internal browser

as when viewing pages in the external browser, select Use External Browser Configuration for Internal Browser.

For more information, see “Configuring an external browser” on page 12.

To install and configure Mozilla:

1 Download a Mozilla build from http://ftp.mozilla.org/pub/mozilla/releases/

http://ftp.mozilla.org/pub/mozilla/releases//a.

For best results, download the Mozilla 0.8.1 build created on 8/28/2001, from

http://ftp.mozilla.org/pub/mozilla/releases/mozilla0.8.1/ mozilla-win32-0.8.1.ziphttp://ftp.mozilla.org/pub/mozilla/releases/

mozilla0.8.1/mozilla-win32-0.8.1.zip/a.

2 Unzip the Mozilla binary files into a new directory on your computer.

+ 328 hidden pages