User manual MACROMEDIA USING HOMESITE+ FOR DREAMWEAVER MX

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 Copyright Notice Copyright 2002 Macromedia, Inc. All rights reserved. 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 xiv xiv xv xv Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Developer resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Macromedia website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ColdFusion web resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Documentation conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Viewing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Printing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Getting answers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Contacting Macromedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Copyright information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Releasing system resources taken at startup . . . . . . . . . . . . . . . . . . . . . . . . . . About the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6 6 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. . . . . . . . . . . . . . . . . . . . . . About the Edit tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the Browse tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the Help tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 29 29 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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . Opening Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . Editing Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . Accessing online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printing Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bookmarking Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Searching the online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extending the Help system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding media content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 35 35 35 35 36 36 38 40 Chapter 4 Managing Files ....................... 41 About the Files tabs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 About file encoding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Working with files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting startup options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Opening a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding a link to an open file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Saving a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Backing up files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing the file list display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dragging a file from Windows Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a Favorite Folders list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Downloading a web page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 44 44 45 45 46 48 48 48 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Tag Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Function Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Tag Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Auto Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Code Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Extended and Special Characters palette . . . . . . . . . . . . . . . . . . . 55 55 56 56 57 57 58 Using code generating tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Adding document content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Using keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Saving a code block as a snippet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing snippets between Dreamweaver MX and HomeSite+ . . . . . . . . . . Using dynamic variables in snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assigning a shortcut key to a snippet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 63 63 64 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Macro Recorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VTOM methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 83 85 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What is XHTML? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting options for XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using coding tools that support XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting color coding for XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using CodeSweepers to convert your code to XHTML . . . . . . . . . . . . . . . Validating XHTML code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Writing regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using a special character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a single-character regular expression . . . . . . . . . . . . . . . . . . . . . . Using a character class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a multi-character regular expression . . . . . . . . . . . . . . . . . . . . . . Using a back reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Anchoring a regular expression to a string . . . . . . . . . . . . . . . . . . . . . . . . . . Regular expression examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 102 103 103 104 105 105 107 107 107 108 108 109 110 110 111 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Running a CodeSweeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing CodeSweepers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Macromedia CodeSweeper options . . . . . . . . . . . . . . . . . . . . . . . . . 114 115 116 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 130 130 130 131 132 133 133 134 135 136 Introduction to database tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Working with data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring a ColdFusion data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connecting to a data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing a data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using SQL Builder for database queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The SQL Builder user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Writing an SQL statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a SELECT statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inserting SQL into a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Testing and editing a query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 9 Managing Projects ................... 137 138 138 138 138 139 140 140 141 141 144 144 145 146 147 148 148 148 148 150 150 150 Understanding projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What is a project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Why use a project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About project folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the project file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting project options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Populating a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Projects tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing project files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing project resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Performing other project-level tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding a project to source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Why use source control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported source control systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting up a project in source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using source control in HomeSite+ for Dreamweaver MX . . . . . . . . . . . . Displaying the Source Control toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing project files in Visual SourceSafe . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the Debug window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Debugging across multiple pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Stepping through code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Evaluating an expression and setting a watch . . . . . . . . . . . . . . . . . . . . . . . 156 157 157 158 158 Chapter 11 Deploying Files ..................... 159 Setting default deployment options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Deploying a single file or folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Performing a custom deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting folders and files to deploy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding a deployment server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Running the Deployment Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 162 164 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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Saving search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using basic search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using extended search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Searching with regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 174 174 175 176 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tag definition file structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining attribute categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a tag editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Populating dialog boxes with tag data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generating a tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 202 203 203 204 204 205 205 Adding tag Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 Container and Control examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TabDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TabPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DropDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ListBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FontPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ColorPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RadioGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SQLTextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FileBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . StyleTextBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ActiveX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 209 209 209 210 210 210 211 211 211 211 212 212 213 213 213 213 Building a custom wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 Creating a wizard definition page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic expressions in tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bound controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wizard definition page example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a wizard output template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Expressions and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WIZ Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Special considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 215 215 215 218 218 218 219 219 x Contents Wizard definition page library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 SelectDataSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Chapter 15 Scripting the Visual Tools Object Model Writing and executing scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The VTOM hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Writing a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Executing a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a custom toolbutton or toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Toolbar and toolbutton methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 224 224 224 225 226 227 227 234 252 ActiveDocument object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 DocumentCache object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 Project object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 ProjectManager object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Folder methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deployment methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DeploymentManager object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Project folder names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 274 274 276 278 280 280 281 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 Macromedia website Product information Technical support Description General information about Macromedia products and services URL www.macromedia.com/ Detailed product information on Macromedia www.macromedia.com/software/ products and related topics Macromedia HomeSite Support Center with www.macromedia.com/support/ links to many support services homesite Search the repository of technical articles on Macromedia products Support for installation-related issues for all www.macromedia.com/support/ Macromedia products homesite/installation.html 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 All the resources that you need to stay current in your skills, including online discussion groups, Knowledge Base, technical papers and more http:// webforums.macromedia.com/ homesite/ Installation support Support forums Developer Center www.macromedia.com/desdev/ developer/ Browser testing sites Links to websites that provide online testing http://builder.cnet.com/ services, as browser compatibility is still an webbuilding/ important issue for website developers. 0-7255-8-5801921-1.html Developer resources xv Resource Description URL Professional education Information about developer certification www.macromedia.com/support/ and the classes, on-site training, and online training/ 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/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: Type of information Code sample Convention Set in a monospaced font Levels to access Separated by the greater than sign (>), and the path is set in bold. a dialog box or Following are two examples: pane · "Select File > New" means "Select New from the File menu." · "Select Options > Settings > Editor > Auto Completion" means "Select Settings from the Options menu. In the Settings dialog box, expand the Editor node and select Auto Completion." Book titles and Set in italics emphasized text New terms Set in boldface 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 3 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. 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 2 Display the Help topic that you want to print. For instructions, see "Viewing online documentation" on page xvi. 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 2 Open the PDF documentation from the product CD-ROM or download it from the HomeSite+ for Dreamweaver MX section of the Macromedia website. 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 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. Toll-free: 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. Technical support Sales Copyright information xix Copyright information Portions of the software are copyrighted as follows: Copyright © 2001, Macromedia Inc. All rights reserved. Copyright © 1987-2000 by Francois Piette, Rue de Grady 24, 4053 Embourg, Belgium. Copyright © 1998-2000 World Wide Web Consortium (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University) ARR. Quality freeware from Sight&Sound, Slovenia: http://www.sight-sound.si Version 1.0: release date 15.11.1996. The Drag & Drop Component Suite Copyright © 1997-1999 (Version 3.7) by Angus Johnson & Anders Melander. All Rights Reserved. Copyright © 1999 Bradley D. Stowers. Copyright © 1996-2000 Plasmatech Software Design, All Rights Reserved. Copyright © 1995-2000 by L. David Baldwin, All Rights Reserved. Copyright © 1995-1998 Xceed Software Inc., All Rights Reserved Copyright © 1996-1999, EFD Systems, All Rights Reserved. Copyright © 1998 by REDSystems. Copyright © 1999-2001 by Hydrix Technologies. Copyright © 2001 Ipswitch Inc. The Sentry Spelling Checker Engine Copyright © 2000 Wintertree Software Inc. Ttree Component Library Copyright © 1998-2000 by David Berneda. Copyright © 1997-1999, Top Support. Copyright © 1997 by Jordan Russell. xx About This Book