Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> C Document and conversion files > C.2 Identifying conversion files > C.2.4 What not to do with conversion files

### C.2.4 What not to do with conversion files

Mostly you should leave conversion files alone. But if you must:

Move files with care

Delete files with care

Modify files with care.

Move files with care

Leave conversion files in place unless you are very sure you will not need to run all or part of the conversion again.

For example, if you move document, project, and FileID files to another directory, Mif2Go still expects to find the FileID file in the original location. This is because the configuration file contains an absolute (full-path) reference to the location of the FileID file at the time the project was created. If Mif2Go does not find a FileID file in the referenced directory, Mif2Go creates a new one there. To get around this problem, edit the configuration file to change the reference; see §C.4 Renaming or relocating the Mif2Go FileID file.

If you do move your entire project to another directory, delete all *.ref files for that project, and also delete all *.ref files for any project that links to the one you are moving.

Delete files with care

You may delete reference (.ref) files as a precursor to a full rebuild. Deleting reference files created in a prior conversion can make the next conversion of the same document run faster. This is safe practice only if both of the following apply:

• You are about to reconvert an entire book.

• No files outside the book reference any files in the book.

Otherwise, you might get broken cross references from other files, until you reconvert those files also. If you reconvert only one chapter after deleting .ref files, any cross references from that chapter to other chapters (or HTML split files) will be wrong until those other chapters have been reconverted also. See §C.5 Working with reference files for HTML or XML. See also §35.4.3 Understanding when not to delete .ref and .htm files

Modify files with care

If you add, rename, or remove any files in your FrameMaker book between conversions, you might need to edit certain conversion files. See §C.4 Renaming or relocating the Mif2Go FileID file and §C.5 Working with reference files for HTML or XML. To modify a conversion file, use a text editor such as Notepad. Otherwise, do not change the content of any conversion files except for the configuration file, unless you know what you are doing.