Sample Helpset File Helpset File
6-10 Oracle Fusion Middleware Developers Guide for Oracle Help
In the following example, the map IDs topic_1 and topic_2 are not associated with window types and therefore use the helpsets default window type. The map IDs
topic_3 and topic_4 map to topic files that will be displayed in the window defined by the intro window type. Map ID topic_5.tsk will display File_
5.html in the window defined by the task window type. Map ID topic_5.cncpt will display the same topic file File_5.html in a different window type
concept. The association between URL and wintype will be used when linking from topic to topic using URLs instead of topic IDs. For example, if a topic had a
hard-coded target to File_5.html, clicking the link would display the HTML content in a task window type.
?xml version=1.0 ? map version=1.0
mapID target=topic_1 url=file_1.html mapID target=topic_2 url=file_2.htmla1
mapID target=topic_3 url=file_3.html wintype=intro mapID target=topic_4 url=file_4.htmla2 wintype=intro
mapID target=topic_5.tsk url=file_5.html wintype=task mapID target=topic_5.cncpt url=file_5.html wintype=concept
map
This scheme allows authors to assign window types to HTML files and to also override those associations by linking to an alternate topic ID. For example, for
topic-to-topic links, TOC links, index links, and hard-coded links to File_5.html, the author might use topic_5.tsk, but for links from a tutorial, the author might
use topic_5.cncpt. By keeping this information in the map file, the author has one central repository for managing these assignments.
Table 6–8 Map File Elements
Element Description
map Defines the mappings. The map element contains only
mapID elements. mapID
An ID and its associations. The mapID element has the following attributes:
■
target – The ID for the associated file. Valid characters are any alphanumeric character or punctuation symbol except
the equals sign =. IDs must be unique across all helpsets in a given help instance. However, you can assign multiple
IDs to a single file. For example, you could assign one ID for a topic file to appear in one window type and a different ID
for the same topic file to appear in a different window type.
■
url – The location of the file to associate with this ID target. Relative URLs are resolved against the absolute
URL for the map file. You may also specify a section of the file using anchor links.
■
wintype – [optional] The name of a windows type, defined using wintype elements in the helpset file. If a windows
type is not specified, the topic associated with this ID is displayed in the default window defined in the helpset. The
attribute is applicable for OHJ only.
7
Help Information Files 7-1
7
Help Information Files
Help information files contain information about the content of the help system. The information includes:
■
Section 7.1, Table of Contents File
■
Section 7.2, Index File
■
Section 7.3, Search Index File
■
Section 7.4, Link File