Adobe 65030089 User Guide - Page 232

USING ROBOHELP HTML 9 226 Context-sensitive Help Author and developer roles in creating contextsensitive Help Author Developer Writes the Help topics that describe how to use application components such as windows, dialog boxes, fields, and controls. Builds the components (windows, dialogs, fields, controls) that make up the application. Imports map files and assigns map IDs to each context-sensitive Help topic. Communicates to the developer any unclear assignments or changes in assignments. or Creates map files and assigns map IDs to each context-sensitive Help topic. Exports map files to the development environment when complete and notifies the developer of any changes. Generates the map files that contain the map IDs and gives them to the author. or Obtains map files that contain the map IDs from the author. Generates the project to include the context-sensitive Help topics with the output. Writes code that calls the correct Help topics from within the application (based on map IDs included in the map files). Tests the context-sensitive topics in the application. Repairs errors in Notifies the author when changes are made to the application (or map the Help system. files) so that the Help project can be updated and regenerated. Repairs errors in the application code. On the Authoring home page of Peter Grainge's website, you can find information about four methods of calling WebHelp: • Using URLs • Using map IDs • Using map IDs in merged WebHelp • Using topic IDs Map files and map IDs About map numbers, map files, and map IDs Map number A numeric value associated with a topic ID. Map numbers and topic IDs are saved in map files. Map numbers are used with applications to specify a topic for calling context-sensitive Help. Whether application developers use map numbers, topics IDs, or both depends on the programming language they use. Map file A text file containing topic IDs and map numbers. You associate map IDs and map files with topics. As author, if you receive a map file from your developer, assign a map ID from the map file. If you manually create a map file, either auto-generate or manually create the map ID. A project can include multiple map files. Map files use the extensions .h, .hh, and .hm. The default map file is BSSCDefault.h. Map ID A string that pairs a topic ID with a map number. For example: #define ID_SetupScreen 101 • ID_SetupScreen is the topic ID. • 101 is the map number. • ID_SetupScreen 101 is the Map ID. Last updated 12/14/2011