Contributing XHTML help documents

Why use XHTML?

The help system provides the ability to produce dynamic help content by annotating your XHTML markup with special tags to filter, includes, and specify anchors for extensions. These features are not available when using HTML.

How to contribute XHTML

XHTML help documents are contributed in much the same way as HTML, except there are a few important differences that must be there in order to support dynamic content and searching. These required modifications are listed below:

XHTML include format

If you wish to use includes in your XHTML, the format of the path attribute is as follow: (explained below)

   <plugin_id>/<path_to_xhtml_file>/<filename_xhtml>/<element_id>

Where the fields are:

For example, if you wish to include the paragraph (<p> element) with the id my_copyright from the file /copyrights/copyright.xhtml in plugin my.product.plugin, you would specify the following:

   my.product.plugin/copyrights/copyright.xhtml/my_copyright