Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 4 Editing configuration files > 4.5 Specifying file paths in configuration settings
Path and file names should conform to the requirements listed in §1.1.2 File, directory, and path names, otherwise you risk run-time errors. Additional considerations:
Path separator can be “\” or “/” (except sometimes!)
Paths that contain spaces must be quoted
Most relative paths relate to the project directory
Paths to configuration templates should be absolute
Some relative paths relate to the configuration file location
Paths to other applications must be absolute.
Path separator can be “\
”
or “/
”
(except sometimes!)
When you specify a file path in a configuration
setting, you can use either a backslash “\
”
or a forward slash “/
” as a separator character. A forward slash is preferred,
except in the following cases, where you must
use a backslash:.
In FrameMaker dialogs, the backslash has a special meaning that trashes paths beyond recovery. In Windows API calls, forward slashes work fine, because the original Windows programmers compiled Windows on VAX/VMS machines.
Paths that contain spaces must be quoted
If a path contains any spaces, enclose the entire path in quotes. See §1.1.2 File, directory, and path names and §3.1 Checking set-up and conversion requirements.
Most relative paths relate to the project directory
Most path settings (other than those listed in
Table 4
When you specify a relative file path in a configuration setting, the path is relative to the project directory, with the following exceptions:
[Automation]ShipPath
,
which is relative to the wrap directory; see §35.3 Understanding path values for deliverables.
Paths to configuration templates should be absolute
Settings that reference configuration templates,
or other files in the Mif2Go distribution directory structure, should use
absolute paths that begin with environment variable %OMSYSHOME%
; for example:
Configs = %omsyshome%\m2g\local\config\local_m2htm_config.ini
See §1.3.1 Set up a framework for Omni Systems applications.
Some relative paths relate to the configuration file location
If you specify a relative path in any of the
settings listed in Table 4
If you want project portability, the price is
using a fixed directory structure, where both the _config
directory (see §30.3.3 Deciding where to keep document-specific configuration
files) and the project directory are immediately
below the source directory. If you have files all over the place, portability
becomes impossible.
Table 4
Paths to other applications must be absolute
File paths to non-Mif2Go executables must be absolute. However, a better
way would be to make sure those executables are on your system PATH
,
so your conversion project is portable.