1/39
Contents
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's New
Part I Oracle Help Overview
1
Introduction to Oracle Help
1.1
Overview of Oracle Help
1.2
Oracle Help for Java
1.3
Oracle Help for the Web – Rich Client
1.4
Oracle Help for the Web – UIX
1.5
Oracle Help in Oracle JDeveloper
1.6
Oracle Help Licensing and Support
2
OHJ User Interface
2.1
Overview of Oracle Help for Java User Interface
2.2
OHJ Topic Windows
2.3
OHJ Navigator Window
2.3.1
Contents Tab
2.3.2
Index Tab
2.3.3
Search Tab
2.3.4
Favorites Tabs
2.3.5
Custom Navigator Tabs
2.4
Merged Helpsets
2.4.1
Merging Table of Contents
2.5
Other OHJ Features
2.5.1
Accessibility Features
2.5.2
Internationalization Features
2.5.3
Java Foundation Class (JFC) Swing Components
2.5.4
Open, Pluggable Architecture
3
OHW-RC User Interface
3.1
Overview of Oracle Help for the Web – Rich Client (OHW-RC) Interface
3.2
OHW-RC Global Toolbar
3.3
OHW-RC Contents Navigator
3.4
OHW-RC Index Navigator
3.5
OHW-RC Search Navigator
3.6
OHW-RC Topic Pane
3.7
Other OHW-RC Features
3.7.1
About OHW-RC Feature
3.7.2
Bookmarking Feature
3.7.2.1
Backward Compatibility
3.7.3
Single Pane Layout Feature
4
OHW-UIX User Interface
4.1
Overview of Oracle Help for the Web – UIX (OHW-UIX) User Interface
4.2
OHW-UIX Table of Contents
4.3
OHW-UIX Index
4.4
OHW-UIX Search
4.5
OHW-UIX Topics
Part II Oracle Help File Formats
5
Introduction to Oracle Help File Formats
5.1
Overview of Oracle Help File Formats
5.2
File Name Extensions
6
Metadata Files
6.1
Overview of Metadata Files
6.2
Helpset File
6.2.1
The <helpset> Element
6.2.2
The <title> Element
6.2.3
The <maps> Element
6.2.4
The <wintype> Element
6.2.5
The <links> Element
6.2.6
The <view> Element
6.2.6.1
Data View Type and Engines
6.2.7
The <subhelpset> Element
6.2.8
Sample Helpset File
6.3
Map Files
6.3.1
Map File Elements
7
Help Information Files
7.1
Overview of Help Information Files
7.2
Table of Contents File
7.2.1
TOC Elements
7.3
Index File
7.3.1
Index Elements
7.4
Search Index File
7.5
Link File
7.5.1
Link File Elements
8
Topic Files
8.1
Overview of Topic Files
8.2
Topic ID Links
8.3
Associative Links
8.4
Custom Protocol Links
8.5
Popups
8.6
Topic IDs
8.7
Window Types
8.8
Dynamic Mapping of Topic IDs to Files
8.8.1
The oracle.help.engine.XMLMapFixedConventionEngine Help Engine
8.8.2
The oracle.help.engine.XMLMapConventionEngine Help Engine
8.8.3
Optimizing Dynamic Maps
9
Oracle Help for the Web Configuration File
9.1
Overview of Oracle Help for the Web Configuration File
9.2
The <helpConfiguration> Element
9.2.1
The debugMode Attribute
9.3
The <brandings> Element
9.3.1
Best Practice for Internationalization
9.4
The <locales> Element
9.4.1
The <locale> Child Element <books>
9.4.2
The <contentLocation> Element
9.4.3
Sample <locales> Section
9.5
Sharing Resources Across Helpsets
9.6
The <parameters> Element
9.7
The <navigatorAliases> Element
9.8
Custom Protocol Links
9.9
Preloading Helpsets Containing Embedded Help
Part III Authoring Oracle Help
10
Authoring Oracle Help Systems
10.1
Overview of Authoring
10.2
Authoring Utilities Included with Oracle Help for Java
10.3
Authoring Embedded Help
10.3.1
HTML Files
11
Helpset Authoring Wizard
11.1
Overview of Helpset Authoring Wizard
11.2
Starting the Wizard
11.3
Creating a Helpset File
11.4
Specifying Authoring Tool and HTML Browser
11.5
Specifying Source Directory
11.6
Defining Views
11.6.1
Defining a New View
11.6.2
Defining a Custom View Type
11.6.3
Defining a Custom Data Engine
11.7
Defining Full-Text Search View
11.8
Defining Map File
11.9
Converting Associative Links
11.10
Converting Popup Window Links
11.11
Defining Window Types
11.11.1
Window Identity
11.11.2
Placement Attributes
11.11.3
Style Attributes
11.11.4
Toolbar Buttons
11.12
Finalizing the HelpSet
12
Using the Text Search Indexer
12.1
Overview of Text Search Indexer
12.2
Java Requirements
12.3
Running the Indexer
12.4
Running the JapaneseIndexer
Part IV Oracle Help for Java
13
Introduction to Oracle Help for Java Developer's Kit
13.1
Overview of Oracle Help for Java Developer's Kit
13.2
Oracle Help for Java Runtime in JDeveloper
13.3
Getting Started with the OHJDK
13.3.1
Installing OHJDK
13.3.2
Contents of an OHJDK Release
13.3.2.1
OHJ Engine
13.3.2.2
Authoring Tools
13.3.2.3
Demonstration Files
13.3.2.4
Documentation
13.3.3
Setting the Java CLASSPATH for OHJDK Development
14
Adding OHJ to Your Application
14.1
Overview of Adding OHJ to an Application
14.2
Constructing the Help Object
14.3
Adding the Help Data
14.3.1
Constructing a HelpSet
14.3.2
Adding Books to Help
14.4
Adding the Favorites Tab or Custom Tab
14.5
When to Create the Help object
14.6
Showing the Navigator Window
14.7
Showing a Topic
14.7.1
Catching TopicDisplayExceptions
14.8
Disposing of the Help Object
15
Enabling Context-Sensitive Help in Your Application
15.1
Overview of Context-Sensitive Help
15.2
Mapping Topic IDs to Help Topics
15.3
Programming Your Application to Support Context-Sensitive Help
15.4
Using CSHManager to Implement Context-Sensitive Help
15.4.1
CSHManager Constructors
15.4.2
Setting the Default Book
15.4.3
Associating Topic IDs with User Interface Components
15.4.4
Explicitly Showing Help for Components
16
Deploying an OHJ Help System
16.1
Supported Java Virtual Machines
16.2
Which OHJ JAR Files Must Be Shipped
16.3
Deploying Compressed Help Content in JARs
16.3.1
Creating JAR files
16.3.2
Which Book Constructor to Use
Part V Oracle Help for the Web – Rich Client
17
Deploying OHW-RC Demo File
17.1
Overview of Deploying OHW Demo Files
17.2
Understanding the OHW-RC Demo Files
17.3
Installing the OHW-RC Demo EAR File on Oracle WebLogic Server
17.4
Installing the OHW-RC Demo EAR File on Oracle JDeveloper
17.5
Running the OHW-RC Demo EAR File
18
Understanding OHW-RC Deployment
18.1
Overview of OHW-RC Deployment
18.2
Verifying Requirements and Dependencies
18.3
Verifying OHW-RC Library Files
18.4
Installing OHW-RC Artifacts
18.5
Understanding OHW-RC Configuration Files
18.6
Configuring OHW-RC to Display Custom Helpsets
18.7
Changing the OHW-RC Access URL
18.7.1
Changing the final URL element of the access URL
18.7.2
Changing the access URL to another name
18.8
Deploying OHW-RC as a Standalone Web Application
18.8.1
Installing the OHW-RC Artifacts
18.8.2
Configuring OHW-RC as Standalone Web Application
18.9
Deploying OHW-RC as part of a Web Application
18.9.1
Installing the OHW-RC Artifacts
18.9.2
Configuring OHW-RC as Part of Web Application
18.10
Deploying Multiple Help Instances in a Web Application
18.10.1
Application and OHW-RC Configuration Files and Setup
18.10.2
Running the application
19
Implementing Context-Sensitive Help in a Web Application
19.1
Overview of Implementing Context-Sensitive Help In a Web Application
19.2
Mapping Topic IDs to Help Topics
19.3
Creating Context-Sensitive Links to the Help System
19.3.1
Linking to the Front Main Page
19.3.2
Linking to a Topic
19.3.3
Specifying the Locale and Group
20
ADF Rich Client Help Provider
20.1
Overview of ADF Rich Client Help Provider
20.2
Integrating Online Help With ADF Faces Application
20.3
Registering OHW-RC as an ADF Rich Client Help Provider
20.4
Using HelpTopicId Attribute
20.5
Using Other Help Providers
Part VI Oracle Help for the Web – UIX
21
Deploying OHW-UIX Demo File
21.1
Overview of Deploying OHW-UIX Demo Files
21.2
Understanding the OHW-UIX Demo File
21.3
Installing the OHW-UIX Demo EAR File on Oracle WebLogic Server
21.4
Installing the OHW-UIX Demo EAR File using Oracle JDeveloper
21.5
Running the OHW-UIX Demo EAR File
22
Understanding OHW-UIX Deployment
22.1
Overview of OHW-UIX Deployment
22.2
Verifying Requirements and Dependencies
22.3
Understanding OHW-UIX Configuration Files
22.4
Configuring OHW-UIX to Display Custom Helpsets
22.5
Changing the OHW-UIX Access URL
22.5.1
Changing the final URL element of the access URL
22.5.2
Changing the access URL to another name
22.6
Upgrading OHW-UIX and UIX
23
Implementing Context-Sensitive Help in a Web Application
23.1
Overview of Implementing Context-Sensitive Help In a Web Application
23.2
Mapping Topic IDs to Help Topics
23.3
Creating Context-Sensitive Links to the Help System
23.3.1
Linking to the Front Page
23.3.2
Linking to a Topic
23.3.3
Specifying the Locale
23.4
Implementing Context-Sensitive Help in Oracle UIX-based Applications
23.4.1
Registering OHW-UIX in the OracleHelpProvider
23.4.2
Databinding a Destination
24
Upgrading OHW-UIX
24.1
Upgrading OHW-UIX to OHW-RC
A
Oracle Help and JavaHelp File Formats
A.1
Helpset File
A.2
Map File
A.3
Table of Contents File
A.4
Index File
A.5
Search Index File
A.6
Link File
A.7
OHW Configuration File
B
Working Around the Java Modal Window Problem
B.1
About the Java Modal Window Problem
B.2
Registering a Window
B.3
Unregistering a Window
C
Working With HelpBooks
C.1
HelpBook File Name Extensions
C.2
Adding the Help Data in OHJ
C.2.1
Constructing a HelpBook
C.2.2
Adding Books to Help
C.3
Locales in Oracle Help for the Web Configuration File
C.3.1
The <locale> Child Element <books>
C.3.2
The <contentLocation> Element
Scripting on this page enhances content navigation, but does not change the content in any way.