12.7.1 Understanding how Mif2Go generates context links

Mif2Go recognizes custom FrameMaker EclipseContext markers as the targets of infopop calls. Each infopop provides a link to the topic where an EclipseContext marker is inserted. The <topic> elements included get their href and label attributes from the <topic> elements of the containing paragraphs. This provides the equivalent of the aliases used for CSH in other Help formats; see §7.10 Setting up Context Sensitive Help (CSH). For example:

In plugin.xml:

<extension point="org.eclipse.help.contexts">

  <contexts file="contexts.xml"/>

</extension>

Note:  Eclipse 3.1 and 3.2 require a name parameter for the <contexts> element in plugin.xml; Eclipse 3.3 requires a file parameter instead. See §12.2.3 Deciding where to locate configuration settings.

In contexts.xml:

<contexts>

  <context id="help_button">

    <description>Brief description of this control.</description>

    <topic href="file_name_link1.html" label="Link1 Topic Title"/>

    <topic href="file_name_link2.html" label="Link2 Topic Title"/>

  </context>

  . . .

</contexts>

Mif2Go creates contexts.xml afresh every time you run the conversion, unless you say not to; see §12.3.4.8 Specifying Eclipse Help CSH properties in plugin.xml.

---

> 12 Generating Eclipse Help > 12.7 Setting up CSH for Eclipse Help > 12.7.1 Understanding how Mif2Go generates context links