Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

34 Automating Mif2Go conversions > 34.8 Renaming output files for automated systems > 34.8.4 Using paragraph formats to name output files > 34.8.4.3 Basing output file names on existing paragraph formats


34.8.4.3 Basing output file names on existing paragraph formats

If you use an existing paragraph format (usually a heading) in your FrameMaker document to mark split points, and the paragraphs in this format already contain appropriate text for output file names, you can assign the FileName property to that format, and if necessary specify prefix and suffix (see §34.8.4.5 Specifying a file-name prefix or suffix). This is a simple way to use titles for file names.

However, if you are creating HTML Help (see §9 Generating Microsoft HTML Help) you would be asking for trouble. Most Help systems have files with identical titles at several points; titles such as “Summary” or “Overview” often appear under several topics, so using the title as the file name is almost certain to cause name collisions, unless you also include a unique identifier in the prefix or suffix, such as the FileID and a sequence number. See §34.8.5 Including identifiers and sequence numbers in file names.

If you ever duplicate a FileName heading in the same file, you are in deep trouble with no warning. The later file will silently overwrite the earlier. It is your responsibility to detect and avoid potential collisions, by changing the text of duplicate headings, or insuring uniqueness via sequence numbers. See §34.8.4.7 Preventing duplicate file names based on paragraph formats for another way to accomplish this. In a large Help system, you might have to use a DBMS (Data Base Management System), such as SQL Server or Access, for the names.



34 Automating Mif2Go conversions > 34.8 Renaming output files for automated systems > 34.8.4 Using paragraph formats to name output files > 34.8.4.3 Basing output file names on existing paragraph formats