Specifying Custom File Names for Word Imports

If you import Microsoft Word documents, you can split those documents into multiple topics based on the styles in them. For example, you might decide to create a new topic at each "Heading 1" style in the Word document. You can also control the file names given to the new topics that are created from the imported Word documents. To do this, you need to apply "Private" field codes to the appropriate headings in the Word documents where new topics will be created. The following format should be used when applying the field: PRIVATE:MADCAP:FILENAME:<custom filename>.

The following steps are based on Microsoft Word 2003 and 2007. For more details on creating Private fields in Microsoft Word in other versions, please refer to the documentation provided with that application.

  1. Open the Word document.
  2. Place your cursor on a heading where you want to start a new topic in Flare.
  3. Do one of the following.

    • For Word 2003 Select Insert > Field.

      OR

    • For Word 2007 Select Insert > Quick Parts > Field.

    The Field dialog opens.

  4. In the Field name section, scroll down and select Private.

  5. In the Field codes section, enter the code using the following format: PRIVATE:MADCAP:FILENAME:<custom filename>.

    example

    Let's say that you have a place in a Word document that is using the "Heading 1" style and contains the text "All About Rabbits." You want a new topic to be created at that point when you import the document. However, you also want to make sure that the file name for that new topic is simply "Rabbits." Therefore, you open the Word document and apply a Private field on that heading, using the following format:

    PRIVATE:MADCAP:FILENAME:Rabbits

    When you import the Word document, you select to split new topics on certain styles, including the "Heading 1" style. After the import is finished, one of the topics created is named "Rabbits.htm."

  6. Click OK.
  7. Save the Word document.

  8. In Flare, go through the process for importing the Word document. When you arrive at the "New Topic Styles" page in the Import Microsoft Word Wizard or the "New Topic Styles" tab in the Word Import Editor, make sure you select the style(s) where you inserted Private fields in the Word document.

    See Importing Word Files.

Note: Flare supports Microsoft Word 2003 and newer versions.