|
Komodo has two distinct types of folders that can be used in
projects or in the Toolbox:
-
Live Folders correspond to actual
directories on the filesystem. The directory tree view
displays the current contents of the corresponding filesystem
directory.
-
Virtual Folders do not directly
correspond to directories on the filesystem. They are
multi-purpose containers; any component that can be added to
a project or the Toolbox can be stored in these folders.
When you Import from File
System, the virtual project or Toolbox folders are
created with the same names as the imported directories, but
modifying the name of the folder within Komodo has no effect
on the directory's name in the file system. See Adding Components
to Projects or Adding Components
to the Toolbox for instructions on adding folders.
Double-click a folder to display its contents. Double-click
again to collapse a folder and hide its contents. Alternatively,
click the plus and minus icons.
To access options for the selected folder, do one of the
following:
- Toolbox or
Project|component_name|option: When
a component is selected in the Project Tab or Toolbox, use the
Project or Toolbox drop-down
menus to access the list of options. The name of the component
that is currently selected in a project or the Toolbox is
displayed in the drop-down menu.
- Context Menu: Right-click an existing
component in a project or the Toolbox and select the desired
option.
The following options are available for folders:
This option imports the files and directories from a local or
network filesystem into a Virtual Folder.
Depending on the configuration of the options below, file and
directory references are created in the same hierarchical
structure as the filesystem. (Alternatively, all the file
references in a recursive directory structure can be located at
the same level within a folder.)
Use the following options on the Import from File System
dialog box to configure the import:
- Directory to import from: Specify the
directory from which you want to import files. Use the
Browse button to navigate the file
system.
- Files to include: Specify the filenames to
include. Use wildcards ("*" and "?") to specify groups of
files. Separate multiple file specifications with semicolons.
If the field is left blank, all files in the specified
directory are imported.
- Files and directories to exclude: Specify
the file and directory names to exclude. Use wildcards ("*" and
"?") to specify groups of files. Separate multiple file
specifications with semicolons. If the field is left blank, no
files in the specified directory are excluded.
- Import Subdirectories Recursively: Check
this box to import directories (and files contained in those
directories) located beneath the directory specified in the
Directory to import from field. This box must
be checked in order to specify the "Import Directory Structure"
option as the Type of folder structure to
create.
-
Type of folder structure to create:
- Import directory structure: If the
Import Subdirectories Recursively box is
checked and this option is selected, Komodo creates folders
within the project that represent imported directories.
Thus, the directory structure is preserved within the
project.
- Make a folder per language: If this
option is selected, imported files are organized into
folders according to the language indicated by file pattern
in the filename. File associations are configured in the
Komodo Preferences.
Each folder is named after the associated language, for
example, "Perl files", "XML files", etc. Files that don't
correspond to a known file pattern are stored in a folder
called "Other files".
- Make one flat list: If this option is
selected, all the imported files are placed directly under
the project or folder from which the Import from
File System command was invoked.
After importing from the file system, you are prompted to
confirm the addition of the files that match the specified
criteria. You may remove one or more files from the import. Click
OK to proceed with the import.
After using the Import from File System
feature, if you attempt to re-import the same file system
location into the same project, only files that are new since the
last import are imported.
Folders can be archived and distributed among multiple Komodo
users via Packages. Packages
are compressed archive files that contain the folder from which
the Export Package option was invoked, as well
as the folder's contents. Packages are stored in files with a
".kpz" extension, and can be opened by any archiving utility that
supports libz (for example WinZip). The
Export Package option differs from the
Export to Project option in that a copy of
filesystem-based components (such as files and dialog projects)
is included in the archive. Conversely, Export to
Project creates a project with a reference to the
component's original location and does not create a copy of the
component.
To export the contents of a folder to a package:
- In the Project Tab or Toolbox, right-click the folder
containing the item(s) to be exported to a package and select
Export Package.
- In the Package Export Wizard, enter the Package
Name and Export Location. Click
Next.
- Click Finish.
Exported packages can only be imported into "container"
objects in Komodo, such as projects, the
Toolbox, and
folders within projects and the Toolbox.
To import the contents of a package to a folder:
- In the Project Tab or Toolbox, right-click the folder and
select Import Package.
- In the Package Import Wizard, enter the name of the package
and the location on disk where files (as opposed to internal
components like snippets and run commands) will be extracted.
Click Next.
- Click Finish.
The Refresh Status option checks read/write
disk status for filesystem-based components (such as files and
dialogs) contained within the folder. If a file is of a language
for which "code intelligence" is supported and enabled (as
configured in the Code
Intelligence Preferences), Refresh Status
will also update the code intelligence database with the contents
of the file.
If the component is stored in a source code control system,
Refresh Status also checks the repository status
of the component. Komodo determines whether a file is contained
in an SCC repository by the following methods:
- Perforce: analysis of the client
configuration
- CVS: analysis of the CVS control
directories
Use this option to add components to the selected folder. All
components can be added to folders, in the same manner they are
added to projects. Refer to the individual component
documentation, or the topics Adding Components to
Projects or Adding Components to
the Toolbox for more information.
Use the cut/copy/paste options to remove folders from a
project or the Toolbox, or to move folders between the project
and the Toolbox, between projects, or between folders.
When this option is invoked, a new project file is created
that contains the folder (and its contents) from which the option
is invoked. You are prompted to provide the name of the new
project file and the directory where it will be stored. To open
the new project file, select
File|Open|Project.
To change the name of a folder, select this option and enter a
new name.
Source Control on Contents refreshes the
source code control status of all the files contained within the
folder. A subset of Komodo's Source Code Control functions
can be performed. See Source Code Control for a
description of specific options.
To remove a folder from a project or the Toolbox, select the
Delete option. Deleting a Komodo folder has no
effect on the actual filesystem contents. The folder is removed
from the project or Toolbox, but not deleted from the disk.
|
