Difference between revisions of "Documentation/Extensible Help"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Context Sensitive Help)
(Help Issue Areas)
Line 30: Line 30:
===Help Issue Areas===
===Functional Areas===
====Context Sensitive Help====
====Context Sensitive Help====

Revision as of 14:21, 12 June 2007

Editing.png Статья в работе (ЧЕРНОВИК), и находится в процессе написания.

Project Objective

The Extensible Help project was found to resolve any issues and incorporate any changes required to allow the application help (aka Online Help) to be extended by extra content, mainly provided by OpenOffice.org extensions.

iTeam Members

Name Represents
Andreas Bregas Development
Carsten Driesner Development
Hans-Peter Burow Development
Ause Release Engineering
Frank Peters Documentation
Matthias Müller-Prove User Experience
Thomas Klarhöfer QA

Functional Areas

Context Sensitive Help

Context Sensitive Help Trigger

The Application Help is context specific, in that calling the Help from within the application (using F1 or the Help button, if available) triggers the display of a help page associated with the context in which the help was called. Note, that not all application contexts may be currently covered. The context sensitivity is established by calling the Help in conjunction with context parameters, such as

  • a Help ID designating the actual context within the application
  • an application name designating the application that calls the help (Writer, Calc, Impress...)
  • a language code designating the current UI language
  • a system identifier designating the current operating platform (Window, Unix)
  1. The application database consulted depends on the application context communicated. It contains tables that relate Help IDs to help pages.
  2. Some Help IDs are not associated with specific help pages
  3. In that case, the default start page for the application context is displayed as defined in the application.cfg file
  4. The help page associated with the help id is extracted from the jar archive
  5. Should the archive not contain the help page, there is a misalignment between database and archive. This should never happen and is a real bug.
  6. The file main_transform.xsl is used to produce the help output as displayed by the viewer
  7. The err.html page contains the id for the help page that could not be found for error reporting

Extended Tips

Extended Tips or bubble help are chunks of help content that are defined in the application help source files and get extracted when the help is built. They are application-dependent, i.e. every application has its own set, and are stored in *.ht files in the help directories. An extended tip gets displayed when the user rests the mouse over a UI element (with extended tips activated through Tools - Options), or if he presses Shift-F1. The Help-ID for that element is used to select the corresponding extended tip content from the *.ht files.


Table of Contents

Keyword Index and Fulltext Search

Localized Content

Personal tools