Working with a Project

Within a project you can run all the standard file management and maintenance operations that you perform on individual files. You can also set and modify resource filters and perform a variety of other project-level tasks.

Performing basic operations

This section contains instructions for opening and closing projects and documents, editing project properties, and deleting projects.

For instructions on deploying a project, see "Deploying Files".

To open a project:

  1. Select a project in the Recent Projects drop-down list at the top of the Projects tab, or select Project > Open Project from the menu.

    The project structure appears on the Projects tab.

  2. Expand the project node to see the project's folders and resources.
  3. To close the project, select Project > Close Project from the menu.

To open all documents, do one of the following:

To view or edit a project's properties:

  1. On the Properties resource tab, if you have more than one project, choose the project to edit from the drop down box.
  2. Right-click any of the project levels and select Properties.

    The Edit Project Properties dialog box appears.

  3. Change or specify project properties as necessary, and click OK.

    The following table shows the properties you can set at each of the project levels:
    Project level
    Project root (blue globe)
    Path options for the project structure
    Can also be opened from Projects > Properties
    Project root folder (top folder in project tree)
    Project folder type and deployment options
    Individual folder type and deployment options

To delete a project:

  1. Select Project > Delete Project from the menu, or right-click the project and select Delete Project from the shortcut menu.
  2. Click Yes to confirm that you want the project deleted.

The project is removed from the Projects panel and the APF file is deleted from your computer. This has no effect on the actual files in the mapped directories; you have only removed the project APF file.

Working with resources

The Resources tree provides an alternate view of the files in your project based on file type. This is useful for isolating application files, media files, and other content.

By default, the Resources tree includes three types of resources: HTML, CFML, and Images. You can easily edit the default resource types and also add new ones.


To prevent slow execution of project link verification and extended search and replace operations-caused by parsing large binary files such as .exe, .pdf, .zip, and media file types-HomeSite installs a list of excluded file extensions in the Windows Registry, in the LinkVerifyExcludeExts key.

To view files for a particular resource:

  1. Expand the Resources node in the top pane of the Projects tab.
  2. Click the resource whose files you want to see.

A list of files, each having a file extension specified for the selected resource, appears in the lower pane.

To set the initial resources for a project:

  1. Open Options > Settings > Projects.
  2. Select the Include project resources option.
  3. Select individual resources in the Resource Name column.
  4. If necessary, add a resource:
    1. Click the Add button to display the Add Project Resource dialog box.
    2. Type a name for the resource in the Resource Name box.
    3. In the Resource Filter box, type one or more file extensions associated with the resource, separated by semicolons; for example: gif;jpg;jpeg;png.
    4. Click OK to add the resource to the table.
  5. If necessary, edit the name or filter (file extensions) for a resources:
    1. Click the Edit button to display the Edit Project Resource dialog box.
    2. Change the resource name or filter as needed, and click OK.
  6. If necessary, remove the resource from the default project by selecting the project to remove and clicking Delete. The resource is removed from the table immediately without asking you to confirm its deletion.
  7. Click Apply to save your changes.

You can also add, edit, or remove a resource while working in the Projects tree.

To add a resource from the Projects tree:

  1. Right-click Resources in the project folder pane and select Add Resource.
  2. In the Add Resource Folder dialog box, type a name for the resource in the Resource Name box.
  3. Type one or more file extensions associated with the resource in the Resource Filter box, separating file extensions with semicolons if you have more than one.

    For example, type: gif;jpg;jpeg;png

  4. Click OK to save the folder in the Resources tree.

To edit or remove a resource from the Projects tree:

  1. Right-click the resource in the project tree.
  2. Click the appropriate command from the popup menu:

Perform other project-level tasks

You can perform other project-level tasks that are described in other sections of this documentation. The following table lists these tasks and their related sections.
Verifying links in a project
"Verifying Links"
Using Find and Replace across entire projects
"Searching Documents"
Working in a Source Control System
"Managing a Project with a Source Control System"
Deploying (uploading) projects
"Deploying Files"