Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

Eclipse Plug-in Developer Guide
Previous Page Home Next Page

Help Data

org.eclipse.help.HELP_DATA

3.3

The help data XML file is used by products to control the order of books in the help table of contents, as well whether or not books or keyword index sets should be displayed at all. The file must be referenced in the product's plugin_customization.ini file using the org.eclipse.help/HELP_DATA property.

<!ELEMENT extensions ( tocOrder? , hidden?)>

The extension data for Help.



<!ELEMENT tocOrder ( toc | category)*>

Specifies the order in which top-level table of contents entries (also called "books") or categories of books should appear in Help. If one of the items listed is not available, it is ignored. If there are items available that are not listed and not hidden, they will be displayed after the ones listed here.



<!ELEMENT toc EMPTY>

<!ATTLIST toc

id CDATA #REQUIRED>

A reference to a top-level table of contents (TOC) entry, also called a "book".


  • id - The unique identifier for this book. For XML file TOC contributions, this is a path to the file in the form "/<plugin_id>/<path>/<file>" (e.g., "/org.eclipse.platform.doc.user/toc.xml"). In general, this is the ID of the TocContribution supplied by its originating AbstractTocProvider.

<!ELEMENT category EMPTY>

<!ATTLIST category

id CDATA #REQUIRED>

A reference to a category of top-level table of contents (TOC) entries (books). Categories are implicitly created when a table of contents contribution declares itself to be of that category, for example, by specifying a category attribute for the toc element in the org.eclipse.help.toc extension point.


  • id - The unique id of the category.

<!ELEMENT hidden ( toc | category | index)*>

Contains a set of help items that should be hidden from the user.



<!ELEMENT index EMPTY>

<!ATTLIST index

id CDATA #REQUIRED>

A reference to a contribution of help index keywords.


  • id - The unique identifier for this contribution of keywords. For XML file index contributions, this is a path to the file in the form "/<plugin_id>/<path>/<file>" (e.g., "/org.eclipse.platform.doc.user/index.xml"). In general, this is the ID of the IndexContribution supplied by its originating AbstractIndexProvider.

The following example shows how to arrange the following books in the order shown:

  • Book #1: "Introduction to XYZ" (category: "user.intro") in /com.xyz.doc.user/introToc.xml
  • Book #2: "Using XYZ" (category: "user.content") in /com.xyz.doc.user/usingToc.xml
  • Book #3: "Troubleshooting" (category: "user.reference") in /com.xyz.doc.user/refToc.xml

As well as hide the following books/categories and related keyword indexes:

  • Book #4: "Platform ABC" (category: none) in /org.abc.doc.isv/toc.xml
  • Book #5: "DEF Toolkit" (category: "isv.reference") in /com.def.doc.isv/toc.xml
  • Book #6: "GHI Support" (category: "isv.reference") in /com.ghi.doc.isv/toc.xml

The markup would be the following:

<extensions>
   <tocOrder>
      <toc id=
"/com.xyz.doc.user/introToc.xml"
/>
      <category id=
"user.content"
/>
      <toc id=
"/com.xyz.doc.user/refToc.xml"
/>
   </tocOrder>
   <hidden>
      <toc id=
"/org.abc.doc.isv/toc.xml"
/>
      <category id=
"isv.reference"
/>
      <index id=
"/org.abc.doc.isv/index.xml"
/>
      <index id=
"/com.def.doc.isv/index.xml"
/>
   </hidden>
</extensions>
This API is supported by any help implementation that is based on org.eclipse.help, including the default help implementation provided by Eclipse.

 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire