Table of Contents



Planning for Context-Sensitive Help in FrameMaker

Creating context-sensitive help requires you to collaborate with application developers. Because topic IDs and map numbers must be embedded in both the software application and in your source documents, you and the application developers must agree in advance on the values to use.

Before you create context-sensitive help topics, complete the following steps:

  1. Confirm with your application developers that the application supports context-sensitive help.

  2. Meet with your application developers to identify each context-sensitive help topic you need to create.

  3. Determine whether you will use topic IDs or file names to create links to context-sensitive help topics.

  4. Discuss the process for referencing context-sensitive help topics from the application with your application developers. Writers and application developers have the following options for creating context-sensitive help links:

  5. The writer chooses the topic IDs or file names and embeds them in the source documents. If the generated output supports map files, the writer performs the following steps:

    1. The writer uses topic IDs inserted into source documents and ePublisher to generate a map file, also known as a header file, that contains the topic IDs defined by the writer and automatically generated mapping IDs.

    2. The writer supplies the generated map file to the application developers to implement.

Note: The writer must supply the header file along with the help system to the developers each time the writer updates the help system. This ensures correctly identified context-sensitive help topics each time.

ePublisher/2009.1/Help/03.Preparing_and_Publishing_Content/01.044.Preparing_FrameMaker_Files (last edited 2009-07-06 18:26:34 by BenAllums)