Why use XHTML?
The help system provides the ability to produce dynamic help content by annotating your XHTML markup with special tags to filter, include, and extend documents. These features are not available when using HTML.
How to contribute XHTML
XHTML help documents are contributed in exactly the same way as HTML documents by referencing them from a table of contents (TOC) file. Since Eclipse 3.4 it is no longer necessary to bind the "org.eclipse.help.base.xhtml" search participant to your doc plugin.
XHTML include format
If you wish to use includes in your XHTML,
the format of the
path attribute is as follow: (explained below)
Where the fields are:
idattribute to that element (e.g.
For example, if you wish to include the paragraph (
with the id
my_copyright from the file
my.product.plugin, you would specify the following: