Managing map IDs

Create a map ID

1)Open the Output Setup pod.

2)Expand the Context-Sensitive Help folder.

3)Expand the Map Files folder.

4)Double-click All Map IDs.

5)In Map File, click the Down Arrow and select a map file to store the map ID.

6)Click the Create/Edit Map ID button .

7)In Topic ID, type a word or phrase to identify the topic.

8)In Map Number, type a number.note: You can create individual map IDs per topic or auto-generate using the Auto Map button. See Auto-generate a map ID

Edit a map ID

You can assign or unassign topic map IDs, create new map IDs and files, and automatically map (auto-map) IDs. You can sort the topics by column.

1)Open the Output Setup pod.

2)Expand the Context-Sensitive Help folder.

3)Right-click the Map Files folder.

4)Select Edit Map IDs.

5)Choose from the following options:

Map File

List available map files (including imported map files).

Display all map IDs.

Display map IDs in the default map file BSSCDdefault.h. The map IDs for deselected map files reside in BSSCDefault.h.

Map file icon

Click to open the New Map File dialog box and create a custom map file. Map numbers for custom map files are numbered automatically.

Map #

Display the map number of the topic ID. Map numbers reside in map files (.h, .hh, .hm).

Topic

Display the topic assigned to the map ID.

Hide Used IDs

Show unassigned map IDs.

New icon

Create a map ID. The ID is appended to the map file selected in Map File.

Edit icon

Edit the selected map ID.

Delete

Remove the selected map ID. Before removing the ID, click Unassign to prevent a broken link to the topic.

Options

Customize topic auto-mapping.

Assign

Assign the selected topic to the selected topic ID. This button is available when a topic is selected on the right and a map ID is selected on the left.

Unassign

Disassociate the map ID from the topic on the right.

Auto Map

Assign a map ID in the custom or default map file (BSSCDefault.h). Select a map file and a topic. Click Auto Map. This button is available only when you select <Project Map File> or a custom map file. If you auto-map a map ID and a map file is not selected, the map ID resides in the default map file (BSSCDefault.h).

•The program assigns the topic title or filename as the topic ID and assigns a map number. Click Options to customize auto-mapping.

•You cannot assign multiple topics to a map ID. You can assign multiple map IDs to a topic.

Topic

Lists the project topics. To filter the list, click the triangle . Select All Folders, Top Level Folder, or a custom folder.

Properties icon

Show all topic IDs assigned to the topic.

Preview icon

Display the topic.

note: If you assign a map ID to a bookmark, you see a misleading error message indicating that the file does not exist. Disregard the warning. The topic does exist.

Reassign a map ID

Update the map ID if the Help topic doesn’t open, if the wrong topic opens, or if the developer changed the application that in way that affects the map IDs.

1)Select a map file under Map IDs in the Edit Map IDs dialog box.

2)Click Create/Edit Map ID.

3)Do one of the following:

•Reassign the map ID. Under Map ID, select the map ID. Click Unassign. Select another topic and click Assign.

•Change the topic ID or map number. Double-click the map ID and change the desired value.

Auto-generate a map ID

You can generate map IDs using a custom map file or the default map file (BSSCDefault.h). Before you generate map files, check with the developer to determine naming conventions.

1)In the Output Setup pod, expand the Context-Sensitive Help folder.

2)Expand the Map Files folder.

3)Double-click All Map IDs.

4)In Map File, click the triangle button.

5)Select a map file.

6)Set options for naming and numbering map IDs. By default, the application assigns the topic title or filename as the topic ID and assigns a map number.

7)In the Topic field, select the topic.

8)Click Auto Map to create a map ID.

9)If necessary, double-click the map file to edit it.

10)Provide a copy of the map file to the developer.

Generate a map ID

The IDs reside in the map file you select from the Edit Map IDs dialog box.

1)Click Options in the Edit Map IDs dialog box.

Prefix Map IDs With

Select to enter a value at the beginning of each map ID.

Make Uppercase

Select for uppercase auto-generated map IDs.

Start Numbering With

Select to enter a starting number for map numbers.

Notes:

•Setting these options does not affect existing map IDs.

•By default, the application assigns the topic title or filename as the topic ID and assigns a map number.

•Auto-generating map IDs is available when you select <Project Map File> or a custom map file. If you auto-map a map ID and do not select a map file, the map ID resides in the default map file (BSSCDefault.h).

•You cannot assign multiple topics to a map ID. You can assign multiple map IDs to one topic.

Assign a map ID to a topic

note: RoboHelp also supports dynamic context-sensitive mapping of dialog boxes and topics. This approach eliminates the need for technical authors to manually keep track of map IDs. See Dynamic editing of context-sensitive topics.

1)Open the Output Setup pod.

2)Expand the Context-Sensitive Help folder.

3)Expand the Map Files folder.

4)Double-click All Map IDs.

5)In Map File, click the Down Arrow and select the map file that contains the map ID.

6)Select the map ID to assign.

7)Select the topic.

8)Click Assign.

9)Click Close.

10)Generate the project.

11)Test the window-level topics with the application.

Unassign a map ID

1)Open the topic.

2)Click the Properties button .

3)Click the Advanced tab.

4)Click Assigned Map IDs.

5)Select the map ID to unassign.

6)Click Edit Map IDs.

7)Click Unassign.

8)Click Close.

9)Generate the project.

10)Test the window-level topics with the application.

note: If you assign map IDs to bookmarks and remove the bookmarks from the topics, manually unassign map IDs from the bookmarks.