Frequently Asked Questions

Q: I use XMLmind DITA Converter to generate HTML Help. In order to implement contextual help, my application needs to be able to address specific sections in the generated .chm file. How can I do this?

A: We don't know how this can be done in the case of HTML Help. In the case of a multi-page HTML file, a specific section of a file generated by XMLmind DITA Converter is addressed by using a URL having a fragment.

• The filename and contents of a generated HTML page are controlled by specifying the chunk attribute (and optionally, the copy-to attribute) on topicref elements..
• The qualified ID of a descendant element of a topic is transformed as follows: topicID/descendantID becomes topicID__descendantID in the generated content. (The separator string being used comprises two underscore characters.)

  Example: let's suppose a topic having "parameters" as its id attribute, containing a table having "default_values" as its id attribute, has been converted to HTML. The generated HTML page which contains the topic is called userguide.html.

  • URL "userguide.html#parameters" allows to address the topic.
  • URL "userguide.html#parameters__default_values" allows to address the table.