1/40

Contents

Expand All · Collapse All

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

Index