34.8.3 Using custom markers to name output files

To specify a file name via marker, you can create a FrameMaker marker type called FileName and insert a FileName marker in the first paragraph of each part to be split or extracted. Make the content of each FileName marker the name you want for the resulting file, without path or extension.

Duplicated file names are hard to locate

Using FileName marker can result in two sections of your document having the same name. When this happens the second file overwrites the first, and the first topic does not appear in output. This error is almost impossible to find, unless you search very specifically through all file-name settings and markers. Expect many problems of this type if you use FileName markers to override Mif2Go-generated file names.

Use FileName markers only for split or extracted files

FileName markers work for any split or extracted file, but not for the first file produced from each FrameMaker file, which must have the same base name as the FrameMaker file. However, you can specify a split at the very first paragraph in each FrameMaker file, usually a chapter heading. For example:

[HTMLOptions]

StartingSplit=Yes

[HTMLParaStyles]

ChapTitle=Split

Keep empty files

The FrameMaker-named split files will be empty, and need not be included with your deliverables. However, do not delete these files from the project directory; subsequent conversions might require their presence.

As an alternative, you can add the FileName property to another marker: for example, custom marker type Split (see §18.2.1 Designating split points), or custom marker type ExtrStart (see §18.7.1 Using markers for extract processing); and specify the name of the file as the marker content.

See also:

§29 Working with FrameMaker markers

§18 Splitting and extracting files

---

> 34 Automating Mif2Go conversions > 34.8 Renaming output files for automated systems > 34.8.3 Using custom markers to name output files