New File Options

Provides settings that affect the creation of new files.

The new file options affect the functionality of the New DITA File dialog. You can access these options from the main Options dialog as well as the New DITA File dialog.



New File Name Format
This field defines the text of auto-generated file names. File names are auto-generated in the New DITA File dialog as well as the Build Map from Outline command. You can enter plain text in this field as well as special building blocks. A building block is a string of text enclosed in angle brackets.
You can include a modifyer value after the building block name in square brackets. This value must be a number (from 0 to 99), and if provided, limits the length of the resulting string to that value.
Valid building blocks are listed below (some of these make more sense to use in a file name than others):
  • <$FM_USER> - maker.ini/RegInfo/User

  • <$FM_COMPANY> - maker.ini/RegInfo/Company

  • <$T_YYYY> - 4 digit year

  • <$T_YY> - 2 digit year

  • <$T_MM> - 2 digit month (zero padded)

  • <$T_MON> - 3 character month

  • <$T_MONTH> - full month name

  • <$T_DD> - 2 digit date (zero padded)

  • <$T_HOUR> - 2 digit hour (zero padded)

  • <$T_MIN> - 2 digit minute (zero padded)

  • <$T_SEC> - 2 digit second (zero padded)

  • <$TITLE> - the actual text of the title (as entered in the New File dialog)

  • <$TITLE_LC> - the text of the title lowercased

  • <$TITLE_NOSPACE> - the text of the title with spaces removed

  • <$TITLE_NOSPACELC> - the text of the title, lowercased with spaces removed

  • <$TITLE_SPACETOUNDER> - the text of the title with spaces replaced with underscores

  • <$TITLE_SPACETOUNDERLC> - the text of the title with spaces replaced with underscores and lowercased

  • <$UNIQUEID> - the unique ID as applied to the root topic element

  • <$TOPIC_TYPE> - the topic type’s element name

Note that you can include slashes (always use forward slashes or double backslashes in FrameMaker dialog boxes) in the New File Name Format field to automatically fill in subdirectory names. For example, if you always want files to be saved into folders based on the topic type, you might use the following format string:
<$TOPIC_TYPE>/<$TOPIC_TYPE[2]>_<$TITLE_NOSPACELC>.dita
If the title was “Using New Tools” and the topic type was task, the resulting filename would be “task/ta_usingnewtools.dita”.
Element Template folder
Specifies the folder where element templates are stored. This can be a local or network location. If the element template folder field is empty, the default location is the folder that contains the structure application template file.
Note: When entering paths in text fields, you must use the forward slash as the directory separator.