Specifying Custom Mappings

A mapping specifies the placement of a file in the staging area. In the screen below, for example, all files found in the directory /hosts/manny.engr.sgi.com/disk2 will be placed in the vrml/ subdirectory of the package directory's stage. CosmoPackage allows you to specify a general default mapping strategy as well as specific custom mappings for packaged files.

Click the Mappings tab to display the Mappings panel of CosmoPackage. Click the Inspect tab to view mappings for individual files as they are packaged.

Custom Mappings

You can specify your own mappings for local files, remote files, and trusted references. This feature allows you to create a cleaner, more logical file structure for the packaged files than their original structure.

In the Map From field, specify the location of the files in the source directory. In the Map To field, specify the desired location of the packaged files in the stage/ subdirectory of the package directory.

If you try to map two files to the same location, an error occurs. To allow the system to handle such errors, check the Auto Handle Overlapping Names box (the default). To disable this feature, click the box to remove the check. When this feature is enabled, the system adds an extra digit to the second name to prevent the duplication.

Default Mapping

If no custom mapping is specified for a given document, a default mapping strategy is used. You can choose between one of two general techniques for mapping files from the source directory on the authoring side to the packaged directory:

Flat
This choice (the default) maps all files directly to the staging area of the package directory, regardless of where they are in the file hierarchy on your system. The staging area is a subdirectory (stage/) in the package directory. The result is a completely flat file structure.
Hierarchical
This choice preserves the file hierarchy found on the author's system. It moves the necessary files to the stage/ directory, mirroring the author's file structure.

Jump to: